动手前构建风险预审(prebuild-risk-review)
Adapted from wshobson/agents by wshobson (MIT),plugins/before-you-build/skills/before-you-build。原 skill 面向 Claude Code/Codex/Cursor 等多 harness 的"动手前产品与功能风险复审";本版剥离平台专有命令与 agent 文件,重写为任何 Agent 平台通用的中文决策纪律,并附一个纯标准库评分脚本 scripts/score_risk.py(零依赖、无需密钥)。
何时使用
当用户要构建或上线以下任一类事物时使用本技能:
- 新产品、MVP、原型、落地页、SaaS、市场、内容站、智能体工作流、内部工具;
- 采用 / 收益 / 留存 / 信任 / 分发影响不明确的重要功能;
- 定位薄弱会浪费开发或推广资源的公开上线物料。
跳过:明确的窄修复、重构、修测试、依赖更新,或已有清晰验收标准且已验证的变更——这些不需要风险预审。
七维风险清单
逐维审查想法,每维只回答"证据强弱":
- 需求 Demand:是否有具体买家 / 用户迫切想要的证据?
- 定位 Positioning:目标用户能否一句话看懂它是什么、为何重要?
- 变现 Monetization:是否存在可信的付费 / 预算 / 战略价值路径?
- 留存 Retention:用户首次使用后有无理由回访?
- 信任 Trust:是否要求用户给出可信度、数据权限、集成或行为改变(用户可能抗拒)?
- 分发 Distribution:是否存在可重复触达目标用户的方式?
- 功能采纳 Feature adoption:功能会改变用户行为,还是只增加表面积?
若结论不显然,用 scripts/score_risk.py 把七维评级量化(见下)。
输出格式
保持简短、以决策为导向,固定五段:
1. 风险结论:低 / 中 / 高风险,一句话说明原因。
2. 最危险假设:最可能拖垮项目的单一假设。
3. 先找的证据:继续扩建前最小的有用信号。
4. 下一步:一个具体的验证动作或缩小的构建范围。
5. 暂缓:暂不应构建的部分。
纪律
- 对证据薄弱要直说,但不否定用户的想法。
- 优先小验证步,而非大型调研计划。
- 把产品风险与工程难度分开谈。
- 若想法已验证,说明是哪条证据降低了风险,并建议最小的实现切片。
- 缺事实时,点名缺失的证据,而不是编造市场论断。
评分脚本(可选)
scripts/score_risk.py 把七维评级(0=证据强 / 低风险,1=部分,2=弱 / 高风险,或 low/med/high)算成整体风险与最危险维度:
python scripts/score_risk.py --input risk.json # 或管道 stdin
输出风险结论、最危险假设、建议下一步;退出码 0(无致命错误)。详见脚本 --help。
反模式
| 反模式 | 问题 | 更好做法 |
|---|---|---|
| 直接开干 | 最危险假设未暴露 | 先写五段预审 |
| 编造市场论断 | 误导决策 | 点名缺失证据 |
| 一次建全 | 浪费投入 | 最小切片 + 验证 |
| 把工程难当产品风险 | 误判 | 两维分开 |