cc-roadmap
Skill1 starsChanged 7 months agoMITView on GitHub
Use when defining, resetting, or narrowing project direction, stage order, or backlog priority before a concrete requirement enters the PDCA loop.
In this repository18 other files it gives its agents.
- life-actSkill
- life-chooseSkill
- life-discoverSkill
- life-integrateSkill
- life-investigateSkill
- life-principleSkill
- life-proveSkill
- life-roadmapSkill
- life-roundtableSkill
- memory-write-gateSkill
- restart-lifeSkill
- cc-actSkill
- cc-checkSkill
- cc-doSkill
- cc-investigateSkill
- cc-planSkill
- cc-simplifySkill
- cc-spec-initSkill
The file
Files
Roadmap
[PROTOCOL]: 变更时同步更新
version、CHANGELOG.md、相关模板/脚本引用,必要时写 migration note,然后检查CLAUDE.md
Role
cc-roadmap 只负责一件事:决定项目接下来 1-3 个阶段该推进哪几个 capability。
它先尽可能收集真实上下文,再逼出真实用户、真实痛点、真实紧迫性,最后把这些现实压成一条能落地、能进入 cc-plan 的主线。
Read First
PLAYBOOK.mdCHANGELOG.mdassets/ROADMAP_TEMPLATE.mdassets/BACKLOG_TEMPLATE.mdreferences/roadmap-dialogue.md
Use This Skill When
- 新项目刚开始
- 项目做到一半,方向开始发散
- backlog 很多,但主线不清楚
- 你需要决定接下来 1-3 个阶段先做什么
如果用户已经在讨论一个明确 requirement、一个 bug 或一组实现任务,停止留在这里,转去 cc-plan。
Quick Start
如果用户只给了一个模糊问题,先把它归到下面 3 类之一,再继续问:
| 用户信号 | 先读成什么问题 | 默认路线形状 |
| “不知道下一步做什么” | 主线不清 | wedge-first |
| “后面几阶段都会重复碰同一底座” | 底座风险 | platform-first |
| “增长/交付/信任卡住了” | 当前最大瓶颈 | rescue-first |
先给一个默认推荐,再解释为什么,不要把用户扔进开放式战略讨论。
Harness Contract
- Allowed actions: read current strategy files, repo context, and recent reality; compare route shapes; write
devflow/ROADMAP.md,devflow/BACKLOG.md, and the optionaldevflow/roadmap-tracking.jsonsidecar used by bundled helpers as the shared roadmap/backlog truth source. - Forbidden actions: decompose implementation tasks, invent hidden context, or jump into
cc-planbefore the roadmap is approved. - Required evidence: every stage and backlog item must point back to explicit repo facts, user constraints, or observed market signals.
- Reroute rule: once the conversation collapses to one concrete requirement, stop strategic expansion and hand off to
cc-plan.
Entry Gate
- 如果
devflow/ROADMAP.md/devflow/BACKLOG.md已存在,先读现状再重写。 - 先判断这是“项目方向问题”还是“单 requirement 执行问题”。
- 先做一次上下文扫描,不能跳过现有事实直接写愿景。
- 方向没被批准前,不准把 roadmap 偷偷下放成实现任务。
Context Sweep
进入对话前,至少主动收这些上下文:
- 当前
devflow/ROADMAP.md/devflow/BACKLOG.md的主线、版本、已停放事项。 devflow/specs/INDEX.md与相关 capability specs 的边界、状态、open gaps。CLAUDE.md、README*、TODOS.md、最近相关 docs / specs / plans。- 最近相关提交、当前分支脏状态、正在进行中的 requirement。
- 真实 forcing functions:deadline、发布窗口、资源上限、依赖、distribution、adoption / trust / delivery 卡点。
- 当前项目最强的现实证据,以及仍然只能靠假设的空白。
先把这些材料压成一个 Context Snapshot,再开始追问用户。
Session Protocol
- 先探索上下文,不靠默认上下文注入替代阅读。
- 先问现实,不先写愿景。
- 一次只推进一个关键未知点,不要一口气抛一串问题。
- 先写
Context Snapshot、证据、约束、非目标,再讨论阶段。 - 给出 2-3 种路线图形状,再明确推荐一种,并说明为什么其他路线现在不值得打。
- 只冻结 1-3 个阶段。每个阶段都必须有 goal、why now、dependencies、exit signal、kill signal、non-goals。
- 把
RM之间的硬依赖压成显式 dependency graph,并标出 parallel-ready wave;不要把“最好按这个顺序做”伪装成 blocker。 - backlog 只保留会真的进入下一轮
cc-plan的事项,每项都要带成功信号、下一决策、Primary Capability、Secondary Capabilities、Expected Spec Delta、Depends On与Parallel With。 - 用户没批准,不进入
cc-plan。
Route Selection Rule
给出 2-3 条路线后,必须明确推荐其中一条。推荐格式至少回答这 4 件事:
- 为什么这条路线最符合当前证据
- 为什么另外两条现在不值得先打
- 这条路线最早会在哪个 signal 上赢
- 如果这个 signal 没出现,什么时候该止损
推荐话术要像这样:
Recommendation:
wedge-first, because the strongest current evidence is demand uncertainty, not platform pain. We should earn the right to build the base layer after Stage 1 proves pull.
不要只写:
- “建议先做 wedge-first”
- “这条更合理”
- “综合来看最优”
Ask
至少要逼清这 5 件事:
- 这个项目真正服务谁
- 用户今天用什么笨办法解决
- 为什么他们会立刻想要这个东西
- 最窄但最有穿透力的第一阶段是什么
- 未来 6-12 个月,产品会长成什么样
同时尽量补齐这些落地上下文:
- 当前最强证据是什么,哪些只是想象
- deadline / team / budget / dependency / distribution 的硬约束是什么
- 当前最大的 adoption、trust、delivery 卡点是什么
- 这个 roadmap 成功与失败各自用什么信号判断
Approval Gates
- 没有
Context Snapshot,不准给路线推荐。 - 没有 2-3 条路线对比,不准直接拍脑袋定主线。
- 没有 exit signal / kill signal / non-goals,不算阶段冻结。
- 没有明确成功信号和下一决策,不准把事项放进
Ready For Req-Plan。 - 没有
RM dependency graph或 parallel-ready wave,不准宣称事项可以并发推进。 - 没有用户批准,不准把 roadmap item 下放到
cc-plan。
Review Loop
写完 devflow/ROADMAP.md / devflow/BACKLOG.md 后,至少完成这 6 个检查:
- Placeholder scan:不能有 TBD、TODO、
[NEEDS CONTEXT]之类的逃避词。 - Evidence scan:每个阶段是否都能指回某个现实证据,而不是空洞愿景。
- Causality scan:Stage 2 是否真的建立在 Stage 1 的胜利条件之上。
- Feasibility scan:阶段目标与团队容量、依赖、distribution 约束是否接得上。
- Graph scan:
Depends On是否只包含硬阻塞,图里有没有环,parallel-ready wave 是否真的共享同一前置。 - Spec scan:每个 roadmap item 是否都落到某个 capability,而不是悬空需求。
- Handoff scan:第一批 roadmap item 是否已经自然长成可进入
cc-plan的对象。
Output
devflow/ROADMAP.mddevflow/BACKLOG.mddevflow/roadmap-tracking.jsonwhen helper automation needs a shared roadmap/backlog truth source
Good Output
一个高质量 roadmap 交付后,用户应该一眼看懂:
- 现在先打哪一仗
- 为什么不是另外两仗
- 哪个 signal 说明这一仗赢了
- 哪些 backlog 项已经真的 ready for
cc-plan - 哪些
RM必须串行,哪些已经可以并行开会话
Versioning
cc-roadmap 自身使用 semver:
patch:措辞、模板字段说明、非契约性澄清minor:新增兼容字段、上下文收集规则、评审规则、输出结构增强major:改变devflow/ROADMAP.md/devflow/BACKLOG.md的核心契约、阶段模型或 handoff 预期
每次修改都必须:
- 更新本文件 frontmatter 的
version - 更新
CHANGELOG.md - 如果会影响已有
devflow/ROADMAP.md/devflow/BACKLOG.md使用方式,在CHANGELOG.md写清 migration note
Bundled Resources
- 变更记录:
CHANGELOG.md - 模板:
assets/ROADMAP_TEMPLATE.md - 模板:
assets/BACKLOG_TEMPLATE.md - 结构化 tracking 模板:
assets/TRACKING_TEMPLATE.json - 对话骨架:
references/roadmap-dialogue.md - 条目定位:
scripts/locate-roadmap-item.sh - tracking 渲染器:
scripts/roadmap-tracking.js - 进度回写:
scripts/sync-roadmap-progress.sh - 版本递增:
scripts/bump-skill-version.sh
Exit Criteria
- 中长期方向清楚
- 核心上下文、证据和硬约束已经显式记录
- 阶段目标与优先级清楚
- 第一批 requirement 从 roadmap 里自然长出来
- 下一步唯一答案是把某个 roadmap item 放进
cc-plan
Working Rules
- 先收上下文,再收意见。
- 没有现实证据时必须明确写成 assumption,而不是偷偷当事实。
devflow/ROADMAP.md是方向真相源,devflow/BACKLOG.md是进入下一轮规划的缓冲区。- 决策理由必须保留下来,方便以后重跑时比较版本差异。
- 不要为了显得完整而写 6 个阶段,能打赢下一仗比画完整战争图更重要。
Do Not
- 不在这里拆实现任务
- 不把 roadmap 写成愿望清单
- 不讨论 20 个阶段,只定最重要的 1-3 步
- 不靠默认上下文注入替代思考
- 不把没有证据支撑的猜测包装成战略
- 不让 backlog 变成“以后再说”的垃圾堆
Companion Files
- 深入剧本:
PLAYBOOK.md - 路线图对话:
references/roadmap-dialogue.md
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

