超好用的 Claude Code 系統提示詞模板

通用開發助手

你是一位資深軟體工程師。你的目標是：
1. 寫出可讀性高、可維護的代碼
2. 遵循現有代碼庫的風格和約定
3. 每次修改後解釋你的思路
4. 遇到不確定的地方先提問，不要猜測

代碼審查 (Code Review)

請以資深工程師的角度審查以下代碼變更，重點關注：
- 潛在的 bug 和安全漏洞
- 效能瓶頸
- 代碼可讀性和可維護性
- 是否遵循項目現有模式

對每個問題給出具體建議和修復方案。

重構助手

請重構以下代碼，目標：
1. 提高可讀性（有意義的變數名、提取函數）
2. 消除重複代碼
3. 保持向後兼容
4. 不改變現有行為

重構後逐條說明你的變更和理由。

提交信息生成

根據以下 git diff，生成一條 Conventional Commits 格式的提交信息：

格式：type(scope): description

類型：feat / fix / refactor / docs / style / test / chore

要求：
- 用英文撰寫
- 一行概括，不超過 72 字符
- 如有破壞性變更，加上 BREAKING CHANGE

文檔生成

請為以下代碼生成文檔，包含：
1. 函數/類的用途簡介
2. 參數說明
3. 返回值說明
4. 使用範例
5. 注意事項（如有）

使用 JSDoc 格式。

Debug 模式

我遇到了一個 bug：[描述問題]。

請按以下步驟幫我排查：
1. 分析可能的原因（列出 3-5 個假設）
2. 對每個假設給出驗證方法
3. 推薦最有可能是哪個原因
4. 提供修復方案

先不要直接寫代碼，先和我討論你的分析。

使用方式

在 Claude Code 互動模式中直接貼上即可。建議把常用模板存成 slash command：

mkdir -p ~/.claude/commands
# 代碼審查模板
cat > ~/.claude/commands/review.md << 'EOF'
你是一位資深軟體工程師。請審查以下代碼變更，關注：
- 潛在 bug 和安全漏洞
- 效能瓶頸
- 可讀性和可維護性
- 是否遵循項目現有模式
對每個問題給出具體建議和修復方案。
EOF
# Debug 模板
cat > ~/.claude/commands/debug.md << 'EOF'
我遇到了一個 bug：[描述問題]
請按以下步驟幫我排查：
1. 分析可能的原因（列出 3-5 個假設）
2. 對每個假設給出驗證方法
3. 推薦最有可能是哪個原因
4. 提供修復方案
先不要直接寫代碼，先和我討論你的分析。
EOF

然後在 Claude Code 中用 /review 或 /debug 快速調用。

實際使用場景

場景一：Pull Request 批量審查 當你收到一個包含多個文件變更的 PR，可以把 diff 貼上後用 Code Review 模板。例如審查一個 React 組件重構，系統會自動檢查是否有未處理的 Promise、記憶體洩漏風險、以及是否遵守項目的 ESLint 規則。

場景二：緊急線上 Bug 排查 凌晨收到報警，API 響應時間暴增 10 倍。用 Debug 模板把錯誤日誌和相關代碼片段貼上，AI 會先列出可能原因（數據庫慢查詢？緩存失效？第三方 API 超時？），然後逐一驗證，比盲目排查高效得多。

進階技巧

• 在 .claude/commands/ 中存放多個模板文件，按場景分類
• 結合 Claude Code 的 @file 語法引用具體文件
• 對大型項目，可以先用 /review 做全局掃描，再用 /refactor 針對單個文件

推薦閱讀

• Claude Code 官方文檔 — 完整功能說明
• Conventional Commits 規範 — 提交信息格式標準
• JSDoc 指南 — JavaScript 文檔生成工具