ln-781-build-verifier

路径： 文件路径（references/、../ln-*）均相对于此技能目录。

必须阅读： 加载 references/ci_tool_detection.md——构建命令注册表、退出代码保留规则和精简输出规则。

ln-781-build-verifier

类型： L3 Worker 类别： 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	获取 crate

第 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	success / failed
duration	构建耗时，单位为秒
outputPath	构建产物路径
errorMessage	失败时的错误详情

---

错误处理

错误类型	恢复操作
依赖项还原失败	检查网络，验证锁定文件完整性
编译错误	记录完整错误输出，并报告失败
缺少构建工具	报告所需安装的工具
超时	报告超时，并建议增加时限

---

关键规则

1. 始终先还原依赖项——缺少最新依赖项时，构建可能会失败
2. 使用 production/release 模式——开发构建可能会掩盖问题
3. 验证产物是否存在——退出代码成功并不足够
4. 报告所有项目——包括成功和失败的构建

---

监控（2.1.98+）： 对于预计耗时超过 30s 的构建/还原命令，请使用 Monitor。备用方案：Bash(run_in_background=true)。

完成标准

• 检测到所有项目类型
• 为每个项目还原依赖项
• 为每个项目执行构建
• 验证制品是否存在
• 将结果返回给协调器

---

参考文件

• 父级：../ln-780-bootstrap-verifier/SKILL.md

---

版本： 2.0.0 最后更新： 2026-01-10