ln-162-skill-reviewer

パス： ファイルパス（references/、../ln-*）は、このスキルディレクトリからの相対パスです。

ln-162-skill-reviewer

タイプ： L3 ワーカー（単独実行可能） カテゴリ： 1XX ドキュメントパイプライン

2 つのモードを備えた汎用レビュアーです。

• ln-*/SKILL.md 用の SKILL
• .claude/commands/*.md 用の COMMAND
• repo／repo-checks が要求された場合、または現在のリポジトリが claude-code-skills の場合に、このスキルリポジトリを対象とするリポジトリ一式

Plan Mode の動作： フェーズ 1〜4 および 6〜7 は調査です。Plan Mode で最後まで実行し、レポートと修正リストをプランに記載して、承認後にのみ編集を適用してください。

---

モードの検出

条件	モード	レビュープロファイル
CWD に ln-*/SKILL.md ファイルが存在する	SKILL	D1〜D11 + M1〜M6 の全項目
.claude/commands/*.md ファイルが存在する	COMMAND	構造 + 実行可能性
両方が存在する	SKILL	$ARGUMENTS=commands で上書き

入力

$ARGUMENTS のオプション：

• 空 -> モードと対象範囲を自動検出
• ln-400 ln-500 -> SKILL モード、指定されたスキル
• repo または repo-checks -> 共通レビューの後に、標準のリポジトリ固有チェックを実行
• commands -> COMMAND モード、すべての .claude/commands/*.md
• deploy.md run-tests.md -> COMMAND モード、指定されたファイル

別のスキルから呼び出された場合、ファイルパスが直接渡されることがあります。

---

SKILL モード

フェーズ 1：対象範囲の検出

$ARGUMENTS が指定されている場合：

• 各トークンをスキルディレクトリのプレフィックスとして扱う
• {prefix}*/SKILL.md にグロブ展開する

$ARGUMENTS が空の場合：

• git diff、ステージ済みファイル、未追跡ファイルを調べる
• 主対象のスキルディレクトリを収集する
• 変更された共有ファイルを参照する影響対象スキルを収集する
• ワーカーテーブルと Skill() 呼び出しから依存スキルを収集する

次の形式で報告します： 対象範囲：主対象 {N} 件、影響対象 {M} 件、依存スキル {K} 件。

フェーズ 2：自動検証

次を実行します：

# Never pass a giant mixed scope in one invocation.
# Split by `ln-NXX` family or by coordinator/worker group.
bash references/scripts/run_checks.sh {batch_1 SKILL.md files}
bash references/scripts/run_checks.sh {batch_2 SKILL.md files}

バッチ処理のルール：

• 可能な限り、各実行を 1 つの ln-NXX ファミリー内に収める
• 対象範囲にコーディネーターとワーカーが混在する場合は、別々の実行に分ける
• それでも 1 つのファミリーが大きい場合は、1 回の実行につき 5〜10 ファイルに分割する

自動検証で検出された問題は事前検証済みです。すべて記録してください。

フェーズ 3：構造レビュー

必須の読み込み： references/structural_review.md、references/skill_contract.md、references/procedural_skill_sop_guide.md、references/mcp_applicability_matrix.md、references/mcp_tool_preferences.md を読み込んでください。

対象範囲内のすべてのスキルを D1〜D11 に照らしてレビューします。

次の項目は、スタイル上の細かな問題ではなく、構造上の問題として扱ってください。

• 役割に応じたチェックで必要とされる場合に、**Type:** がない
• L3 ワーカーにおけるワーカーの独立性違反
• 壊れた共有パス
• 古くなったルートドキュメントの前提 — @AGENTS.md インポートスタブと範囲を限定したハーネス差分を使わず、CLAUDE.md が AGENTS.md の内容を重複して記載している
• markdown_read_protocol.md が欠落している Markdown 分析スキル
• 共有のドキュメント品質契約と矛盾する抽出または監査スキル
• 共有スキル契約と矛盾するスキル
• hex-line を主要ツールにすべきなのに、組み込みのファイルツールのみを記述しているスキル
• hex-graph を主要ツールにすべきなのに、grep／手動分析を既定の方法として記述しているスキル
• 共有マトリックス上で実際の適用性がないのに、hex-graph または hex-line を追加しているスキル
• mcp__hex_graph__... など、誤った MCP 名前空間
• 曖昧な法助動詞、高リスクな複合手順、手順の実行箇所におけるチェックリストの欠落、リスクのある手順についての理由の欠落、実行可能な事前チェックの欠落、または根拠の欠落がある手順型スキル

フェーズ 4：意図のレビュー

必須の読み込み： references/intent_review.md を読み込んでください。

主対象のスキルにのみ M1〜M6 を適用します。各主対象スキルの git diff を確認してください。

フェーズ 5：修正

次の決定的な問題を自動修正します。

• 誤ったパス
• 古くなった参照
• 重複した表現
• 削除箇所を正確に特定できるワーカーの独立性違反
• コマンドファイルに複製されたドキュメント用シェルセクション

