parallel-code-review について
parallel-code-reviewは、Cursorのエージェント向けコードレビュー用スキルです。読み取り専用の4つのレビューを並行実行し、結果を優先度順にまとめます。大規模な変更やセキュリティ・性能が重要な変更に適しています。
主な機能
- 014つの読み取り専用レビューを並行実行
- 02セキュリティ・性能・正確性・可読性の確認
- 03指摘の重複排除と重大度順の整理
- 04任意の対象限定フォローアップタスク
活用シーン
- 01大規模な差分やリファクタリングのレビュー
- 02認証や決済の変更確認
- 03性能が重要なコードの調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ revitalb-port/ skills-registry-demo --skill parallel-code-reviewインストール後、Claude Code で/parallel-code-reviewを入力して読み込まれたか確認します。
詳細
並列コードレビュー
Cursor の Task ツールを使って、explore(読み取り専用)のサブエージェントを4つ同時に実行します。各サブエージェントはコードを読み取るだけで、1つの観点について調査結果をまとめます。メインエージェントが結果を統合し、優先順位を付けた単一のレビューを作成します。これは、複数のエージェントを使うことで効率よく行えます。
使用する場面
- 1回の確認では見落としが発生しやすい、大規模な差分やリファクタリング。
- セキュリティ上重要な変更(認証、決済、信頼できない入力の解析)。
- パフォーマンスが重要な処理(頻繁に実行されるループ、N+1 クエリ、バンドルのエントリーポイント)。
ワークフロー
1. 変更範囲を絞る
レビュー担当者には、具体的なファイル一覧を渡すことをおすすめします。
git diff --name-only origin/main...HEAD
または、PR のリンクを貼り、メインエージェントにブランチから変更ファイルを一覧表示させます。
2. 4つのサブエージェントを並列で起動する
subagent_type: "explore" と readonly: true を指定した Task 呼び出しを4つ含むメッセージを1つ送信します。プロンプトの例:
セキュリティ
Read-only review: SECURITY
Changed files:
<list>
Focus: injection (SQL, shell, XSS), authZ/authN gaps, secrets in code, unsafe deserialization, path traversal, SSRF, IDOR, dependency CVEs mentioned in diff.
Output:
- Critical / High / Medium / Low findings
- File:line and short fix recommendation
- "No issues" if nothing material
パフォーマンス
Read-only review: PERFORMANCE
Changed files:
<list>
Focus: N+1 queries, missing indexes, accidental O(n²) loops, bundle size impact, unnecessary re-renders, sync I/O on hot paths, unbounded caches.
Output: same severity + location format as above.
正確性
Read-only review: CORRECTNESS
Changed files:
<list>
Focus: logic bugs, off-by-one, wrong edge cases, race conditions, error handling gaps, breaking API changes, test gaps for new behavior.
Output: same format.
可読性/保守性
Read-only review: READABILITY
Changed files:
<list>
Focus: naming, duplication, abstraction boundaries, file size, unclear control flow, missing types/docs where they would prevent bugs.
Output: same format; prefer suggestions over nitpicks.
3. 結果を統合する
メインエージェントは次の作業を行います。
- 複数の観点で重複している調査結果を統合します(1件として数え、最も重大な深刻度を適用します)。
- 深刻度の高い順に並べ、同じ深刻度の場合は修正コストの順に並べます。
- 簡潔なエグゼクティブサマリー(最大5項目)と、実行可能な項目をまとめた表またはリストを作成します。
4. 任意 — 指摘事項に対応する
メインエージェントで修正するか、承認された項目に限り、対象を絞った読み取り専用ではない後続タスクを開始します。
注意事項
- 並列実行中に書き込みが競合しないよう、プロンプトは読み取り専用にしてください。
- 差分が非常に大きい場合は、ディレクトリごとに分割し、第2段階でディレクトリごとに4人のレビュー担当者を実行してください。無関係な巨大な差分を1回のレビューに詰め込まないでください。
- これは人によるレビューを補完するものであり、規制対象の環境におけるコンプライアンスやセキュリティの承認に代わるものではありません。
コメント
Markdown 対応