project-reviewlisted
Install: claude install-skill ijufumi/claude-skills
# プロジェクト全体レビュー実施スキル
リポジトリ全体(または指定スコープ)に対して、Claude がプロジェクトレビューを実施し、コンソール表示または Markdown レポートとして結果を出力するためのスキル。差分ベースの code-review が「変更による影響」を見るのに対し、本スキルは「現在のコードベース全体の健全性」を見る。テックデット棚卸し、アーキテクチャ評価、リポジトリ監査、新規参画時のコードベース把握といった用途を想定する。
## 2 つの実行モード
このスキルには **通常モード(normal)** と **詳細モード(detailed)** の 2 つがあり、ユーザーの依頼文に応じて自動で切り替わる。
- **通常モード(normal、既定)** — **1 つの subagent A_review が 11 観点すべてを横断的にレビューし、1 つの subagent C_review がそのメタレビュー(誤検知排除・重要度見直し・文言改善・漏れ補完)を行う**。動作確認は subagent B として並列に走らせ、責務を完全に分離する。サブエージェントの起動コストを抑えつつ、観点間の重複指摘を A_review 内部で吸収できるため、日常のプロジェクトレビューはこちらで十分。
- **詳細モード(detailed)** — **11 観点に分割し、1 観点 1 subagent(A_i)で並列にレビューし、観点ごとに対応する評価 subagent C_i を起動してメタレビューする**。動作確認は subagent B として並列に走らせる。観点ごとの専門性を最大化したい時、または大規模リポジトリで観点別に深掘りしたい時に使う。**詳細モードの各レビュー subagent(A_i)とメタレビュー subagent(C_i)は `ultrathink`(拡張思考)を使って深く分析する**(動作確認の subagent B は対象外)。
**モードの判定**: ユーザーの依頼文に「詳細に」「詳しく」「観点別に」「観点ごとに」「徹底的に」「徹底レビュー」「deeply」「detailed」「thoroughly」「`--detailed`」などのキーワードが含まれている場合のみ **detailed** を採用し、それ以外は **normal** とする(ユーザーへの追加確認はしない)。どちらのモードでも Step 1(範囲・動作確認・出力先)の 3 点確認は同じ手順で行う。
どちらのモードでも、レビュー観点は 11 観点(コード正確性 / プロジェクト規約準拠 / パフォーマンス / テストカバレッジ / セキュリティ / エラーハンドリング / 可読性・保守性 / シンプル化 / アーキテクチャ・設計 / リポジトリ共通観点 + ユーザー指定の重点観点)で構成し、リポジトリ共通のレビュー観点(`docs/REVIEW.md`)とユーザー指定の重点観点は観点として扱う。**通常モードはこの 11 観点を 1 本の subagent で横断的にレビューし、詳細モードは 1 観点 1 subagent で並列にレビューする**。
## 前提条件
- レビュー対象のリポジトリがカレントディレクトリで読み取れること(`Read` / `Grep` でコードを追うため)
- `git` CLI が利用可能であること(リポジトリのルート特定・追跡ファイル一覧の取得に使用)。`git` 管理外のディレクトリは追跡ファイルが