roadmap-refresh
Regenerate `docs/roadmap.md` for a repo from all specs under `docs/specs/` + their frontmatter (status, tags, pr). Produces Now/Next/Recently-shipped sections. Run after creating / shipping a spec, or at the start of a new session for orientation.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 1
01 前言 Front Matter
- name
- roadmap-refresh
- type
- skill
- description
- Regenerate `docs/roadmap.md` for a repo from all specs under `docs/specs/` + their frontmatter (status, tags, pr). Produces Now/Next/Recently-shipped sections. Run after creating / shipping a spec, or at the start of a new session for orientation.
02 资源文件 1
- 参考文档evals.json977 B
03 SKILL.md 正文
roadmap-refresh
Agent-OS-style roadmap, generated — not hand-edited.
Usage
~/.claude/rag-index/venv/bin/python ~/.claude/rag-index/specs.py roadmap --repo <path>
Reads every docs/specs/*/spec.md, buckets by status: frontmatter:
- Now =
status: active - Next =
status: proposed - Recently shipped = last 10 under
docs/specs/archived/
Writes to docs/roadmap.md. Idempotent; safe to re-run.
When to run
- After
spec-neworspec-ship(automatic future: wrap via git hook). - At session start in an unfamiliar repo — immediately shows what's live/queued/just shipped.
- Before opening a PR that references "per the roadmap".
Why not hand-edited
Hand-curated roadmaps rot within 2 weeks. This one is derived state — the spec frontmatter is the source of truth.
Editing conventions
- To move a spec from Next → Now: edit frontmatter
status: proposed → active, re-run. - To retire a proposed spec:
rm -rf docs/specs/<folder>(or archive manually), re-run. - Tags appear next to entries when set:
tags: rag,platform.
See also
spec-new,spec-shipbacklog-mapper— different: that scans git/PRs, this reads spec files.
04 同仓库更多 Skills
token-audit
Audit historical Claude Code token usage from JSONL session files — shows total spend, cache hit rates, top costly sessions, weekly trends, and where tokens are going. Run after heavy sessions or weekly to measure optimization impact. Answers how many tokens a session used, how expensive was that session, session cost, and token usage report.
smart-model-route
Auto-classify prompt complexity via Haiku (with heuristic fallback) and inject model routing hints for Agent tool calls. Wired as a UserPromptSubmit hook — fires on every prompt, routes low tasks to Haiku, standard to Sonnet, complex to Sonnet with thorough reasoning, and critical (security/arch/migrations) to Opus. Handles model selection, for example choose model by task complexity.
smart-commands
Decision guide for when to proactively use Claude Code slash commands — /think, /model, /compact, /clear. Use when choosing whether to invoke a command before or during a task, or when a complexity-classifier hook has flagged a task as high or critical. Pairs with the complexity-classifier UserPromptSubmit hook. Answers when to compact, should I switch models, and whether to use extended thinking. Use to pick the right /model command and switch model.
spec-ship
暂无简介
spec-new
Create a committed per-feature spec under `docs/specs/YYYY-MM-DD-<slug>/{spec,tasks}.md` with frontmatter (status, created, owner, pr, tags). Promotes an ephemeral `.claude/plans/<name>.md` into a persistent, searchable artifact. Use when starting a feature that's larger than a one-shot PR.
roadmap-refresh
Regenerate `docs/roadmap.md` for a repo from all specs under `docs/specs/` + their frontmatter (status, tags, pr). Produces Now/Next/Recently-shipped sections. Run after creating / shipping a spec, or at the start of a new session for orientation.