关于 roadmap-analyzer
roadmap-analyzer 是只读技能,将产品代码和文档与 ICP 对照,按收入影响确定路线图优先级。它要求提供 `.agents/memory/icp.md`,并输出标注严重程度的差距分析、排序后的待办事项和战略主题。
主要功能
- 01只读审查代码与文档
- 02基于 ICP 的差距分析
- 03按收入排序的 P0/P1/P2 待办
- 04待办事项的收入理由
- 05按顺序排列的战略主题
适用场景
- 01为主要客户群确定工作优先级
- 02发现与流失或销售损失相关的产品差距
- 03选择以收入为重点的下一项路线图工作
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ shipshitdev/ skills --skill roadmap-analyzer安装后在 Claude Code 中输入/roadmap-analyzer确认已加载。
附带文件plugin.json
详细介绍
路线图分析器
根据对收入的影响,为下一步要构建的内容排序,并以 ICP 为依据。输出是一份创始人能够说服自己的待办清单:每一项都对应于吸引、留住或扩展某个付费客群。
只读代码。它生成分析,不创建提交或问题 — 将待办清单交给
roadmap-to-milestones,即可转化为可追踪的工作。
约定
输入:
.agents/memory/icp.md(来自icp技能)— 客群及其吸引/留存/扩展杠杆。如果该文件不存在,请停止并建议先运行icp;没有 ICP 的路线图按个人偏好排序,而不是按收入排序。- 代码库和产品文档,用于盘点当前已发布的功能。
输出:
- 差距分析:ICP 需求与当前状态的对比,并标注严重程度。
- 按收入排序的待办清单:P0/P1/P2,每项附一行收入依据。
- 战略主题:3–5 个重点方向,并按顺序排列。
创建/修改:
- 无。只读。
委派给:
- 如果还没有 ICP 文档,则交给
icp。 - 建议使用
roadmap-to-milestones,将排序后的待办清单转化为 GitHub 里程碑和问题。 - 使用
feature-intake/prd-writer,将单个待办事项扩展为 PRD。
步骤 1 — 加载 ICP
读取 .agents/memory/icp.md。针对主要客群,提取其迫切痛点、购买触发因素、流失原因和扩展路径。这些是路线图服务的三个收入杠杆:
- 吸引 — 消除阻碍主要客群购买的因素。
- 留存 — 消除明确指出的流失原因。
- 扩展 — 打通所述扩展路径(席位、用量、套餐层级)。
如果缺少 icp.md,不要猜测客户情况。明确说明这一点,并建议使用 icp。
步骤 2 — 盘点当前已发布的功能
从代码和文档中发现当前功能,而不是凭记忆判断。搜索产品的核心操作、自动化、协作、集成和计费相关界面。为每项功能记录状态(生产可用/部分可用/缺失)和质量(扎实/粗糙/原型),并以 file:line 作为证据锚点。认可已有成果 — 差距应以实际情况衡量,而不是假设一切从零开始。
步骤 3 — 差距分析
将 ICP 需求与盘点结果进行对比。每项需求占一行:
| ICP 需求(客群) | 杠杆 | 当前状态 | 差距严重程度 |
|---|---|---|---|
| <需求> | 吸引/留存/扩展 | 缺失/部分可用/扎实 | 严重/高/中/低 |
严重程度按收入加权:主要客群的吸引或留存差距至少为高;对于「非目标 ICP」客群,无论差距有多大,严重程度都为低。
步骤 4 — 按收入排序,而不只看工作量
为每个候选项打分:
- 收入影响(1–5) — 它能否吸引新销售、针对流失原因留住客户,或拓展账户?主要客群的吸引/留存项得分为 4–5;面向次要客群的润色项得分为 1–2。
- 紧迫性(1–5) — 当前是否有销售、续约或流失事件受它阻碍?
- 工作量(1–5) — 如实评估构建规模。
**得分 =(收入影响 × 2 + 紧迫性)÷ 工作量。**分数越高,优先级越高。
然后应用两条朴素评分容易忽略的规则:
- 完成优先于启动。 如果一项功能仍处于部分完成状态,且关系到收入杠杆,它就不是普通待办事项 — 而是正在造成收入流失的客户流失/销售流失风险。优先完成它,而不是启动任何新项目。只发布了一半的核心功能是负担,不是进展。
- 可销售优先于惊艳。 优先选择能完善客户愿意付费的完整方案的事项,而不是添加一个新的半成品方案。十项完成度为 80% 的功能,销售表现不如七项完成度为 100% 的功能。
将排序后的清单分为 P0(立即构建)、P1(下一步)和 P2(之后),并单独列出快速见效项 — 高收入影响、低工作量 — 这些是推动 MRR 增长最快的事项。
步骤 5 — 战略主题
将待办清单归纳为 3–5 个主题,每个主题都使用产品自身的语言命名,并对应一个收入杠杆。按顺序安排:先夯实能帮助主要客群实现吸引目标的基础,再解决留存,最后推动扩展。为每个主题提供一行愿景、服务的 ICP 客群,以及衡量成功的指标(最好是收入或留存数据,而非虚荣指标)。
输出
# Roadmap Analysis — <product> (<date>)
## Executive summary
- <3–5 bullets: the revenue story and the single most important next move>
## Gap analysis
<table from Step 3>
## Revenue-ranked backlog
### P0 — build now
1. **<feature>** (score X.X) — Lever: <Land/Retain/Expand>. Why: <revenue rationale>.
### P1 — next
### P2 — later
## Quick wins
- <high-impact, low-effort items>
## Strategic themes
1. **<theme>** — serves <segment>, <lever>. Success: <metric>.
## Recommended next step
Run `roadmap-to-milestones` to sequence P0/P1 into milestones with due dates.
反模式
- 未定义 ICP 就进行排名。 没有
icp.md,优先级排序就只是主观偏好。先运行icp。 - 优先考虑投入成本。 便宜又容易做,不代表能带来收入;评分将收入权重设为 ×2 是有原因的。
- 一视同仁地对待所有细分群体。 应针对主要细分群体进行优化;非 ICP 细分群体的巨大差距仍然是 LOW。
- 罗列功能却没有收入依据。 每一项都要说明会影响哪个杠杆,否则就不该列入待办事项。
- 新开工优先于完成现有工作。 影响收入杠杆的未完成功能优先级高于任何新项目——它们正在造成收入损失。