ln-622-build-auditor

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

ビルドヘルス監査担当（L3 ワーカー）

タイプ： L3 ワーカー

ビルドの健全性とコード品質ツールを監査する専門ワーカーです。

目的と範囲

• コードベース監査パイプラインのワーカー
• コードベースの ビルドヘルスに関する問題（カテゴリ 2：優先度「重大」）を監査します
• コンパイラー／リンターのエラー、非推奨の警告、型エラー、テストの失敗、ビルド設定を確認します
• 重要度、場所、作業量、推奨事項を含む構造化された検出結果をコーディネーターに返します
• ビルドヘルスカテゴリのコンプライアンススコア（X/10）を算出します

入力

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

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

ワークフロー

検出ポリシー：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 レポートをメモリ上に作成し、1 回の Write 呼び出しで {output_dir}/ln-622--global.md に書き込みます
7. 傾向の追跡： references/results_log_pattern.md に従って、ビルドヘルスの指標を results_log に追記します。指標：build_health | 0-10 | penalty formula。前回の実行と比較して差分とステータス（改善／安定／悪化）を算出します。
8. 概要の返却： 最小限の概要をコーディネーターに返します（出力形式を参照）

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

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

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

内容： 構文エラー、コンパイルの失敗、リンタールール違反

検出： ci_tool_detection.md のコマンドレジストリ（ビルドおよびリンターのセクション）を使用します。終了コードを確認し、標準エラー出力からエラーを解析します。利用可能な場合は JSON 出力フラグを使用します。

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

重要度：

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

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

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

2. サポート対象外 API の警告

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

検出：

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

重要度：

• 重大： 次のメジャーバージョンで削除されるサポート対象外 API（差し迫った破損）
• 高： サポート対象外だが、移行パスがある
• 中： サポート対象外だが、1 年以上は引き続きサポートされる
• 低： ソフトな非推奨（削除時期の予定なし）

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

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

3. 型エラー

内容： 型の不一致、型注釈の欠落、型チェッカーの失敗

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

重大度：

• CRITICAL： 型エラーによりコンパイルできない（tsc が失敗、cargo check が失敗）
• HIGH： 実行時に型エラーが発生する可能性が高い（暗黙の any、型ガードの欠落）
• MEDIUM： 型注釈の欠落（コードは動作するものの、型が指定されていない）
• LOW： 制限が緩すぎる型（絞り込みを行わない any、unknown）

推奨事項： 型注釈を追加し、strict モードを有効にして、型ガードを使用します

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

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

内容： テストスイートの失敗、スキップされたテスト、テストカバレッジの不足

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

重大度：

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

推奨事項： 失敗したテストを修正し、スキップマーカーを削除して、不足しているテストを追加します

作業量： 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 Health" と、次のチェックを指定します：compilation_errors、linter_warnings、type_errors、test_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 モードで実行します（対話型プロンプトなし）

Monitor（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 呼び出しによるアトミックな書き込み）
• 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