SuperAPI AI 工具集

plan-in-files

编程与开发

查看项目

更新于 10-16 02:38

技能介绍

用途:当任务超过两三个步骤、涉及多个文件或需要跨会话延续时(重构、迁移、多文件功能开发),把计划写在文件里而不是留在对话中,避免会话结束、崩溃或上下文清空导致进度丢失。

主要能力与计划结构:默认把计划写入仓库根目录的 PLAN.md;若仓库保留计划历史,则用 docs/plans/<yyyy-mm-dd>-<topic>.md。是否被 git 忽略或提交,按其自身说明是先询问一次、之后遵循仓库惯例。计划文件包含:目标(Goal)、完成条件(Done when,可观察的结束状态)、约束(Constraints,必须保持成立的条件)、步骤(Steps)、备注(Notes,记录发现、坑与后来被证伪的事)、日志(Log,记录日期时间)。每个步骤必须是对某个具名文件或命令的单一动作,例如把 verifyToken 从 api/auth.ts 移到 lib/token.ts 并更新三处导入,而非笼统的“重构认证层”。

使用方式:1)先写计划;工作量大或具破坏性时,执行前先给用户看。2)一次只做一步。3)做完立即在文件中勾选该步,而非等全部结束。4)现实与计划不符时修改计划。5)把意外写入 Notes。恢复已有计划时:先读文件,再用 git log、git diff 或跑测试对照实际情况核实已勾选步骤,纠正错误记录,从第一个真正未完成的步骤继续。完成时在 Log 写一行收尾说明并保留文件。

规则与限制:未经验证不得勾选;不得伪造进度;计划控制在一页以内;单个步骤若实际是五步,先在文件中拆分。不适合单文件编辑、一行修复或单纯提问;判断标准是:若丢失会话会带来超过五分钟的返工,才值得写计划文件。