
community-code-review
社群版本的 Git 提交程式碼審查工具,使用多個專門代理進行自動化審查,配備驗證機制以過濾誤報
- version
- 1.0.0
- GitHub stars
- 29
Install
/plugin install community-code-review@claude-plugin-marketplace-zh-twRun it inside Claude Code after adding the marketplace with /plugin marketplace add DennisLiuCk/claude-plugin-marketplace.
Contents
Discovered from sourceCommands 1
為指定的提交提供程式碼審查。
支援的輸入格式:
- 單一提交:
abc1234或HEAD - 提交範圍:
main..feature-branch或HEAD~5..HEAD - 多個提交:
abc1234 def5678
要執行此操作,請精確遵循以下步驟:
-
啟動一個 Haiku 代理檢查以下任一條件是否為真:
- 提交不存在
- 提交範圍為空
- 提交範圍包含超過 20 個提交且未獲得使用者確認
如果任何條件為真,請停止且不要繼續。
-
啟動一個 Haiku 代理返回所有相關 CLAUDE.md 文件的文件路徑列表(不是內容),包括:
- 根目錄的 CLAUDE.md 文件(如果存在)
- 提交修改的文件所在目錄中的任何 CLAUDE.md 文件
-
啟動一個 Sonnet 代理查看提交並返回變更摘要
-
並行啟動 4 個代理獨立審查變更。每個代理應返回問題列表,其中每個問題包含描述和標記原因(例如「CLAUDE.md 遵守情況」、「錯誤」)。代理應執行以下操作:
代理 1 + 2:CLAUDE.md 合規性 Sonnet 代理 並行審計變更以確保符合 CLAUDE.md。注意:評估文件的 CLAUDE.md 合規性時,您應該只考慮與該文件或其父目錄共享路徑的 CLAUDE.md 文件。
代理 3:Opus 錯誤代理(與代理 4 並行的子代理) 掃描明顯的錯誤。僅關注差異本身,不要閱讀額外的上下文。只標記重大錯誤;忽略吹毛求疵和可能的誤報。不要標記您無法在 git diff 範圍外驗證的問題。
代理 4:Opus 錯誤代理(與代理 3 並行的子代理) 尋找引入程式碼中存在的問題。這可能是安全問題、不正確的邏輯等。只尋找變更程式碼範圍內的問題。
關鍵:我們只需要高信號問題。 這意味著:
- 會在執行時導致錯誤行為的客觀錯誤
- 清晰、明確的 CLAUDE.md 違規,您可以引用被違反的確切規則
我們不需要:
- 主觀的擔憂或「建議」
- CLAUDE.md 未明確要求的風格偏好
- 「可能」是問題的潛在問題
- 任何需要解釋或判斷的事項
如果您不確定某個問題是否真實,請不要標記它。誤報會削弱信任並浪費審查者的時間。
除上述外,每個子代理都應被告知提交訊息。這將有助於提供關於作者意圖的上下文。
-
對於上一步中代理 3 和 4 發現的每個問題,啟動並行子代理來驗證該問題。這些子代理應獲得提交訊息以及問題描述。代理的工作是審查問題以高置信度驗證所述問題確實是問題。例如,如果標記了「變數未定義」這樣的問題,子代理的工作是驗證程式碼中確實如此。另一個例子是 CLAUDE.md 問題。代理應驗證被違反的 CLAUDE.md 規則適用於此文件且確實被違反。對於錯誤和邏輯問題使用 Opus 子代理,對於 CLAUDE.md 違規使用 Sonnet 代理。
此外,驗證者應透過與基礎提交比較,檢查問題是否是預存的(在提交範圍之前就存在)。
-
過濾掉步驟 5 中未被驗證的任何問題。此步驟將為我們的審查提供高信號問題列表。
-
最後,輸出程式碼審查報告。 編寫報告時,請遵循以下準則: a. 保持輸出簡潔 b. 避免使用表情符號 c. 為每個問題引用相關程式碼,包含提交 SHA、文件路徑和行範圍 d. 引用 CLAUDE.md 違規時,您必須引用被違反的 CLAUDE.md 確切文字(例如,CLAUDE.md 說:「使用 snake_case 作為變數名稱」)
在步驟 4 和 5 中評估問題時使用此列表(這些是誤報,不要標記):
- 預存問題(在提交範圍之前就存在的問題)
- 看起來像錯誤但實際上正確的東西
- 資深工程師不會標記的迂腐吹毛求疵
- 檢查工具會捕獲的問題(不要執行檢查工具來驗證)
- 一般程式碼質量問題(例如缺乏測試覆蓋率、一般安全問題),除非在 CLAUDE.md 中明確要求
- CLAUDE.md 中提到但在程式碼中明確禁用的問題(例如透過 lint 忽略註釋)
注意事項:
- 使用
git命令與儲存庫互動 - 開始前先建立待辦事項列表
- 您必須為每個問題引用完整的提交 SHA、文件路徑和行範圍
- 對於您的最終報告,請精確遵循以下格式(假設本例中您發現了 3 個問題):
Code review
發現 3 個問題:
-
<錯誤簡要描述>(CLAUDE.md 說:「<CLAUDE.md 的確切引用>」)
<full_commit_sha>:<path/to/file>#L<start>-L<end>To view:
git show <full_commit_sha>:<path/to/file> | sed -n '<start>,<end>p' -
<錯誤簡要描述>(some/other/CLAUDE.md 說:「<CLAUDE.md 的確切引用>」)
<full_commit_sha>:<path/to/file>#L<start>-L<end>To view:
git show <full_commit_sha>:<path/to/file> | sed -n '<start>,<end>p' -
<錯誤簡要描述>(bug:<原因>)
<full_commit_sha>:<path/to/file>#L<start>-L<end>To view:
git show <full_commit_sha>:<path/to/file> | sed -n '<start>,<end>p'
Generated with Claude Code
- 如果沒有發現問題,請精確遵循以下格式:
Code review
未發現問題。已檢查錯誤和 CLAUDE.md 合規性。
Generated with Claude Code
- 引用程式碼時,請精確遵循以下格式:
<full_sha>:<path>#L<start>-L<end>,例如1d54823877c4de72b2316a64032a54afc404e619:src/auth.ts#L13-L17 - 需要完整的 git sha(40 個字元)
- 您必須提供完整的 sha。不要在引用中使用 HEAD 或分支名稱。
- 始終包含
To view:命令,以便使用者可以輕鬆檢視程式碼
Sponsors
Details
- Marketplace
- DennisLiuCk/claude-plugin-marketplace
- Source
- plugins/community-code-review
- Author
- Dennis Liu
- Category
- Productivity
More from DennisLiuCk/claude-plugin-marketplace
All 20- explanatory-output-stylev1.0.0
- feature-devv1.0.0
- frontend-designv1.0.0
- hookifyv0.1.0
- issue-reviewv1.0.0
- java-code-simplifierv1.0.0
- learning-output-stylev1.0.0
- legacy-analyzerv1.4.0
- plugin-devv1.1.0
- pr-review-toolkitv1.0.0
- ralph-loopv1.0.0
- security-guidancev1.0.0
- skill-creatorv1.0.0
- sql-to-oscv1.0.0
- agent-sdk-devv1.0.0
- claude-opus-4-5-migrationv1.0.0
- code-reviewv1.0.0
- code-simplifierv1.0.0
- commit-commandsv1.0.0