skills/qiao-925/qiao-skills/roi-value-density

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
是否值得做 明确价值来源、投入代价、影响范围和验证方式 只因“看起来有用”就建议推进
先做哪个 比较当前阶段的推进价值、验证速度和新增复杂度 把长期想象空间直接当成当前优先级
是否延后 说明延后的代价与保留条件 用“以后再说”替代判断
继续投入还是止损 回看原目标是否仍成立,判断新增投入是否还能换来有效回报 因为已经投入过就继续追加投入

默认判断顺序

  1. 先确认当前要解决的核心问题是什么。
  2. 再判断候选动作整体上是否值得投入。
  3. 再比较哪些候选在当前阶段更容易产生有效推进。
  4. 最后给出“为什么现在做 / 为什么暂不做”的一句话结论。
  5. 若证据不足,显式标出待验证点。

输出要求

  • 回答中必须同时覆盖 ROI价值密度,除非当前只有一个候选且用户只问“值不值得做”。
  • 结论必须能落到当前上下文任务,而不是停留在抽象原则。
  • 默认给出轻量结论,不强制使用表格、打分或优先级标签。
  • 若需要排序,优先使用 现在做 / 稍后做 / 暂不做P0 / P1 / P2 这类轻量表达。

与其他 skill 的协同边界

  • workflowdiscovery 阶段,本 skill负责候选方向的统一比较与轻量收敛。
  • planning、方案取舍、架构权衡、任务裁剪等场景,本 skill 负责判断哪些动作值得进入执行面。
  • 它不替代 JTBDKanoStrategic Fit 等发现/解释型视角,而是承接这些视角产出的候选并做决策收敛。

判断标准

先看 ROI

当以下信号更强时,通常说明 ROI 更高:

  • 直接命中当前核心目标,而不是边缘优化。
  • 对用户结果、交付效率或维护质量有明确改善。
  • 能减少返工、讨论成本或长期停滞。
  • 投入规模与预期回报基本匹配。

再看价值密度

当以下信号更强时,通常说明当前价值密度更高:

  • 能直接缓解当前最主要的阻塞或不确定性。
  • 可以在短周期内验证是否有效。
  • 不需要引入明显超前设计或全局复杂度。
  • 做完后能带动后续更多判断或执行继续推进。

默认比较维度

默认比较以下五项即可:

维度 关注点
预期价值 是否真正改善当前问题与目标结果
总投入 需要花多少时间、资源、协作成本
新增复杂度 是否引入新的抽象、耦合或认知负担
验证速度 多快能知道这个动作是否有效
不确定性 是否依赖未确认的假设、数据、接口或组织条件

可以上调优先级的例外

即使表面上的价值密度一般,以下情况也可以上调优先级:

  • 它是当前主线的阻塞项。
  • 它会持续制造返工或判断噪音。
  • 它能显著提升后续决策清晰度。
  • 用户已经明确承诺要做,且继续犹豫的成本高于先推进一小步的成本。

反模式

  • 把 ROI 理解成“实现越便宜越优先”。
  • 把价值密度理解成“只看短平快”。
  • 没有候选比较对象,却硬做排序。
  • 不解释当前阶段,直接给固定优先级标签。
  • 用复杂分数掩盖证据不足。
  • ROI + 价值密度 直接当成发现问题的主视角,跳过问题定义本身。

参考资料

  • references/roi-value-density-evaluation.md - ROI 与价值密度的统一判断框架、比较顺序与输出模板
Weekly Installs
2
First Seen
1 day ago
Installed on
mcpjam2
claude-code2
replit2
junie2
windsurf2
zencoder2