SuperAPI AI 工具集

close-roadmap

办公与效率

查看项目

更新于 10-27 16:23

技能介绍

用途

close-roadmap 用于在功能执行结束后收尾路线图。当 ROADMAP.final.md 或 PLAN.final.md 已签署并构建完成,docs/<feature>/ 中堆积了规划文档、评审笔记和执行产物时,该技能负责留下仍然成立的内容(规范、当前、距离项目代理定位仅一跳)和仍然欠下的内容(下一版路线图的 rev1),其余全部清理。

主要能力

  • 验收复核:逐项检查 ACCEPTANCE.md 中需要人工验证的清单,给出 passed、failed 或 never run 的结果。never-run 的检查属于未验证工作,需向用户逐项询问是现在运行还是接受未验证。
  • 四类去向分诊:最终文档中的每个里程碑和计划、问题日志、未测试清单和测试计划中的每条记录,都被赋予 landed、pending、deferred 或 dropped 之一。只有用户能指定 deferred 或 dropped。
  • 生成下一版路线图:将 pending 的计划写入 docs/<feature>/ROADMAP-V2.rev1.md,保留其原始 id、输入、输出和验证步骤,并针对当前代码重写。
  • 落地工作归档:按项目的文档地图,将决策写入决策记录(ADR)、模型写入数据模型文档、代码结构与数据流写入架构文档、运维/API/事件/配置写入相应文档、人工操作写入用户指南、当前可用状态写入产品状态页、技术债写入技术债记录。
  • 重写文件夹 README:说明功能是什么、导航表、文件夹内各文件用途、新工作应去往何处,以及最短的现状摘要。
  • 删除不再需要的文件:删除最终文档、所有 .revN.md 和 .revN.notes.md、EXECUTION.md、问题日志、ACCEPTANCE.md、HANDOFF.md 和未测试清单,并修复所有入站链接。

使用方式

通过参数传入功能名称,例如 /close-roadmap notifications。技能会按顺序读取 docs/<feature>/ 下的最终文档、执行记录、代码与历史、受影响的规范文档、已关闭的功能文件夹,并与主集成分支进行比对。

适用场景

适用于功能执行已经结束、规划文档已签署并构建完成、需要将规划产物收敛为规范文档并规划下一版路线图的场景。

限制

  • 不擅自丢弃任何工作:最终文档承诺的计划是产品承诺,未落地则进入下一版路线图,除非用户另有决定。
  • 不在记录决策时做新决策:只记录已做出的决策,遇到模糊之处需逐项询问用户。
  • 只有用户能指定 deferred 或 dropped。
  • 如果只有 revs 存在而没有最终文档,则停止,因为没有签署就没有可收尾的内容。
  • 除非被要求,否则不推送。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。