normies

Normies

概览

调度一组子 Agent，让每个 Agent 扮演一位技术水平各不相同、在毫无背景信息的情况下访问网站的人。他们会报告自己理解了什么、哪些内容让自己困惑，以及在哪里放弃。组织原则是技术水平光谱——从专家到新手。

这不是技术审查。 review-squad:experts 技能负责代码质量、SEO、无障碍合规等方面的审查。此技能要回答的是：“真实的人能看懂我的网站吗？”

适用时机

• 发布前：“访客能看懂这是做什么的吗？”
• 改版后：“我们让内容更清晰了，还是更令人困惑了？”
• 新着陆页：“此页面传达了我们想表达的内容吗？”
• 定期检查：“我们是否忽略了新访客的体验？”

工作流

digraph normies {
  rankdir=TB;
  "User requests first-time review" -> "Present default persona panel";
  "Present default persona panel" -> "Ask: add, remove, or adjust?";
  "Ask: add, remove, or adjust?" -> "Finalize panel";
  "Finalize panel" -> "Ensure dev server is running";
  "Ensure dev server is running" -> "Dispatch agents sequentially";
  "Dispatch agents sequentially" -> "After each: report key impression";
  "After each: report key impression" -> "All done?";
  "All done?" -> "After each: report key impression" [label="no"];
  "All done?" -> "Compile confusion matrix + recommendations" [label="yes"];
}

必须按顺序调度。 浏览器 MCP 工具共用一个浏览器实例。Agent 必须逐个运行，不能并行运行。

默认评审小组（6 种角色）

调度前先向用户介绍这组角色。用户可以进行调整。

#	角色	技术水平	耐心	放弃条件
1	资深开发者	专家	低——能注意到每个瑕疵	困惑 30 秒
2	产品经理	高	中——目标明确，想快速“弄明白”	45 秒内仍未弄清楚
3	大学生	中——数字原住民，不愿费力	很低——快速浏览，凭视觉判断	感到无聊 10 秒
4	小企业主	中——每天使用网络，但不懂技术	低——很忙，需要立即找到答案	60 秒内仍未找到所需信息
5	退休教师	低——仔细阅读，容易被行话弄糊涂	高——会努力尝试，但迷路时会放弃	困惑 2 分钟
6	某人的祖父母	极低——看不懂图标，也不熟悉行话	很高——想弄明白，但很容易受挫	第一次真正感到困惑时

根据网站受众建议增加角色。 如果网站面向开发者，可以加入初级开发者。如果是餐厅网站，可以加入一位用手机浏览的饥肠辘辘的人。角色应符合实际访客的情况。

Agent 提示词模板

每条 Agent 提示词都必须遵循以下结构：

You are [NAME], a [AGE]-year-old [OCCUPATION/DESCRIPTION].
[2-3 sentences of personality and web behavior.]
You have NEVER seen this site before. You know NOTHING about it.

Do NOT read any source code or project files. You are a visitor, not a developer.
If browser MCP tools are available, use them to visit the site at [URL].

YOUR EXPERIENCE:
1. Navigate to [URL]. Take a screenshot.
2. In the first [TIME LIMIT] seconds, answer: What is this site about?
   If you can't tell, say so honestly.
3. Try to find [SOMETHING RELEVANT TO THIS PERSONA].
4. Navigate wherever feels natural to you. Take screenshots.
5. Note every moment you feel confused, lost, or unsure what to do.
6. Note every piece of jargon or text you don't understand.
7. When you would give up in real life, STOP. Say why.

Write your report IN CHARACTER as [NAME]. Be honest. Structure it as:
- **First Impression** (what I saw and thought in the first 5 seconds)
- **What I Think This Site Is About** (honest interpretation)
- **Where I Got Confused** (every point of friction, in order)
- **Where I Gave Up** (what finally stopped me, or "I didn't")
- **What I Couldn't Find** (things I wanted but couldn't locate)
- **Words I Didn't Understand** (jargon list)
- **What I Liked** (be fair)

关键要素：

• 丰富的角色设定——姓名、年龄、性格、上网习惯。不只是“普通用户”。
• 禁止读代码——“不要阅读任何源代码。”这是最重要的规则。只记录第一印象。
• 时间限制——每种角色都有耐心阈值。到了现实生活中会离开的时间，就停止。
• 角色内报告——退休教师要像退休教师一样写报告。这有助于呈现不同的语言风格和关注重点。
• 以截图为依据——在关键时刻截图，让用户看到角色看到的内容。

调度模式

按顺序运行，不能并行。 浏览器 MCP 共用一个浏览器实例。

Agent 1 (Senior Developer) → collect report
Agent 2 (Product Manager) → collect report
...
Agent 6 (Grandparent) → collect report

每个 Agent 完成后，在转到下一个 Agent 前，先向用户简要分享主要印象。

汇总结果

所有角色报告完毕后，整理一份困惑矩阵：

## Normies Review: [Site Name]

### Confusion Matrix

| Issue | Dev | PM | Student | Business | Retired | Grandparent |
|-------|:---:|:--:|:-------:|:--------:|:-------:|:-----------:|
| Can't tell what site is about | | | ✗ | ✗ | ✗ | ✗ |
| Can't find contact info | | | | ✗ | ✗ | ✗ |
| Jargon in hero text | | | | ✗ | ✗ | ✗ |
| Hamburger menu not recognized | | | | | | ✗ |

### Severity (by how many personas hit it)

- **6/6 or 5/6** → CRITICAL — nearly everyone is confused
- **3/6 or 4/6** → IMPORTANT — most non-technical visitors struggle
- **1/6 or 2/6** → MINOR — only edge cases

### Recommendations (prioritized)

| Priority | Issue | Who's confused | Suggested fix |
|----------|-------|---------------|---------------|
| 1 | ... | 5/6 personas | ... |
| 2 | ... | 3/6 personas | ... |

困惑矩阵是关键交付成果。 它能一目了然地显示哪些问题普遍存在，哪些问题只影响特定技术水平的访客。

报告之后

1. 展示困惑矩阵和改进建议
2. 询问用户是否想解决这些问题
3. 如果想解决，按受影响角色的数量确定优先级（先处理普遍存在的困惑）

常见错误

• 先读代码 — Agent 必须是初次访问者。了解代码会影响他们的印象。
• 进行技术测试，而非印象测试 — 这不是无障碍审计或 SEO 检查。此类检查应交给 review-squad:experts。
• 用户画像过于笼统 — “普通用户”算不上用户画像。请为他们设定姓名、年龄、职业、个性和具体的网页行为模式。
• 没有耐心阈值 — 真实用户在感到困惑时会离开。Agent 也应该如此。
• 用第三人称汇报 — 以角色身份汇报能呈现不同的措辞和关注点。Margaret 不会说“信息架构不清晰”——她会说“我不知道东西都在哪儿”。
• 并行运行 — Browser MCP 是共享资源。只能按顺序运行。