作者 shanraisshan · shanraisshan/claude-code-best-practice
從臨時提示到工程級 Claude 使用方式的實用手冊——計劃、驗證、鉤子、事後回顧。
claude-code-best-practice 是一套讓 Claude Code 在實際工作中可靠的精選實踐和模板。先規劃再執行的提示方式、驗證鉤子、事後回顧格式、重構檢查清單。與其說是「魔法自動技能」，不如說是一套紀律套件——選擇加入、遵循步驟、信任輸出。
%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 | 任何非平凡變更之前 | token |
| critique_plan | plan | 規劃後、執行前 | token |
| postmortem_draft | logs, commits, summary | 事故後 | token |
事後回顧用的日誌／提交讀取存取計劃太通用提供具體的 repo 上下文；技能會錨定在你提供的內容上
與團隊現有流程衝突選擇性採用——單獨使用事後回顧模板就很有價值
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| everything-claude-code-skill | 你想要更完整的套件（記憶、安全性、直覺） | 需要學習的表面積更大 |
| 手工撰寫的 CLAUDE.md 規則 | 高度客製化的工作流程 | 維護工作量更大 |