mcpField
L
ln-610-docs-auditor

ln-610-docs-auditor

github.com/levnikolaevichドキュメント584315 回インストール2 日前に更新
リポジトリ

ln-610-docs-auditor について

文書構造、内容、コメント、事実の正確性を確認するチーム向けの、文書監査を統括する L2 コーディネーターです。4 つの専門ワーカーに委任し、調査に基づく基準を最終評価に求めます。

主な機能

  1. 01文書構造と関連性のレビュー
  2. 02意味内容とコードコメントの確認
  3. 03文書に記載された事実の検証
  4. 044 つの専門監査ワーカーの統括
  5. 05所見の集約と改善レポートの作成

活用シーン

  1. 01複数の文書領域にまたがる監査の実施
  2. 02調査資料に基づく文書上の問題の検証
  3. 03ワーカー結果の集約と改善計画の策定

インストール

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

$npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-610-docs-auditor

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

同梱ファイル

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

references/
audit_final_report_contract.md
epistemic_protocol.md
evaluation_coordinator_runtime_contract.md
evaluation_research_contract.md
evaluation_summary_contract.md
meta_analysis_protocol.md
research_tool_fallback.md

詳細

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

タイプ: L2 コーディネーター カテゴリー: 6XX 監査

ドキュメント監査

必読

必読: references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md、references/evaluation_research_contract.md を読み込んでください。 必読: references/audit_final_report_contract.md を読み込んでください。 必読: references/research_tool_fallback.md を読み込んでください。 条件付きで読む:情報源の信頼度または主張の不確実性が問題の検証に影響する場合に限り、references/epistemic_protocol.md を読み込んでください。

目的

  • ドキュメントの構成、関連性、コメント、事実の正確性を監査します
  • ln-611、ln-612、ln-613、ln-614 を調整します
  • 最終評価の前に、調査に裏付けられた基準を必須とします

ランタイム契約

ランタイムファミリー:

  • evaluation-runtime

識別子:

  • docs-audit

フェーズの順序:

  1. PHASE_0_CONFIG
  2. PHASE_1_DISCOVERY
  3. PHASE_2_RESEARCH
  4. PHASE_3_DELEGATE
  5. PHASE_4_AGGREGATE
  6. PHASE_5_REPORT
  7. PHASE_6_SELF_CHECK

ワーカーセット

  • ln-611-docs-structure-auditor
  • ln-612-semantic-content-auditor
  • ln-613-code-comments-auditor
  • ln-614-docs-fact-checker

ワーカーの呼び出し(必須)

ホストスキルの呼び出し: Skill(skill: "...", args: "...") による委任が必須です。

  • Claude:Skill ツールを、表示どおりに呼び出してください。
  • Codex:Skill ツールがない場合は、利用可能なスキルから指定されたスキルを探し、その SKILL.md を読み込み、args を $ARGUMENTS として扱ってスキルのワークフローを実行し、その結果または成果物を持ってここに戻ってください。
  • ワーカーのロジックをインラインで記述したり、対象スキルを実行せずにワーカーを完了扱いにしたりしないでください。

委任するワーカーには Skill ツールを使用してください。コーディネーター内にワーカーのロジックをインラインで記述しないでください。

TodoWrite の形式(必須):

  • Resolve audit scope and build manifest
  • Load project documentation tree
  • Run best-practice research
  • Delegate to domain audit workers
  • Aggregate worker findings
  • Generate final audit report and remediation plan
  • Verify cleanup and self-check

呼び出し例:

Skill(skill: "ln-611-docs-structure-auditor", args: "{scope}")
Skill(skill: "ln-612-semantic-content-auditor", args: "{scope}")
Skill(skill: "ln-613-code-comments-auditor", args: "{scope}")
Skill(skill: "ln-614-docs-fact-checker", args: "{scope}")

ワークフロー

フェーズ 0:設定

required_research=true を指定して evaluation-runtime を開始します。

フェーズ 1:検出

ドキュメントの対象範囲と監査範囲を特定します。

フェーズ 2:調査

必須の調査情報源:

  1. 公式ドキュメントまたは標準規格
  2. MCP Ref
  3. フレームワークのドキュメントが関係する場合は Context7
  4. 最新のウェブ上のベストプラクティス調査
フェーズ 3:委任

専門の監査ワーカーに委任します。

子ワーカーは evaluation-worker-runtime を使用し、evaluation-runtime を通じて記録された、評価に対応した要約を出力する必要があります。

フェーズ 4:集約

ワーカーの要約を統合し、ドキュメント監査結果を一つにまとめます。すべてのワーカーの report_path を読み、問題点を標準化し、重複する問題を統合したうえで、対応が必要な各問題を references/evaluation_research_contract.md に記載された情報源の順序に従って検証します。

フェーズ 5:レポート

references/audit_final_report_contract.md に従い、.hex-skills/runtime-artifacts/runs/{run_id}/audit-report/ln-610--final-report.md を作成します。修正計画、確認済みの各問題を裏付ける情報源による検証、およびクリーンアップに関する注記を含めてください。統合後、一時的なワーカーの Markdown レポートを削除してください。evaluation-coordinator の要約の report_path は、最終レポートのみを指す必要があります。

フェーズ 6:セルフチェック

必須の確認項目:

  • 必須の調査を完了した
  • すべてのワーカーの要約を記録した
  • 集約した要約が存在する
  • 最終的な修正レポートを作成した
  • 一時的なワーカーの Markdown レポートを削除した
  • クリーンアップを確認した
  • コーディネーターの要約を記録した

要約の契約

summary_kind=evaluation-coordinator として記述します。

完了の定義

  • 評価ランタイムが起動している
  • 調査が完了している
  • すべてのドキュメント監査ワーカーが完了している
  • 集約が完了している
  • 最終レポートと修正計画が作成されている
  • 一時的なワーカーマークダウンレポートが削除されている
  • evaluation-coordinator の概要が作成されている
  • ランタイムが完了している

メタ分析

参考資料(任意):ユーザーが実行後のメタ分析またはプロトコル形式での実行振り返りを求めた場合に限り、references/meta_analysis_protocol.md を読み込みます。

コーディネーターの実行後に依頼された場合は、プロトコルのセクション 7 に従ってセッションを分析し、プロトコル形式の出力を最終的なドキュメント監査結果に含めます。

参考資料

  • ワーカー:../ln-611-docs-structure-auditor/SKILL.md、../ln-612-semantic-content-auditor/SKILL.md、../ln-613-code-comments-auditor/SKILL.md、../ln-614-docs-fact-checker/SKILL.md

バージョン: 5.0.0 最終更新日: 2026-03-01

コメント