ln-781-build-verifier

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

必ず読むこと： references/ci_tool_detection.md を読み込みます。ビルドコマンドレジストリ、終了コードの保持、簡潔な出力のルールが記載されています。

ln-781-build-verifier

種類： L3 ワーカー カテゴリ： 7XX プロジェクトのブートストラップ

---

目的

プロジェクトの種類を検出し、依存関係を復元してビルドを実行し、コンパイルの成功を検証します。

対象範囲：

• ファイルマーカーからプロジェクトの種類を自動検出します
• 適切なパッケージマネージャーを使用して依存関係を復元します
• 各プロジェクトのビルドコマンドを実行します
• ビルド成果物の存在を検証します

対象外：

• テストの実行（ln-782 が担当します）
• コンテナー操作（ln-783 が担当します）
• ワークフローのオーケストレーション（ln-780 が担当します）

---

使用するタイミング

シナリオ	このスキルを使用
単独で使用可能	はい
単独でのビルド検証	はい
CI/CD パイプラインのビルドステップ	はい
テストの実行が必要	いいえ。ln-782 を使用

---

ワークフロー

ステップ 1：プロジェクトの種類を検出する

プロジェクトのルートで種類を示すマーカーをスキャンします。

マーカーファイル	プロジェクトの種類	ビルドシステム
package.json	Node.js/フロントエンド	npm/yarn/pnpm
*.csproj	.NET	dotnet
setup.py / pyproject.toml	Python	pip/poetry
go.mod	Go	go build
Cargo.toml	Rust	cargo
pom.xml	Java/Maven	mvn
build.gradle	Java/Gradle	gradle

ステップ 2：依存関係を復元する

検出されたプロジェクトごとに、ビルド前に依存関係を復元します。

プロジェクトの種類	依存関係の復元
Node.js	ロックファイルからパッケージをインストール
.NET	NuGet パッケージを復元
Python	requirements または pyproject からインストール
Go	モジュールをダウンロード
Rust	クレートを取得

ステップ 3：プロジェクトをビルドする

各プロジェクトの種類で、Release/Production モードのビルドを実行します。

プロジェクトの種類	ビルドモード	想定される結果
Node.js	Production	dist/ または build/ にバンドル済みアセットが生成される
.NET	Release	bin/Release/ にコンパイル済み DLL が生成される
Python	編集可能インストール	パッケージが環境にインストールされる
Go	Production	コンパイル済みバイナリが生成される
Rust	Release	target/release/ に最適化済みバイナリが生成される

ステップ 4：ビルド成果物を検証する

ビルド出力が存在することを確認します。

プロジェクトの種類	成果物の確認
Node.js	dist/ または build/ ディレクトリが存在し、ファイルが含まれている
.NET	bin/Release/{framework}/ に DLL ファイルがある
Python	パッケージをインポートできる
Go	実行可能なバイナリが存在する
Rust	target/release/ にバイナリがある

ステップ 5：結果を報告する

オーケストレーターに構造化された結果を返します。

結果の構造：

フィールド	説明
projectName	プロジェクト名
projectType	検出された種類（nodejs、dotnet、python など）
status	成功 / 失敗
duration	ビルド時間（秒）
outputPath	ビルド成果物のパス
errorMessage	失敗時のエラー詳細

---

エラー処理

エラーの種類	復旧アクション
依存関係の復元に失敗	ネットワークを確認し、ロックファイルの整合性を検証します
コンパイルエラー	エラー出力全体を記録し、失敗として報告します
ビルドツールが見つからない	必要なツールのインストールを報告します
タイムアウト	タイムアウトを報告し、制限時間の延長を提案します

---

重要なルール

1. 必ず最初に依存関係を復元する - 依存関係が最新でないと、ビルドに失敗することがあります
2. Production/Release モードを使用する - 開発ビルドでは問題が隠れることがあります
3. 成果物の存在を確認する - 終了コードが成功でも、それだけでは不十分です
4. すべてのプロジェクトを報告する - 成功したビルドと失敗したビルドの両方を含めます

---

モニター（2.1.98+）： 30 秒を超えると予想されるビルド／復元コマンドには、Monitor を使用します。フォールバック：Bash(run_in_background=true)。

完了の定義

• すべてのプロジェクトタイプが検出されている
• 各プロジェクトの依存関係が復元されている
• 各プロジェクトのビルドが実行されている
• 成果物の存在が確認されている
• 結果がオーケストレーターに返されている

---

参照ファイル

• 親: ../ln-780-bootstrap-verifier/SKILL.md

---

バージョン: 2.0.0 最終更新日: 2026-01-10