mcpField
L
ln-312-review-findings-worker

ln-312-review-findings-worker

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

ln-312-review-findings-worker について

ln-312-review-findings-workerは、対象の成果物や差分をStoryレビューや計画レビュー向けの標準化された指摘に変換するスキルです。モードに応じて基準を監査し、Storyモードではペナルティ計算と修正計画の作成も行います。

主な機能

  1. 01対象成果物や差分の分析
  2. 02Storyモードで30項目を監査
  3. 03計画レビューで指定4項目を確認
  4. 04重大度に応じたペナルティ計算
  5. 05指摘の標準化と修正計画の作成

活用シーン

  1. 01Storyやタスクの監査基準への適合確認
  2. 02計画における標準・バージョン・案の評価
  3. 03Storyの違反に対するペナルティ計算
  4. 04レビュー結果の構造化された指摘への整理

インストール

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

$npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-312-review-findings-worker

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
cross_reference_validation.md
epistemic_protocol.md
evaluation_summary_contract.md
evaluation_worker_runtime_contract.md
penalty_points.md
phase2_research_audit.md
plan_review_pipeline.md
premortem_validation.md
research_methodology.md

詳細

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

タイプ： L3 ワーカー
カテゴリ： 3XX 計画

レビュー所見ワーカー

必読事項

必読： references/evaluation_worker_runtime_contract.md、references/evaluation_summary_contract.md を読み込みます。
必読： ../ln-310-multi-agent-validator/references/phase2_research_audit.md、../ln-310-multi-agent-validator/references/penalty_points.md を読み込みます。
必読： ../ln-310-multi-agent-validator/references/premortem_validation.md、../ln-310-multi-agent-validator/references/cross_reference_validation.md を読み込みます。

目的

  • 対象の成果物または差分を分析します
  • エビデンスを正規化された所見に変換します
  • mode=story の場合：phase2_research_audit.md に従い、30 の基準について減点ポイントを算出します
  • mode=plan_review の場合：基準 #5、#6、#21、#28 のみを評価します（減点の累積は行いません）
  • ストーリー形式のみのレビュー出力を避けます

モードゲート

  • mode=story：完全なパイプライン — プレモーテム、相互参照、30 の基準に対する減点ポイントの算出、修正計画の作成
  • mode=plan_review：適用可能性の確認、スタックの検出、基準 #5（標準）、#6（ライブラリのバージョン）、#21（代替案）、#28（ライブラリの機能）のみを評価し、減点を累積せずに所見を正規化します

ランタイム

ランタイムファミリー：

  • evaluation-worker-runtime

必須のマニフェストフィールド：

  • identifier
  • phase_order
  • summary_kind=review-findings
  • operation=findings

推奨される phase_order：

  1. PHASE_0_CONFIG
  2. PHASE_1_LOAD_TARGET
  3. PHASE_2_PREMORTEM（mode=story、複雑さが Medium 以上の場合）
  4. PHASE_3_CROSS_REFERENCE（mode=story、複数のストーリーがあるエピックの場合）
  5. PHASE_4_CRITERIA_AUDIT
  6. PHASE_5_PENALTY_CALCULATION（mode=story のみ）
  7. PHASE_6_NORMALIZE_FINDINGS
  8. PHASE_7_WRITE_SUMMARY
  9. PHASE_8_SELF_CHECK

ワークフロー

フェーズ 0：設定

ランタイムマニフェスト、対象識別子、リンクされた調査成果物のパスを読み込みます。

フェーズ 1：対象の読み込み

レビュー範囲に必要な対象成果物のみを読み込みます。

フェーズ 2：プレモーテム（mode=story）

premortem_validation.md に従ってプレモーテム分析を実行します。

  1. 些細なストーリー（タスクが 1～2 件、外部依存関係がなく、既知の技術を使用）の場合はスキップします。
  2. 複雑さが Medium 以上（タスクが 3 件以上、外部依存関係がある、または不慣れな技術を使用）のストーリーで実行します。
  3. タイガー（エビデンスに基づくリスク）はリスク基準 #20 に反映し、減点計算の前にリスクテーブルへ追加します。
  4. エレファント（明示されていない前提）は前提条件基準 #24 に反映し、[pre-mortem] タグと Confidence=LOW を付けて追加します。
  5. ペーパータイガー（エビデンスのない懸念）は記録して却下します。
  6. 監査レポートにプレモーテムのテーブルを含めます。
フェーズ 3：相互参照（mode=story）

cross_reference_validation.md に従って相互参照分析を実行します。

  1. エピックにストーリーが 1 件のみの場合、またはすべての兄弟ストーリーが Done/Canceled の場合はスキップします。
  2. list_issues(project=Epic.id) を使って兄弟ストーリーを読み込みます。
  3. AC の重複（#25）を確認します。まず構造化されたトレーサビリティを使用し、キーワードによる代替手段は参考情報としてのみ使用します。
  4. タスクの重複（#26）を確認します。構造化された照合を優先します。
  5. 監査レポートに相互参照の所見を含めます。
フェーズ 4：基準監査
  1. mode=story：phase2_research_audit.md の自動修正アクション参照に従って、ストーリー／タスクに対する 30 の基準をすべて評価します。
  2. mode=plan_review：基準 #5、#6、#21、#28 のみを評価します（標準とソリューショングループ）。
  3. 提供された調査エビデンスがある場合は、それに照らして主張を照合します。
フェーズ 5：減点計算（mode=story）
  1. phase2_research_audit.md の重大度レベル（CRITICAL=10、HIGH=5、MEDIUM=3、LOW=1）に従い、違反ごとに減点ポイントを割り当てます。
  2. penalty_points.md の計算ルールに従って、複数違反のルールを適用します。
  3. 減点ポイントの合計を算出します。
  4. 各違反について修正計画を作成します。
  5. penalty_points.md のレポート形式に従って、減点監査テーブルを整形します。
フェーズ 6：所見の正規化

各所見では、次のような構造化フィールドを優先します。

  • id
  • severity
  • category
  • subject
  • evidence
  • recommendation
フェーズ 7：サマリーの作成

summary_kind=review-findingsを出力します。

ペイロードには以下を含める必要があります：

  • worker=ln-312
  • status
  • operation=findings
  • warnings

利用可能な場合は、以下のフィールドを優先してください：

  • findings
  • metrics.penalty_total（mode=story）
  • metrics.criteria_violated（基準番号のリスト）
  • metrics.fix_plan（{criterion, action, severity}の配列）
  • metrics.premortem_summary（実行した場合）
  • metrics.cross_reference_summary（実行した場合）
フェーズ 8：セルフチェック
  1. 重複を削除します。
  2. 裏付けのない主張を削除します。
  3. 罰則の計算がpenalty_points.mdのルール（mode=story）に一致することを確認します。
  4. サマリーの書き込み後にのみpass=trueを記録します。

完了の定義

  • 対象の成果物を読み込み済み
  • 事前検死を実施済み、またはスキップした理由を記録済み（mode=story）
  • 相互参照を実施済み、またはスキップした理由を記録済み（mode=story）
  • 基準の監査を完了済み（storyの場合は30項目、その他の場合は#5/#6/#21/#28）
  • 罰則ポイントを計算し、修正計画を作成済み（mode=story）
  • 指摘事項を正規化済み
  • 裏付けのない主張を削除済み
  • review-findingsサマリーを作成済み
  • セルフチェックに合格済み

バージョン： 1.0.0 最終更新日： 2026-04-10

コメント

Markdown 対応