用途
roadmap-refresh 用于从仓库中的规格文件自动生成路线图，取代手工编辑的 docs/roadmap.md。它读取 docs/specs/ 下的所有规格文件，依据其 frontmatter 生成 Now / Next / Recently shipped 三个分区，属于 Agent-OS 风格的派生路线图，不以手工维护为源。
主要能力
- 读取每个 docs/specs/*/spec.md。
- 按 frontmatter 的 status 分桶：
- Now = status: active
- Next = status: proposed
- Recently shipped = docs/specs/archived/ 下最近 10 条
- 将结果写入 docs/roadmap.md。
- 命令幂等，可安全重复运行。
- 当规格设置了 tags 时，标签会显示在条目旁边，例如 tags: rag,platform。
使用方式
安装与调用命令：
~/.claude/rag-index/venv/bin/python ~/.claude/rag-index/specs.py roadmap --repo <path>
运行时机：
- 在 spec-new 或 spec-ship 之后（未来可自动：通过 git hook 包装）。
- 在不熟悉的仓库中开始会话时——可立即看到哪些在进行中、排队中和刚交付。
- 在打开引用“per the roadmap”的 PR 之前。
编辑约定：
- 要把规格从 Next 移到 Now：将 frontmatter 的 status: proposed 改为 active，然后重新运行。
- 要下线一个 proposed 规格：rm -rf docs/specs/<folder>（或手动归档），然后重新运行。
适用场景
适合需要让路线图与仓库内规格状态保持同步的团队或开发者，尤其是在规格驱动的工作流中，路线图由规格 frontmatter 作为唯一事实来源派生而来。
限制与说明
手工维护的路线图通常在两周内就会失效；本工具生成的是派生状态。相关工具包括 spec-new、spec-ship；backlog-mapper 与它不同，后者扫描 git/PR，而本工具读取规格文件。关于收费、价格、平台或效果等信息，资料中暂未提供。