agent-infra: Skill for Claude Code

完成人工验证

--agent 取值见 .agents/rules/task-management.md「合作者 token 规范」。

事务协调器统一追加 lifecycle 事件和 PR 摘要最终状态。维护者提供的验证说明和 PR 摘要留言就是人工验证依据；事务回执负责保证状态转换和恢复一致性。

行为边界 / 关键规则

持久化报告证据

生成验证完成报告时，先读取 .agents/rules/evidence-reporting.md。状态核对和同步结果记录命令、范围、结构化结果、实际结论和未覆盖部分；继续遵守人工验证的 basename-only 与 sanitized result 脱敏边界。

• 本技能用于收尾已有 PR 摘要评论中的人工校验状态，不创建并行的普通验证留言。
• 必须写入 manual-validation.md 或 manual-validation-r{N}.md，让后续 PR 摘要刷新可复用人工验证结果。
• 找不到 sync-pr 摘要评论时失败，不创建部分摘要兜底；receipt、通过日志和 final summary 未全部提交前，远端只允许 pending/non-pass 状态。
• 生成会由 task 评论和 PR 摘要引用的人工验证 artifact Markdown 前，先读取 .agents/rules/sync-content-generation.md 并遵循其中的生成端约束；人工验证 artifact 保留在本地，不发布为 Issue artifact 评论。
• 执行本技能后必须立即更新 task.md。

版本戳规则：创建或更新 task.md frontmatter 时，先读取 .agents/rules/version-stamp.md，并写入或刷新 agent_infra_version。

第 0 步：状态核对（执行前硬约束）

在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前，必须先执行状态核对。指令类文件读取不算对外动作或结论。

运行以下命令，并在本轮产物的 ## 状态核对 段记录任务/产物范围、关键结果和未覆盖部分；正常成功不粘贴完整目录清单或 task.md 尾部。失败、阻塞、身份不一致或争议时，附决定性原文行：

agent-infra-internal task-snapshot {task-id} --format text

任务上下文解析

入口可省略 task ref；显式 task scope 仅接受 --task <ref> 或 -t <ref>，不再解释位置 task ref。保留其余业务操作数后调用 agent-infra-internal task-context resolve {task-scope}；{task-scope} 为空或 task flag 之一。只读取结构化结果的 taskId，后续把 {task-id} 绑定为完整 TASK-YYYYMMDD-HHMMSS。解析失败时透传非零退出码，不自行扫描任务。

解析任务引用，并确认任务位于本技能支持的状态或目录且存在 task.md；无法定位时按未找到任务处理并停止。

执行步骤

1. 解析入参

输入格式：

complete-manual-validation [--task <ref> | -t <ref>] [{pr-ref}] {verification-summary}

• task scope 可省略；显式 scope 只接受 --task <ref> 或 -t <ref>。
• {pr-ref} 可选，支持 #NN、NN 或完整 PR URL。
• {verification-summary} 必填。若缺失，立即停止并提示补充验证说明；不写产物、不更新 PR。

2. 验证前置条件

检查：

• <task-workspace>/active/{task-id}/task.md
• 有效 PR：优先使用显式 {pr-ref}，否则读取 task.md frontmatter 的 verified pr_delivery_fact.identity.number

如果任务不存在、验证说明缺失，或无法解析有效 PR，立即停止。

3. 解析产物上下文

运行 agent-infra-internal task-artifact {task-id} inspect --family manual-validation。仅当结果为 ready 时继续；从 next.round / next.name 取得本轮 round 与 {manual-validation-artifact}。不得自行扫描轮次或拼装文件名。事务协调器负责 started 事件。