规格驱动开发指南

一份全面的指南，介绍如何使用三阶段规格流程——需求 → 设计 → 任务——进行系统化的功能开发。

被以下项目使用

• @kazini 在其规格工具包中使用：https://github.com/kazini/yask-spec-kit
• 亚马逊在其内部演示文稿中提到：“这是我所见过关于[规格驱动开发]的最佳资料。我会将链接完整署名后分享给我的团队。”

🧭 导航指南

初次接触规格驱动开发？ → 从 方法论概述 开始
准备创建你的第一个规格文档？ → 直接跳转到 流程指南
寻找示例？ → 浏览 示例与案例研究
需要模板？ → 获取 即用型模板
与 AI 合作？ → 学习 提示策略

📍 需要详细导航？ → 查看 完整导航索引 - 按角色、问题或学习方式查找内容

---

📚 完整目录

🎯 方法论

了解规格驱动开发的基础概念和哲学

• 概述 - 核心概念与优势
• 哲学 - 为什么规格驱动开发有效
• 适用场景 - 决策框架与适用情况

📋 流程指南

三阶段工作流的分步详解

• 需求阶段 - 使用 EARS 收集并结构化需求
• 设计阶段 - 创建全面的设计文档
• 任务阶段 - 将设计拆解为可执行的编码任务
• 流程图 - 可视化的流程与决策点

🧠 AI 推理

关于决策框架与思维过程的深入见解

• 决策框架 - 如何评估选择
• 思维过程 - 分析与优先级排序方法
• 示例 - 真实的推理链与决策点

💬 提示策略

与 AI 合作的有效沟通技巧

• 策略 - 核心提示方法
• 模板 - 即用型提示模式
• 最佳实践 - 清晰高效沟通的建议

⚡ 执行指南

根据规格文档实现功能的实用指导

• 实施指南 - 分步执行策略
• 质量保证 - 测试与验证技术
• 故障排除 - 常见问题及解决方案

📚 资源

精选参考文献与学习材料

• 标准 - EARS 及行业标准
• 工具 - 推荐工具与集成方案
• 延伸阅读 - 更多学习资源

📖 示例

真实案例与完整规格示例

• 简单功能规格 - 基础功能示例
• 复杂系统规格 - 大型系统示例
• 案例研究 - 成功故事与经验教训
• 故障排除与陷阱 - 常见错误及应对策略

📝 模板

即用型模板与检查清单

• 需求模板 - EARS 格式的客户需求
• 设计模板 - 全面的设计结构
• 任务模板 - 实施计划格式

---

快速入门

初次接触规格驱动开发？请从这里开始：

1. 理解方法论 - 阅读 概述，掌握核心概念
2. 查看实际应用 - 参阅 简单功能规格 示例
3. 动手尝试 - 使用 需求模板 创建你的第一个规格文档
4. 提升效果 - 应用 提示策略 与 AI 协作

导航提示

• 📋 流程章节 提供分步指导
• 🧠 AI 推理章节 解释决策背后的逻辑
• 💬 提示章节 帮助你与 AI 进行高效沟通
• 📖 示例 展示完整的实际应用
• 📝 模板 提供开箱即用的起点

---

🔗 交叉引用与相关内容

按工作流阶段

• 规划阶段: 方法论 → 需求 → 设计 → 任务
• 执行阶段: 实施指南 → 质量保证
• AI 协作: 提示策略 → AI 推理 → 最佳实践

按经验水平

• 初级: 方法论 → 简单示例 → 模板
• 中级: 流程指南 → 提示策略 → 案例研究
• 高级: AI推理 → 复杂示例 → 决策框架

快速解决问题

• 需求不明确 → 需求阶段 + EARS标准
• 设计挑战 → 设计阶段 + AI决策框架
• 实现问题 → 实施指南 + 故障排除
• AI沟通问题 → 提示最佳实践 + 故障排除

---

🔌 Kiro MCP服务器

Kiro MCP服务器通过模型上下文协议（MCP）公开Kiro的系统提示和指令，使其他AI助手和工具能够访问Kiro的最佳实践。

功能

• 资源: 通过MCP资源访问所有Kiro系统文档文件
• 工具: 以编程方式查询和检索特定的系统指令
• 提示: 针对常见Kiro工作流的预配置提示

快速开始

安装并配置MCP服务器：

# 使用uvx（推荐）
uvx kiro-mcp-server

# 或者使用pip安装
pip install kiro-mcp-server

将以下内容添加到您的MCP客户端配置中（例如：~/.kiro/settings/mcp.json）：

{
  "mcpServers": {
    "kiro-prompts": {
      "command": "uvx",
      "args": ["kiro-mcp-server"],
      "disabled": false
    }
  }
}

更多详情，请参阅MCP服务器文档。

---

🎯 Claude代码插件

Kiro作为可安装的Claude代码插件提供，包含7项技能，遵循agentskills.io规范。

快速安装

# 在Claude代码中
/plugin marketplace add https://github.com/jasonkneen/kiro
/plugin install kiro-spec-driven@kiro-marketplace

可用技能

安装完成后，Claude会在相关场景下自动调用这些技能：

