克劳德代码模板
适用于Claude Code辅助开发的生产就绪GitHub模板
此模板提供了一个完整的AI辅助开发工作流系统,其特点包括:
- 10种经过MCP增强的专用制剂 优雅地降级
- 20+ 个工作流自动化命令 对于共同开发任务
- Git子模块知识管理 用于系统记录
- 自我报告的错误可见性 在所有代理中
使用此模板
快速入门
- 根据模板创建仓库:
# On GitHub: Click "Use this template" button
# Or via CLI:
gh repo create my-project --template Ferymad/claude-code-boilerplate- 初始化模板:
cd my-project
./scripts/init-template.sh- 完整设置:
./scripts/setup.sh- 启动Claude代码:
claude什么是自动定制的
初始化脚本会替换这些占位符:
{{REPO_NAME}}→ 您的仓库名称{{GITHUB_USER}}→ 你的GitHub用户名{{REPO_PATH}}→ 您的本地仓库路径
这些会自动配置在:
- 所有代理提示(
.claude/agents/) - 所有命令提示符(
.claude/commands/) - 文档(README.md,CLAUDE.md)
- 辅助脚本(
hack/)
需要手动定制的内容
初始化后,您应该进行自定义设置:
- MCP服务器配置 (
claude.json):
- 如使用,请添加Linear的API密钥 - 配置kit-dev路径 - 添加任何额外的MCP服务器
- 团队设置 (
.claude/settings.json):
- 更新团队名称 - 调整预算控制 - 配置自动批准的工具
- 思想子模块:
- 创建一个独立的GitHub仓库: {your-repo}-thoughts - 添加为子模块: git submodule add thoughts - 或者不加思考地使用模板(删除引用)
- 项目特定的代理/命令:
- 评论 .claude/agents/ - 移除未使用的代理 - 评论 .claude/commands/ - 根据您的工作流程进行定制 - 添加项目特定的自动化功能
模板结构
claude-code-boilerplate/
├── .claude/
│ ├── agents/ # 10 specialized MCP-enhanced agents
│ ├── commands/ # 20+ workflow automation commands
│ └── settings.json # Team configuration
├── .github/
│ ├── workflows/ # Template init & validation
│ └── ISSUE_TEMPLATE/ # Bug reports & feature requests
├── hack/
│ └── spec_metadata.sh # Documentation generation
├── scripts/
│ ├── init-template.sh # Template initialization
│ └── setup.sh # Post-init setup
├── CLAUDE.md # MCP integration guidelines
├── LICENSE # Apache 2.0 with attribution
├── CONTRIBUTING.md # Contribution guidelines
└── README.md # This fileMCP增强型代理
| 代理 | 目的 | MCP 工具 |
|---|---|---|
| 代码库定位器 | 查找文件和组件 | MCP AST 工具包 |
| 代码库分析器 | 分析代码结构 | Kit MCP 符号/依赖项 |
| 代码库模式查找器 | 查找代码模式 | Kit MCP 模式工具 |
| 外部文档研究者 | 研究文档 | 参考编号 MCP |
| MCP软件包研究者 | 深度包装研究 | 套装+参考MCP |
| 代码库依赖追踪器 | 跟踪依赖项 | Kit MCP |
| 线性票务阅读器 | 阅读Linear工单 | Linear MCP |
| 线性搜索器 | 搜索Linear票 | Linear MCP |
| 思维定位器 | 查找想法文档 | 使用 Grep/Glob |
| 思想分析器 | 分析思想内容 | 阅读 |
当MCP工具可用时,代理会自动使用;若未配置,则优雅地降级为使用基本工具。
MCP集成
此模板旨在与以下内容无缝协作:
- MCP套件 - 代码库智能与抽象语法树(AST)分析
- Ref MCP 翻译为中文是“参考 MCP”或“MCP 参考”,具体取决于上下文语境。在这里,“Ref”通常表示“参考”或“参照”,“MCP”则可能是一个特定的术语或缩写,需要根据具体情境来确定其准确含义 - 外部文献研究
- 线性MCP(多分类器问题,或根据具体上下文可能指其他含义,如“线性多分类感知机”等,但“MCP”在此处为通用缩写,具体翻译需结合上下文) - 票务管理(可选)
见 CLAUDE.md(文件名可译为“克劳德.md”或保持原样,具体取决于上下文是否需要翻译文件名) 关于详细的MCP集成指南。
做出贡献
看 \CONTRIBUTING.md\ 翻译成中文是:“贡献指南.md” 或 “贡献规范.md”。这个文件通常用于说明如何向某个项目或组织做出贡献,包括提交代码、报告问题、提出建议等相关的指导原则和流程 关于改进此模板的指南。
许可证
见 许可证 关于许可信息和归属声明。
致谢
见 致谢文件(ACKNOWLEDGMENTS.md) 对于从HumanLayer改编的模式,应给予完整署名。
