task-acceptance

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。

# 检查各仓库的 git log
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 格式：

# 检查每个相关 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*