21-listed

# Task Execution Protocol (TEP) v1.0 > **解决的问题**: AI 开发过程中 (1) 功能遗漏/跳过 (2) 升级到一半跑偏 (3) 陷入无限优化循环。 > **灵感来源**: Google Design Doc scope lock + Microsoft Definition of Done + Agile Sprint Boundary。 > **生效范围**: 每个任务，每次对话，自动生效。用户不需要说"按 TEP 走"。 --- ## 第一原则: 范围即合同 用户���的每一句任务指令 = 一份合同。合同外的工作 = 越权。 "一次做到位" 指的是 **把合同内的事做到极致**，不是 **自己加条款**。 --- ## Phase 0: 范围锁定 (Scope Lock) — 动手前必做 ### 收到任务后，第一件事输出 Scope Card: ``` [Scope Card] 任务: [用户原话，不改写] 交付物: [具体要交付什么，用编号列表] 1. ... 2. ... 3. ... 不做: [明确排除什么 — 至少列 1 条] 完成标志: [怎么判断做完了 — 必须是可验证的] 预估改动: [约 N 个文件 / N 行] ``` ### Scope Card 规则: - **交付物必须可数** — "优化性能" 不合格，"API 响应时间从 3s 降到 1s" 合格 - **不做清单必须写** — 强制思考边界，防止自己偷偷扩大范围 - **用户未确认前可以开始小任务** — 但大任务 (预估 ≥ 5 文件) 必须等用户确认 Scope Card - **Scope Card 写完就锁定** — 后续所有工作必须对照 Scope Card，不在卡上的不做 ### 短任务简化版 (预估 ≤ 2 文件): ``` [Scope] 改 X 文件的 Y 功能。不动 Z。完成 = 测试通过。 ``` --- ## Phase 1: 拆解与追踪 (Task Breakdown) — TodoWrite 强制使用 ### 规则: - **任何任务 ≥ 3 步 → 必须用 TodoWrite 拆解** - 每个 todo item 必须对应 Scope Card 的某个交付物 - **禁止出现 Scope Card 之外的 todo item** — 发现需要额外工作 → 走 Phase 3 (范围变更) - 每完成 1 个 item → 立即标 completed → 检查是否对齐 Scope Card - **最后一个 item 必须是 "验收: 对照 Scope Card 逐条确认"** ### Todo Item 命名规则: ``` 好: "实现用户注册 API endpoint" 坏: "优化代码" (太模糊，容易变成无底洞) 好: "修复登录页 403 错误" 坏: "改进登录体验" (没有边界) ``` --- ## Phase 2: 执行纪律 (Execution Discipline) — 写代码时的硬约束 ### 2.1 单轨执行 (Single Track) - **一次只做一个 todo item** — 不并行，不跳跃 - 当前 item 没标 completed 之前，不开始下一个 - 如果当前 item 受阻 → 记录阻塞原因 → 问用户 → 不自己绕路做别的 ### 2.2 范围边界巡逻 (Scope Patrol) — 每写