Kiro规范同步Skill kiro-sync

---

name: kiro-sync description: “与AWS Kiro格式同步规范（requirements.md, design.md, tasks.md）。” argument-hint: “<规范文件或目录> [–direction import|export|bidirectional]” allowed-tools: 读取, 全局, 搜索, 写入, 编辑, 技能, 任务

Kiro规范同步

与AWS Kiro IDE格式同步规范。

Kiro文件结构

AWS Kiro使用特定的文件结构：

.kiro/
├── steering/
│   ├── requirements.md    # 项目范围需求
│   ├── design.md          # 总体设计
│   └── tasks.md           # 当前任务
├── specs/
│   └── {feature-name}/
│       ├── requirements.md
│       ├── design.md
│       └── tasks.md
└── kiro.json              # 配置

同步方向

方向	描述
import	Kiro → 规范（从Kiro读取）
export	规范 → Kiro（写入到Kiro）
bidirectional	双向同步，带冲突检测

工作流

1. 检测结构

   • 检查现有.kiro/目录
   • 识别规范规格
   • 确定同步方向

2. 执行同步

   • 启动spec-converter kiro代理
   • 比较内容哈希
   • 识别更改

3. 处理冲突

   • 如果双向且双方都更改：
     • 标记冲突
     • 呈现差异
     • 提示解决

4. 应用更改

   • 写入更新文件
   • 保留格式
   • 更新时间戳

5. 报告

   • 显示同步摘要
   • 列出所做更改
   • 记录任何冲突

参数

• $1 - 规范文件或.kiro/目录
• --direction - 同步方向：import, export, bidirectional（默认）
• --force - 覆盖，不带冲突检查
• --dry-run - 显示会更改的内容，不写入

示例

# 导出规范到Kiro
/spec-driven-development:kiro-sync .specs/auth/spec.md --direction export

# 从Kiro导入
/spec-driven-development:kiro-sync .kiro/specs/auth/ --direction import

# 双向同步
/spec-driven-development:kiro-sync .specs/auth/spec.md

# 干运行查看更改
/spec-driven-development:kiro-sync .specs/auth/spec.md --dry-run

映射：规范 ↔ Kiro

requirements.md

规范	Kiro
问题陈述	上下文
范围	上下文/范围
FR-X	REQ-X
NFR-X	REQ-NX
AC-X.Y	AC-X.Y

design.md

规范	Kiro
设计概述	概述
组件	组件
数据模型	数据模型
API设计	API设计

tasks.md

规范	Kiro
任务列表	任务列表
TASK-X	TASK-X
依赖关系	依赖图

EARS兼容性

Kiro原生使用EARS语法，因此需求传递不变：

规范：

## FR-1: 用户登录

当用户提交有效凭证时，
系统应认证该用户。

Kiro (requirements.md)：

### REQ-1: 用户登录

当用户提交有效凭证时，
系统应认证该用户。

仅ID前缀更改（FR-X → REQ-X）。

同步报告

# Kiro同步报告

**方向：** 双向
**时间戳：** 2024-01-15T10:30:00Z

## 摘要

| 类型 | 添加 | 更新 | 未更改 | 冲突 |
| --- | --- | --- | --- | --- |
| 需求 | 1 | 2 | 5 | 0 |
| 设计 | 0 | 1 | 0 | 0 |
| 任务 | 3 | 0 | 2 | 0 |

## 更改

### 添加
- REQ-8（规范中新需求）

### 更新
- REQ-2：更新接受标准
- REQ-5：澄清EARS语句

## 生成文件

- .kiro/specs/auth/requirements.md（更新）
- .kiro/specs/auth/design.md（更新）
- .kiro/specs/auth/tasks.md（创建）

相关命令

• /spec-driven-development:convert - 通用格式转换
• /spec-driven-development:speckit-run - 完整Spec Kit工作流
• /spec-driven-development:specify - 生成规范