用途:create-plan 用于在动手实现前生成战略性的实施计划,适合用户明确要求计划、路线图或实施方案,任务复杂需要结构化拆解,或需要风险评估与替代方案分析时使用。它只做规划,不修改代码、不运行测试或构建命令,也不在计划中写代码片段;如用户要求实现,应改用实现型代理。
主要能力:先对代码库进行初步评估,调研项目结构与组织、相关文件与组件、既有模式与约定、潜在挑战与风险,以及从入口到最终使用的数据流。可使用 search、sem_search 和 read 工具检查代码库,需要更深入研究时使用 sage,并在计划中以 filepath:line 形式标注来源。随后生成 Markdown 计划文件,命名与存放位置为 plans/{YYYY-MM-DD}-{task-name}-v{N}.md,例如 plans/2025-11-24-add-auth-v1.md。
计划结构:包含 Objective(目标与预期结果)、Implementation Plan(全部任务使用 - [ ] 复选框格式,禁用编号列表或普通项目符号,说明做什么、为什么、受影响文件与集成点)、Verification Criteria(具体可度量)、Potential Risks and Mitigations、Alternative Approaches。要求以自然语言描述要做什么,聚焦战略层面的 what 与 why,而非战术层面的 how;引用文件采用 filepath:line 格式;需求含糊时可做合理假设并记录。
必要用法:创建后必须运行验证脚本 ./.forge/skills/create-plan/validate-plan.sh plans/{YYYY-MM-DD}-{task-name}-v{N}.md,修复错误或警告并重新验证直至通过。
限制:不实际改代码、不修改文件或创建实现、不运行测试或构建命令、不在计划中写代码或代码示例。其他细节,如具体运行环境要求,暂未提供。