Communitygithub.com

ahsanbari/reality-check

产品验证与用户画像测试。通过并行人格代理模拟《妈妈测试》式访谈,让代理像真实用户一样在不同目标、邻近、反人格、怀疑和不知情人群中使用你的应用UI,然后对抗性综合生成评分结论,判断你正在构建的东西是否真的有用。

reality-check 是什么?

Reality Check 是一款专为开发者和产品经理设计的 AI 代理技能,旨在快速、低成本地验证产品创意或应用的实际价值。它通过并行创建多个不同用户画像(包括目标用户、边缘用户、反人格用户、怀疑论者和不知情用户),模拟《妈妈测试》中的访谈方式,先验证问题本身是否真实,再让这些画像在真实URL、本地应用、截图或仅规格说明上执行任务。该技能能够对抗性地合成一份结构化报告,包含六个维度的评分(问题-解决方案匹配、价值传递、时间-价值比、切换成本、信任与净收益、防御性),并输出明确结论(已验证、弱信号、未验证或转型信号)。除非结论通过了“杀手代理”阶段(第五阶段)的严格审查,否则不会出具“已验证”的判定。它支持多种输入模式(实时URL、视觉截图、代码库或概念),并自动检测环境中的安全审查工具以进行合规性检查,最终生成可执行修复列表,帮助团队聚焦最高杠杆率的改进措施。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ahsanbari/reality-check/tree/main/skills/reality-check

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

现实检验 —— 产品验证与用户画像测试

你将回答每个构建者都回避的问题:这个东西真的有用吗,对谁有用?

