cc-sdd：面向 AI 编码代理的长期运行规范驱动实现

将已批准的规范转化为长期运行的自主实现

只需一条命令，即可将代理式 SDLC 流程作为 Agent Skills 安装到位：发现、需求、设计、任务，以及带有每项任务独立评审的自主实现。该工具可在 8 款 AI 编码代理上运行，且每款代理均配备相同的 17 种技能集。

👻 受 Kiro 启发。 类似于 Kiro IDE 的规范驱动、代理式 SDLC 风格。现有的 Kiro 规范仍然兼容并可移植。

v3.0 的新特性

cc-sdd v3.0 围绕 Agent Skills 和长期运行的自主实现进行了重构。

• /kiro-discovery 成为新的入口点。 发现模块会将新工作引导至以下几种路径之一：扩展现有规范、无需规范直接实现、创建一个新规范、分解为多个规范，或混合分解。它会生成 brief.md 文件，并在需要时生成 roadmap.md 文件，以便您可以在不重新说明范围的情况下继续推进工作流。
• /kiro-impl 用于长期运行的自主实现。 每个任务都会启动一名全新的实施者，在功能开关后执行 TDD（RED → GREEN），同时配备一名独立评审员和自动调试流程。当实施者被阻塞或评审员两次拒绝时，自动调试流程会在干净的上下文中调查根本原因。先前任务的经验教训会通过 tasks.md 中的 ## Implementation Notes 汇报给后续任务。每次迭代处理一个任务，即使中断后也可以安全地重新运行。
• 以边界为先的规范纪律。 design.md 现在包含文件结构计划，用于定义任务边界。任务中会标注 _Boundary:_ 和 _Depends:_。评审和验证不仅关注样式问题，更注重边界违规情况。
• /kiro-spec-batch 用于多规范项目。 可以将路线图并行转化为多个规范，并进行跨规范评审，以发现矛盾、职责重复和接口不匹配等问题。
• Agent Skills 覆盖 8 款编码代理。 每次安装提供 17 种技能，按需加载（渐进式披露）。Claude Code 和 Codex 处于稳定状态；Cursor、Copilot、Windsurf、OpenCode、Gemini CLI 和 Antigravity 则处于测试阶段。无外部依赖；子代理通过各平台的原生 API 启动。

完整的技能模式工作流及 /kiro-impl 内部机制：技能参考。

从 v1.x 或 v2.x 升级？请参阅 迁移指南。

为什么选择 cc-sdd？

cc-sdd 将规范视为系统各部分之间的契约，而非交予代理的总指挥文档。代码始终是事实的唯一来源。规范明确了代码各部分之间的边界，使人类与代理能够并行工作，而无需持续同步。

我们的假设是：以适当粒度明确的契约能够让团队规模的 AI 驱动开发更快，而非更慢。代理负责编写规范，人类在各个阶段关口批准契约，最终交付的是代码。

边界并非额外开销，而是让您在内部自由移动的同时保护外部的关键所在。

完整理由、权衡分析以及适用场景与不适用场景：为什么选择 cc-sdd？哲学思考。

快速开始

cd your-project
npx cc-sdd@latest

默认安装的是带有英文文档的 Claude Code Skills。如需选择其他代理或语言：

npx cc-sdd@latest --codex-skills --lang ja      # Codex，日语
npx cc-sdd@latest --cursor-skills --lang zh-TW  # Cursor IDE，繁体中文

支持 8 款 AI 编码代理（Claude Code 和 Codex 稳定；Cursor、Copilot、Windsurf、OpenCode、Gemini CLI 和 Antigravity 处于测试阶段）以及 13 种语言。完整列表请参阅 支持的代理。

随后，在您的代理中输入：

/kiro-discovery <idea>

不知道从哪里开始？那就从 kiro-discovery 开始吧。它会根据您的请求进行路由，并提示您接下来应执行的命令。

常见工作流

您想...	技能模式
开始一项新功能或产品级别的想法	kiro-discovery → kiro-spec-init → kiro-spec-requirements → kiro-spec-design → kiro-spec-tasks → kiro-impl
扩展现有系统	kiro-steering → kiro-discovery 或 kiro-spec-init → 可选 kiro-validate-gap → kiro-spec-design → kiro-spec-tasks → kiro-impl
分解大型项目	kiro-discovery → kiro-spec-batch
实现一个小改动且无需规范	kiro-discovery → 直接实施

旧版 /kiro:* 命令模式仍可使用（如 --claude、--cursor 等），但已被弃用。升级路径请参阅 迁移指南。

对于较大的已批准任务集，可运行 kiro-impl 来启动自主实现，每个任务都会启动子代理、独立评审，并在失败时自动调试。

实际演示

示例：构建一个新的相册功能。

