From harness-flow
Converges fuzzy product ideas into reviewable discovery drafts defining problems, users, wedges, key assumptions, probes, and validation needs before formal specs.
npx claudepluginhub hujianbest/harness-flow --plugin harness-flowThis skill uses the workspace's default tool permissions.
把模糊的产品想法收敛成一份可评审的 discovery 草稿,明确问题、用户、wedge、关键假设与进入 formal spec 前仍需验证的事项。本 skill 不写正式规格,不替代 `hf-specify`。
evals/README.mdevals/evals.jsonevals/fixtures/notes-to-draft/context-note.mdevals/fixtures/notes-to-draft/task-progress.mdevals/fixtures/notes-to-draft/user-notes.mdevals/fixtures/targeted-repair/discovery-draft.mdevals/fixtures/targeted-repair/discovery-review-record.mdevals/fixtures/targeted-repair/task-progress.mdevals/fixtures/targeted-repair/user-answer.mdreferences/discovery-template.mdreferences/jtbd-framework.mdreferences/opportunity-solution-tree.mdreferences/prioritization-quant.mdReviews completed product discovery drafts with structured rubric on problem focus, wedge convergence, assumptions, and spec readiness. Activate for formal review verdicts before hf-specify.
Guides product discovery: customer interviews, problem mapping, opportunity assessment, prototype testing, and assumption testing to reduce build risks. Activates on mentions of product discovery, customer research, user interviews.
Orchestrates product discovery by routing to specialized frameworks for customer interviews, assumption testing, JTBD analysis, prioritization, and roadmaps.
Share bugs, ideas, or general feedback.
把模糊的产品想法收敛成一份可评审的 discovery 草稿,明确问题、用户、wedge、关键假设与进入 formal spec 前仍需验证的事项。本 skill 不写正式规格,不替代 hf-specify。
本 skill 融合以下已验证方法。每条方法都有对应的 reference 与落地章节。
| 方法 | 核心原则 | 来源 | 落地 |
|---|---|---|---|
| Problem Framing | 先定义用户、问题、阻塞进展与 why-now,而不是从功能清单反推问题 | 项目化实践(discovery 通用方法) | 步骤 3;discovery 正文 section 1–3 |
| Hypothesis-Driven Discovery | 把"我们觉得应该这样做"拆成可验证假设、风险和 probe 方向,避免把猜测直接写成已确认需求 | Lean Startup, Ries 2011;Teresa Torres Continuous Discovery Habits | 步骤 3;discovery 正文 section 6 / 8 |
| Opportunity / Wedge Mapping | 在多个候选方向之间收敛当前轮最小 wedge,明确哪些能力进入当前轮、哪些只是后续候选 | 项目化实践(wedge 收敛通用做法) | 步骤 2;discovery 正文 section 4 / 7 |
| Assumption Surfacing | 显式写出已确认事实、未确认假设和 open questions,为后续 hf-specify 提供稳定 bridge | 项目化实践(HF 上游证据约定) | 步骤 3;discovery 正文 section 5–6 / 13;Bridge to Spec |
| JTBD / Jobs Stories(Phase 0 新增) | 需求锚定到「用户在某情境下想取得的进展」,而非功能 | Christensen Competing Against Luck;Alan Klement When Coffee & Kale Compete | 步骤 3;discovery 正文 section 10;见 references/jtbd-framework.md |
| Opportunity Solution Tree(Phase 0 新增) | Outcome → Opportunity → Solution → Assumption / Experiment 的收敛骨架 | Teresa Torres Continuous Discovery Habits | 步骤 3–4;discovery 正文 section 11;见 references/opportunity-solution-tree.md |
| 量化优先级 RICE / ICE / Kano(Phase 0 新增) | 在多个合理候选之间做可被冷读的比较;不替代 MoSCoW | Intercom (RICE);Sean Ellis (ICE);Noriaki Kano (Kano) | 步骤 3;discovery 正文 section 7 / 11;见 references/prioritization-quant.md |
| Desired Outcome / North Star Framing(Phase 0 新增) | 显式写出当前轮成功度量与门槛,防止下游 Success Criteria 凭空生成 | Sean Ellis Hacking Growth;Amplitude North Star Playbook | 步骤 4;discovery 正文 section 9;Bridge to Spec |
适用:
不适用:
hf-specify / 对应下游 skillhf-discovery-reviewhf-workflow-routerDirect invoke 信号:“先帮我把产品方向想清楚”“先收敛问题和 wedge”“还没到写 spec,先做 discovery”。
只读完成 discovery 所需的最少材料:用户请求、已有会议纪要 / notes / insight docs、项目级上下文约定(若项目已声明)、以及少量仓库背景用于理解当前主题。
先归纳:
若输入同时混有多个方向,先明确这一轮只回答:
不要把多个不相关方向揉成一份大而空的 discovery 文档。
把原始输入至少归一化为:
Problem / User / Why nowConfirmed factsAssumptions / risks(按 Desirability / Viability / Feasibility / Usability 分类,若适用)Candidate wedgesProbe ideasLikely out-of-scope / later在这一步同时引入两个视角:
When <situation>, I want to <motivation>, so I can <outcome>),避免从"功能清单"反推用户(见 references/jtbd-framework.md)。切换型主题(从旧方案切到新方案)额外做四力分析(push / pull / anxiety / habit)。references/opportunity-solution-tree.md)。规模控制在 Outcome 1 个、Opportunity 3–5 个(选 1 主)、每个 opportunity 下 Solution 2–3 个。若输入里夹带明显实现细节(接口、数据库表、服务名、技术栈),只保留其业务意图,不把它写成 discovery 结论。
若候选 opportunity / solution ≥ 2 个且仅凭 MoSCoW 难以收敛,引入 RICE / ICE 做量化辅助(见 references/prioritization-quant.md);分数必须带来源,严禁纯凭直觉。低 confidence 的候选不进入 wedge 候选,而是转成假设交给 hf-experiment。
在进入 draft 之前,必须显式写出本轮的 成功度量:
这些度量直接成为 Bridge to Spec 的上游输入,对应后续 hf-specify 正文中的 Success Criteria / Success Metrics。
按 references/discovery-template.md(或 项目级覆盖模板)起草 discovery 文档。
默认应显式写出:
章节密度按 references/discovery-template.md 的 profile-aware 表格执行:lightweight 允许压缩 JTBD / OST 为最简形式,但 Desired Outcome + Success Threshold + Bridge to Spec 始终是 hard requirement。
若 discovery 草稿已经足够稳定,应在文档中单列 Bridge to Spec 小节,说明:
hf-specify 的范围边界hf-experiment 验证的关键假设清单(若存在)Bridge to Spec 是 discovery 输出的一部分,不要求先拆成独立文件。
交给 hf-discovery-review 前确认:
Bridge to Spec 中哪些结论可进入 hf-specifyhf-experiment 先验证"完成时产出:
docs/insights/YYYY-MM-DD-<topic>-discovery.md;若 项目级覆盖,优先遵循)
docs/insights/ 长期资产目录;只有当 discovery 通过评审并决定推进为 feature 时,才由 hf-specify 创建 features/<NNN>-<slug>/hf-specify 起草 features/<NNN>-<slug>/spec.md 的输入features/<NNN>-<slug>/progress.md若草稿未达评审门槛,不伪造 handoff;明确还缺什么。
| Skill | 区别 |
|---|---|
using-hf-workflow | 入口层只负责判断是否该进入 discovery;本 skill 负责真正起草 discovery 正文。 |
hf-discovery-review | review 负责独立评审 discovery 草稿;本 skill 只负责起草和回修。 |
hf-specify | discovery 回答“为什么值得做、当前 wedge 是什么、哪些假设仍未关闭”;specify 回答“这一轮正式做什么、做到什么程度算完成”。 |
hf-workflow-router | router 负责 authoritative runtime routing;本 skill 假设当前已明确在做 discovery authoring。 |
hf-experiment 假设按需加载详细参考内容。任一 reference 未命中其"加载时机"时,不需要提前读取。
| 主题 | Reference | 加载时机 | 最小 profile |
|---|---|---|---|
| discovery 文档骨架 | references/discovery-template.md | 起草 discovery 草稿时;每次会话至少读一次 | lightweight / standard / full 全档必读 |
| JTBD / Jobs Stories / 四力 | references/jtbd-framework.md | 需要把"要功能"翻译成"要进展";或主题属于切换型(push/pull/anxiety/habit) | standard / full;lightweight 仅当问题陈述仍卡在功能语言时 |
| Opportunity Solution Tree | references/opportunity-solution-tree.md | 候选方向 ≥ 2 个、或需要剪枝到当前轮 wedge | standard / full;lightweight 候选 ≤ 1 可跳过 |
| RICE / ICE / Kano 量化优先级 | references/prioritization-quant.md | 多个候选 opportunity / solution 难以用 MoSCoW 直接收敛 | 按需;候选 ≤ 2 或分数无法带来源时跳过 |
加载策略:
lightweight 会话默认只读 discovery-template.md;JTBD / OST / 量化只在模板章节显式触发时再按上表加载standard 会话默认读 discovery-template.md + jtbd-framework.md;其余按命中条件full 会话按实际需要加载;若主题已明确为切换型或多候选并排,预读对应 referencehf-specify 读取;Desired Outcome / Success Threshold 已并入 Bridge to Spechf-experiment 先验证"hf-discovery-review;进入 feature 后续 progress 落到 features/<NNN>-<slug>/progress.md