← ClaudeAtlas

complete-manual-validationlisted

标记 PR 人工验证已完成,并原地更新 PR 摘要评论中的人工校验段落。 当维护者已完成真实环境或权限相关人工验证、需要统一收尾 PR 摘要时使用。 仅当对话包含可解析的任务引用时才可自动调用本技能。
fitlab-ai/agent-infra · ★ 84 · AI & Automation · score 80
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