mcpField
L
ln-513-agent-reviewer

ln-513-agent-reviewer

github.com/levnikolaevichテスト・品質58440 回インストール2 日前に更新
リポジトリ

ln-513-agent-reviewer について

コード実装を対象に、外部エージェントのレビューを並行実行するスキルです。提案を検証・重複排除し、信頼度付きの結果を返して ln-510 の品質調整フローを支援します。

主な機能

  1. 01codex-review と gemini-review を並行実行
  2. 02レビュー提案を批判的に検証
  3. 03改善案を重複排除して選別
  4. 04提案に信頼度を付与
  5. 05レビュー概要を保存

活用シーン

  1. 01完了したコード実装のレビュー
  2. 02複数の外部エージェントの結果を集約
  3. 03品質調整フロー向けに検証済み提案を提供

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-513-agent-reviewer

インストール後、Claude Code で/ln-513-agent-reviewerを入力して読み込まれたか確認します。

詳細

パス: ファイルパス(shared/、references/、../ln-*)は、skills リポジトリのルートからの相対パスです。CWD に見つからない場合は、この SKILL.md ディレクトリを特定し、1 つ上の階層をリポジトリのルートとしてください。

エージェントレビュー(コード)

コード実装に対する外部エージェントのレビューを並行して実行し、提案を批判的に検証して、改善点を絞り込んで返します。

目的と範囲

  • ln-510 品質コーディネーターのパイプラインで動作するワーカー(ln-510 のフェーズ 4 から呼び出されます)
  • codex-review と gemini-review をバックグラウンドタスクとして並行実行します
  • 結果を受信次第処理します(最初に完了したエージェントの結果をただちに処理します)
  • 各提案を批判的に検証し、Claude が異議を唱える場合はエージェントと議論します
  • 信頼度スコアを付け、絞り込み、重複を排除し、検証した提案を返します
  • ヘルスチェックとプロンプトの実行を 1 回の呼び出しで行います

使用するタイミング

  • ln-510-quality-coordinator のフェーズ 4(エージェントレビュー)から呼び出されます
  • Story のステータスが Done の実装タスクすべて
  • コード品質(ln-511)と技術的負債のクリーンアップ(ln-512)がすでに完了していること

パラメーター

パラメーター値
review_typecodereview
skill_group513
prompt_templateshared/agents/prompt_templates/code_review.md
verdict_acceptableCODE_ACCEPTABLE

入力

入力必須ソース説明
storyIdはいargs、git branch、kanban、user処理対象の Story

解決方法: shared/references/input_resolution_pattern.md に従います — Story 解決チェーン。 ステータスフィルター: In Progress、To Review

ワークフロー

必須の読み込み: shared/references/input_resolution_pattern.md、shared/references/tools_config_guide.md、shared/references/storage_mode_detection.md、shared/references/agent_review_workflow.md、shared/references/agent_delegation_pattern.md を読み込みます。

フェーズ 0:入力とツール設定の解決
  1. storyId を解決します(input_resolution_pattern.md に従います)。

    • args が指定されている場合 → args を使用します
    • それ以外で、git branch が feature/{id}-* に一致する場合 → id を抽出します
    • それ以外で、kanban に [In Progress, To Review] の Story がちょうど 1 つある場合 → 提案します
    • それ以外の場合 → AskUserQuestion:kanban から [In Progress, To Review] で絞り込んだ Story を表示します
  2. docs/tools_config.md を読み込みます(存在しない場合は tools_config_guide.md に従って初期設定します)。 抽出項目:task_provider = Task Management → Provider(linear | file)。

独自の手順(共通ワークフローの前に実施)
  1. ヘルスチェック: 共通ワークフローに従い、skill_group = 513 で絞り込みます。

  2. 参照情報の取得:

    • task_provider = linear の場合:get_issue(storyId) → URL と identifier を抽出します。list_issues(filter: {parent: {id: storyId}, status: "Done"}) → Done の実装 Task の URL/identifier を抽出します(label "tests" は除外)。
    • task_provider = file の場合:story.md を読み込み → path を抽出します。Glob("docs/tasks/epics/*/stories/*/tasks/*.md") → Done の Task を絞り込み(**Status:** Done を確認)、label "tests" は除外します。
  3. .agent-review/ を確保します: 共通ワークフローに従います。

  4. プロンプトを作成します: テンプレート shared/agents/prompt_templates/code_review.md を読み込みます。

    • {story_ref} を - Linear: {url} または - File: {path} に置き換えます
    • {task_refs} を各 Task の箇条書き - {identifier}: {url_or_path} に置き換えます
    • .agent-review/{identifier}_codereview_prompt.md に保存します(共有ファイルは 1 つだけです。両方のエージェントが同じプロンプトを読み込みます)
共通ワークフローの手順

5-8) レビュー履歴の読み込み、エージェントの実行、批判的検証と議論、集約と返却: 共通ワークフローに従います。

  • {review_type} = "Code Implementation"(チャレンジ用テンプレート)
  1. レビューサマリーの保存: 共通ワークフローの「レビューサマリーの保存」手順に従います。

出力形式

verdict: CODE_ACCEPTABLE | SUGGESTIONS | SKIPPED
suggestions:
  - area: "security | performance | architecture | correctness | best_practices"
    issue: "What is wrong"
    suggestion: "Specific fix"
    confidence: 95
    impact_percent: 15
    source: "codex-review"
    resolution: "accepted | accepted_after_debate | accepted_after_followup | rejected"

エージェントの統計情報と議論ログは、共通ワークフローの出力スキーマに従います。

フォールバックルール

共通ワークフローに加えて、次のとおりです。

条件アクション
親スキル(ln-510)Self-Review(ネイティブ Claude)にフォールバックします

判定のエスカレーション

  • area=security または area=correctness の指摘がある場合 → 親スキルは PASS を CONCERNS にエスカレーションできます
  • このスキルは検証済みの提案をそのまま返します。エスカレーションの判断は ln-510 が行います

重要なルール(追加)

  • 呼び出し必須: 親スキルは必ずこのスキルを呼び出してください。エージェントを利用できない場合は、SKIPPED を返して正常に終了します。親は事前確認して呼び出しをスキップしてはいけません。

参照ファイル

  • ツール設定: shared/references/tools_config_guide.md
  • ストレージモードの操作: shared/references/storage_mode_detection.md
  • 共有ワークフロー: shared/references/agent_review_workflow.md
  • エージェントへの委任パターン: shared/references/agent_delegation_pattern.md
  • プロンプトテンプレート(レビュー): shared/agents/prompt_templates/code_review.md
  • チャレンジスキーマ: shared/agents/schemas/challenge_review_schema.json

バージョン: 2.0.0 最終更新日: 2026-02-11

コメント