| name | task-acceptance |
| description | PM task-level acceptance verification with full traceability. Use when the PM needs to verify completed work from team members, run acceptance on daily work assignments, or confirm deliverables before signing off — every acceptance decision must be traceable to specific criteria and verified deliverables. Triggers on keywords like "确认并验收", "验收一下", "verify and accept", "检查完成情况", "task acceptance", "任务验收". Covers per-task-assignment verification workflow with cross-worktree git checks, commit signature validation, and report data cross-validation. |
Task Acceptance
验收不是读报告，是逐项验证代码、测试、git commit 的真实存在。本技能与 [[task-traceability]] 协作，确保每次验收不走形式、不漏步骤、可追溯——每个 Go/No-Go 决策都可追溯到具体的验收标准和经过验证的交付物。
何时触发
- 用户说"确认并验收"、"验收一下"、"检查一下完成情况"
- 团队成员报告任务完成，PM 需要核实
- daily work assignment 文档中所有任务标记为已完成
- PM 准备签阶段验收报告
验收八步法
按顺序执行，每一步通过才进入下一步。任一步不通过 → 记录问题，最终 No-Go。
1. 读取工作分配文档
找到对应的任务分配文档（如 docs/pm/YYYY-MM-DD/daily-work-assignment.md），提取：
- 每个成员的任务清单和验收标准
- 预期的产出物路径
- 依赖链（谁依赖谁先完成）
2. 检查产出物是否存在
对每个成员，检查指定的产出目录下是否有对应的产出文件。
ls -la docs/{member}/YYYY-MM-DD/
如果报告引用了产出物但文件不存在 → P1 问题。
3. 验证代码变更真实存在
不要轻信报告中的描述。 对每项声称的代码修改，直接 grep 验证：
grep -n "<key-symbol>" <source-file-path>
grep -n "<new-value>" <spec-file-path>
grep "<old-value>" <spec-file-path>
如果代码变更不存在但报告声称已完成 → P0 问题（虚假报告）。
4. 运行测试验证数字
报告中的测试数字必须可复现：
<project-test-command> 2>&1 | tail -20
for f in <test-glob-pattern>; do
count=$(grep -c "test(" "$f")
echo "$f: $count tests"
done
将实际测试数与报告中的数字对比。不一致 → P2 问题（报告错误）。
5. 验证 git commit 真实存在
关键：如项目使用多个独立 git worktree 或子模块，必须在对应目录下检查 commit。
cd <subdir> && git log --oneline -10
对报告中引用的每个 commit hash：
cd <subdir> && git log --all --oneline | grep "^<commit-hash>"
如果 commit hash 不存在 → P0 问题（commits 未生成或引用了虚构 hash）。
同时检查工作区是否干净（git status）—— 如果有未提交的变更，成果可能未真正落盘。
6. 验证 commit message 格式
根据项目 CLAUDE.md 中的 Git Commit Rules 检查 commit message 格式：
cd <subdir> && git log --format="%B" <commit-hash> -1
格式不符合项目规范 → P1 问题（规范违规）。
amend 边界：如果 commit 未 push 到 remote，可 amend 修复；已 push 则必须新建 commit。
7. 交叉验证报告数据
报告中的数字必须自洽：
- 分项测试数相加是否等于合计？
- 表格是否有重复行？
- 截图数量是否与声称一致？
- 引用文件路径是否真实存在？
ls -la docs/{member}/YYYY-MM-DD/*.png
不一致 → P2 问题。
8. 产出验收报告
写入 PM 的验收报告文件（如 docs/pm/YYYY-MM-DD/acceptance-report.md），使用以下模板：
# 验收报告
> PM | YYYY-MM-DD | 验收范围：成员 A / 成员 B / ... 交付物
## 验收结论：Go / No-Go
（一句话结论 + 原因）
---
## 逐项验收
### 成员 A — 任务名称
| 检查项 | 预期 | 实际 | 结果 |
|--------|------|------|------|
| ... | ... | ... | ✅/❌/⚠️ |
### 成员 B — 任务名称
...
---
## 问题清单
| # | 严重度 | 问题 | 责任人 | 修复方案 |
|---|--------|------|--------|---------|
| 1 | P0/P1/P2 | 描述 | @name | 具体操作 |
---
## 验收完成标准重检
- [ ] 标准 1 ✅/❌
- [ ] 标准 2 ✅/❌
...
---
*PM — YYYY-MM-DD*
问题严重度分级
| 级别 | 定义 | 示例 |
|---|
| P0 | 虚假报告、代码变更不存在、commit 不存在 | 引用不存在的 commit hash |
| P1 | 规范违规、产出物缺失、签名格式错误 | commit 格式不符合项目要求 |
| P2 | 报告数据错误、表格笔误 | 测试数分项与合计不对应 |
验收标准：零问题才能签 Go。不做"条件通过"。
与其他技能的协作
- [[task-traceability]]：基础层。Accepter 严格遵循追溯 → 执行 → 映射 → 举证 → 记录的五步法。追溯全链产出和验收标准（Trace），逐项核实验收标准（Execute），映射交付物到验收标准（Map），提供代码检查、测试运行、git log 等证据（Evidence），签署验收报告并记录 Go/No-Go（Record）。零问题才能签 Go——不做条件通过。
- [[task-planning]]：Accepter 以 Planner 蓝图中的验收标准为核实基准。
- [[task-execution]]：Accepter 核验 Builder 的代码变更和 commit hash 是否真实存在。
- [[task-verification]]：Accepter 引用 Verifier 的报告，但不替代自己的独立核实。
- [[task-review]]：Accepter 依赖 Reviewer 的 Pass 结论。Review 不通过无须进入 Accept。
特别注意
- 外部阻塞不是缺陷：如外部依赖未就绪导致某些验收项无法执行，在报告中标注为外部阻塞，不计入问题清单，但须明确放行条件。
- worktree / 多仓库：如项目使用多个独立 git worktree 或子模块，git 操作必须
cd 到对应子目录执行。根目录的 git log 看不到子目录的 commit。
- 报告 ≠ 真相：报告中的 claim 必须可独立验证。如果某项验收标准无法复现（如需要外部系统产出），标记为 ⏸ Blocked，不打 ☑。
- commit 后验收：团队成员应在验收前完成 commit。如果发现未 commit，退回要求先 commit 再验收。
