mcpField
L
ln-620-codebase-auditor

ln-620-codebase-auditor

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

ln-620-codebase-auditor について

ln-620-codebase-auditorは、コードベースとランタイムのリスクを監査するコーディネータースキルです。9つの専門ワーカーに作業を委任し、調査に基づいて評価したうえで、修正計画を含むレポートをまとめます。

主な機能

  1. 01ln-621からln-629までのワーカーを調整
  2. 02セキュリティ、デリバリー、保守性のリスクを監査
  3. 03評価前に技術スタックに応じた調査を実施
  4. 04各ワーカーの調査結果を集約・重複排除
  5. 05最終レポートと修正計画を作成

活用シーン

  1. 01プロジェクトのランタイムとコードベースのリスク確認
  2. 02コード品質の複数領域にわたる監査の調整
  3. 03調査に基づく修正レポートの作成

MCP 対応

調査工程でMCP Refを参照するワークフローです。

インストール

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

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

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

同梱ファイル

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

references/
audit_final_report_contract.md
codebase_audit_worker_boundaries.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/codebase_audit_worker_boundaries.md を読み込みます。 必読: references/research_tool_fallback.md を読み込みます。 条件付きで読む:ソースの確信度または主張の不確実性が問題の検証に影響する場合に限り、references/epistemic_protocol.md を読み込みます。

目的

  • セキュリティ、デリバリーゲート、依存関係と再利用の健全性、保守性、デッドコード、診断可能性、並行処理、ライフサイクル、設定の検証など、ランタイム/コードベースのリスクを監査します
  • ln-621 から ln-629 までをすべて調整します
  • 評価前に、スタックを考慮した調査を必須とします

ランタイム契約

ランタイムファミリー:

  • evaluation-runtime

識別子:

  • codebase-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-621-security-boundary-auditor
  • ln-622-build-delivery-gate-auditor
  • ln-623-duplication-overabstraction-auditor
  • ln-624-code-maintainability-hotspot-auditor
  • ln-625-dependency-reuse-auditor
  • ln-626-dead-code-pruning-auditor
  • ln-627-diagnosability-auditor
  • ln-628-concurrency-correctness-auditor
  • ln-629-runtime-lifecycle-config-auditor

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

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

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

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

TodoWrite の形式(必須):

  • Resolve audit scope and build manifest
  • Load codebase structure and stack
  • 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-621-security-boundary-auditor", args: "{scope}")
Skill(skill: "ln-622-build-delivery-gate-auditor", args: "{scope}")
Skill(skill: "ln-623-duplication-overabstraction-auditor", args: "{scope}")
Skill(skill: "ln-624-code-maintainability-hotspot-auditor", args: "{scope}")
Skill(skill: "ln-625-dependency-reuse-auditor", args: "{scope}")
Skill(skill: "ln-626-dead-code-pruning-auditor", args: "{scope}")
Skill(skill: "ln-627-diagnosability-auditor", args: "{scope}")
Skill(skill: "ln-628-concurrency-correctness-auditor", args: "{scope}")
Skill(skill: "ln-629-runtime-lifecycle-config-auditor", args: "{scope}")

ワークフロー

フェーズ 0:設定

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

フェーズ 1:ディスカバリー

プロジェクトの種類、スタック、監査ワーカーの適用可否を特定します。

フェーズ 2:調査

必須の調査ソース:

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

適用可能な監査ワーカーに委任します。子ワーカーは evaluation-worker-runtime を使用し、評価互換のサマリーを出力する必要があります。

フェーズ 4:集約

references/codebase_audit_worker_boundaries.md に従って、ランタイム/コードベースのリスクに関する所見を統合します。すべてのワーカーの report_path を読み込み、対応策を標準化し、重複する問題を統合し、ワーカー間の矛盾を解決したうえで、references/evaluation_research_contract.md に記載された調査ソースの順序に従って、対応が必要な各問題を検証します。

フェーズ 5:レポート

references/audit_final_report_contract.md に従って、.hex-skills/runtime-artifacts/runs/{run_id}/audit-report/ln-620--final-report.md を作成します。修正計画、確認済みの各問題についてのソースに基づく検証、クリーンアップの注記を含めます。統合後、ワーカーが作成した一時的な Markdown レポートを削除します。evaluation-coordinator サマリーの report_path は、最終レポートのみを指す必要があります。

フェーズ 6:自己確認

必須チェック:

  • 調査が完了している
  • 該当するすべてのワーカーのサマリーが記録されている
  • codebase_audit_worker_boundaries.md に従ってワーカー間の競合が解決されている
  • 集約が完了している
  • 最終的な修正レポートが作成されている
  • クリーンアップが確認されている
  • ワーカーの一時的な Markdown レポートが削除されている
  • コーディネーターのサマリーが記録されている

サマリーの仕様

summary_kind=evaluation-coordinator として記述してください。

完了条件

  • 評価ランタイムが起動している
  • 該当するワーカーが選定されている
  • 調査が完了している
  • 該当するすべてのワーカーのサマリーが記録されている
  • ワーカーの構成が ln-621 から ln-629 までのまま変更されていない
  • codebase_audit_worker_boundaries.md に従ってワーカー間の競合が解決されている
  • 最終レポートと修正計画が作成されている
  • ワーカーの一時的な Markdown レポートが削除されている
  • evaluation-coordinator のサマリーが作成されている
  • ランタイムが完了している

メタ分析

任意の参照先:ユーザーが実行後のメタ分析またはプロトコル形式の実行振り返りを求めた場合に限り、references/meta_analysis_protocol.md を読み込んでください。

コーディネーターの実行後に求められた場合は、プロトコルのセクション 7 に従ってセッションを分析し、最終的なコードベース監査結果とともに、プロトコル形式の出力を含めてください。

参照先

  • ワーカー:../ln-621-security-boundary-auditor/SKILL.md、../ln-622-build-delivery-gate-auditor/SKILL.md、../ln-623-duplication-overabstraction-auditor/SKILL.md、../ln-624-code-maintainability-hotspot-auditor/SKILL.md、../ln-625-dependency-reuse-auditor/SKILL.md、../ln-626-dead-code-pruning-auditor/SKILL.md、../ln-627-diagnosability-auditor/SKILL.md、../ln-628-concurrency-correctness-auditor/SKILL.md、../ln-629-runtime-lifecycle-config-auditor/SKILL.md

バージョン: 5.0.0 最終更新日: 2025-12-23

コメント