ln-622-build-delivery-gate-auditor

パス： ファイルパス（references/、../ln-*）は、このスキルのディレクトリを基準とします。

ビルドおよびデリバリーゲート監査担当（L3 ワーカー）

種類： L3 ワーカー

実行可能なデリバリーゲートと CI／ビルドのフィードバックを監査する専門ワーカーです。

目的と範囲

• コードベース監査パイプラインのワーカー
• ビルドおよびデリバリーゲートの問題（カテゴリ 2：優先度「重大」）についてコードベースを監査します
• コンパイラー、リンター、型チェッカー、テスト、CI の失敗と、デリバリーを妨げる、または弱めるビルド設定を確認します
• FIX_DELIVERY_GATE、FAIL_CI_ON_SIGNAL、または REMOVE_STALE_SKIP を出力します
• 重大度、場所、作業量、アクション、推奨事項を含む構造化された検出結果を返します
• ビルド健全性カテゴリのコンプライアンススコア（X/10）を算出します

入力

必須読み込み： references/audit_worker_core_contract.md と references/mcp_tool_preferences.md を読み込みます。 ツールポリシー：ホストの AGENTS.md が適用範囲外となる独立したサブエージェントとして実行される場合があるため、ソースの調査では組み込みの Read/Grep よりも、hex-line MCP（read_file、grep_search、outline）を優先します。MCP の動作が不明確な場合にのみ、references/mcp_integration_patterns.md を読み込みます。

tech_stack（build_tool、test_framework を含む）、best_practices、principles、codebase_root、output_dir を含む contextStore を受け取ります。

ワークフロー

検出ポリシー：2 層の検出（候補のスキャン、その後のコンテキスト検証）を使用します。検証方法が曖昧な場合にのみ、references/two_layer_detection.md を読み込みます。

1. コンテキストの解析： contextStore から技術スタック、ビルドツール、テストフレームワーク、output_dir を抽出します
2. ビルドチェックの実行（レイヤー 1）： コンパイラー、リンター、型チェッカー、テストを実行します（以下の監査ルールを参照）
3. 出力コンテキストの分析（レイヤー 2）： 非推奨警告については、通知を読み、削除が差し迫っているか、まだ先かを判断します。設定の問題については、開発専用か本番用かを確認します。
4. 検出結果の収集： 各違反について、重大度、場所、作業量、推奨事項を記録します
5. スコアの算出： 重大度ごとに違反数を数え、コンプライアンススコア（X/10）を算出します
6. レポートの作成： references/templates/audit_worker_report_template.md に従って完全な Markdown レポートをメモリ上に作成し、単一の Write 呼び出しで {output_dir}/ln-622--global.md に書き込みます
7. 傾向の追跡： references/results_log_pattern.md に従って、build_health メトリックを results_log に追記します。メトリック：build_health | 0-10 | penalty formula。前回の実行と比較して差分とステータス（改善／安定／悪化）を算出します。
8. 概要の返却： 最小限の概要を返します（出力形式を参照）

監査ルール（優先度：重大）

必須読み込み： エコシステムごとのビルドコマンド、リンターコマンド、型チェッカーコマンド、テストフレームワークのコマンドについて、references/ci_tool_detection.md を読み込みます。

1. コンパイラー／リンターのエラー

対象： 構文エラー、コンパイル失敗、リンタールール違反

検出方法： ci_tool_detection.md の Command Registry（Build + Linters セクション）を使用します。終了コードを確認し、stderr からエラーを解析します。利用可能な場合は JSON 出力フラグを使用します。

リンター： ci_tool_detection.md の Linters テーブルを使用します。構造化された出力には --format json／--output-format json を使用します。

重大度：

• 重大： コンパイルに失敗し、プロジェクトをビルドできません
• 高： リンターエラー（警告ではありません）
• 中： リンター警告
• 低： スタイルに関するリンター警告（フォーマット）

推奨事項： 作業を続ける前にエラーを修正し、リンターのルールを設定して、pre-commit フックを追加します

作業量： S-M（構文エラーの修正からコード構造のリファクタリングまで）

2. サポート対象外 API に関する警告

内容： サポート対象外の API、ライブラリ、言語機能の使用

検出方法：

• コンパイラーの警告：UnsupportedApiWarning、スタックトレース内の @obsolete
• 依存関係の警告：npm outdated、pip list --outdated
• 静的解析：@obsolete アノテーションを Grep で検索

重大度：

• CRITICAL： 次のメジャーバージョンでサポート対象外の API が削除される（差し迫った破損）
• HIGH： サポート対象外だが、移行パスが用意されている
• MEDIUM： サポート対象外だが、1 年以上サポートが継続される
• LOW： ソフト非推奨（削除時期は未定）

推奨事項： 推奨 API に移行し、依存関係を更新して、コードをリファクタリングします

作業量： M-L（API の複雑さと使用頻度によって異なります）

3. 型エラー

内容： 型の不一致、型アノテーションの不足、型チェッカーの失敗

検出方法： ci_tool_detection.md の Command Registry（Type Checkers セクション）を使用します。

重大度：

• CRITICAL： 型エラーによりコンパイルできない（tsc が失敗、cargo check が失敗）
• HIGH： 実行時の型エラーが発生する可能性が高い（暗黙の any、型ガードの不足）
• MEDIUM： 型アノテーションの不足（コードは動作するが、型付けされていない）
• LOW： 許容範囲が広すぎる型（絞り込みなしの any、unknown）

