SuperAPI AI 工具集

plan-first

编程与开发

查看项目

更新于 10-16 01:10

技能介绍

plan-first 是一套结构化的编码任务规划工作流,主张在动手前先规划。它适用于每个新功能、缺陷修复、重构或实现请求的开始阶段。

核心规则:在 TODO.md 获得批准前,绝不编写代码、创建文件或运行命令;绝不假设缺失信息,而应询问;绝不跳过步骤,按阶段顺序执行;绝不偏离计划,若发现新工作,先加入 TODO.md 并请求批准后再进行。

工作流分五个阶段。第一阶段分析项目:在提问前静默阅读项目,检查目录结构(顶层两级)、package.json、pubspec.yaml、go.mod、requirements.txt、Cargo.toml、pom.xml 等依赖清单、已有依赖及版本、构建系统与脚本(Makefile、scripts/、CI 配置)、README、已有 TODO.md/TASKS.md/.todo 或待办文件;除非与提问直接相关,不输出分析结果。

第二阶段提问澄清:找出会阻碍正确实现的缺口,仅在单条消息中提出至多 5 个关键问题,只问无法从代码库推断的内容,需编号,且不得分多轮提问,之后等待用户回复。

第三阶段创建 TODO.md:在项目根目录写入文件,结构包含 Goal(一句话目标)、Tasks(按阶段分组、可勾选的具体可衡量动作)、Notes(约束、决策与已知风险)。任务要小且可独立验证,按依赖排序,可明确判断完成与否,避免“修复问题”“改进代码”等模糊项。写完后向用户展示完整内容并请求批准。

第四阶段修订循环:若用户要求修改,提出针对性追问、重写 TODO.md、展示更新后的计划并再次请求批准,直至获批。

第五阶段执行计划:获批后按顺序逐项执行,开始前说明正在处理的任务,完成后将 - [ ] 改为 - [x],当前任务未完成前不开始下一项,不执行计划外工作;若发现必须的未列出任务,应停止、加入 ## Discovered Tasks 并说明原因与请求批准。全部标记完成后输出“All tasks in TODO.md are complete.”。