用途:Create Plan 是一个规划型技能,用于在真正动手实现前,为复杂任务生成完整的实施计划,提供战略指导而不做实际代码改动。当用户明确要求计划、路线图或实施方案,或任务复杂需要结构化拆解、风险评估与替代方案分析时使用。
主要能力:先对代码库做初步评估,了解项目结构与组织、相关文件与组件(需完整阅读以理解流程)、既有模式与约定、潜在挑战与风险,以及从入口到最终使用的数据流;随后生成 Markdown 计划文件;最后强制运行校验脚本检查计划是否满足要求,修复错误或警告后重新校验直至通过。
使用方式:调研阶段可使用 search、sem_search、read 工具,需要更深入研究时使用 sage,并在计划中以 filepath:line 格式(如 crates/forge_repo/src/provider.rs:45)显式引用来源。计划文件放在 plans/ 目录,命名为 plans/{YYYY-MM-DD}-{task-name}-v{N}.md,例如 plans/2025-11-24-add-auth-v1.md。创建后必须运行:./.forge/skills/create-plan/validate-plan.sh plans/{YYYY-MM-DD}-{task-name}-v{N}.md。
计划结构:包含任务名称、目标(清晰陈述目的与预期结果)、实施计划(所有任务必须用复选框格式 - [ ],绝不用编号列表或普通项目符号,且不写代码或代码片段)、验证标准(具体可衡量)、潜在风险与缓解措施、替代方案及权衡。
限制:该技能仅用于规划,只能调研代码库、编写计划文档、评估风险、用自然语言描述实现;不得修改文件或创建实现、不得运行测试或构建命令、不得在计划中写代码示例。若用户要求实现工作,应建议切换到实现类智能体。