cc-sdd部署指南：从本地开发到生产环境的完整配置

cc-sdd部署指南：从本地开发到生产环境的完整配置

【免费下载链接】cc-sddTurn approved specs into long-running autonomous implementation. A minimal, adaptable SDD harness with Agent Skills for Claude Code, Codex, Cursor, Copilot, Windsurf, OpenCode, Gemini CLI, and Antigravity.项目地址: https://gitcode.com/gh_mirrors/cc/cc-sdd

cc-sdd（GitHub 加速计划）是一个轻量级、适应性强的SDD工具，能够将已批准的规范转化为长期运行的自主实现。它支持Claude Code、Codex、Cursor、Copilot、Windsurf、OpenCode、Gemini CLI等多种AI代理技能，为开发者提供了强大的规范驱动开发体验。

📋 目录

• 环境准备
• 本地开发环境部署
• 配置自定义
• 生产环境部署
• 常见问题解决

🚀 环境准备

在开始部署cc-sdd之前，请确保您的系统满足以下要求：

• Node.js 14.0.0或更高版本
• npm 6.0.0或更高版本
• Git

检查环境

node -v # 检查Node.js版本 npm -v # 检查npm版本 git --version # 检查Git版本

如果您的系统中没有安装这些工具，请参考官方文档进行安装。

💻 本地开发环境部署

1. 克隆仓库

git clone https://gitcode.com/gh_mirrors/cc/cc-sdd cd cc-sdd

2. 安装依赖

npm install

3. 初始化项目

根据您使用的AI代理，选择相应的初始化命令：

# 默认（Claude Code） npx cc-sdd@latest # 其他代理 npx cc-sdd@latest --cursor # Cursor IDE npx cc-sdd@latest --codex-skills # Codex npx cc-sdd@latest --copilot-skills # GitHub Copilot npx cc-sdd@latest --gemini-skills # Gemini CLI

安装过程中，系统会提示您选择文件处理方式（覆盖/追加/保留），您可以根据需要进行选择。

4. 验证安装

# 检查版本 npx cc-sdd --version # 查看帮助信息 npx cc-sdd --help

如果一切正常，您应该能看到cc-sdd的版本信息和可用命令列表。

⚙️ 配置自定义

cc-sdd提供了灵活的自定义选项，您可以根据团队需求调整模板和规则。主要的自定义点包括：

1. 模板自定义

模板文件位于.kiro/settings/templates/目录下，用于定义AI生成文档的结构和格式。

# 查看模板文件 ls -la .kiro/settings/templates/specs/

主要模板文件包括：

• requirements.md- 需求文档结构
• design.md- 设计文档结构
• tasks.md- 任务分解结构

您可以根据需要编辑这些模板，添加自定义部分或调整现有结构。例如，添加PRD风格的章节、审批清单或JIRA字段。

2. 规则自定义

规则文件位于.kiro/settings/rules/目录下，用于定义AI的判断标准和生成原则。

# 查看规则文件 ls -la .kiro/settings/rules/

主要规则文件包括：

• ears-format.md- EARS格式需求描述规则
• design-principles.md- 设计原则和文档标准
• tasks-generation.md- 任务分解粒度和结构规则

通过编辑这些规则，您可以调整AI的生成风格和判断标准，如任务粒度、设计原则或需求优先级确定标准。

3. 验证自定义

完成自定义后，建议通过创建测试规范来验证更改：

# 创建测试规范 npx cc-sdd spec-init "Test customization" # 生成需求文档 npx cc-sdd spec-requirements test-customization # 检查生成的文件 cat .kiro/specs/test-customization/requirements.md

🌐 生产环境部署

1. 准备生产环境

在生产环境中部署cc-sdd时，建议：

• 使用稳定版本而非最新版本
• 配置适当的权限控制
• 设置日志记录和监控

2. 安装稳定版本

# 安装特定版本 npx cc-sdd@2.0.0 --claude-skills # 替换为最新稳定版本号

3. 配置自动化流程

您可以将cc-sdd集成到CI/CD流程中，实现规范驱动的自动化开发：

# 示例：在CI中运行规范验证 npx cc-sdd validate-design my-feature npx cc-sdd validate-impl my-feature

4. 多环境配置

对于不同的环境（开发、测试、生产），您可以使用不同的配置文件：

# 使用特定环境配置 npx cc-sdd --config .kiro/config.prod.json spec-impl my-feature

系统架构流程

cc-sdd的系统架构设计确保了从规范到实现的流畅转换。以下是系统主要组件之间的交互流程：

该流程图展示了用户、UI、状态管理、API和数据库之间的交互，体现了cc-sdd在规范驱动开发过程中的核心工作流。

🛠️ 常见问题解决

1. 版本兼容性问题

如果遇到版本兼容性问题，可以尝试以下解决方案：

# 清除npm缓存 npm cache clean --force # 重新安装特定版本 npx cc-sdd@1.1.5 --claude-code # 旧版本 npx cc-sdd@latest --claude-skills # 最新版本

2. 模板和规则迁移

从旧版本迁移到v2.x或v3.0时，建议：

# 备份现有配置 cp -r .kiro .kiro.backup # 安装新版本 npx cc-sdd@latest --claude-skills # 比较并合并模板和规则 diff -r .kiro.backup/settings .kiro/settings

详细迁移指南请参考迁移指南。

3. 性能优化

如果在大型项目中使用cc-sdd遇到性能问题，可以：

• 优化规则文件，减少不必要的判断逻辑
• 使用--batch模式处理多个规范
• 增加系统资源，特别是内存和CPU

📚 更多资源

• 官方文档
• 定制指南
• 命令参考
• 技能参考

通过本指南，您应该已经掌握了cc-sdd从本地开发到生产环境的完整部署流程。cc-sdd的灵活设计使其能够适应各种开发需求，帮助您实现真正的规范驱动开发。如有任何问题，欢迎查阅官方文档或提交issue。

【免费下载链接】cc-sddTurn approved specs into long-running autonomous implementation. A minimal, adaptable SDD harness with Agent Skills for Claude Code, Codex, Cursor, Copilot, Windsurf, OpenCode, Gemini CLI, and Antigravity.项目地址: https://gitcode.com/gh_mirrors/cc/cc-sdd