SuperAPI AI 工具集

roadmap-plan

办公与效率

查看项目

更新于 10-15 23:48

技能介绍

用途:在仓库中创建或重构持久化的里程碑路线图,文件位于 .spec-driven/roadmap/。它只做规划与文档,不修改产品代码。

主要能力:读取 .spec-driven/config.yaml、roadmap/INDEX.md、milestones/ 下各文件、specs 索引与相关主规格,以及 changes/ 中活跃和归档的变更,据此确定里程碑边界、目标、完成标准、计划变更、依赖与风险;可将旧格式里程碑重写为规范结构;支持把有界分析工作委派给子代理,但用户确认、路线图形状选择与最终写入必须由父代理完成。

使用方式:先确认 .spec-driven/ 存在,可用 ls .spec-driven/ 检查;若未初始化,先运行 /spec-driven-init。若 roadmap/ 缺失,运行 node {{SKILL_DIR}}/scripts/spec-driven.js init 修复脚手架。写入前先汇总里程碑结构并请求用户明确确认。完成后运行 node {{SKILL_DIR}}/scripts/spec-driven.js verify-roadmap 校验规模。

规范要求:每个里程碑使用 ## Goal、## In Scope、## Out of Scope、## Done Criteria、## Planned Changes、## Dependencies、## Risks、## Status、## Notes 等标准标题;里程碑状态限于 proposed、active、blocked、complete;计划变更首行格式为 - ` - Declared: - `,状态限于 planned、complete,描述保持同一行,不添加缩进续行;新或未完成项默认 Declared: planned;每个里程碑不超过 10 项计划变更,超出需拆分;完成状态由归档的计划变更推导,不手动切换。

限制:不改变产品代码;不把多个里程碑合并为超大文档;规模校验失败时不得宣称路线图就绪;迁移旧格式时保守映射,歧义应反馈用户而非臆造。具体命令与路径以资料为准,其他细节暂未提供。