/ 目录 / 演练场 / Claude Code Best Practice
← 全部服务器 ↗ GitHub
● 社区 shanraisshan ⚡ 即开即用

Claude Code Best Practice

作者 shanraisshan · shanraisshan/claude-code-best-practice

从随机 prompt 升级到工程级 Claude 用法的实践手册——计划、验证、回顾、检查清单。

claude-code-best-practice 是一套让 Claude Code 在真实工作中可靠运转的实践方法和模板。先计划后执行的 prompt 模式、验证 hook、事故复盘格式、重构检查清单。它不是「神奇的自动 skill」，更像一套纪律包——选择采用，按步骤执行，信任输出。

▶ 观看演示 📦 安装 💡 使用场景

为什么要用

核心特性

实时演示

实际使用效果

就绪

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： Claude Code Best Practice

在非简单改动上强制执行先计划后执行的流程

👤 厌倦了 agent 不加思考直接动手的开发者 ⏱ ~30 min intermediate

何时使用： 改动涉及 3 个以上文件，或范围不清晰。

步骤
  1. 规划
    Use claude-best-practice. Write a plan for refactoring auth: scope, sequence, risks, rollback. Do not write code yet.✓ 已复制
    → 计划文档；没有代码
  2. 自我审查
    Critique your own plan as if you were the senior reviewer. What's missing?✓ 已复制
    → 带具体修改意见的批评
  3. 执行
    Now execute step 1 of the revised plan. Stop after that step.✓ 已复制
    → 第 1 步完成；等待确认

结果： 经过深思熟虑的重构，干净落地。

注意事项
  • 计划太抽象 — 要求计划细化到文件级别

在 agent 帮助下完成事故复盘

👤 on-call / SRE ⏱ ~45 min intermediate

何时使用： 出了故障，你需要写复盘报告。

步骤
  1. 收集信息
    Use the postmortem template. Pull the timeline from /logs and recent commits.✓ 已复制
    → 自动构建的时间线
  2. 五个为什么
    Walk through five-whys on the root cause. Distinguish proximate from contributing.✓ 已复制
    → 分层次的原因分析
  3. 行动项
    Generate action items with owners and due dates.✓ 已复制
    → AI 建议的负责人列表，需人工审阅

结果： 对下次有帮助、而不是用于追责的复盘文档。

注意事项
  • 自动分配的负责人可能不对 — 发布前一定要审阅负责人分配
搭配使用： filesystem

用迁移检查清单完成框架大版本升级

👤 进行大版本升级的开发者（如 React 18 → 19） ⏱ ~60 min intermediate

何时使用： 迁移跨越多个文件；你希望不遗漏任何步骤。

步骤
  1. 采用模板
    Apply the migration template to React 18→19. Customize for our codebase.✓ 已复制
    → 定制化的检查清单
  2. 追踪进度
    Walk through the checklist, marking done/blocked for each item.✓ 已复制
    → 进度日志

结果： 迁移后不会出现「我们忘了更新 X」的意外。

注意事项
  • 检查清单过时 — 每个大版本更新一次；skill 提供骨架模板

组合

与其他 MCP 搭配，撬动十倍杠杆

claude-best-practice-skill + everything-claude-code-skill

结合两个有主见的套件——先计划后执行 + 先研究后开发的默认行为

Use claude-best-practice for plan-then-execute; everything-claude-code for research-first.✓ 已复制
claude-best-practice-skill + filesystem

将计划和复盘文档与代码一起持久化

Save the plan to /docs/plans/auth-refactor.md before executing.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
make_plan task description 任何非简单改动之前 tokens
critique_plan plan 计划完成后、执行之前 tokens
postmortem_draft logs, commits, summary 故障发生后 tokens

成本与限制

运行它的成本

API 配额
N/A
每次调用 Token 数
增加了前期成本（规划），但减少了返工循环
费用
免费
提示
对真正简单的改动跳过计划步骤

安全

权限、密钥、影响范围

最小权限： Read access to logs/commits for postmortems
凭据存储： 无
数据出站： 无

故障排查

常见错误与修复

Plans are too generic

提供具体的仓库上下文；skill 会根据你给的信息进行锚定

Conflicts with team's existing process

选择性采用——单独使用复盘模板的价值就已经很高

替代方案

Claude Code Best Practice 对比其他方案

替代方案何时用它替代权衡
everything-claude-code-skill需要更完整的套件（记忆、安全、本能反应）需要学习的内容更多
Hand-rolled CLAUDE.md rules工作流高度定制化维护成本更高

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills