name: kiro-integration description: AWS Kiro 规格模式与同步。用于处理 Kiro IDE、同步 requirements.md/design.md/tasks.md 文件，或配置 AI 智能体上下文的 steering 文件。 allowed-tools: Read, Glob, Grep, Write, Edit, Task

Kiro 集成

AWS Kiro 规格模式、文件结构以及与规范模型的同步。

何时使用此技能

关键词： Kiro, AWS Kiro, requirements.md, design.md, tasks.md, steering 文件, Kiro IDE, Kiro 智能体, Kiro 同步, 规格生成, 智能体开发, Kiro 钩子

在以下情况下使用此技能：

使用 AWS Kiro IDE 或兼容 Kiro 的工具时
在 Kiro 格式与规范规格之间同步时
创建或更新 Kiro 规格文件时
配置智能体上下文的 steering 文件时
将 Kiro 集成到现有规格驱动工作流中时
在 Kiro 与其他规格格式之间转换时

Kiro 概述

Kiro 是 AWS 开发的一种智能体 IDE，使用规格驱动开发。它生成三个互连的文件：

.kiro/
├── specs/
│   ├── requirements.md    # EARS 格式的需求
│   ├── design.md          # 技术实现设计
│   └── tasks.md           # 可执行任务分解
└── steering/
    └── context.md         # 智能体 steering 上下文

关键概念

规格文件

文件	目的	格式
`requirements.md`	使用 EARS 模式的需求	EARS 语法的 markdown
`design.md`	技术设计和架构	带图的 markdown
`tasks.md`	可执行任务清单	markdown 复选框

EARS 集成

Kiro 使用 EARS（简易需求语法）处理需求。支持所有六种模式：

泛在： 系统应...
状态驱动： 当 <条件> 时，系统应...
事件驱动： 当 <触发器> 时，系统应...
非期望： 如果 <条件>，那么系统应...
可选： 当 <功能> 时，系统应...
复杂： 以上模式的组合

Steering 文件

Steering 文件为 Kiro 智能体提供上下文：

项目特定知识
代码库约定
领域术语
架构约束

Kiro 文件结构

requirements.md

# 需求：<功能名称>

## 上下文

<问题陈述和背景>

## 功能性需求

### FR-1: <需求标题>

**模式：** 事件驱动
**优先级：** 必须

当用户提交表单时，系统应验证所有必填字段。

#### 验收标准

- [ ] AC-1.1: 给定有效输入，当提交时，显示成功消息
- [ ] AC-1.2: 给定无效输入，当提交时，高亮错误

### FR-2: ...

## 非功能性需求

### NFR-1: 性能

系统应在 200ms 内响应所有 API 请求。

design.md

# 设计：<功能名称>

## 概述

<高层次设计方法>

## 架构

### 组件图

<Mermaid 或文本图>

### 组件

| 组件 | 职责 |
| --- | --- |
| FormValidator | 输入验证逻辑 |
| FormHandler | 表单提交处理 |

## 数据模型

### 实体

- **FormSubmission**: 捕获表单数据
  - id: UUID
  - data: JSON
  - status: 枚举

## API 设计

### 端点

| 方法 | 路径 | 描述 |
| --- | --- | --- |
| POST | /api/forms | 提交表单 |

## 技术决策

### 选择的方法

<选择的方法及其理由>

### 考虑的替代方案

| 替代方案 | 优点 | 缺点 | 为什么不用 |
| --- | --- | --- | --- |
| ... | ... | ... | ... |

tasks.md

# 任务：<功能名称>

## 任务列表

### 阶段 1：设置

- [ ] **TSK-001**: 创建 FormValidator 组件
  - 需求：FR-1
  - 可交付物：`src/validators/FormValidator.ts`
  - 验收：单元测试通过

- [ ] **TSK-002**: 创建 FormHandler 服务
  - 需求：FR-1, FR-2
  - 可交付物：`src/services/FormHandler.ts`
  - 验收：集成测试通过

### 阶段 2：集成

- [ ] **TSK-003**: 连接 API 端点
  - 需求：FR-1
  - 可交付物：`src/routes/forms.ts`
  - 验收：E2E 测试通过

## 依赖图

```text
TSK-001 ─┬─> TSK-003
TSK-002 ─┘
```

## 进度

| 状态 | 数量 |
| --- | --- |
| 待处理 | 3 |
| 进行中 | 0 |
| 完成 | 0 |

与规范模型同步

Kiro 到规范

Kiro 字段	规范字段
requirements.md FR-x	`requirements[].id`
EARS 文本	`requirements[].text`
优先级	`requirements[].priority`
AC-x.y	`requirements[].acceptance_criteria[]`
design.md	`implementation_notes`
tasks.md TSK-x	映射到任务模式

规范到 Kiro

从规范格式转换到 Kiro 时：

将规范规格拆分为三个文件
使用 EARS 语法格式化需求
从实现说明生成 design.md
从任务分解创建 tasks.md

Steering 文件配置

context.md 结构

# 项目上下文

## 概述

<项目描述和目的>

## 技术栈

- 语言：TypeScript
- 框架：Next.js
- 数据库：PostgreSQL

## 约定

### 命名

- 变量使用驼峰式
- 组件使用帕斯卡式
- 文件使用短横线式

### 架构

- 遵循垂直切片架构
- 使用基于功能的文件夹结构
- 对复杂操作应用 CQRS

## 领域词汇表

| 术语 | 定义 |
| --- | --- |
| Form | 用户输入收集 |
| Submission | 完成的表单数据 |

## 约束

- 所有 API 必须是 RESTful
- 响应时间 < 200ms
- 测试覆盖率 > 80%

工作流

从功能请求生成 Kiro 规格

分析功能请求
使用 EARS 模式生成 requirements.md
生成带架构的 design.md
生成带分解的 tasks.md
如有需要创建 steering 上下文

同步 Kiro 到规范

读取 Kiro 规格文件
解析 EARS 需求
提取验收标准
映射到规范模式
输出规范 YAML/JSON

同步规范到 Kiro

读取规范规格
拆分为三个 Kiro 文件
将需求格式化为 EARS
结构化设计文档
创建任务清单

快速命令

操作	命令
从功能生成	`/spec:kiro:sync --from feature`
同步到规范	`/spec:kiro:sync --to canonical`
从规范更新	`/spec:kiro:sync --from canonical`
验证 Kiro 文件	`/spec:validate .kiro/specs/`

与 Spec Kit 集成

Kiro 文件映射到 Spec Kit 阶段：

Kiro 文件	Spec Kit 阶段
requirements.md	阶段 1: 规格化
design.md	阶段 2: 规划
tasks.md	阶段 3: 任务

参考

详细文档：

Kiro 结构参考 - 文件组织模式
Steering 文件指南 - 上下文配置
钩子集成 - Kiro 钩子模式

相关技能：

ears-authoring - EARS 需求模式
speckit-workflow - GitHub Spec Kit 5阶段工作流
canonical-spec-format - 规范规格结构

最后更新： 2025-12-24

版本历史

v1.0.0 (2025-12-26): 初始发布