task-verification

任务验证

本技能（Skill）是 buildr.task-verification/v4 的默认提供者。项目拥有测试代码、替身（fixture/mock）、构建脚本和环境；智能体（Agent）选择并调用 Maven、Gradle、npm、Playwright、Browser、HTTP 等真实工具。Buildr 只维护项目测试地图和开发完成后的任务验证报告，不生成计划或统一运行测试。

按本次目标进入

目标	读取与动作
选择已有检查	核对任务目标、真实改动和相关项目测试地图，按下节选择与执行；遇到服务绑定、外部代码库或位置诊断时读路径根与声明字段
维护测试地图	读地图写入步骤，依据实际构建、测试、脚本、持续集成（CI）和团队边界维护少量稳定测试体系；不在地图中逐项登记测试文件
查看或登记已有报告	读报告登记步骤；查看只执行 inspect，登记先核对已有结果适用性，不因登记重新调查测试体系或运行检查

项目测试地图位于 projects/<project>/verification.yml，使用 buildr.project-verification/v4。只选择检查或登记报告时不加载地图写入步骤；缺少测试时交给 project-testing 在实际改动范围内补齐，不在本技能中生成框架或测试。

选择与执行已有检查

先从 task inspect 的 record.brief 读取任务说明（Task Brief），对照其中的目标、必要范围、风险和完成依据决定需要哪些真实证明；独立于方案审查（Planning Review）、实现审查（Implementation Review）以及是否采用 OpenSpec。没有变更（Change）不代表无需验证，审查通过也不替代验证。确实不适用时通过工作摘要（Work Context）的 checks 结论显式留痕本次事实理由（task work-context record --check verification --check-status not-applicable --check-reason <理由>），不只留在对话或临时文本中；需要但未完成、没有报告、未执行或材料缺失不能写成不适用或已通过，不生成占位报告。

从改动追踪到用户实际使用的交付物（Artifact），核对受影响的公共行为、构建与资源依赖、安装或部署后入口及平台差异。先判断已有检查的内容、环境、目标和覆盖范围是否仍适用；复用有效结果，只补充新改动、失败或明确未解决风险所需的检查。保留原执行事实并说明复用依据，无法确认适用性的历史结果不作为当前成功证据。

需要执行时，智能体（Agent）直接调用项目工具。执行地图入口前重新读取当前地图的 locations 及根目录适用规则，在对应 ready 位置按声明的 argv 与解析后的 cwd 调用，保留项目拥有的包装命令（wrapper），不得简化为系统 PATH 上的裸 node 或 npm；kind: agent 按真实根和指引选择工具。路径根、服务范围和位置诊断的解释见声明字段。unavailable 只表示该族当前目录不可用，说明局部缺口并继续其他可执行检查，不使有效地图或已有真实结果失效。

优先运行相关检查。纯文档改动只选实际受影响的链接、渲染、资源引用或敏感信息检查，不默认捆绑编译、整组单元测试、架构或规范检查；文档确为可执行输入时保留其真实消费方验证。扩大到完整回归应有改动影响或明确未解决风险作为依据，不能只以默认组合或阶段名称解释；环境冒烟仅在目标适用、环境可用且已获授权时执行。必要的构建、安装后功能和平台检查应在开发完成前执行，不能仅因被归类为发布检查而推迟；优先复用真实入口和隔离环境，外部副作用仍遵守原有授权。

自动选择结果、测试名称、位置可用和命令成功都不能替代覆盖判断。完整入口必须覆盖测试族声明的范围；发现缺少测试、入口失配或漏选时，在授权范围内调整声明，或交给 project-testing 补齐并验证。运行中不改被验证源码，一次收集可独立执行的失败后集中报告；真实依赖阻塞的下游列为未执行。处理失败前先审视检查价值，按已有授权修复后只补失败与实际受影响的检查，不自动整套重跑。

开发中的临时反馈不写任务验证报告（Task Verification Report），不创建 Buildr 计划（Plan）、执行（Run）、执行记录（Execution Record）或流程状态。