動作が曖昧な場合は推測しないでください。

修正後、各主対象スキルを最初から最後まで読み直し、動作を変更せずに冗長な表現を簡潔にしてください。

フェーズ 6：レポート

判定ルール：

• 自動修正されていない構造上の違反がある場合 -> FAIL
• 助言レベルの意図に関する懸念のみが残る場合 -> PASS with CONCERNS
• 指摘事項がない場合 -> PASS

レポート形式：

## Skill Coherence Review -- {PASS|PASS with CONCERNS|FAIL}

**Scope:** {reviewed skills}
**Verdict:** {verdict}

フェーズ 7：変動する数値のクリーンアップ

SKILL.md ファイルから古くなった集計カウントを削除します。レビュー対象のファイルに固有のローカルカウントのみを残します。

---

リポジトリスイートモード

このリポジトリ内で実行する場合、または $ARGUMENTS に repo / repo-checks が含まれる場合に使用します。

フェーズ 1：共通レビュー

該当する SKILL モードまたは COMMAND モードを先に実行します。共通レビューを省略しないでください。

フェーズ 2：リポジトリ固有のチェック

標準のリポジトリスイートを実行します。

node plugins/documentation-pipeline/skills/ln-162-skill-reviewer/references/scripts/repo_review_suite.mjs

リポジトリスイートのデフォルト実行ポリシー：

• デフォルト：--runtime quick（暗黙的）では範囲を限定したスモークテストのみを実行します
• 構造のみ：--runtime skip
• リリース／CI：--runtime full

node plugins/documentation-pipeline/skills/ln-162-skill-reviewer/references/scripts/repo_review_suite.mjs --runtime full

スイートは R1-R27 を担当します。これらのチェックをホスト固有のコマンドファイルにコピーしないでください。通常のレビューにおけるデフォルトのゲートとして、フルランタイムスイートを使用しないでください。これは意図的にリリース品質向けに設定されており、通常のレビューで許容される所要時間を超える場合があります。

フェーズ 3：統合レポート

共通レビューの判定とリポジトリスイートの判定を統合します。

| Source | Verdict | Details |
|--------|---------|---------|
| Universal review | {PASS|PASS with CONCERNS|FAIL} | {summary} |
| Repo suite | {PASS|PASS with WARNINGS|FAIL} | {R1-R27 summary} |
| Combined | {worst verdict} | |

すべての FAIL 項目と WARN 項目を、ファイルパスおよび修正内容とともに列挙します。

---

COMMAND モード

必読： references/command_review_criteria.md を読み込みます

フェーズ 1：対象範囲の特定

• 明示的にファイルパスが指定されている場合 -> それらのファイルをレビューします
• commands -> .claude/commands/*.md に glob を適用します
• コーディネーターからファイルリストが提供されている場合 -> それらのファイルをレビューします

フェーズ 2：レビュー

各コマンドファイルについて：

• すべてのコマンドレビュー基準を適用します
• ソースの出所を確認します
• コピーされたドキュメントのシェルセクションが残っていないことを確認します

フェーズ 3：修正

安全に行える場合は自動修正します：

• frontmatter の欠落
• allowed-tools の欠落
• 説明が長すぎる
• Last Updated の欠落
• 完全にコピーされたドキュメントのシェルセクション

フェーズ 4：レポート

## Command Review -- {N} files

| File | Verdict | Issues |
|------|---------|--------|

Verdicts: PASS / FIXED / WARN / FAIL
Pass rate: {X}%

---

ルール

• 自動チェックは必須です。
• レポートを作成する前に、対象範囲内のすべてのファイルを読みます。
• 確定的な問題は直ちに修正します。
• ユーザーから明示的に依頼されない限り、バージョンや日付を更新しないでください。
• shared/ の変更は、参照しているすべてのスキルに影響します。
• L3 ワーカーには独立性が必須です：
  • **Coordinator:** を含めない
  • **Parent:** を含めない
  • 呼び出し元の宣言を必須にしない
• ドキュメントモデルの不整合は、好みの問題ではなく構造上の欠陥です。
• 明確に歴史的な参照と示されている場合を除き、サポート対象外のプラットフォーム API の使用は禁止されています。

参照ファイル

• references/structural_review.md
• references/intent_review.md
• references/automated_checks.md
• references/scripts/run_checks.sh
• references/scripts/run_runtime_suite.mjs
• references/scripts/repo_review_suite.mjs
• references/command_review_criteria.md
• references/scripts/check_marketplace.mjs

完了の定義

• 対象範囲を特定済み
• 自動チェックを実行済み
• 対象範囲内のすべてのスキルについて D1-D11 をレビュー済み
• プライマリスキルについて M1-M6 を評価済み
• 修正可能な指摘事項を自動修正済み
• 修正後の全体的な圧縮を完了済み
• 最終判定レポートを作成済み

---

バージョン： 1.0.0 最終更新日： 2026-03-26