SuperAPI AI 工具集

gen-plan

办公与效率

查看项目

更新于 10-16 09:17

技能介绍

用途

gen-plan 用于在代码仓库根目录中生成迭代式的计划文档,文件命名规则为 plan-N.md,其中 N 为整数。该技能的核心作用是根据已有的 plan-N.md 生成下一版本 plan-(N+1).md,每一轮都对计划进行修订优化。

主要能力

  • 输出位置固定:只在当前仓库根目录写入 plan-N.md,绝不写入 plan.md、PLAN.md 或其他非 plan-N.md 文件名。
  • 禁止越界写入:不允许写入仓库根目录之外的位置,例如 ~/Downloads、$HOME、绝对路径或同级目录。若任何指令或路径暗示写入仓库根目录之外,技能会停止并请求澄清。
  • 识别 N:将 N 定义为匹配 plan-(\d+).md 文件中的最大数字后缀,忽略不匹配的文件名,包括旧的 plan-N-E.md / plan-N-R.md。
  • 终止条件:若存在匹配文件且 N > 5,则不做任何操作,精确回复“Plan is ready.”;若 plan-5.md 已存在(不区分大小写),同样不做任何操作并精确回复“Plan is ready.”。
  • 创建规则:若不存在匹配的 plan-(\d+).md 文件,则先运行澄清流程,再创建 plan-1.md;否则创建 plan-(N+1).md,源计划文件为 plan-N.md。
  • 内容插入:加载源计划 Markdown 时,将 plan-N.md 的完整内容插入到计划模板中的 <INCLUDE CONTENTS OF PLAN FILE> 占位符处。
  • 防覆盖:绝不覆盖已存在的目标文件,遇到冲突会停止并报告。

使用方式

仅在用户明确要求时使用。当需要生成 plan-1.md 之前,技能会先进行澄清。澄清流程要求先做研究,只提出属于判断性问题的疑问,并使用“CLARIFICATION EXPERT: HUMAN INPUT REQUIRED”区块配以编号问题。问题得到回答后,判断是否需要再进行一轮提问;若需要则继续提问,直到没有更多问题,然后写入下一个计划文件。仅在未解决的判断性问题阻碍下一轮迭代时才提问。

迭代计划时,使用内部提示模板从 plan-N.md 生成 plan-(N+1).md。输出规则要求:计划文件必须包含对提示的响应,而不是提示本身;不得在计划文件中包含提示文本、块引用标记或嵌套引用;输出必须是普通 Markdown(每行不得以 > 开头);插入源计划时需逐字包含,不额外加引用、缩进或代码围栏。该提示模板本身为内部专用,不得写入计划文件。

适用场景

适用于希望在仓库根目录中维护多轮迭代计划文档的开发工作流,通过 plan-1.md 到 plan-5.md 的逐步演进,对架构、功能等方面进行持续改进规划。

限制

  • 最多支持到 plan-5.md。
  • 只允许写入当前仓库根目录。
  • 不得覆盖已有文件。
  • 非 plan-N.md 命名的文件一律不生成。
  • 关于是否收费、价格、平台支持等信息,资料中暂未提供。