mcpField
L
ln-311-agent-reviewer

ln-311-agent-reviewer

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

ln-311-agent-reviewer について

ln-311-agent-reviewerは、ln-310の検証ワークフローでStoryとTasksを審査するスキルです。CodexとGeminiのレビューを並行実行し、提案を検証・重複排除して編集上の改善点を返しますが、親スキルの判定は変更しません。

主な機能

  1. 01CodexとGeminiによる並行レビュー
  2. 02提案の批判的な検証とエージェントとの議論
  3. 03StoryとTasksの提案の重複排除
  4. 04レビュー概要と議論ログの保存

活用シーン

  1. 01承認前の検証済みStoryのレビュー
  2. 02StoryとTasksの編集上の改善点の特定

インストール

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

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

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

詳細

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

Agent Reviewer(ストーリー)

検証済みのストーリーとタスクを外部エージェントで並列レビューし、提案を批判的に検証して、編集上の改善点を返します。

目的と範囲

  • ln-310 検証パイプラインのワーカー(フェーズ 5 で呼び出されます)
  • codex-review と gemini-review をバックグラウンドタスクとして並列実行します
  • 結果が届いた順に処理します(最初に完了したエージェントの結果を即座に処理します)
  • 提案を批判的に検証します。Claude が同意しない場合は、エージェントと議論します
  • ストーリー/タスクの改善に向け、フィルタリング、重複排除、検証を行った提案を返します
  • ヘルスチェックとプロンプト実行を 1 回の呼び出しで行います

使用するタイミング

  • ln-310-story-validator のフェーズ 5(エージェントレビュー)で呼び出されます
  • フェーズ 4 の自動修正が適用され、Penalty Points = 0 になった後
  • 承認前の最終形になったストーリーとタスクが対象です

パラメーター

ParameterValue
review_typestoryreview
skill_group311
prompt_templateshared/agents/prompt_templates/story_review.md
verdict_acceptableSTORY_ACCEPTABLE

入力

InputRequiredSourceDescription
storyIdはいargs、git ブランチ、kanban、ユーザー処理するストーリー

解決方法: shared/references/input_resolution_pattern.md に従います(ストーリー解決チェーン)。 ステータスフィルター: Backlog

ワークフロー

必須の読み込み: 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 ブランチが feature/{id}-* に一致する場合 → id を抽出します
    • それ以外で、kanban に [Backlog] のストーリーがちょうど 1 件ある場合 → 提案します
    • それ以外 → AskUserQuestion:kanban から [Backlog] でフィルタリングしたストーリーを表示します
  2. docs/tools_config.md を読み込みます(存在しない場合は tools_config_guide.md に従ってブートストラップします)。 task_provider = Task Management → Provider(linear | file)を抽出します。

固有の手順(共有ワークフローの前に実行)
  1. ヘルスチェック: 共有ワークフローに従い、skill_group = 311 でフィルタリングします。

  2. 参照情報の取得:

    • task_provider = linear の場合:get_issue(storyId) → URL と識別子を抽出します。list_issues(filter: {parent: {id: storyId}}) → 子タスクの URL/識別子を抽出します。
    • task_provider = file の場合:story.md を読み込みます → パスを抽出します。Glob("docs/tasks/epics/*/stories/*/tasks/*.md") → 子タスクのファイルパスを抽出します。
  3. .agent-review/ を確保: 共有ワークフローに従います。

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

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

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

  • {review_type} = "Story/Tasks"(チャレンジ用テンプレート)
  1. レビュー概要の保存: 共有ワークフローの「レビュー概要の保存」手順に従います。

出力形式

verdict: STORY_ACCEPTABLE | SUGGESTIONS | SKIPPED
suggestions:
  - area: "security | performance | architecture | feasibility | best_practices | risk_analysis"
    issue: "What is wrong or could be improved"
    suggestion: "Specific change to Story or Tasks"
    confidence: 95
    impact_percent: 15
    source: "codex-review"
    resolution: "accepted | accepted_after_debate | accepted_after_followup | rejected"

共有ワークフローの出力スキーマに従ったエージェント統計と議論ログ。

フォールバックルール

共有ワークフローに加えて、以下に従います。

ConditionAction
親スキル(ln-310)セルフレビュー(ネイティブ Claude)にフォールバックします

判定のエスカレーション

  • エスカレーションはありません。 提案は編集上のものに限られ、ストーリー/タスクのテキストを修正します。
  • 親スキル(ln-310)のゲート判定は、エージェントの提案によって変更されません。

重要なルール(追加)

  • 呼び出し必須: 親スキルは必ずこのスキルを呼び出す必要があります。エージェントを利用できない場合は、正常にスキップします。親は事前確認してスキップしてはなりません。

参照ファイル

  • ツール設定: 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/story_review.md
  • チャレンジスキーマ: shared/agents/schemas/challenge_review_schema.json

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

コメント