Kiro Specs（规格说明）是将高层想法转化为可执行实现计划的结构化产物，包含 requirements.md、design.md 和 tasks.md 三个核心文件。所有 Specs 遵循"需求 → 设计 → 任务"三阶段工作流。Kiro 提供两种类型：Feature Specs（构建新功能，支持需求优先和设计优先两种变体）和 Bugfix Specs（系统性修复 Bug，防止回归）。适合复杂功能、需要团队协作文档或要求精确追踪进度的场景。

什么是 Specs？

Specs（规格说明）是将高层想法系统化转化为详细实现计划的结构化产物，为功能开发和 Bug 修复提供清晰的追踪与问责机制。

通过 Kiro Specs，你可以：

• 将需求拆解为带验收标准的用户故事
• 构建包含时序图和架构方案的设计文档
• 跨离散任务追踪实现进度
• 在产品与工程团队之间高效协作

核心文件结构

每个 Spec 会生成三个关键文件：

• requirements.md（或 bugfix.md）：以结构化符号记录用户故事、验收标准或 Bug 分析
• design.md：记录技术架构、时序图和实现考量
• tasks.md：提供带离散可追踪任务的详细实现计划

三阶段工作流

所有 Specs 遵循将想法转化为可执行实现的三阶段工作流：

阶段一：需求或 Bug 分析

定义需要构建或修复的内容。

• Feature Specs：在 requirements.md 中以用户故事和验收标准的形式描述需求
• Bugfix Specs：在 bugfix.md 中分析当前行为、预期行为和不应改变的行为

阶段二：设计

在 design.md 中创建技术架构和实现方案，包含：

• 系统架构与组件设计
• 时序图与数据流
• 错误处理与测试策略

阶段三：任务

在 tasks.md 中生成离散可执行的实现任务：

• 带清晰产出的可追踪任务
• 实现过程中的实时状态更新
• 支持单个执行或一键全部执行

任务执行

Kiro 为 tasks.md 文件提供任务执行界面，实时展示状态更新。任务会被标记为进行中或已完成，便于高效追踪实现进度。

Specs 的类型

Feature Specs

用于构建应用中的新功能和能力。支持两种工作流变体：需求优先（Requirements-First）和设计优先（Design-First）。

了解更多 Feature Specs →

Bugfix Specs

用于系统性地诊断和修复 Bug，同时防止回归。帮助你识别根本原因、设计修复方案，并验证其他功能不受影响。

了解更多 Bugfix Specs →

快速开始

1. 在 Kiro 面板的 Specs 下点击 +，或在聊天框中选择 Spec
2. Kiro 会询问你是在开发功能还是修复 Bug
   • 选择功能：描述功能，选择工作流（需求优先或设计优先）
   • 选择Bug：描述 Bug
3. 跟随工作流完成各阶段直到实现

何时使用 Specs，何时直接对话

使用 Specs 的场景：

• 构建需要结构化规划的复杂功能
• 修复回归代价高昂的 Bug
• 需要团队协作文档
• 需求或设计需要多轮迭代

直接对话（Vibe）的场景：

• 快速探索性编码
• 目标不明确的原型验证

进一步学习

• Feature Specs — 新功能开发的结构化流程
• Bugfix Specs — 系统性 Bug 修复
• 最佳实践 — Specs 使用技巧
• Correctness 与属性测试 — 验证实现正确性

常见问题

Q：一个代码仓库可以有多少个 Specs？

没有数量限制。建议为不同功能分别创建 Spec，而不是用一个 Spec 覆盖整个代码库。例如一个电商应用可以有 user-authentication、product-catalog、shopping-cart 等多个并行 Spec。

Q：如何在聊天中引用已有的 Spec？

在聊天框中输入 #spec 并回车，会列出所有可用 Specs，选择后 Kiro 会自动将该 Spec 的 requirements.md、design.md 和 tasks.md 全部纳入上下文。

Q：任务已经有部分被同事实现了，怎么处理？

打开 tasks.md 点击 Update tasks，Kiro 会分析代码库并自动将已完成的任务标记为完成状态；也可以在 Spec 聊天会话中直接说"检查哪些任务已经完成"。