cc-sdd：面向 AI 编程智能体的长周期规范驱动实现

项目自述：English | 日本語 | 繁體中文

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

通过一条命令，即可将自动化的 SDLC（软件开发生命周期）工作流作为“智能体技能”（Agent Skills）安装：涵盖需求发现、需求分析、设计、任务拆解以及带独立审查机制的自主实现。该工具适用于 8 种 AI 编程智能体，且每种智能体均配置统一的 17 项技能。

👻 灵感源于 Kiro。采用了与 Kiro IDE 类似的规范驱动型智能体 SDLC 风格。现有的 Kiro 规范完全兼容且可移植。

v3.0 更新内容

cc-sdd v3.0 围绕“智能体技能”和“长周期自主实现”进行了重构。

• /kiro-discovery 作为新的入口点。 Discovery 流程会将新任务引导至以下路径之一：扩展现有规范、直接实现（无规范）、创建新规范、拆分为多个规范，或混合拆分。它会写入 brief.md，并在必要时生成 roadmap.md，让你无需重新解释范围即可恢复工作流。
• /kiro-impl 用于长周期自主实现。 每个任务都会由一个全新的实现者执行，并在功能标志（feature flag）下运行 TDD（红→绿测试流程），配备独立的审核员，以及自动调试通道。当实现者受阻或审核员两次拒绝时，系统会在干净的上下文中调查根本原因。前序任务的经验教训会通过 tasks.md 中的 ## Implementation Notes 向后传递。每次迭代处理一个任务，中断后可安全重启。
• 边界优先的规范原则。 design.md 现在包含驱动任务边界的“文件结构规划”（File Structure Plan）。任务带有 _Boundary:_ 和 _Depends:_ 注解。审查与验证过程不仅检查样式问题，更重点关注是否违反边界约定。
• /kiro-spec-batch 用于多规范方案。 将路线图并行转化为多个规范，并通过跨规范审查来捕获逻辑矛盾、功能重复和接口不匹配问题。
• 适配 8 种编程智能体的技能集。 每次安装包含 17 项技能，按需加载（渐进式披露）。Claude Code 和 Codex 处于稳定状态；Cursor、Copilot、Windsurf、OpenCode、Gemini CLI 和 Antigravity 处于测试阶段。无外部依赖；子智能体通过各平台的原生原语（native primitive）生成。

完整的技能模式工作流及 /kiro-impl 内部机制：技能参考指南 (Skill Reference)。

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

为什么选择 cc-sdd？

cc-sdd 将规范视为系统各部分之间的契约，而非交给智能体的“主指令文档”。代码始终是事实的唯一来源。规范明确了代码各部分之间的边界，使得人类与 AI 智能体可以在无需持续同步的情况下并行工作。

核心理念：在合适的粒度下明确契约，能让团队规模的 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 

不知道从哪里开始？请从 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 即可开始带审查机制的自主实现。