用途:将功能描述、缺陷报告或改进想法整理为结构良好、可执行的 Markdown 实施计划,遵循 VGV 约定与最佳实践,并提供灵活的细节层级。
主要能力:先检查 docs/brainstorm/ 中近 7 天内且主题匹配的头脑风暴输出,提取关键决策与架构模式;若描述不清则先运行 /brainstorm。随后做本地定向研究(Glob、Grep 搜索相关包、层或功能,读取被引用文件),并按风险、上下文熟悉度决定是否运行外部研究代理(官方文档、最佳实践)。接着进行问题规划与结构设计:标题遵循 conventional commits 格式,确定类型(enhancement、bug、refactor),生成带日期前缀的 kebab-case 文件名;做干系人分析与内容规划。再运行用户流程分析代理补全流程与边界情况,更新验收标准。默认使用 Standard 模板,简单任务用 Minimal,重大功能或架构变更用 Extensive。写文件前先通过 /create-branch 确保在功能分支上。
使用方式:以功能描述作为参数触发($ARGUMENTS)。输出文件为 docs/plan/YYYY-MM-DD-<type>-<descriptive-name>-plan.md,例如 docs/plan/2026-01-15-feat-user-authentication-flow-plan.md。写完后提供选项:清空上下文并构建(推荐)、直接构建(/build)、在编辑器中打开计划文件(open docs/plan/<plan_filename>.md)、运行 /plan-technical-review、或通过 /refine-approach 审阅改进。
适用场景:需求从想法到落地计划的前期整理,尤其适合需要澄清边界、协调多方干系人、或在动工前评审的大型功能与缺陷修复。
限制:本阶段明确禁止编写代码,只产出计划;计划文件命名必须带日期前缀且描述清晰;需先有明确的功能描述才能继续;外部研究仅在风险高、领域不熟或缺少本地示例时触发。其他收费、平台支持等信息暂未提供。