/kiro-discovery 相册功能，支持上传、标签和分享
# 发现模块会生成 brief.md（如果是多规范则还会生成 roadmap.md），并建议下一步操作
/kiro-spec-init photo-albums
/kiro-spec-requirements photo-albums
/kiro-spec-design photo-albums
/kiro-spec-tasks photo-albums
/kiro-impl photo-albums
# 自主运行：每个任务都有全新的实施者、独立评审员，并在失败时自动调试

典型的规范输出（耗时不到 10 分钟）：

• requirements.md：采用 EARS 格式的用户需求，包含验收标准。
• design.md：包含 Mermaid 图表和文件结构计划的架构设计。
• tasks.md：带有边界和依赖标注的实现任务。

随后，/kiro-impl 会按照 TDD 流程（RED → GREEN）在功能开关后，由独立评审员审核，并在失败时自动调试，从而自主完成各项任务。

支持的代理

所有8种技能变体都配备了相同的17项技能集。区别在于各平台集成在实际使用中的成熟度。

代理	技能模式	稳定性	旧版模式
Claude Code	--claude-skills	稳定	--claude / --claude-agent（已弃用）
Codex	--codex-skills	稳定	--codex（已屏蔽）
Cursor IDE	--cursor-skills	测试版	--cursor（已弃用）
GitHub Copilot	--copilot-skills	测试版	--copilot（已弃用）
Windsurf IDE	--windsurf-skills	测试版	--windsurf（已弃用）
OpenCode	--opencode-skills	测试版	--opencode / --opencode-agent（已弃用）
Gemini CLI	--gemini-skills	测试版	--gemini（已弃用）
Antigravity	--antigravity	测试版（实验性）	—
Qwen Code	—	—	--qwen

“测试版”并不意味着“功能缺失”，这17项技能和模板在所有8个平台上都是完全一致的。这意味着这些平台集成（子代理生成行为、易用性、SKILL.md加载等）的实际使用次数不如Claude Code和Codex多，仍可能出现边缘情况。如果您遇到任何问题，请提交反馈。

高级安装

技能模式（推荐）

npx cc-sdd@latest                     # Claude Code Skills（默认）
npx cc-sdd@latest --claude-skills     # Claude Code Skills
npx cc-sdd@latest --codex-skills      # Codex Skills
npx cc-sdd@latest --cursor-skills     # Cursor IDE Skills（测试版）
npx cc-sdd@latest --copilot-skills    # GitHub Copilot Skills（测试版）
npx cc-sdd@latest --windsurf-skills   # Windsurf IDE Skills（测试版）
npx cc-sdd@latest --opencode-skills   # OpenCode Skills（测试版）
npx cc-sdd@latest --gemini-skills     # Gemini CLI Skills（测试版）
npx cc-sdd@latest --antigravity       # Antigravity Skills（测试版，实验性）

旧版模式（已弃用）

npx cc-sdd@latest --claude         # Claude Code 命令（请使用 --claude-skills）
npx cc-sdd@latest --claude-agent   # Claude Code 子代理（请使用 --claude-skills）
npx cc-sdd@latest --cursor         # Cursor IDE 命令（请使用 --cursor-skills）
npx cc-sdd@latest --copilot        # GitHub Copilot 提示词（请使用 --copilot-skills）
npx cc-sdd@latest --windsurf       # Windsurf IDE 工作流（请使用 --windsurf-skills）
npx cc-sdd@latest --opencode       # OpenCode 命令（请使用 --opencode-skills）
npx cc-sdd@latest --opencode-agent # OpenCode 子代理（请使用 --opencode-skills）
npx cc-sdd@latest --gemini         # Gemini CLI 命令（请使用 --gemini-skills）
npx cc-sdd@latest --codex          # Codex（已屏蔽，使用 --codex-skills）
npx cc-sdd@latest --qwen           # Qwen Code

语言设置

npx cc-sdd@latest --lang ja        # 日语
npx cc-sdd@latest --lang zh-TW     # 繁体中文
npx cc-sdd@latest --lang es        # 西班牙语
# 支持：en, ja, zh-TW, zh, es, pt, de, fr, ru, it, ko, ar, el

高级选项

# 在应用更改之前预览
npx cc-sdd@latest --dry-run

# 自定义规范目录
npx cc-sdd@latest --kiro-dir docs

自定义

编辑 {{KIRO_DIR}}/settings/ 中的模板和规则，以匹配您团队的工作流程。

• templates/: 用于需求、设计和任务的文档结构。
• rules/: AI 生成原则和评判标准。

常见用例：PRD风格的需求文档、API和数据库架构、审批流程、JIRA集成、领域特定标准。

自定义指南 提供了可复制粘贴的实用示例。

文档

指南	您将学到的内容	链接
技能参考	技能模式工作流程、支持的技能、/kiro-impl 子代理流程、技能与 --claude-agent 的区别	英文 | 日文
命令参考	旧版 /kiro:* 命令的详细用法、参数和示例	英文 | 日文
自定义指南	实用示例：PRD需求、前端/后端设计、JIRA集成	英文 | 日文
规范驱动指南	从需求到实现的完整工作流方法论	英文 | 日文
为什么选择 cc-sdd？	设计理念、权衡取舍、适用场景与不适用场景	英文 | 日文
Claude 子代理	旧版 --claude-agent 安装目标及其快速规范子代理流程	英文 | 日文
迁移指南	从 v1.x / v2.x 升级	英文 | 日文

