roi-value-density
SKILL.md
ROI 与价值密度判断规范
把“整体值不值得做”和“当前先做哪个更划算”拆开判断,再统一收敛到当前上下文里最值得推进的动作。
核心原则
1) ROI 回答“值不值得做”
- ROI 用于判断一个方向、任务或投入整体上是否值得承担。
- 它关注的是总回报与总投入是否匹配,而不是只看实现成本高低。
- 没有明确价值来源的动作,即使实现简单,也不能因为“便宜”就默认值得做。
2) 价值密度回答“现在先做哪个”
- 价值密度用于判断在当前上下文里,哪个动作最容易以较小新增复杂度带来较大推进。
- 它强调单位时间、单位复杂度、单位认知负担下的有效价值,而不是抽象的长期想象空间。
- ROI 高不代表现在就该做;价值密度高也不代表它在长期上最重要。
3) 判断必须立足当前上下文
- 所有判断都必须结合当前目标、阶段、约束、阻塞点和已有信息。
- 同一个动作在不同阶段的 ROI 和价值密度可能完全不同。
- 不允许脱离上下文给出“通用高优先级”式结论。
4) 证据优先于伪精确
- 默认使用定性判断即可,不追求复杂权重公式和伪精确分数。
- 必须区分“来自上下文的证据”和“Agent 的推断”。
- 当证据不足时,应明确说明不确定性,而不是硬凑排序结果。
5) 少量候选优于全量发散
- 默认只比较少量最有代表性的候选,而不是一次列出大量方向。
- 输出应服务于收敛和决策,而不是把用户重新带回发散状态。
- 如果没有形成真正可比较的候选,先补齐候选,再谈 ROI 与价值密度。
AI Agent 行为要求
触发场景
以下场景默认适用本 skill:
| 场景 | 正确做法 | 不该做什么 |
|---|---|---|
| 优先级排序 | 先识别当前主线、阻塞和约束,再比较 2-3 个候选 | 直接按直觉给 P0/P1/P2 |
| 是否值得做 | 明确价值来源、投入代价、影响范围和验证方式 | 只因“看起来有用”就建议推进 |
| 先做哪个 | 比较当前阶段的推进价值、验证速度和新增复杂度 | 把长期想象空间直接当成当前优先级 |
| 是否延后 | 说明延后的代价与保留条件 | 用“以后再说”替代判断 |
| 继续投入还是止损 | 回看原目标是否仍成立,判断新增投入是否还能换来有效回报 | 因为已经投入过就继续追加投入 |
默认判断顺序
- 先确认当前要解决的核心问题是什么。
- 再判断候选动作整体上是否值得投入。
- 再比较哪些候选在当前阶段更容易产生有效推进。
- 最后给出“为什么现在做 / 为什么暂不做”的一句话结论。
- 若证据不足,显式标出待验证点。
输出要求
- 回答中必须同时覆盖
ROI与价值密度,除非当前只有一个候选且用户只问“值不值得做”。 - 结论必须能落到当前上下文任务,而不是停留在抽象原则。
- 默认给出轻量结论,不强制使用表格、打分或优先级标签。
- 若需要排序,优先使用
现在做 / 稍后做 / 暂不做或P0 / P1 / P2这类轻量表达。
与其他 skill 的协同边界
- 在
workflow的discovery阶段,本 skill负责候选方向的统一比较与轻量收敛。 - 在
planning、方案取舍、架构权衡、任务裁剪等场景,本 skill 负责判断哪些动作值得进入执行面。 - 它不替代
JTBD、Kano、Strategic Fit等发现/解释型视角,而是承接这些视角产出的候选并做决策收敛。
判断标准
先看 ROI
当以下信号更强时,通常说明 ROI 更高:
- 直接命中当前核心目标,而不是边缘优化。
- 对用户结果、交付效率或维护质量有明确改善。
- 能减少返工、讨论成本或长期停滞。
- 投入规模与预期回报基本匹配。
再看价值密度
当以下信号更强时,通常说明当前价值密度更高:
- 能直接缓解当前最主要的阻塞或不确定性。
- 可以在短周期内验证是否有效。
- 不需要引入明显超前设计或全局复杂度。
- 做完后能带动后续更多判断或执行继续推进。
默认比较维度
默认比较以下五项即可:
| 维度 | 关注点 |
|---|---|
| 预期价值 | 是否真正改善当前问题与目标结果 |
| 总投入 | 需要花多少时间、资源、协作成本 |
| 新增复杂度 | 是否引入新的抽象、耦合或认知负担 |
| 验证速度 | 多快能知道这个动作是否有效 |
| 不确定性 | 是否依赖未确认的假设、数据、接口或组织条件 |
可以上调优先级的例外
即使表面上的价值密度一般,以下情况也可以上调优先级:
- 它是当前主线的阻塞项。
- 它会持续制造返工或判断噪音。
- 它能显著提升后续决策清晰度。
- 用户已经明确承诺要做,且继续犹豫的成本高于先推进一小步的成本。
反模式
- 把 ROI 理解成“实现越便宜越优先”。
- 把价值密度理解成“只看短平快”。
- 没有候选比较对象,却硬做排序。
- 不解释当前阶段,直接给固定优先级标签。
- 用复杂分数掩盖证据不足。
- 把
ROI + 价值密度直接当成发现问题的主视角,跳过问题定义本身。
参考资料
references/roi-value-density-evaluation.md- ROI 与价值密度的统一判断框架、比较顺序与输出模板
Weekly Installs
2
Repository
qiao-925/qiao-skillsFirst Seen
1 day ago
Security Audits
Installed on
mcpjam2
claude-code2
replit2
junie2
windsurf2
zencoder2