SuperAPI AI 工具集

create-plan

编程与开发

查看项目

更新于 10-15 12:26

技能介绍

用途

create-plan 用于把一个用户提示转化为一份单一、可执行的计划,并交付在最终助手消息中。它主要面向编码任务场景:当用户明确要求制定计划时使用。整个工作流程中,技能要求以只读模式运行,不写入或更新文件。

主要能力

该技能的能力集中在计划的生成与组织上,包括:

  • 快速扫描上下文:读取 README.md 及明显文档(docs/、CONTRIBUTING.md、ARCHITECTURE.md),浏览最可能被触及的相关文件,识别约束(语言、框架、CI/测试命令、部署形态)。
  • 有限度地追问:仅在阻塞时提问,最多 1–2 个问题,优先采用多选形式;若不确定但不阻塞,则做出合理假设并继续。
  • 按固定模板输出计划:以一小段描述意图与方法开头,简短说明在范围内与不在范围内的内容,然后给出 6–10 项动作清单,并在存在未知项时附带最多 3 条开放问题。
  • 动作清单规范:每项为具体动作,必要时提及文件/命令;项须原子化且有序(发现 → 改动 → 测试 → 发布);以动词开头(如 Add、Refactor、Verify、Ship);在适用时至少包含一项测试/验证项和一项边界情况/风险项。
  • 保持与实现无关,不编写代码片段。
  • 输出时不以元解释作前言,仅按模板输出计划。

使用方式

触发条件为用户明确要求针对某个编码任务制定计划。技能按以下最小工作流执行:先快速扫描上下文,再仅在阻塞时追问,然后使用指定模板创建计划。计划模板为:标题“# Plan”,其后是 1–3 句说明要做什么、为什么以及高层方法;再列“## Scope”,包含 In 与 Out;随后是“## Action items”,以 [ ] 开头列出步骤(模板示例为 Step 1 到 Step 6);最后是“## Open questions”,最多列出 3 个问题。输出应严格遵循该模板。

适用场景

适用于需要针对编码任务快速产出可执行计划的场景,尤其是用户明确要求制定计划的场合。清单项可指向可能的文件/模块(如 src/...、app/...、services/...),可命名具体验证动作(如“Run npm test”“Add unit tests for X”),并在相关时纳入安全发布(功能开关、迁移计划、回滚说明)。

限制

该技能只读运行,不写入或更新文件。不做无谓提问,仅阻塞时最多问 1–2 个问题。应避免含糊步骤(如“handle backend”“do auth”)和过多微步骤。计划中不编写代码片段,保持与实现无关。关于该技能的收费、价格、平台支持范围及实际效果等信息,资料中暂未提供。