agent-rules 規則包：Conventional Commit + 6 視角 PR 審查 + 5 Whys 根因分析

commit 訊息亂、PR 審查靠感覺、bug 修了又復發？steipete 的 agent-rules 提供三條打磨過的規則：語意化 commit（含 emoji 與自動分拆）、6 視角 PR 審查、5 Whys 根因分析。直接當 Claude Code / Cursor 的 slash 指令用。

[ Log in to see the full prompt ]

## 這是什麼／解決什麼痛點 三個天天發生、又天天被將就的問題：commit 訊息隨便寫（之後 git log 看不懂）、PR 審查靠當下心情（漏掉安全或測試）、bug 修了表面又復發（沒找到真因）。steipete/agent-rules 把這些做成「規則檔」，讓 AI 助理每次都照同一套標準執行。本篇把其中最實用的三條打包成一個可切換模式的規則包。 ## 為什麼這個來源值得用 來源是 Peter Steinberger（steipete，知名 iOS 開源作者、PSPDFKit 創辦人）的 agent-rules（MIT 授權、可商用）。這些規則原本是他用 Cursor 時打磨出來的 `.mdc` 規則檔，而 `.mdc` 規則本質上就能當成 Claude Code 的 slash 指令來用（複製到 `.claude/commands/` 即可）——同一套規則跨 Cursor 與 Claude Code 通用。三條規則的內容很扎實： - **commit**：12 種 Conventional Commit 型別配 emoji（✨feat／🐛fix／📝docs／♻️refactor…），會先跑 pre-commit 檢查、強調 atomic commit，並主動「把不相關的變更分拆成多個 commit」。 - **pr-review**：用 6 個專業 persona（PM／開發／品保／資安／DevOps／UI-UX）各自一份 checklist 審查，並有一條硬規則：「打算之後再修的，現在就要修」。 - **five（5 Whys）**：定義問題 → 連問五次為什麼 → 驗證因果鏈 → 針對根因提解法＋預防措施，並強調「對事不對人」。 ## 怎麼用（步驟） 1. 把上方 full_prompt 存成一個 Claude Code slash 指令（`.claude/commands/agent-rule.md`），或直接貼進對話。 2. 設定 `{{MODE}}` 為 `commit`、`pr-review` 或 `five-whys`，並在 `{{CONTEXT}}` 給對應材料（diff／PR 連結／問題描述）。 3. AI 就會照該模式的固定流程執行並輸出。想要原汁原味的全套規則，直接 clone repo 把 `project-rules/*.mdc` 丟進你的工具。 ## 何時用 - 想統一團隊的 commit 風格與 PR 審查品質。 - 線上事故 / 反覆出現的 bug，需要結構化地挖根因而非貼 OK 繃。 - 同時用 Cursor 和 Claude Code，想要一套規則兩邊共用。 📎 來源：steipete/agent-rules（project-rules，作者 Peter Steinberger，MIT 授權）— 本篇為繁中改寫整理，三條規則合併成可切換模式的版本；原始各別 `.mdc` 規則檔見上方連結。