用途
ln-780-bootstrap-verifier 是一个 L2 领域协调器（Domain Coordinator），属于 7XX 项目引导分类，父级为 ln-700-project-bootstrap。其目的是编排最终的引导验证流水线：将工作委派给专门的工作技能，并把结果聚合为一份综合报告。
主要能力
- 协调构建、测试与容器验证三个阶段
- 聚合所有工作技能返回的结果
- 生成最终验证报告
不在范围内的事项：
- 直接执行构建、测试或容器操作（这些委派给工作技能）
- 创建项目结构（由更早的阶段处理）
使用方式
何时使用
- 在 ln-700 完成项目设置之后：使用本技能
- 仅做独立构建验证：不使用本技能，直接使用 ln-781
- 仅做手动测试：不使用本技能，直接使用 ln-782
- 仅启动容器：不使用本技能，直接使用 ln-783
工作流程
阶段 1：预检（Pre-flight Checks）
在启动验证流水线前确认环境就绪。检查项包括：
- Docker 是否安装：检查 docker 命令是否可用；失败则报告错误并跳过容器阶段
- Docker Compose：检查 docker compose 版本；失败则报告错误并跳过容器阶段
- 项目结构：扫描 package.json、*.csproj、docker-compose.yml；据此调整工作流以适配检测到的组件
- 端口可用性：检查所需端口是否空闲；若被占用则警告用户并建议替代方案
阶段 2：构建验证
委派给 ln-781-build-verifier。传入检测到的项目类型，收集构建结果（状态、耗时、输出路径）。若失败：收集错误日志，进入报告阶段（跳过测试与容器阶段）。
阶段 3：测试验证
委派给 ln-782-test-runner。传入构建结果作为上下文，收集测试结果（总数、通过、失败、耗时）。若失败：收集失败详情，可选择继续进入容器阶段。
阶段 4：容器启动
委派给 ln-783-container-launcher。传入项目配置，收集容器状态与健康检查结果。若失败：收集容器日志。
阶段 5：报告生成
将所有结果聚合为最终验证报告。报告包含以下部分：
- 构建结果：每个项目的状态、耗时、输出路径
- 测试结果：每个测试套件的总数、通过数、失败数
- 容器状态：每个容器的名称、状态、端口、健康情况
- 健康检查：每个端点的 URL、状态码、响应时间
- 后续步骤：给用户的可执行事项
TodoWrite 格式（强制）：
- Pre-flight checks (in_progress)
- Invoke ln-781-build-verifier (pending)
- Invoke ln-782-test-runner (pending)
- Invoke ln-783-container-launcher (pending)
- Generate verification report (pending)
工作技能调用（强制）
宿主技能调用：Skill(skill: "...", args: "...") 是强制委派方式。
- Claude：严格按所示方式调用 Skill 工具。
- Codex：若不存在 Skill 工具，则在可用技能中定位指定技能，读取其 SKILL.md，将 args 视为 $ARGUMENTS，执行该技能工作流，然后带着其结果/产物返回此处。
不得内联工作技能逻辑，也不得在未执行目标技能的情况下将工作技能标记为完成。
各阶段与工作技能对应关系：
- 阶段 2：ln-781-build-verifier，共享（Skill 工具）——针对检测到的项目类型进行构建验证
- 阶段 3：ln-782-test-runner，共享（Skill 工具）——执行测试套件
- 阶段 4：ln-783-container-launcher，共享（Skill 工具）——容器启动与健康检查
所有工作技能均通过 Skill 工具调用，工作技能可看到协调器上下文。
必须顺序执行：构建 -> 测试 -> 容器。
调用示例：
Skill(skill: "ln-781-build-verifier", args: "{detected_project_types}") Skill(skill: "ln-782-test-runner", args: "{build_status}") Skill(skill: "ln-783-container-launcher", args: "{compose_file_path}")
关键规则
- 绝不直接执行构建、测试或容器——始终委派给工作技能
- 构建错误时快速失败——跳过测试与容器阶段
- 始终生成报告——即使失败，也要包含已收集的数据
- 先做预检——在开始前发现环境问题
选项
- runTests：默认 true，执行测试阶段
- skipTestsOnFailure：默认 false，测试失败时是否继续进入容器阶段
- startContainers：默认 true，执行容器阶段
- keepContainersRunning：默认 true，验证后保持容器运行
- healthCheckTimeout：默认 120，等待容器健康的最长秒数
完成定义（Definition of Done）
- 所有检测到的项目类型均构建成功
- 所有测试套件均已执行（若启用）
- 所有容器均健康（若启用）
- 已生成验证报告并展示给用户
- 已提供后续步骤
参考文件
- 工作技能：../ln-781-build-verifier/SKILL.md
- 工作技能：../ln-782-test-runner/SKILL.md
- 工作技能：../ln-783-container-launcher/SKILL.md
元分析
可选参考：仅当用户要求运行后元分析或协议格式的运行反思时，加载 references/meta_analysis_protocol.md。
技能类型：review-coordinator — workers only。当被请求时，在所有阶段完成后运行。使用 review-coordinator — workers only 格式输出到聊天。
版本：2.0.0 最后更新：2026-01-10
适用场景
适用于在 ln-700 完成项目引导后，对项目搭建完整性进行端到端验证，包括构建、测试与容器健康检查。
限制
本技能不直接执行构建、测试或容器操作，也不负责创建项目结构；这些分别由工作技能和更早阶段处理。若只需单项验证，应直接使用对应的工作技能。