SuperAPI AI 工具集

mt-plan

编程与开发

查看项目

更新于 11-16 19:47

技能介绍

mt-plan 是 Molten OS Core 中智能体开发循环的第三步,定位在 mt-spec 与 mt-build 之间:把已批准的规格说明转化为小型、可执行的实施计划。

用途与输入输出 它定义规格如何被构建,拆成智能体可以一次执行并验证一个的小步骤。输入路径为 mt-spec 产出的 molten-docs/spec/<slug>.md;若文件缺失或仍为草稿,应建议先完成 mt-spec,仅在用户坚持时继续并在计划中标注风险。输出规范路径为 molten-docs/plan/<slug>.md,目录不存在时创建。后续技能为 mt-build。

主要能力与规则 计划前先阅读代码库,引用真实文件、模块与模式,而非假设;计划期间只读,不修改应用代码。采用纵向切片而非横向切片:每个任务交付一条贯穿技术栈(界面→逻辑→数据)的薄工作路径。任务规模以一次专注会话为限,约触及 1 至 5 个文件,并以可验证状态结束;若需用“和”来描述任务,或无法用一句话说明完成条件,就应拆分。每个任务映射到一条或多条规格验收标准(AC-n),每条验收标准至少被一个任务覆盖。需先梳理依赖,把基础工作与风险最高的工作排在前面,并保证任务之间应用保持可运行。每个阶段后设检查点:完整测试运行、手动冒烟检查,以及让人重新定向的机会。每个任务都包含测试或验证步骤。交互运行开始时建议用户使用语音模式口述反馈;提问以纯文本编号形式在聊天中提出,有限选项用字母列出(1a、1b、1c),不使用智能体的提问工具。技能激活期间不开始实现,计划获批后再交接。

工作流程 读取规格、原型经验与相关代码;识别架构决策与依赖(新包、迁移、环境变量);起草依赖顺序,再划分阶段并将阶段拆成清单任务;与用户复核排序、每个任务范围、遗漏项与可裁剪项;写出计划并指引用户查看文件,仅在明确签署后把状态设为 approved。

输出结构 计划文件包含元信息(feature、slug、created、spec 路径、status、molten_next_skill: mt-build),以及方法、架构决策、依赖与设置、分阶段任务清单(每项标注文件、覆盖的 AC、依赖与验证方式)、阶段检查点、风险与缓解、完成定义。完成清单要求:每条验收标准至少被一个任务覆盖;每个任务写明真实文件、完成条件与验证步骤;任务为按依赖排序的纵向切片以保持应用可运行;每个阶段以检查点收尾;计划文件已写入并在用户签署后设为 approved。

适用场景与限制 适合需要把规格转成可执行、可验证任务序列的开发流程。它本身不实现功能,而要求计划阶段保持只读,实现交由 mt-build。可扩展项如每任务工作量估算、多智能体并行标记、发布/特性开关步骤或导出到 Linear、GitHub issues,属于可选补充,并非内置功能;其他功能细节暂未提供。