cc-sdd：让 AI 编程工具学会「自律」的长流程开发框架

想象一个场景：你对 AI 编程助手说「帮我做个用户登录功能」，它立刻开始写代码，一小时后交出一堆文件，单元测试跑不通，代码风格也不统一，你还得花两小时返工收拾烂摊子。

cc-sdd 正是为了解决这个问题而诞生的。它是一套 Spec-Driven Development（规格驱动开发，SDD） 的工具框架，核心理念很直接：AI 应该先看规格说明书，再动手写代码，而且写完后要自己 review——就像正规软件开发团队的流程，只是所有步骤都跑在 AI agent 里。

该框架的灵感来源于 Kiro IDE，后者的核心思想是将规格文档作为开发流程的中心，AI 编程工具围绕规格文档而非零散对话来工作。cc-sdd 将这套理念提取为一套通用的工具包，支持 Claude Code、Codex、Cursor、Windsurf、Copilot、OpenCode、Gemini CLI 等 8 种主流 AI 编程工具，让它们在大型项目中能够保持一致的工程纪律。

17 个 Agent Skills：把开发流程拆成可组合的步骤

cc-sdd 将一个完整的开发流程拆解为 17 个可独立调用的 Agent Skills，核心流程包括：

• /kiro-discovery：需求发现阶段，AI 根据用户的一句话需求，决定是直接开发、扩展现有规格还是创建新规格，并生成 brief.md（需求简报）和 roadmap.md（路线图）
• /kiro-requirements：需求正式化，写出 requirements.md，明确功能边界和验收标准
• /kiro-design：设计阶段，输出 design.md，涵盖架构设计、API 接口、数据库 schema 等
• /kiro-tasks：任务分解，将设计拆解为可独立执行的原子任务 tasks.md
• /kiro-impl：自主实现阶段，每个任务由独立的 implementer agent 执行，遵循 TDD 流程（RED → GREEN），同时有独立的 reviewer agent 进行审查，失败时自动触发 debug 流程

这套流程的精妙之处在于每个任务都是独立运行的：即使中间被中断，下一次重启时 AI 仍然从上次状态继续，而不是从头开始。同时，前序任务中积累的「经验」（写在 tasks.md 的 ## Implementation Notes 章节中）会传递给后续任务，避免重复踩坑。

适用于大型项目的多 agent 协作架构

cc-sdd 另一个值得关注的特性是对多 agent 并行的支持。在 /kiro-impl 阶段，虽然每次迭代只运行一个任务（保证审查质量），但任务列表本身支持并行规划，这意味着 AI 可以同时思考多个任务的依赖关系和执行顺序。

框架本身采用 TypeScript + Node.js 开发，发布为 npm 包 cc-sdd，构建流程使用 TypeScript 编译器 + vitest 测试框架，代码质量有完整保障。它通过 .kiro/ 目录（steering/ 存放全局规则，specs/ 存放各功能规格）来管理项目上下文，并通过 AGENTS.md 和 CLAUDE.md 为不同 AI 编程工具提供统一的开发指导。

技术规格一览

上手门槛与适用人群

cc-sdd 的安装极其简单——一行 npm install -g cc-sdd 即可搞定。但它天然面向中大型项目，对于小型脚本或一次性任务，传统的手动对话方式反而更高效。

如果你在带领团队使用 AI 编程工具处理复杂需求（涉及多个模块、需要持续维护），cc-sdd 可以有效约束 AI 的「冲动」行为，让它学会先规划再动手、自觉审查代码质量，并保留完整的开发轨迹供人类回溯。这在 Code Review 资源有限、代码质量靠 AI 自律的项目中尤为有价值。

对于个人开发者，cc-sdd 的 /kiro-discovery 阶段尤其有用——它强迫你在动手之前先把需求想清楚，避免被 AI 带偏方向。

局限性与适用边界

cc-sdd 也有其局限性。首先，它目前没有 Web UI，所有操作都通过命令行完成，对不熟悉终端操作的团队成员有较高门槛。其次，框架假设你已有明确的规格文档意识，对于「先写代码再想需求」的草根开发团队而言，推行 SDD 本身就需要文化转变。

另外，项目对 AI 工具本身的能力依赖较强——reviewer agent 的质量、debug agent 定位根因的准确度，都直接影响整个流程的效率。在当前 AI 模型能力参差不齐的环境下，cc-sdd 在 Claude Code/Codex 等较强模型上的表现会明显优于轻量级工具。

在 AI 编程工具生态中的意义

cc-sdd 代表了 AI 编程工具从「快代码生成」向「规范开发流程」演进的趋势。随着 GitHub Copilot、Claude Code 等工具在代码补全之外越来越多地承担复杂开发任务，如何让 AI 在大型代码库中保持一致的工程纪律成为关键挑战。

cc-sdd 通过将 SDD 框架工具化，提供了一套与具体 AI 工具无关的流程规范——无论你用哪款 AI 编程工具，进入项目后看到的都是统一的规格管理方式和开发节奏。这对于需要在同一代码库中混合使用多种 AI 工具的团队（如部分开发者用 Claude Code，部分用 Copilot）尤为重要。

当前版本 3.0.2 在 GitHub 已获得 3400+ Stars，并提供了日语、简体中文、繁体中文的多语言文档支持。