SuperAPI AI 工具集

convert

通用与其它

查看项目

更新于 10-16 00:23

技能介绍

用途:该技能(convert)用于在多种规格书写格式之间互相转换,同时尽量保留语义,并对输出做目标格式合规校验。

支持的格式:canonical(规范格式,扩展名 .md)、ears(仅 EARS 的需求列表,.md)、gherkin(Gherkin 特性文件,.feature)、kiro(AWS Kiro 结构,含 requirements.md、design.md、tasks.md)、userstory(敏捷用户故事,.md)。转换矩阵显示 canonical、EARS、Gherkin、Kiro 之间可相互转换(不含同格式自转)。

工作流程:先读取源文件并分析结构判定源格式,再依据源与目标格式选择转换器(EARS↔Canonical、Gherkin↔Canonical、Kiro↔Canonical 分别由对应 spec-converter 代理执行),随后调用相应转换代理、保留语义、映射标识符,最后校验目标格式合规、确认无内容丢失、报告转换摘要,并写入指定或推导出的输出路径。

用法:命令为 /spec-driven-development:convert,$1 为源文件路径,--to 指定目标格式(canonical、ears、gherkin、kiro、userstory),--output 为可选输出路径。示例:/spec-driven-development:convert requirements.md --to gherkin;/spec-driven-development:convert auth.feature --to canonical;/spec-driven-development:convert .specs/auth/spec.md --to kiro;/spec-driven-development:convert spec.md --to gherkin --output tests/auth.feature。

转换要点:EARS 的 “WHEN...SHALL” 映射为 Gherkin 的 “When...Then”,状态驱动型 EARS 映射为 Given 前置条件,非期望型 EARS 映射为负向场景;Canonical 与 Kiro 之间,Kiro 原生使用 EARS 语法,requirements.md 对应功能需求,design.md 对应设计章节,tasks.md 对应实现任务。相关命令还有 ears-convert、gherkin-convert、kiro-sync。

限制:资料未提供安装方式、依赖、平台、收费与价格信息,暂未提供;实际转换效果与边界情况亦未说明。