相关资源

文章与演讲

• Kiro的仕様書駆動開発プロセスをClaude Codeで徹底的に再現した（Zenn，日语）
• Claude Codeは仕様駆動の夢を見ない（Speaker Deck，日语）

外部资源

• Kiro IDE: 增强的规范管理和团队协作。
• Kiro的规范方法论: 最初的规范驱动开发方法论。

许可证

MIT 许可证

cc-sdd 快速上手指南

cc-sdd 是一个专为 AI 编程助手设计的长期运行、规格驱动（Spec-Driven）的实现工具。它能将批准的规格说明书转化为自主的代码实现工作流，支持发现需求、设计架构、分解任务及自动编码与审查。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• Node.js: 需安装 Node.js (推荐 v18 或更高版本)，因为该工具通过 npx 运行。
• AI 编程助手: 需在终端或 IDE 中配置好以下任一 AI Agent（cc-sdd 作为技能包加载到这些 Agent 中）：
  • 稳定版: Claude Code, Codex
  • 测试版: Cursor, GitHub Copilot, Windsurf, OpenCode, Gemini CLI, Antigravity
• 网络环境: 确保能访问 npm registry 以及你所使用的 AI 模型服务。

安装步骤

cc-sdd 无需全局安装，推荐使用 npx 直接在项目中进行一次性设置。它会将 17 个核心技能（Skills）注入到你选择的 AI Agent 中。

1. 基础安装（默认）

默认安装适用于 Claude Code，文档语言为英语。在项目根目录运行：

cd your-project
npx cc-sdd@latest

2. 指定 AI Agent 和语言

你可以根据使用的工具和偏好语言自定义安装命令：

使用 Cursor IDE 并生成繁体中文文档：

npx cc-sdd@latest --cursor-skills --lang zh-TW

使用 Codex 并生成日文文档：

npx cc-sdd@latest --codex-skills --lang ja

支持的 Agent 参数示例：

• --claude-skills (默认)
• --codex-skills
• --cursor-skills
• --copilot-skills
• --windsurf-skills
• --opencode-skills
• --gemini-skills
• --antigravity

支持的语言参数 (--lang)： en, ja, zh-TW, zh, es, pt, de, fr, ru, it, ko, ar, el

注意：国内开发者若需简体中文界面，目前主要支持 zh-TW（繁体中文），部分场景下可尝试 zh，具体取决于模板覆盖情况。

基本使用

安装完成后，无需手动调用复杂脚本，只需在你的 AI Agent 对话框中输入特定的指令即可启动工作流。

核心入口：需求发现

无论你想做什么，始终从 /kiro-discovery 开始。它会根据你的想法自动路由到合适的工作流（是扩展现有规格、直接实现、还是创建新规格）。

示例：构建一个包含上传、标签和分享功能的“相册”新功能

在你的 AI Agent 中输入：

/kiro-discovery Photo albums with upload, tagging, and sharing

执行流程：

1. 自动规划：Agent 会分析请求，生成 brief.md（简报），如果需要还会生成 roadmap.md（路线图）。
2. 后续指引：Agent 会告诉你下一步该运行什么命令。通常遵循以下标准流程：

# 1. 初始化规格
/kiro-spec-init photo-albums

# 2. 生成需求文档 (EARS 格式)
/kiro-spec-requirements photo-albums

# 3. 生成设计文档 (含架构图和文件结构计划)
/kiro-spec-design photo-albums

# 4. 分解实施任务 (含边界和依赖标注)
/kiro-spec-tasks photo-albums

# 5. 启动自主实现 (核心步骤)
/kiro-impl photo-albums

自主实现 (/kiro-impl)

这是 cc-sdd 最强大的功能。运行 /kiro-impl 后，系统将进入长期运行的自主模式：

• 独立任务执行：每次迭代处理一个任务。
• TDD 驱动：自动执行测试驱动开发（RED → GREEN）。
• 独立审查：每个任务都有独立的审查环节。
• 自动调试：如果实施受阻或审查失败，系统会在干净的上下文中自动调查根本原因并重试。
• 断点续传：支持中断后安全重跑。

常见场景速查

你的目标	推荐指令序列
全新功能/产品级创意	/kiro-discovery → /kiro-spec-init → ... → /kiro-impl
扩展现有系统	/kiro-steering → /kiro-discovery → ... → /kiro-impl
大型项目拆解	/kiro-discovery → /kiro-spec-batch (并行生成多个规格)
微小改动 (无需规格)	/kiro-discovery → (直接进入实现)

提示：旧版的 /kiro:* 命令模式已弃用，请优先使用上述 Skills 模式以获得最佳的长期自主运行体验。