任务规划规范

适用于长程任务的事前规划，通过 Plan + Checkpoint 机制确保执行可控、进度可追踪。

---

⚠️ 核心强制要求

触发条件

• 用户明确要求"规划"、"计划"、"设计方案"等
• Agent 评估任务需要 >= 3 个明确步骤
• 涉及多文件改动或架构变更

复杂任务必须创建计划书

复杂度	特征	处理方式
简单	1-2 步，单文件	直接执行
中等	3-5 步，2-3 文件	建议创建计划书
复杂	>5 步，多文件/架构变更	必须创建计划书

长程任务必须启用 GitHub Issue 存档（W00）

• 预计跨会话/跨天任务，或需要全局追踪进行中状态时，必须通过 w00-workflow-checkpoint 创建或绑定 Issue。
• 计划书需记录：Issue #、当前 status、Next（下一步）。
• 创建/绑定 Issue 由主流程完成；w00-workflow-checkpoint 仅负责后续存档与读档。

---

AI Agent 行为要求

主动提议

对于复杂任务，必须主动提议先创建计划书：

检测到任务涉及 [N] 个步骤，建议先创建计划书。是否执行 scripts/generate_task_plan.py？

状态更新

每完成一个 CP 后，提醒更新状态表：

CP1 已完成，建议更新计划书状态表：CP1: ⬜ → ✅ 已完成 | 2026-01-22

并同步更新对应 Issue 的 checkpoint（含 下一步）。

与 W00 协同（自动 + 手动）

• 创建计划书并完成 Issue 绑定后可自动触发：w00-workflow-checkpoint checkpoint。
• 也可手动触发：执行 /w00-workflow-checkpoint 进行 checkpoint 存档或读档上下文。
• 若已存在 Issue：在计划书中补写 Issue # 并沿用状态流转。
• 若未明确 Issue 且存在多个候选：先列候选 issue（3~5 条）并让用户选择，再执行存档/读档。

必须等待用户决策

• 架构/技术选型
• 性能与维护性取舍
• 技术债务或临时方案

---

工具脚本

脚本：scripts/generate_task_plan.py

功能：规划 Checkpoint、生成符合规范的计划书

---

参考资料

• references/planning-workflow.md - 规划工作流详细说明（CP划分、状态标记、文件管理、文件清单格式）
• references/requirements-decisions.md - 需求决策流程详细说明（需求理解、方案设计、决策确认）
• ../w00-workflow-checkpoint/SKILL.md - Workflow GitHub Issues 基础存档能力（自动 + 手动）
• refactor-and-decompose/SKILL.md - 规划时文件清单与模块边界约束