SuperAPI AI 工具集

draft-plan

通用与其它

查看项目

更新于 10-16 05:47

技能介绍

用途:当用户要求“draft a plan”“write an implementation plan”等时,该技能在 .turbo/plans/<slug>.md 产出一份实现计划,覆盖任务捕获、模式调研、技能与文档咨询、产品决策升级、深入讨论与撰写计划。

主要能力与流程:使用 TaskCreate 为每个步骤建任务,依次为:捕获任务并选 slug;运行 /survey-patterns 技能;咨询任务相关技能与文档;升级产品决策;深入讨论;起草并写入计划文件;展示摘要;按用户回复行动。slug 由任务标题生成:小写、非字母数字替换为连字符、合并连续连字符、去除首尾连字符、在词边界截断到 40 字符;文件已存在时追加 -2、-3 等,不覆盖。用户显式指定 slug 或输出路径时从之,若冲突则用 AskUserQuestion 询问覆盖、加数字后缀或换 slug。

背景文档作为输入时,它是产品决策与讨论范围的来源:Step 4 跳过文档已解决的问题,Step 5 跳过文档已覆盖的领域;仍要确认部署边界,且 Step 2、Step 3 照常执行。

Step 4 用 AskUserQuestion 升级请求未解决的产品或设计决策;不升级代理可自主决定的技术决策。选项最多三个,最强项标 “(Recommended)” 并置顶;代价高或难以逆转时提供 Get a second opinion(运行 /consult-codex)。涉及既有界面外观时先观察当前渲染状态;涉及交互行为时先运行 /user-experience 技能。

Step 5 用 AskUserQuestion 一次一个问题深入访谈,涵盖结果、边界、约束、原型未知项、复用与新做、文件位置、数据流、边界情况、测试、范围裁剪;先确定前两项(结果、边界)。能通过探索代码库回答的就去探索;边界、契约或数据形状问题加 Get a second opinion 选项;外观或交互问题若散文回答仍会让人迟疑,加 Prototype it first 选项(运行 /prototype 技能)。每个问题附带建议与理由。

Step 6 综合任务描述、模式调研结果、技能与文档上下文、已解决的产品决策和讨论结果,写入计划文件,结构含 frontmatter status: draft,以及 Context、Acceptance Criteria、Pattern Survey、Implementation Steps、Verification、Context Files 等小节。若前面把工作推迟到改进待办,先运行 /note-improvement 技能。

限制:资料未提供安装命令、收费、价格、平台或效果信息。计划内容需遵守相应内容规则(如实现步骤使用具体 file_path 与命名符号、验证优先具体命令等),此处不展开细节。