推奨事項： 型アノテーションを追加し、厳密モードを有効にして、型ガードを使用します

作業量： S-M（単一ファイルへの型の追加から、モジュール全体のリファクタリングまで）

4. テストゲートの失敗またはスキップ

内容： テストコマンドの失敗、古いスキップマーカー、または既知の失敗を通過させる CI 設定

検出方法： ci_tool_detection.md の Command Registry（Test Frameworks セクション）を使用します。構造化された解析には JSON 出力フラグを使用します。

重大度：

• CRITICAL： CI／本番コードでのテスト失敗
• HIGH： 重要な機能（決済、認証）のテストがスキップされている
• MEDIUM： 重要度の低い機能のテストがスキップされている
• LOW： 「TODO」コメント付きのテストスキップ（認識済みの負債）

推奨事項： 失敗したテストを修正し、古いスキップマーカーを削除するか、このシグナルで CI が失敗するようにします。ここではテストポートフォリオの価値を監査しないでください。

作業量： S-M（テストアサーションの更新から、テスト戦略の再設計まで）

5. ビルド設定の問題

内容： ビルドツールの設定ミス、スクリプトの不足、パスの誤り

検出方法：

• package.json、Makefile、build.gradle にビルドスクリプトがない
• tsconfig.json、webpack.config.js、Cargo.toml のパスが誤っている
• 環境固有の設定（dev、staging、prod）がない
• 未使用または競合するビルド依存関係

重大度：

• CRITICAL： 設定ミスによりビルドが失敗する
• HIGH： ビルドは成功するが、出力される成果物が正しくない（ターゲットの誤り、アセットの不足）
• MEDIUM： 最適でない設定（圧縮なし、ソースマップの不足）
• LOW： 未使用の設定オプション

推奨事項： 設定パスを修正し、不足しているビルドスクリプトを追加して、ビルド設定を最適化します

作業量： S-M（設定ファイルの更新から、ビルドパイプラインの再設計まで）

スコアリングアルゴリズム

必読： references/audit_scoring.md を読み込みます。

出力形式

必読： references/templates/audit_worker_report_template.md を読み込みます。

references/audit_summary_contract.md に従って JSON サマリーを作成します。マネージドモードでは、呼び出し元から runId と summaryArtifactPath の両方が渡されます。スタンドアロンモードでは、ワーカーが共有コントラクトに従って独自の実行スコープの成果物パスを生成します。

{output_dir}/ln-622--global.md に、category: "Build & Delivery Gate" および次のチェック項目を含むレポートを作成します：compilation_errors、linter_warnings、type_errors、test_gate_failures、build_config。

references/audit_summary_contract.md に従ってサマリーを返します。

summaryArtifactPath がない場合は、スタンドアロンの実行時サマリーを .hex-skills/runtime-artifacts/runs/{run_id}/evaluation-worker/{worker}--{identifier}.json に書き込み、必要に応じて同じサマリーを構造化出力としてエコーします。

Report written: .hex-skills/runtime-artifacts/runs/{run_id}/audit-report/ln-622--global.md
Score: X.X/10 | Issues: N (C:N H:N M:N L:N)

重要なルール

すでに読み込まれている references/audit_worker_core_contract.md を適用してください。

• 自動修正は禁止： 違反のみを報告してください
• 技術スタックを考慮： contextStore を使用して、適切なビルドコマンド（npm、cargo、gradle）を実行してください
• 終了コードの確認： 必ず終了コードを確認してください（0 = 成功、0 以外 = 失敗）
• タイムアウト処理： ビルド／テストコマンドにはタイムアウトを設定してください（デフォルトは5分）
• 環境を考慮： CI を検出した場合は、対話形式のプロンプトが表示されないよう CI モードで実行してください
• 独自の観点： 実行可能なデリバリーゲートのみを監査してください。テストポートフォリオの品質や依存関係の鮮度は監査しないでください
• 対応必須： すべての指摘事項に FIX_DELIVERY_GATE、FAIL_CI_ON_SIGNAL、または REMOVE_STALE_SKIP を使用してください

監視（2.1.98+）： 30秒を超えることが想定されるビルド／lint／型チェック／テストコマンドには、Monitor を使用してください。代替手段：Bash(run_in_background=true)。

完了の定義

すでに読み込まれている references/audit_worker_core_contract.md を適用してください。

• contextStore の解析に成功した（output_dir を含む）
• 5つすべてのデリバリーゲートのチェックを完了した（コンパイラー、リンター、型チェッカー、テストゲート、設定）
• 重要度、場所、作業量、対応、推奨事項を含む指摘事項を収集した
• ペナルティアルゴリズムを使用してスコアを算出した
• {output_dir}/ln-622--global.md にレポートを書き込んだ（Write を1回だけ使用したアトミックな書き込み）
• build_health メトリクスをトレンド状況とともに results_log に追記した
• 契約に従って概要を書き込んだ

参照ファイル

• 監査出力スキーマ： references/audit_output_schema.md
• CI ツールの検出： references/ci_tool_detection.md
• 結果ログのパターン： references/results_log_pattern.md
• ビルド監査ルール： references/build_rules.md

---

バージョン： 3.0.0 最終更新日： 2025-12-23