统一任务执行与验收规范
版本：v1.0 · 日期：2026-10-24 · 适用于本实施计划内所有后续实施任务（Agent 执行与人工执行同规）。 授权分级定义见 docs/21 附录 A。
1. 任务规范模板
每项实施任务在启动前必须具备以下十二要素（缺任一项不得启动；L0 只读任务可豁免第 6–9 项）：
| # | 要素 | 说明 |
|---|---|---|
| 1 | 任务编号及所属阶段 | 格式 T-<阶段>.<序号>，与 docs/23 对应 |
| 2 | 目标与预期结果 | 一句话目标 + 可观察的预期结果 |
| 3 | 工作范围与禁止修改的范围 | 明确列出允许触碰的文件/模块；禁止范围默认为其余一切，含任务定义未提及的"顺带改进" |
| 4 | 前置条件及所需授权 | ⛔/▽ 依赖 + 授权级别（L0–L3） |
| 5 | 输入、依赖和预期输出 | 输入材料、依赖任务、产出物形态 |
| 6 | 实施要求 | 关键技术约束（如：改动最小、不引入新依赖、遵循既有风格） |
| 7 | 自动化测试与人工核验要求 | 跑什么测试；人工看什么 |
| 8 | 成功、失败和异常条件 | 三种情形各自的判定标准与处置 |
| 9 | 安全、兼容性和回归检查 | 是否触碰兼容策略（docs/21 §3.5）；回归范围 |
| 10 | 回滚或暂停条件 | 何时停手；如何还原 |
| 11 | 完成证据 | diff、运行记录、测试输出、截图、对账清单等可复核材料 |
| 12 | 最终状态与遗留问题 | 六态之一 + 遗留清单 |
2. Agent 自主与升级边界
2.1 授权范围内自主完成（不逐项请示）
Agent 在明确授权范围内应自行完成：合理的技术设计、实施、自检、失败诊断、修复和复测。普通技术细节（实现方式、函数拆分、错误信息措辞、测试组织）不得反复提交所有者决定。
2.2 必须暂停并请求明确授权的事项（L2/L3 边界）
- 生产发布或影响外部服务的操作（L2）；
- 凭据轮换、删除文件等安全敏感操作（L3）；
- 不可逆的数据修改（L3）；
- 超出批准范围的架构变更（含仓库拆合、执行层独立化）；
- 与既有协议或所有者目标冲突的决定；
- 无法通过既定安全边界解决的重大问题。
未获授权，推荐方案不得当作批准执行。
3. 操作三分法（与授权分级对应）
| 类别 | 例 | 授权 | 记录要求 |
|---|---|---|---|
| 只读检查 | 读文件、git status、只读脚本、GET 探测 | L0 免批 | 操作清单 |
| 可控测试 | 本地配置修改、本地手动跑任务、受控预演 | L1：所有者对具体任务及范围明确授权（可一次列明一批） | diff+运行记录 |
| 真实生产 | 发布、服务器变更、线上数据 | L2 逐次批准 | 批准记录+变更证据 |
4. 完成判定与状态枚举
4.1 完成判定八项核实（全部通过才算"已完成且验收通过"）
- 预期功能真实可用（非"代码写完了"）；
- 正常路径与关键异常路径均已验证；
- 现有功能无回归影响；
- 数据与结果可追溯（记录、日志、版本可查）；
- 兼容性、安全性、权限边界符合要求；
- 达到任务定义的验收标准；
- 有实际测试输出、运行记录或其他可复核证据；
- 未解决问题已如实列出。
4.2 状态枚举（唯一合法值）
| 状态 | 含义 |
|---|---|
| 已完成且验收通过 | 4.1 八项全部通过 |
| 部分完成 | 范围内部分达成，剩余部分已列出并有计划 |
| 阻塞，等待授权或前置条件 | 因依赖/授权未满足而停滞 |
| 已实施但未验证 | 改动已发生但验证未完成——禁止标记为完成 |
| 验收失败 | 验证已做且不达标 |
| 暂停或取消 | 所有者决定或条件消失 |
4.3 硬性禁令
- 禁止将"已实施但未验证"标记为任何形式的完成。
- 禁止以"构建成功 / 测试数量增加 / 页面能开"替代 4.1 核实。
- 禁止在证据缺失时默认通过（缺失本身记为"未验证"并展示）。
5. 失败与异常处置
- 任务失败 → 先诊断（区分：环境问题/前置缺失/实现缺陷/外部依赖）→ 出诊断结论；
- 可在授权范围内修复 → 修复+复测，全程留痕；
- 超出授权（触发 2.2 任一条）→ 暂停 + 报告 + 等待，不得边报边干；
- 每次失败复现 → 对应 docs/23 任务状态更新为"验收失败"或"阻塞"，禁止静默重试掩盖。