规划与任务拆解

要解决的具体问题

当 AI Agent 面对复杂需求时，直接编码易导致代码混乱、返工频繁，甚至无法验证功能正确性。没有明确的任务拆分和验收标准，Agent 容易陷入“边写边改”的泥潭，最终产出难以维护的“意大利面代码”。

技能如何工作

核心流程

1. 进入规划模式（Plan Mode）：写代码前以只读模式分析需求和现有代码，识别模式、依赖关系和风险。输出 tasks/plan.md 计划文档和 tasks/todo.md 任务清单，而非实现代码。
2. 识别依赖图：绘制组件依赖关系，确保实现顺序自底向上，先构建基础模块再扩展功能。
3. 垂直切片：每次开发完整功能路径（如“用户注册”含 DB、API、UI），而非先完成所有数据库再所有 API。每个切片独立运行、可测试。
4. 编写带验收标准的任务：每个任务需包含明确验收标准，回答“是否完成正确功能？”，遵循 S/M/L/XL 规模指导（如 M 任务=3-5 文件，一个功能切片）。
5. 排序与检查点：确保依赖满足、系统保持可工作状态、高风险任务优先（快速失败），每 2-3 个任务设验证检查点。

输出文件

• tasks/plan.md：详细实现计划，含任务依赖和验收标准。
• tasks/todo.md：清单式任务列表，供 /build 等下游命令使用。

适用边界与注意点

• 何时不用：单文件修改、需求已明确包含定义好的任务时无需使用。
• 任务拆分原则：若任务超 2 小时 Agent 工作、验收标准超 3 条、涉及多独立子系统（如认证+计费），或标题含“和”字，需进一步拆分。
• 避免 XL 任务：8+ 文件的 XL 任务必须拆分，Agent 在 S/M 任务中表现最佳。
• 并行化注意：独立功能切片、已实现功能测试可并行；数据库迁移、共享状态变更必须串行；共享 API 契约功能需先定义契约再并行。