SuperAPI AI 工具集

quick-plan

编程与开发

查看项目

更新于 10-16 08:37

技能介绍

用途:当需要一份精简、TDD 驱动的实施计划,但手头没有可对照的 brainstorm-beagle 规格(spec)时使用。quick-plan 从当前会话对话中重建意图,产出的计划与 write-plan 一致,区别在于前半段:没有 spec,改为在计划内部捕获 WHAT 与 WHY。

主要能力:从整个会话重建意图(目标、必备项、约束、范围外、方法信号、待解问题)形成 Intent Brief;做缺口检查,仅在意图存在真实空洞时批量提针对性问题;并行派发领域专家子代理探索代码库,返回文件映射、约定、确切测试命令、file:line 参考点与陷阱;读取项目约定(AGENTS.md/CLAUDE.md);设计文件结构并把工作拆成 2-5 分钟粒度的 TDD 任务;自审后先在对话中呈现草稿,获明确批准后才写入磁盘。

使用方式:按顺序执行重建意图→缺口检查→扇出探索与专家→读项目约定→设计文件结构→拆解 TDD 任务→自审→呈现草稿→获批后写入 .beagle/plans/<slug>/plan.md。若环境支持子代理则并行派发(一条消息多个工具调用,传路径而非文件内容),否则按同样简报串行内联执行。任务若仅改动单个文件,可跳过扇出、直接内联探索。

适用场景:会话中已充分讨论、但尚无已评审 spec 的功能或改动;希望计划可直接逐任务执行而无需重新推导意图时。若会话过薄,连目标、必备项、范围外都填不满,则说明时机未到,应提示改用 brainstorm-beagle 先行梳理,而非编造需求。

限制:quick-plan 只产出计划,不执行计划、不运行测试、不修改生产代码。写入磁盘前必须同时满足用户明确批准与路径确定两个条件。任何未经本仓库或会话验证的“工具 X 会有 Y 行为”“输入形状为 Z”类断言,需先设 Task 0 Spike 验证;在既有接口后新增第二后端/适配器时,最终任务须运行契约套件并断言可观察行为一致。计划中不得出现 TBD/TODO 或含糊动词。终端状态是写好的计划,之后可询问是否通过 subagent-prompt 技能生成执行交接提示。