AI导哈

Claude代码模板工具

一个集成了多种最佳实践的Claude代码模板工具，提供快速修复、深度分析、功能规划和并行实现等功能，适用于软件开发全生命周期管理。

  • by ifitsmanu
  • Shell
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ifitsmanu/claude-template

使用说明

Claude代码统一模板

生产就绪的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"

设计原则

  1. 默认情况下为零开销 -快速命令立即生效
  2. 选择复杂性 -只有在需要时才进行深入思考
  3. 基于文件的状态 -Git+markdown，无外部数据库
  4. 明显的失败 -特工报告受阻/失败，从不沉默
  5. 尽可能平行 -独立任务同时运行

此模板避免了什么

我们明确拒绝的模式：

反模式 为什么被拒绝
自动捕获内存 产生噪音，污染上下文
27+个代理 大多数重叠，12个就足够了
始终处于计划状态 扼杀简单任务的速度
外部数据库 添加故障点
无声的失败 掩盖问题

来源

此模板综合了：

链接

许可证

麻省理工学院

相关 MCP