SuperAPI AI 工具集

plan-mode

编程与开发

查看项目

更新于 10-16 05:08

技能介绍

用途:Plan Mode 是一种结构化规划模式,用于 AI 智能体处理编程与开发任务。触发后智能体切换到规划状态:分析任务、产出结构化计划,并在写代码或做任何改动前等待用户明确批准。核心理念是深入思考、清晰沟通、对齐后再执行。

触发时机:用户显式要求(/plan、“plan this”、“think first”等);任务涉及 3 个以上文件或组件;涉及架构决策、新模式或破坏性变更;任务含义模糊、存在多种实现路径;涉及基础设施、CI/CD、数据库变更或迁移;或不确定正确做法时。

计划结构:包含理解(用自己的话复述目标、列出假设与待澄清问题,若关键问题会显著改变方案则先停下询问)、方案选项(非平凡任务给出 2-3 个方案,含摘要、高层实现步骤、优缺点、工作量估计,并给出推荐及理由)、任务拆解(按阶段列出可独立验证的具体步骤与检查点)、风险评估(针对本任务的具体风险,含可能性、影响与缓解措施,并考虑破坏性变更、数据影响、回滚难度与依赖)、受影响文件与范围(创建/修改/删除的文件及用途)、批准关口(以明确请求批准结束,选项为批准、修订、澄清、取消)。

保存方式:生成计划后保存到项目根目录的 plans/ 目录,文件名为 plans/YYYY-MM-DD-<short-slug>.md,slug 为 3-5 个词的 kebab-case 摘要。文件内容为完整计划的 Markdown,顶部加 YAML frontmatter,含 task、status(proposed → approved → in-progress → completed → cancelled)、created、approach 字段。状态随进展更新;计划修订后在末尾追加 Revision Log,而非覆盖原计划。目录不存在则创建;若存在 .gitignore 且用户未说明 plans 是否纳入 git,需询问。

批准后执行:按任务拆解逐步执行,每个阶段检查点后简要汇报完成内容、确认检查点达成,再进入下一阶段。若执行中发现与计划矛盾(意外复杂度、更好方案、阻塞),应暂停并重新规划,而非默默偏离。

规模适配:小任务(修 bug、改配置、改错字)只需理解、单一方案、文件列表与批准关口;中等任务用完整结构、2 个方案与基本风险评估;大任务用详细方案、完整风险表,可建议拆分为多个 PR/阶段,并在组件交互时给出依赖图。

应避免的反模式:为改个变量名写 500 行计划;步骤含糊(“实现该功能”不是步骤);乐观评估风险;已获批准仍反复规划;隐藏假设。

限制:资料未提供该技能的安装命令、平台支持、收费方式或实际效果数据。