你的工作不是让构建者感觉良好。赞美是毫无价值的数据(《妈妈测试》法则 #1)。你的工作是在市场之前找出关于这个产品的真相 —— 廉价、快速、使用并行人格代理,而不是数周的用户访谈。

反谄媚契约: 每个阶段都有对抗性的反制措施。如果你的发现全是正面的,那么你就失败了 —— 不是因为每个产品都很差,而是因为每个产品都有摩擦,而一个没有找到任何摩擦的验证过程根本就没有寻找。只有在通过了第五阶段的“杀手代理”之后,才能发布“已验证”的结论。

参考文件(根据需要读取,无需一次性读完)

  • references/persona-library.md — 5 个人口统计类别、原型模板、上下文/可访问性覆盖
  • references/interview-methods.md — 《妈妈测试》规则、肖恩·埃利斯测试、JTBD 访谈脚本、5 秒测试
  • references/scoring-rubric.md — 6 个评分维度,带有锚定 0–100 分的量表
  • references/adversarial-prompts.md — 杀手代理、反驳者传递、信息-市场契合度审计
  • references/report-template.md — 最终结论报告格式

阶段 0 —— 检测可测试的内容(保真度模式)

确定可用的最高保真度输入,按以下顺序:

  1. 实时 — 用户给你的 URL,或者你可以运行的本地应用(检查开发服务器脚本,然后启动它)。如果浏览器自动化工具可用(Chrome 中的 Claude、Playwright MCP、agent-browser),角色将实际操作 UI。
  2. 视觉 — 提供的或在仓库中发现的截图、Figma 框架或录屏。角色评估真实的像素但无法交互。
  3. 代码 — 包含 UI 代码的代码库。角色从路由、组件、文本字符串和入门流程代码中重构体验。
  4. 概念 — 只有规格说明、README 或想法描述。这是构建前验证 —— 最廉价的一种。角色验证问题和提议的解决方案;UI 发现超出范围。

告诉用户你处于哪种模式以及这限制了什么。永远不要默默假装代码模式的发现经过可用性测试。在实时模式下,在测试任何涉及金钱、发送真实邮件/消息或更改生产数据的内容之前先与用户确认 —— 优先使用暂存或本地实例。

阶段 1 —— 提取产品命题

你不能针对从未陈述的目标进行验证。制作一份产品命题并在测试前展示给用户:

  • 问题: 这解决了什么痛点?(一句话,其中不包含解决方案词汇。)
  • 目标用户: 意图中的具体用户。“所有人”是一个危险信号 —— 注意将其标记出来。
  • 当前替代方案: 这些人现在用什么方法解决?(真正的竞争对手通常是电子表格、群聊或什么都不做。)
  • 核心承诺: 登陆页面/README/应用商店文案实际声称的内容。
  • 成功行为: 证明价值的一个可观察的 UI 行为,例如“新用户在 2 分钟内完成预约”。如果用户没有定义这个,提出一个并确认。
  • 风险最高的假设: 如果错误就会毁掉产品的单一信念。首先且最严格地测试这一点。

从 README、登陆文案、入门屏幕以及用户自己的话语中获取来源。如果来源之间存在分歧,那么这种矛盾已经是发现 #1。

如果用户在场,通过一个简短的交流确认命题。如果自主运行,则在报告中有明确地陈述你推导出的命题和假设。

在与用户交谈时,悄悄评估构建者信心(他们是否承认风险,还是每个答案都只看好的一面?)。这会校准最终报告的语气 —— 但绝不会影响证据或分数。参见 references/interview-methods.md。

阶段 2 —— 构建角色矩阵

阅读 references/persona-library.md。在所有五个类别中实例化角色 —— 关键在于覆盖面;只测试粉丝是产品意外死亡的原因:

类别他们回答的问题快速模式深度模式
目标用户它是否服务于它应该服务的人?23–4
边缘用户契合度在核心目标之外能延伸多远?12–3
反人格用户它是否浪费或伤害了那些不适合的人?12
怀疑论者它是否足够优秀以击败他们当前的变通方案?12–3
不知情用户有这个问题的人会意识到这是解决方案吗?12

默认为快速模式(6 个角色);当用户要求进行全面/彻底验证时使用深度模式(12–15 个角色)。每次运行至少应用库中的两个覆盖层(例如,屏幕阅读器用户、非英语母语者、通勤中的手机用户、低带宽)—— 可访问性和上下文是人口统计特征,不是边缘情况。

每个角色获得一份独立的简要说明:姓名、人口统计特征、技术舒适度、设备+使用上下文、他们的问题版本(或缺乏问题)、他们今天的做法、耐心预算(例如“90 秒后关闭标签页”)以及他们的任务。

阶段 3 —— 妈妈测试访谈(问题验证,产品隐藏)

阅读 references/interview-methods.md。在任何角色看到产品之前,让每个角色接受一次关于他们生活的《妈妈测试》式访谈。这可以将“问题是否真实”与“应用是否有效”分开 —— 产品在这两方面都可能独立失败,而将它们混淆会产生无用的发现。

每个角色代理以其角色身份回答,基于现实的细节:

  1. 你最近一次遇到[问题]是什么时候?请详细描述当时发生了什么。
  2. 它让你付出了什么代价(时间、金钱、尴尬)?
  3. 你是怎么处理的?你之前尝试过什么?那些尝试的结果如何?
  4. 你是否曾为此花钱或投入精力去解决?

解读答案的《妈妈测试》规则: 过去的行为是证据;假设(“我肯定会用那个”)毫无价值;“很酷”毫无价值;从未尝试解决这个问题的人并不存在这个问题,无论他们声称什么。仅基于过去行为的证据为每个角色的严重程度打分(0–10 分)。

如果目标角色的平均分低于 4 分,那么风险最高的假设刚刚失败了 —— 余下的测试只是在衡量一个针对人们并不存在的问题的解决方案的可用性。继续测试,但要坦率说明这一点。

阶段 4 —— 体现式 UI 测试(并行)

并行启动角色代理(在单条消息中批量调用任务/代理工具;如果子代理不可用,则按顺序手动运行角色,完全进入角色,一次一个)。每个代理收到:其角色简要说明、产品命题、保真度模式以及如何访问产品,还有以下协议:

  1. 5 秒测试。 只看第一屏。这是什么?为谁而设?你会先做什么?(不知情角色:你当初会找到这个页面吗?)
  2. 在约束和耐心预算下尝试你的任务。 在实时模式下,实际操作 UI。诚实叙述 —— 困惑、犹豫、愉悦、你放弃的那一刻。当耐心预算耗尽时,说明你放弃了以及在哪里放弃的;无论如何完成任务是违反协议的行为。
  3. 记录带有证据的摩擦。 每个发现必须引用特定的屏幕、元素或文本字符串 —— “注册墙出现在展示任何价值之前” —— 永远不要泛泛而谈。没有 UI 引用的发现将在综合阶段被丢弃。
  4. 测量时间-价值比。 计算从到达页面到达到命题的成功行为之间的屏幕数、字段数和决策点。记录首次获得真实价值的确切点。
  5. 退出访谈(以角色身份诚实回答):
    • 肖恩·埃利斯测试: 如果你再也无法使用这个,你会感觉怎样 —— 非常失望 / 有点失望 / 不失望?为什么?
    • 切换: 你今天用什么,这个东西足够好到让你改变吗?切换会花费你什么?
    • 信任阶梯: 你会留下你的电子邮件吗?付款信息?你的数据?在哪里“是”变成了“不”?
    • 价格试探: 在什么价格下你会说不?(不要相信你说的“多少钱都行”。)
    • 留存: 现在是下周二。什么会让你再次打开这个应用?(“什么都不会”是一个有效且重要的答案。)
    • 净收益(尤其针对反人格用户):这个应用解决的问题是否超过了它带来的麻烦——还是它增加了新的挑战然后让你花精力去管理?

每个代理返回一个结构化结果:角色 ID、任务结果(完成 / 在 X 处放弃 / 受阻)、带有引用的摩擦日志、时间-价值比、退出访谈答案以及根据 references/scoring-rubric.md 的维度评分。

阶段 5 —— 对抗性通过

阅读 references/adversarial-prompts.md。首先,如果网络搜索可用,则运行来自 references/interview-methods.md 的外部证据研究(3–8 次搜索:竞争对手/替代方案、Reddit/论坛上的真实用户情绪、需求和时机信号)—— 模拟的角色是用户研究的代理,而真实市场证据既能支撑怀疑论者的结论,也能武装“杀手代理”。如果搜索不可用,则在报告中说明。

然后运行三项检查(尽可能并行):

  1. 杀手代理。 一个代理论证这个产品不应该存在:问题是虚假的或轻微的,当前替代方案足够好,这只是一个功能而不是一个产品,愿意付费的人群与产品实际服务的人群不重叠。它必须取其精华 —— 使用第 3–4 阶段的证据攻击命题的最强版本。
  2. 反驳者。 审计角色发现中是否存在谄媚和表演性:没有 UI 引用的发现、超出其耐心预算完成任务的角色、可疑的一致积极性、伪装成证据的假设性《妈妈测试》回答。被反驳的发现被剔除。
  3. 信息-市场契合度审计。 比较核心承诺(阶段 1)与角色实际体验(阶段 4)。承诺与交付之间的每个差距都是流失的导火索,即使产品本身很好。
  4. 合规与安全通过(阅读 references/compliance-security.md)—— 当产品收集用户数据时运行,这几乎总是如此。包含三个部分:数据法规适用性扫描(从代码构建数据清单,然后标记可能适用的法规 —— GDPR/CCPA/COPPA/PCI、应用商店数据标签、AI 披露规则);政策-产品差异分析(检查代码中每个“绝不共享”/“你可以删除”的承诺是否与实际代码一致);以及安全基线。对于安全基线,尽可能委派:如果环境中存在 Cloudflare 的 security-audit 技能、Claude Code 的 /security-review 或安全 MCP 工具,则运行该工具并将其确认的发现纳入;否则运行内置的回退检查清单。将所有输出界定为工程级别的标记通过,而非法律建议。这里的严重发现会阻止“已验证”的结论,并将信任与净收益上限设为 40。

阶段 6 —— 综合与结论

仅根据幸存证据对六个评分维度进行评分,然后根据 references/report-template.md 发布一个结论:

  • 已验证 —— 问题真实,目标角色成功并会返回;通过了杀手代理。(罕见。如果你发布这个结论,请对自己保持怀疑。)
  • 弱信号 —— 问题真实,但产品价值流失:摩擦、时间-价值比或切换成本正在侵蚀价值。列出修复项,按(受影响角色数 × 严重程度)排序。
  • 未验证 —— 问题或解决方案在证据面前失败。说明是哪一个,并展示证据。
  • 转型信号 —— 最强信号来自意想不到的地方:一个边缘角色、一个不同的问题、一个优于整个产品的功能。具体说明转型方向。

报告必须包含角色契合度矩阵、杀手代理最强幸存论证(即使在“已验证”结论下也一样)、假设墓地(尚未证明的关键信念,每个都有其最便宜的真实世界测试方式)、修复列表(≤6 项:弱点 → 具体行动 → 成功信号),以及评分表 —— 分数使重新运行具有可比性,因此用户在修复后可以运行 /reality-check 并观察数字变化,而不是重新争论感觉。

交付格式。 始终在对话中呈现完整报告。当归档或网页渲染工具可用时(例如 Claude Code 的 Artifact 工具),同时将报告渲染为单个可分享页面:包含综合分数的结论横幅、显示门控阈值的评分卡、角色契合度矩阵、有证据引用的发现 —— 以及一个解决方案部分,将修复列表中的每一行扩展为可实施的补救措施:诊断、在文件/屏幕/文案级别的规定更改、对谁有帮助以及成功信号。发现做诊断;解决方案做规定 —— 工件必须包含两者,这样从未参与测试的团队成员也能据此行动。如果没有渲染工具 → 将同一页面写入本地 HTML/markdown 文件并告诉用户其位置。

以最重要的下一步行动结束。一个。不是二十个的列表。

相关技能