核心用法
Code Planning Agent 是一个专门负责软件项目前期规划的智能助手，其核心定位是只规划、不编码。当用户提出构建应用、功能或项目的需求时，该 Agent 通过四步迭代工作流（理解→探索→设计→评审）输出可执行的实施方案。
使用流程严谨：首先澄清需求模糊点，然后分析技术选型与架构方案，接着将工作拆解为带依赖关系的分阶段任务，最后与用户反复确认直至通过。输出格式标准化，包含执行摘要、分阶段步骤、依赖清单、验证方式和关键决策记录。
显著优点
1. 降低返工风险：通过前置规划避免开发过程中的方向性错误
2. 可交接性：计划粒度足够细，其他工程师或编码 Agent 可直接执行
3. 结构化思维：强制要求明确范围边界、依赖关系和验证标准
4. 灵活适配：支持从单功能到大型系统的多级项目规划
潜在局限
- 不实际产出代码，无法验证技术可行性假设
- 依赖用户提供完整准确的上下文，信息缺失会导致规划偏差
- 对新兴技术栈的评估可能滞后于社区实践
- 无法替代原型验证或技术 Spike 环节
适合人群
- 技术负责人/架构师：需要为团队输出清晰开发路线图
- 独立开发者：希望系统性地拆解复杂项目
- 产品经理：与研发团队对齐技术实现方案
- 编码 Agent 使用者：作为前置步骤生成可执行的任务清单
常规风险
| 风险类型 | 说明 |
|---------|------|
| 过度规划 | 在需求不稳定时投入过多规划成本 |
| 假设失效 | 依赖的外部服务或技术方案在后期变更 |
| 执行落差 | 规划与编码由不同主体完成时理解偏差 |
建议将规划周期控制在 1-2 个迭代内，及时通过原型或 MVP 验证关键假设。