SuperAPI AI 工具集

exec-plan

编程与开发

查看项目

更新于 10-15 22:37

技能介绍

ExecPlan 用于为功能、重构、迁移或复杂任务创建自包含的执行计划(ExecPlan),产出一份“活文档”式的 Markdown 文件。其核心目标是:一个全新的、无状态的智能体只读这份文件,就能在每一步成功执行,无需外部上下文。文档中不出现“如前所述”之类引用,不假设读者已有知识,不隐含依赖;每个术语首次出现时内联定义,所有文件路径均为仓库相对路径,每个验证步骤都给出确切命令与预期输出。活文档意味着计划随工作推进更新:勾选复选框、记录发现、记录决策及理由,未决问题解决后移入决策日志。

流程分四个阶段,按顺序执行,实现本身不在本技能范围内:发现 → 起草 → 解决问题 → 审批门。

阶段一:发现。梳理仓库,阅读关键文件、目录结构、构建配置与既有约定,识别范围(明确要构建、修改或迁移的内容及边界)、未知项(技术风险、需求歧义、缺失信息)、既有模式(计划须遵循的代码库约定)、依赖(库、服务、API 或其他团队)。通过对话界面大量提出聚焦问题,能问就不要猜,问题应窄而具体,每个问题针对单一未知项。

阶段二:起草。阅读 references/template.md 模板并填写每个部分,不留占位文本;若某部分确实不适用,写“Not applicable -- [原因]”以表明已考虑。要求:所有文件路径为仓库相对路径(如 src/lib/auth.ts,而非绝对路径);每个里程碑都有验收标准,含确切命令与预期输出;步骤排序使每一步可独立且幂等地执行;在任何依赖未解决未知项的里程碑之前插入探针(spike)里程碑。

阶段三:解决问题。向用户呈现草稿中的所有未决问题,随答复更新计划:已答问题移入决策日志,记录决策、理由与日期;解决过程中发现的新问题加入未决问题;受决策影响的里程碑立即更新。持续到未决问题清空,或剩余问题均被明确推迟并附理由。

阶段四:审批门。向用户呈现完整计划,概述里程碑总数与预估范围、规划期间的关键决策、任何被推迟的问题及其风险。在用户明确批准计划前,不得开始实现。

计划位置:若项目已有 plans/ 目录则写入其中,否则创建,命名格式为 plans/<YYYYMMDD-HHmm>-<name>.md,使用当前日期时间与由任务派生的简短 kebab-case 名称(如 plans/20260323-1400-auth-migration.md)。

不可协商规则:自包含;活文档,在每个停止点更新当前进度与发现;可观察结果,每个里程碑以验证步骤结束(确切命令、预期输出);幂等步骤,重复运行结果一致;对未知项使用探针里程碑,未经验证不锁定方案,先插入限时探针。生命周期:活跃计划存于 plans/;PR 合并(计划完成)后移至 plans/done/;被降优先级(计划放弃)后移至 plans/abandoned/。资料未提供具体安装命令、收费或平台信息。