规范格式转换Skill convert

---

name: 转换 description: “在不同格式之间转换规范 (EARS, Gherkin, Kiro, 规范)。” argument-hint: “<源路径> --to <格式>” allowed-tools: Read, Glob, Grep, Write, Edit, Skill, Task

转换规范格式

在不同格式之间转换规范，同时保持语义一致。

支持的格式

格式	描述	扩展名
canonical	规范规范格式	.md
ears	仅EARS需求列表	.md
gherkin	Gherkin 功能文件	.feature
kiro	AWS Kiro 结构	requirements.md, design.md, tasks.md
userstory	敏捷用户故事	.md

工作流程

1. 检测源格式

   • 读取源文件
   • 分析结构以确定格式
   • 解析内容

2. 选择转换器

   • 基于源和目标格式：
     • EARS ↔ Canonical: spec-converter ears 代理
     • Gherkin ↔ Canonical: spec-converter gherkin 代理
     • Kiro ↔ Canonical: spec-converter kiro 代理

3. 执行转换

   • 调用适当的转换器代理
   • 保持语义一致
   • 适当映射标识符

4. 验证输出

   • 检查目标格式合规性
   • 验证无内容丢失
   • 报告转换摘要

5. 保存结果

   • 写入指定输出路径
   • 或从源路径派生

参数

• $1 - 源文件路径
• --to - 目标格式 (canonical, ears, gherkin, kiro, userstory)
• --output - 输出文件路径 (可选)

例子

# 转换 EARS 到 Gherkin
/spec-driven-development:convert requirements.md --to gherkin

# 转换 Gherkin 到 canonical
/spec-driven-development:convert auth.feature --to canonical

# 转换到 Kiro 格式
/spec-driven-development:convert .specs/auth/spec.md --to kiro

# 指定输出路径
/spec-driven-development:convert spec.md --to gherkin --output tests/auth.feature

转换矩阵

从 → 到	Canonical	EARS	Gherkin	Kiro
Canonical	-	✓	✓	✓
EARS	✓	-	✓	✓
Gherkin	✓	✓	-	✓
Kiro	✓	✓	✓	-

转换笔记

EARS ↔ Gherkin

• EARS “WHEN…SHALL” 映射到 Gherkin “When…Then”
• 状态驱动的 EARS 映射到 Given 前置条件
• 不需要的 EARS 映射到负面场景

Canonical ↔ Kiro

• Kiro 本地使用 EARS 语法
• requirements.md ↔ 功能需求
• design.md ↔ 设计部分
• tasks.md ↔ 实施任务

相关命令

• /spec-driven-development:ears-convert - EARS 特定转换
• /spec-driven-development:gherkin-convert - Gherkin 特定转换
• /spec-driven-development:kiro-sync - Kiro 同步