mcpField
L
ln-313-review-docs-worker

ln-313-review-docs-worker

github.com/levnikolaevich開発584105 回インストール2 日前に更新
リポジトリ

ln-313-review-docs-worker について

Story の要件に基づき、レビューに必要なドキュメントを生成・更新する Worker Skill です。パターンを検出し、作成したドキュメントを Story に関連付けて review-docs サマリーを記録します。

主な機能

  1. 01Story から技術領域を抽出
  2. 02レジストリに基づくパターン検出
  3. 03ドキュメントの生成と更新
  4. 04Story へのリンクとランタイムチェックポイント
  5. 05review-docs サマリーの記録と自己確認

活用シーン

  1. 01Story に不足するドキュメントの作成
  2. 02検証済み変更に基づく既存文書の更新
  3. 03計画レビューで差分がない場合のスキップ

インストール

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

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

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

同梱ファイル

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

references/
documentation_creation.md
domain_patterns.md
evaluation_summary_contract.md
evaluation_worker_runtime_contract.md
references/templates/
adr_template.md
guide_template.md
manual_template.md
research_template.md

詳細

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

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

ドキュメントレビューワーカー

必読

必読： references/evaluation_worker_runtime_contract.md、references/evaluation_summary_contract.md を読み込みます 必読： ../ln-310-multi-agent-validator/references/domain_patterns.md を読み込みます

目的

  • レビューで必要な未作成のドキュメントを作成します
  • 検証済みの変更のみを既存ドキュメントに反映します
  • ドキュメント作業をマージや修復とは分けて行います

モードゲート

  • mode=story：ドメイン抽出、パターン検出、ドキュメント生成を含む、ドキュメント作成の全工程を実行します
  • mode=plan_review：ドキュメントの差分がなければスキップし、docs_skipped_reason を記録します

ランタイム

ランタイムファミリー：

  • evaluation-worker-runtime

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

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

推奨する phase_order：

  1. PHASE_0_CONFIG
  2. PHASE_1_EXTRACT_DOMAINS
  3. PHASE_2_PATTERN_DETECTION
  4. PHASE_3_GENERATE_DOCS
  5. PHASE_4_LINK_TO_STORY
  6. PHASE_5_WRITE_SUMMARY
  7. PHASE_6_SELF_CHECK

ワークフロー

フェーズ 1：ドメインの抽出
  1. ストーリーのタイトル、技術メモ、実装タスクから技術ドメインを抽出します。
  2. 範囲を限定したドキュメントのトピック一覧を作成します。
フェーズ 2：パターン検出
  1. domain_patterns.md からパターンレジストリを読み込みます。
  2. キーワード検出を通じて、ストーリーの内容からパターンに一致するものを検索します。
  3. 複数のパターンが検出された場合は、該当するドキュメントをすべて作成します。
フェーズ 3：ドキュメントの生成

検出されたパターンごとに、以下を実行します。

  1. 想定される出力パス（glob docs/{type}s/*{pattern}*.md）にドキュメントがすでに存在するか確認します。
  2. 存在しない場合は、references/templates/（adr_template.md、guide_template.md、manual_template.md）からテンプレートを読み込みます。
  3. 調査方法に従って、利用可能な MCP ツールを使い、パターンのトピックを調査します。
  4. ADR パターンの場合は、生成前に 5 つの ADR に関する質問（コンテキスト、決定、結果、代替案、ステータス）に内部で回答します。
  5. ドキュメントを生成します。ルール：生成するドキュメントにはコードを含めず、散文より表を優先し、目標の長さは 300～500 語とします。
  6. docs/{type}s/{naming}.md に保存します。
フェーズ 4：ストーリーへのリンク
  1. 作成したドキュメントへのリンクをストーリーの技術メモに追加します。
  2. docs_checkpoint でランタイム状態を更新します。
フェーズ 5：サマリーの作成

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

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

  • worker=ln-313
  • status
  • operation=docs
  • warnings

利用可能な場合は、以下のフィールドを含めることを推奨します。

  • docs_created（パスの一覧）
  • docs_updated（パスの一覧）
  • docs_skipped_reason（該当する場合）
  • patterns_detected（一致したパターンの一覧）
フェーズ 6：セルフチェック

フォールバック：パターンが一致しなかったものの、技術的な側面に関するドキュメントが不足している場合は、domain_patterns.md のフォールバック戦略に従って MCP Ref を使用します。

完了の定義

  • ドキュメントの対象が特定されている
  • domain_patterns.md に基づいてパターン検出が実行されている
  • ドキュメントの変更が適用されているか、スキップの理由が示されている
  • review-docs サマリーが作成されている
  • セルフチェックに合格している

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

コメント

Markdown 対応