gotalab/cc-sdd

cc-sdd – 以规范为驱动、长期运行的 AI 编程代理

它是什么

• 一个 npm 包，为八种不同的 AI 编程助手（Claude Code、Codex、Cursor、GitHub Copilot、Devin、OpenCode、Gemini CLI、Antigravity）安装一套 Agent Skills。
• 这些技能实现了一种 以规范为驱动的软件开发生命周期 (SDLC)，让 AI 编写规范，经由人类确认合同后，自主生成、测试、审查并调试代码。
• 工作流程拆分为一系列指令（/kiro-discovery、/kiro-spec-init、/kiro-spec-requirements、/kiro-spec-design、/kiro-spec-tasks、/kiro-impl 等），这些指令会创建 Markdown 文件（brief.md、requirements.md、design.md、tasks.md）并驱动长期运行的实现循环。

为什么存在

• 传统的 AI 辅助编程通常将单个提示词交给模型，并期望输出即为最终产品。cc-sdd 将规范视为一种 合同，将“系统应该做什么”与“如何构建”分开。这使得多个代理（或人类）能够并行工作，而不会互相覆盖。
• 通过为每个任务附加一个全新的子代理，该工具可以在功能标志后执行测试驱动开发 (RED → GREEN)、进行独立审查，并在审查失败时自动调试。当原生子代理不可用时，相同的流程会以嵌入方式执行。

核心概念

概念	角色
探索 (/kiro-discovery)	将想法路由至多个路径之一：扩展现有规范、开始新规范、分解为多个规范，或直接实现而不需规范。产生 brief.md（必要时产生 roadmap.md）。
规范文件 (requirements.md, design.md, tasks.md)	遵循 Kiro 方法论的结构化 Markdown：EARS 风格需求、Mermaid 图表、文件结构计划 以及任务注释（_Boundary:_、_Depends:_）。
实现 (/kiro-impl)	隔离执行每个任务。使用原生子代理时，它会生成一个全新的实现者、一个独立审查者，若审查者拒绝变更，则进行自动调试。结果会记录在 tasks.md 中，以便稍后恢复执行。
规范批次 (/kiro-spec-batch)	将多规范路线图转变为并行规范创建波次，增加跨规范审查以捕捉重复的责任或接口不匹配。
代理技能 (Agent Skills)	每个代理 17 个指令的集合（例如 Claude Code、Codex、Cursor）。相同的技能集适用于所有支持的代理；默认安装使用 Claude Code。

如何开始

# 在任何项目文件夹中安装默认 (Claude Code) 技能集
cd my-project
npx cc-sdd@latest

# 若您偏好，可选择不同的代理或语言
npx cc-sdd@latest --codex-skills --lang ja   # Codex, 日文文档
npx cc-sdd@latest --cursor-skills --lang zh-CN   # Cursor IDE, 简体中文

然后在您使用的 AI 助手内执行第一个指令：

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

该工具将写入 brief.md 并告知您下一个指令（通常是 kiro-spec-init）。请依照指令链执行，直到 kiro-impl 完成实现。

支持的代理与稳定性

• Claude Code – 稳定
• Codex – 稳定
• Cursor IDE, GitHub Copilot, Devin, OpenCode, Gemini CLI, Antigravity – 测试版
• 旧版 “Cascade/Windsurf” 模式仍然存在但已弃用。

自定义

• 所有模板（需求、设计、任务）位于 {{KIRO_DIR}}/settings/templates/ 下。
• 指导 AI 生成的规则（例如验收标准格式、命名惯例）位于 {{KIRO_DIR}}/settings/rules/ 中。
• 团队可以调整这些设置以符合 PRD 流程、JIRA 集成、特定领域标准等。

文档与指南

• 技能参考 – 17 种技能与 /kiro-impl 子代理流程的详细说明。
• 指令参考 – 旧版 /kiro:* 指令的使用方式。
• 自定义指南 – 调整模板与规则的具体代码片段。
• 规范驱动指南 – 从想法到部署代码的端到端逐步说明。
• 为什么选择 cc-sdd? – 设计理念以及何时适合使用此工具。

谁应该使用它

• 想要尝试大规模 AI 驱动、合同优先开发的开发团队。
• 寻求结构化、可重复方式让 LLM 处理繁重工作，同时保持清晰规范到代码追踪的个人开发者。
• 已经使用 Kiro 规范方法论并希望拥有通往多个编程代理之 CLI 桥梁的组织。

授权

• MIT (参阅 LICENSE)。

---

以上所有信息均直接取自仓库的 README；未推论出任何额外功能。