complete-manual-validationlisted
Install: claude install-skill fitlab-ai/agent-infra
# 完成人工验证
> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」。
## 行为边界 / 关键规则
- 本技能用于收尾已有 PR 摘要评论中的人工校验状态,不创建并行的普通验证留言。
- 必须写入 `manual-validation.md` 或 `manual-validation-r{N}.md`,让后续 PR 摘要刷新可复用人工验证结果。
- 找不到 `sync-pr` 摘要评论时失败,不创建部分摘要兜底。
- 执行本技能后必须立即更新 `task.md`。
版本戳规则:创建或更新 `task.md` frontmatter 时,先读取 `.agents/rules/version-stamp.md`,并写入或刷新 `agent_infra_version`。
## 第 0 步:状态核对(执行前硬约束)
在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前,必须先执行状态核对。指令类文件读取不算对外动作或结论。
运行以下命令,并把原文粘贴到本轮产物的 `## 状态核对` 段:
```bash
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`;无法定位时按未找到任务处理并停止。
## 步骤开始:声明 started 事件
确���前置条件和产物上下文后、本轮第一个产出动作之前执行 `agent-infra-internal task-event {task-id} manual-validation.started --agent {standard-agent-token}`,并以返回的 `artifactContext` 记录本轮身份。
## 执行步骤
### 1. 解析入参
输入格式:
```text
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. 验证前置条件
检查:
- `.agents/workspace/active/{task-id}/task.md`
- 有效 PR:优先使用显式 `{pr-r