# 研发交付验收流程

> 状态：当前有效
> 建立日期：2026-05-30
> 适用范围：Aligner 每个涉及代码实现、脚本实现、构建产物或用户可见行为变更的开发事项。
> 任务记录入口：`/Users/ar/Projects/Aligner/02-P/GTD.md`

## 流程定义

“按流程”指每个开发事项完成后，必须依次通过以下关卡：

```text
开发实现
  -> 开发自查
  -> 代码审核员复审
  -> 修复审核问题
  -> QA 自动化测试 / 半自动测试
  -> 修复 QA 问题
  -> 记录验收证据
  -> 需要用户真机验收时再通知 Boss
```

只有代码审核和 QA 都通过，事项才允许在 `GTD.md` 中标记为完成。

## 角色责任

| 关卡 | 责任角色 | 产出 |
|---|---|---|
| 开发实现 | coder / 开发 | 代码、脚本、构建产物或文档变更 |
| 开发自查 | coder / 开发 | 本地构建、测试、边界检查结论 |
| 代码审核 | 代码审核员 / 架构师 | PASS 或带优先级的问题清单 |
| QA 验证 | QA | 自动化测试、半自动测试、手测矩阵执行记录 |
| 最终真机验收 | Boss | 仅在 QA 判断需要用户真实体验确认时介入 |

## 执行规则

- 一个事项一个事项推进；未通过当前事项的审核和 QA 前，不把它标记为完成。
- 代码审核员发现问题时，回到开发修复；修复后必须再次审核。
- QA 发现问题时，回到开发修复；修复后必须再次执行相关 QA。
- 自动化能覆盖的优先自动化；窗口层级、全屏、双屏、Split View、系统关键窗口等真实 macOS 场景可使用半自动或手测矩阵补足。
- 用户不作为常规 QA；用户是最后一个验收者，只在 QA 认为需要真机体验确认时通知。
- 每个事项的状态、责任角色、Review 角色、QA 结论和关键证据应记录在 `GTD.md` 对应 Round / 会议 / Todo 下。

## 状态记录规范

`GTD.md` 是当前唯一 Todo 扎口文件。任务状态使用以下格式：

- `[ ]`：todo。
- `[ ] [in-progress]`：正在处理。
- `[x]`：代码审核和 QA 均已通过，可以视为完成。
- `[ ]（状态：canceled）`：取消。
- `[ ]（状态：delayed）`：延期或卡住。

每个可执行 Todo 尽量写明：

- `Owner`：主责任角色。
- `Review`：审核角色。
- `QA`：QA 结论或待执行项。
- `产物`：代码、脚本、文档或构建产物路径。
- `证据`：测试命令、报告、截图、trace 或关键输出摘要。

## 当前配套依据

- `/Users/ar/Projects/Aligner/02-P/GTD.md`：统一 Todo、状态和验收证据入口。
- `/Users/ar/Projects/Aligner/02-P/AGENTS.md`：过程文档规则，要求测试计划和验收记录写入当前 Round 的 QA 区域，长期流程经验沉淀到 `03-O/K2.项目管理/`。
- `/Users/ar/.codex/rules/qa-workflow.md`：QA 通用规则，要求覆盖真实用户节奏、窗口层级、过渡过程和可复核证据。
- 当前 Round 的 PRD / QA / 架构文档：定义本轮范围、验收口径和具体测试矩阵。

## 废除旧流程说明

`03-O/K2.项目管理/round-workflow.md`、`03-O/K2.项目管理/code-review-checklist.md`、`03-O/K2.项目管理/团队协作规范.md` 文件头已标记 `X-已废除`，只作为历史参考，不作为当前流程依据。