Claude代码统一模板
 
哲学：复杂性是可选择的，而不是默认的。
⚡ 最新增强功能（2026-01-21）
采用了15种以上经过实战考验的模式 一切克劳德代码:
- 🎯 规则体系 -可执行的质量门（覆盖率80%，OWASP Top 10，代码标准）
- 🪝 高级挂钩 -在所有5个生命周期事件中有9个钩子（防止错误发生）
- ⚠️ 上下文窗口管理 -关于MCP开销（200k）的严重警告→ 70k，20多台服务器）
- 🎓 技能体系 -可重复使用的工作流程（TDD指南与RED→GREEN→改善循环）
- 🧪 增强测试 -E2E专业代理、强制覆盖、TDD执行
看 改进.md 了解完整细节。
快速开始
# Clone template
git clone https://github.com/ifitsmanu/claude-template.git my-project
cd my-project && rm -rf .git && git init
# Or copy to existing project
cp -r claude-template/.claude your-project/
cp claude-template/CLAUDE.md your-project/
cp claude-template/.mcp.json your-project/然后运行 claude 并开始工作：
/fix "button not responding" # Quick bug fix
/plan "add OAuth authentication" # Plan a feature
/ship # Commit + push + PR所得
5个核心命令+40个插件命令
模板命令（每天使用）：
/fix-快速修复错误/commit-安全承诺，质量把关/ship-完全发布（提交+推送+公关）/memory-手动知识获取/sprint-基于PRD的自主迭代
插件命令：
- 23来自复合工程（/计划、/思考、/审查、/工作、/lfg等）
- 14种自动激活技能（前端设计、dhh-rails风格等）
- 3来自ralph wiggum（/ralph循环用于连续工作）
看 COMMANDS.md 供完整参考。
13名代理人（核心+专家）
| 核心代理 | 模型 | 责任 |
|---|---|---|
| 构建器 | 俳句 | 实现代码 |
| 评论家 | 十四行诗 | 评判质量 |
| 调试器 | 俳句 | 查找错误 |
| tester | 俳句 | 编写测试（需要80%的覆盖率） |
| 建筑师 | 十四行诗 | 设计系统 |
| 专业代理 | 模型 | 触发器 |
|---|---|---|
| 安全 | 十四行诗 | --security、身份验证、OWASP |
| 表演 | 十四行诗 | --performance，优化 |
| 数据库 | sonnet | 迁移、模式 |
| 前端 | 俳句 | UI，组件 |
| 后端 | 俳句 | API、服务 |
| 人工智能工程师 | 十四行诗 | 法学硕士、RAG、嵌入式 |
| 设计师 | 十四行诗 | 用户体验，设计系统 |
| e2e跑者 | 俳句 | 剧作家e2e测试（新） |
6台MCP服务器（全部免费）
| 服务器 | 用途 |
|---|---|
| 顺序思维 | 深度推理 /think, /plan |
| context7 | 实时库文档 |
| 剧作家 | 浏览器自动化 |
| 内存 | 知识图持久化 |
| exa | AI驱动的搜索（免费增值） |
| jina | 网络内容阅读器（免费增值） |
选择性记忆系统
没有自动捕捉。没有污染。
/memory save patterns "API routes follow /api/v1/[resource]"
/memory save decisions "PostgreSQL for ACID transactions"
/memory save learnings "Pool exhaustion = random 500s at peaks"
/memory search "authentication"冲刺模式（拉尔夫模式）
多层功能的自主循环：
/sprint init # Create PRD template
# Edit .claude/prd/current.json
/sprint .claude/prd/current.json # Run autonomous loop每次迭代都有新的上下文。基于文件的状态。质量门强制执行。
命令参考
/fix -快速修复Bug
/fix "login button not responding on mobile"零开销。调试器代理。直接修复。
/think -深度分析
/think "how should we migrate to microservices?"32k代币预算。顺序思维。分支和修订。
/plan -功能规划
/plan "add OAuth2 with Google and GitHub"建筑师代理人。制定实施计划。需要批准。
/build -并行实施
/build "user profile with avatar" --all前端+后端+数据库+测试仪并行。
/review -代码审查
/review src/auth/ --security --performance审核代理+可选专家。产生判决。
/sprint -自主循环
/sprint .claude/prd/feature.json执行所有故事，直到完成。每次迭代都有新的上下文。
项目结构
.claude/
├── rules/ (NEW) # testing.md, security.md, quality.md, agent-delegation.md
├── skills/ (NEW) # tdd-guide.md (RED→GREEN→IMPROVE workflow)
├── agents/
│ ├── core/ # builder, reviewer, debugger, tester, architect
│ └── specialists/ # security, performance, database, frontend, backend, ai-engineer, designer, e2e-runner
├── commands/
│ ├── quick/ # fix, commit, ship
│ ├── deep/ # analyze, plan, debug, refactor
│ └── parallel/ # implement, research
├── memory/ # patterns.md, decisions.md, learnings.md
├── prd/ # Sprint PRD templates
├── hooks/ # 9 hooks across 5 lifecycle events
├── settings.json # Safe defaults (commit this)
└── settings.local.json # Dev permissions (gitignored)配置
两个配置文件：
| 文件 | Git | 目的 |
|---|---|---|
.mcp.json | 提交 | 团队MCP服务器 |
settings.json | 提交 | 安全基础权限 |
settings.local.json | Gitignored | 开发人员权限，API密钥 |
设置本地配置：
cp .claude/settings.local.json.example .claude/settings.local.json
# Edit with your API keys if desired可选API密钥：
export EXA_API_KEY=your-key # Better search
export JINA_API_KEY=your-key # More URL reads
export GITHUB_TOKEN=your-token # GitHub API access
export DATABASE_URL=postgres://... # Database access质量门
预提交（自动）
- ✓ 测试通过(需要80%的覆盖率)
- ✓ 棉绒通过（零警告）
- ✓ 类型检查通过
- ✓ 未检测到秘密（OWASP检查）
- ✓ JS/TS文件中没有console.log
代理状态（标准化）
所有代理人报告： SUCCESS | BLOCKED | FAILED
SUCCESS-任务已完全完成BLOCKED-需要人类决策FAILED-无法完成，解释原因
质量规则（新）
- 📋 测试：80%的覆盖率，TDD工作流程，需要3种测试类型
- 🔒 安全性：OWASP十大合规性、机密扫描
- 📝 代码质量：函数\<50行，嵌套\<3级
- 🤝 代理委托：明确何时使用哪个代理的规则
看 .claude/rules/ 完整的标准。
定制
添加命令
# .claude/commands/quick/deploy.md
# /deploy - Deploy to environment
## When to Use
Deploying to staging or production
## Process
1. Run tests
2. Build
3. Deploy to $ARGUMENTS添加代理
# .claude/agents/specialists/devops.yml
name: devops
model: sonnet
tools: [Read, Bash, Grep]
prompt: |
You are the DEVOPS agent...添加内存
/memory save patterns "Services use repository pattern"
/memory save decisions "Chose Redis for session store: need distributed cache"设计原则
- 默认情况下为零开销 -快速命令立即生效
- 选择复杂性 -只有在需要时才进行深入思考
- 基于文件的状态 -Git+markdown，无外部数据库
- 明显的失败 -特工报告受阻/失败，从不沉默
- 尽可能平行 -独立任务同时运行
此模板避免了什么
我们明确拒绝的模式：
| 反模式 | 为什么被拒绝 |
|---|---|
| 自动捕获内存 | 产生噪音，污染上下文 |
| 27+个代理 | 大多数重叠，12个就足够了 |
| 始终处于计划状态 | 扼杀简单任务的速度 |
| 外部数据库 | 添加故障点 |
| 无声的失败 | 掩盖问题 |
来源
此模板综合了：
- 克劳德·梅 → 3-图层检索模式
- 复合工程学 → 平行代理、专业评审员
- 拉尔夫 → 基于文件的状态、迭代循环、AGENTS.md学习
- 顺序思维 → 对难题进行深入分析
- 一切克劳德代码 → 规则系统、高级钩子、技能、上下文管理（经过10个多月的生产测试）
链接
- 改进.md -最新增强功能（2026-01-21）
- CLAUDE.md -项目说明和上下文窗口警告
- COMMANDS.md -完整的命令参考
- 塞子.md -带有头顶警告的MCP安装指南
- 贡献.md -如何做出贡献
- Claude 代码文档 -官方文件
许可证
麻省理工学院