技能	描述	使用场景
规范驱动开发	掌握方法论	“为……创建规范”
需求工程	EARS格式	“为……编写需求”
设计文档	技术架构	“设计架构……”
任务分解	实施计划	“将其分解为任务……”
AI提示	AI沟通	“如何更好地提示……”
质量保证	测试策略	“针对……的测试策略”
故障排除	问题解决	“调试这个问题……”
创建指导性文档	项目指南	“创建指导性文档……”

安装选项

# 用户范围（在任何地方可用）
/plugin install kiro-spec-driven@kiro-marketplace

# 项目范围（通过git共享）
/plugin install kiro-spec-driven@kiro-marketplace --scope project

验证技能

./scripts/validate-skills.sh

更多详情，请参阅插件文档和技能文档。

---

本指南旨在作为学习资源和参考手册。您可以根据当前需求跳转至任意章节，或按顺序阅读以获得全面理解。

📍 如需按角色、问题或学习风格进行详细导航，请参阅完整导航索引

Kiro 快速上手指南

Kiro 是一套基于规范驱动开发（Spec-Driven Development）的方法论与工具集，旨在通过“需求 → 设计 → 任务”的三阶段流程，系统化地指导开发者与 AI 协作完成功能开发。它提供了一套完整的文档、模板以及适用于 Claude Code 的插件技能。

环境准备

在开始使用 Kiro 之前，请确保满足以下前置条件：

• 操作系统：支持 Linux、macOS 或 Windows (WSL)。
• Python 环境：建议安装 Python 3.8+，用于运行 MCP 服务器。
• 包管理工具：
  • 推荐安装 uv (用于快速运行 uvx 命令)。
  • 或确保已安装 pip。
• AI 助手：
  • Claude Code：需安装并配置好 Claude Code CLI，以便使用 Kiro 插件技能。
  • MCP 客户端：如果使用 MCP 模式，需配置支持 Model Context Protocol (MCP) 的客户端。

安装步骤

Kiro 主要通过两种方式使用：作为 MCP 服务器集成到通用 AI 工作流，或作为 Claude Code 插件直接调用技能。

方式一：安装 Kiro MCP 服务器

此方式允许其他 AI 助手通过 MCP 协议访问 Kiro 的系统提示和最佳实践。

1. 启动服务器 推荐使用 uvx 直接运行（无需全局安装）：

   uvx kiro-mcp-server
   

   或者使用 pip 安装：

   pip install kiro-mcp-server
   

2. 配置 MCP 客户端 将以下配置添加到你的 MCP 客户端配置文件中（例如 ~/.kiro/settings/mcp.json）：

   {
     "mcpServers": {
       "kiro-prompts": {
         "command": "uvx",
         "args": ["kiro-mcp-server"],
         "disabled": false
       }
     }
   }
   

方式二：安装 Claude Code 插件

此方式专为 Claude Code 用户设计，安装后可自动激活 7 项核心开发技能。

1. 添加市场源并安装 在 Claude Code 终端中执行以下命令：

   /plugin marketplace add https://github.com/jasonkneen/kiro
   /plugin install kiro-spec-driven@kiro-marketplace
   

2. 选择安装范围（可选）

   • 用户级安装（全局可用）：

     /plugin install kiro-spec-driven@kiro-marketplace
     

   • 项目级安装（通过 git 共享）：

     /plugin install kiro-spec-driven@kiro-marketplace --scope project
     

3. 验证技能 运行脚本确认技能已正确加载：

   ./scripts/validate-skills.sh
   

基本使用

Kiro 的核心在于遵循 需求 (Requirements) → 设计 (Design) → 任务 (Tasks) 的开发流程。

1. 使用 Claude Code 技能（推荐）

安装插件后，只需在对话中使用自然语言触发对应技能，Claude 会自动调用 Kiro 的方法论。

• 生成需求文档 (使用 EARS 标准)：

  "为一个新的用户登录功能 write requirements for..."

  • 触发技能：requirements-engineering

• 架构设计：

  "design the architecture for 上述登录功能，包含数据库 schema 和 API 定义..."

  • 触发技能：design-documentation

• 拆解开发任务：

  "break down into tasks for 实现该登录功能..."

  • 触发技能：task-breakdown

• 优化 AI 提示词：

  "how to prompt better 以获取更准确的代码生成结果..."

  • 触发技能：ai-prompting

2. 手动参考模板与流程

如果不使用插件，可参照 Kiro 定义的标准化流程手动编写文档：

1. 需求阶段：参考 Requirements Template，使用 EARS 格式清晰描述系统行为。
2. 设计阶段：参考 Design Template，输出包含技术选型、数据流和接口定义的详细设计文档。
3. 任务阶段：参考 Tasks Template，将设计拆解为可执行的编码任务列表。
4. 执行与验证：依据 Execution Guide 进行代码实现和质量保证。

3. 快速入门路径

对于初次使用者，建议按以下顺序体验：

1. 阅读 方法论概览 理解核心理念。
2. 查看 简单功能示例 了解成品样子。
3. 复制 需求模板 尝试编写第一个规范。