简介

使用 Claude Code、Gemini CLI 和 Cursor 的规范驱动开发，从原型到生产。Slash 命令强制执行结构化需求→设计→任务的工作流程，彻底改变您使用 AI 进行构建的方式。

Github地址

claude-code-spec/
├── tools/cc-sdd/              # Main cc-sdd NPM package
│   ├── src/                   # TypeScript source code
│   ├── templates/             # Agent templates (Claude Code, Gemini CLI)
│   ├── package.json           # Package configuration
│   └── README.md              # Tool documentation
├── docs/                      # Documentation
├── .claude/                   # Example Claude Code commands
├── .gemini/                   # Example Gemini CLI commands
├── README.md                  # This file (English)
├── README_ja.md               # Japanese project README
└── README_zh-TW.md            # Traditional Chinese project README

快速入门

安装

目前支持的语言比较少，没有中文简体，可以选择默认英文安装

# Basic installation (default: Claude Code)
npx cc-sdd@latest

# With language: --lang en (English) or --lang ja (Japanese) or --lang zh-TW (Traditional Chinese)
# With OS: --os mac or --os windows (if auto-detection fails)
npx cc-sdd@latest --lang ja --os mac

# With different agents: gemini-cli
npx cc-sdd@latest --gemini-cli

# Ready to go! Now Claude Code and Gemini CLI can leverage `/kiro:spec-init <what to build>` and the full SDD workflow

注意：没有提供qwen-cli的安装命令，可以直接将代码库中的.gemini/commands/kiro 目录copy到qwen-cli的用户目录~/.qwen/commands 或者到项目根目录下.qwen/commands.

自定义工作流

在项目的templates目录下找到agents目录下对于平台的自定义工作流模版文件，更具需要进行修改。如spec-init.tpl.toml 修改后重名spec-init.toml放入cli工具下commands下对于的目录。

AI-DLC 工作流

Step 1（可选）: 逆向工程

通过已有的工程环境逆向生成工作流规范。

/kiro:steering- 创建/更新指导文件

/kiro:steering-custom- 为专门环境创建自定义指导

注意：对于新功能或小规模添加，可选。可直接进入 spec-init 阶段。

Step 2 : 规范创建

1. /kiro:spec-init [detailed description]- 使用详细的项目描述初始化规范
2. /kiro:spec-requirements [feature]- 生成需求文档
3. /kiro:spec-design [feature]- 交互式：“您是否查看过 requirements.md？[y/N]”
4. /kiro:spec-tasks [feature]- 交互式：确认需求和设计评审

Step 3 : 进度跟踪

1. /kiro:spec-status [feature]- 检查当前进度和阶段

开发规则

1. 考虑转向：/kiro:steering 在重大开发之前运行（新功能可选）
2. 遵循三阶段审批流程：需求→设计→任务→实施
3. 需要批准：每个阶段都需要人工审核（交互式提示或手动）
4. 不跳过任何阶段：设计需要获得批准的需求；任务需要获得批准的设计
5. 更新任务状态：在处理任务时将任务标记为已完成
6. 保持方向盘的当前状态：在发生重大变化后运行/kiro:steering
7. 检查规格符合性：用于/kiro:spec-status验证对齐

配置规则

默认规则

由命令/kiro:steering控制，由Ai 逆向的规则。

• product.md：始终包含 - 产品背景和业务目标
• tech.md：始终包含 - 技术堆栈和架构决策
• structure.md：始终包含 - 文件组织和代码模式

自定义规则

由命令/kiro:steering-custom创建的自定义规则。可根据项目需求进行调整和扩展。

• api-standards.md：始终包含 - API 设计标准和最佳实践
• database.md：始终包含 - 数据库设计标准和最佳实践
• security.md ：始终包含 - 安全标准和最佳实践
• testing.md：始终包含 - 测试标准和最佳实践

纳入模式

• 始终：每次交互时加载（默认）

• 条件：针对特定文件模式加载（例如"*.test.js"）