核心用法
Code Planning Agent 是一款专注于软件项目前期规划的 AI 技能，其核心使命是在编码开始前产出详尽、可执行的实施方案。用户可通过自然语言描述项目需求，Agent 将系统性地拆解任务、梳理依赖并设计验证流程。
标准使用流程：
1. 需求澄清 — 识别核心目标与约束，必要时追问细节
2. 方案探索 — 分析技术选型，对比多种实现路径并给出推荐
3. 结构化规划 — 输出包含阶段、步骤、依赖、验证方法的完整计划
4. 迭代确认 — 与用户反复打磨，直至获得明确批准
输出格式规范：
- 计划标题与摘要（含架构概述）
- 分阶段实施步骤（支持并行任务标注）
- 系统依赖与外部集成清单
- 具体验证手段（测试/命令/人工检查）
- 关键决策与假设声明
- 待解决问题（如有）
---
显著优点
- 执行导向：计划粒度精细到"另一位工程师可直接执行"，消除实现歧义
- 系统思维：强制要求考虑架构、依赖、约束与风险，避免局部最优
- 分阶段验证：支持里程碑式交付，降低大型项目失控风险
- 人机协作设计：内置迭代确认机制，确保计划与真实意图对齐
- 零代码介入：严格限定于规划环节，避免过早陷入实现细节
---
潜在局限
- 无自动执行能力：需配合开发工具或人工完成实际编码
- 依赖输入质量：模糊需求会导致反复澄清，降低效率
- 技术时效性：训练知识截止日可能影响新兴技术栈建议
- 领域深度受限：垂直领域（如嵌入式、高性能计算）需人工补充专业判断
---
适合人群
- 技术负责人 / 架构师：快速产出可评审的 RFC 级方案
- 创业团队 / 独立开发者：降低项目启动的认知负荷
- 敏捷团队：生成 Sprint 级别的任务拆解与验收标准
- 学习开发者：通过结构化分析理解复杂项目的拆解逻辑
---
常规风险
- 范围蔓延：未严格执行"明确排除"声明时，计划边界易模糊
- 验证标准缺失：若用户未提供验收标准，Agent 可能预设不匹配的验证方法
- 假设失效：隐含的第三方服务可用性、API 稳定性假设需在实施前复核
- 过度规划：简单项目使用完整模板可能产生不必要的过程负担
---
综合评估
该技能填补了"想法→代码"之间的关键断层，特别适合追求工程纪律的团队。其价值不在于替代人类决策，而在于将隐性经验转化为显性、可协作的计划资产。建议在项目 Kick-off、技术方案评审、外包需求交接等场景优先启用。