作者 shanraisshan · shanraisshan/claude-code-best-practice
从随机 prompt 升级到工程级 Claude 用法的实践手册——计划、验证、回顾、检查清单。
claude-code-best-practice 是一套让 Claude Code 在真实工作中可靠运转的实践方法和模板。先计划后执行的 prompt 模式、验证 hook、事故复盘格式、重构检查清单。它不是「神奇的自动 skill」，更像一套纪律包——选择采用，按步骤执行，信任输出。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"claude-best-practice-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/shanraisshan/claude-code-best-practice",
"~/.claude/skills/claude-best-practice"
],
"_inferred": true
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"claude-best-practice-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/shanraisshan/claude-code-best-practice",
"~/.claude/skills/claude-best-practice"
],
"_inferred": true
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"claude-best-practice-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/shanraisshan/claude-code-best-practice",
"~/.claude/skills/claude-best-practice"
],
"_inferred": true
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"claude-best-practice-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/shanraisshan/claude-code-best-practice",
"~/.claude/skills/claude-best-practice"
],
"_inferred": true
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "claude-best-practice-skill",
"command": "git",
"args": [
"clone",
"https://github.com/shanraisshan/claude-code-best-practice",
"~/.claude/skills/claude-best-practice"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"claude-best-practice-skill": {
"command": {
"path": "git",
"args": [
"clone",
"https://github.com/shanraisshan/claude-code-best-practice",
"~/.claude/skills/claude-best-practice"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add claude-best-practice-skill -- git clone https://github.com/shanraisshan/claude-code-best-practice ~/.claude/skills/claude-best-practice一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 改动涉及 3 个以上文件，或范围不清晰。
结果： 经过深思熟虑的重构，干净落地。
何时使用： 出了故障，你需要写复盘报告。
结果： 对下次有帮助、而不是用于追责的复盘文档。
何时使用： 迁移跨越多个文件；你希望不遗漏任何步骤。
结果： 迁移后不会出现「我们忘了更新 X」的意外。
结合两个有主见的套件——先计划后执行 + 先研究后开发的默认行为
将计划和复盘文档与代码一起持久化
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| make_plan | task description | 任何非简单改动之前 | tokens |
| critique_plan | plan | 计划完成后、执行之前 | tokens |
| postmortem_draft | logs, commits, summary | 故障发生后 | tokens |
Read access to logs/commits for postmortemsPlans are too generic提供具体的仓库上下文；skill 会根据你给的信息进行锚定
Conflicts with team's existing process选择性采用——单独使用复盘模板的价值就已经很高
| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| everything-claude-code-skill | 需要更完整的套件（记忆、安全、本能反应） | 需要学习的内容更多 |
| Hand-rolled CLAUDE.md rules | 工作流高度定制化 | 维护成本更高 |