SuperAPI AI 工具集

normies

测试与质量

查看项目

更新于 10-15 10:42

技能介绍

用途

Normies 用于从“第一次访问者”的视角审视一个网站,判断不同类型的人能否理解网站内容、找到所需信息,以及在哪里产生困惑或放弃。它回答的核心问题是:“真实的人能理解我的网站吗?”

该技能明确说明它不是技术审查。代码质量、SEO、无障碍合规性等由 review-squad:experts 技能负责。Normies 专注于首次体验和印象测试。

适用时机包括:

  • 发布前:访客能明白这是什么吗?
  • 重新设计后:我们让事情更清楚了还是更混乱了?
  • 新落地页:这个页面传达了我们想要的信息吗?
  • 定期检查:我们是否忽略了新访客的体验?

主要能力

默认人物面板(6 种人物)

在调度前会向用户展示这一熟练度谱系,用户可进行调整:

# 人物 熟练度 耐心 放弃阈值
1 高级开发者 专家 低——会注意到每个缺陷 困惑 30 秒
2 产品经理 高 中——目标导向,想快速“搞懂” 45 秒没有清晰信息
3 大学生 中——数字原住民,低投入 极低——快速滚动,凭视觉判断 无聊 10 秒
4 小企业主 中——日常上网,不技术 低——忙碌,需要立刻找到答案 60 秒找不到所需内容
5 退休教师 低——仔细阅读,被术语困扰 高——会尝试,但迷失后放弃 困惑 2 分钟
6 某人的祖父母 最低——图标无意义,术语陌生 极高——想理解,但容易被击败 第一次真正困惑的时刻

技能建议根据网站受众添加人物。如果网站面向开发者,可添加初级开发者;如果是餐厅,可添加一个用手机找吃的饥饿的人。人物应与实际访客匹配。

智能体提示模板

每个智能体提示必须遵循以下结构:

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)

模板中的关键要素:

  • 丰富的人物:姓名、年龄、性格、上网行为,而不是笼统的“一个普通用户”。
  • 禁读代码:“Do NOT read any source code.” 这是最重要的规则,确保只有冷启动印象。
  • 时间限制:每个人物有耐心阈值,当他们现实中会离开时就停止。
  • 角色内报告:退休教师以退休教师的方式写作,这能揭示不同的语言和优先级。
  • 截图驱动:在关键时刻截图,让用户看到人物所看到的内容。

调度方式

必须顺序调度,不能并行。浏览器 MCP 工具共享单个浏览器实例。

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

每个智能体完成后,在进入下一个之前简要向用户分享主要印象。

结果整合

所有人物报告后,编译混淆矩阵:

## 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. 询问:添加、移除或调整?
  4. 确定面板。
  5. 确保开发服务器正在运行。
  6. 顺序调度智能体,每个完成后报告主要印象。
  7. 全部完成后,编译混淆矩阵和优先建议。
  8. 询问用户是否修复问题。

适用场景

  • 网站发布前的首次体验检查
  • 重新设计后的清晰度验证
  • 新落地页的信息传达评估
  • 定期检查是否忽略了新访客体验

限制与常见错误

  • 先读代码:智能体必须是冷访客,代码知识会污染印象。
  • 技术测试代替印象测试:这不是无障碍审计或 SEO 检查,那些属于 review-squad:experts。
  • 扁平人物:“一个普通用户”不是人物,需要姓名、年龄、工作、性格和具体上网行为模式。
  • 没有耐心阈值:真实的人困惑时会离开,智能体也应如此。
  • 第三人称报告:角色内报告能揭示不同的语言和优先级。Margaret 不会说“信息架构不清晰”,她会说“我不知道东西在哪儿”。
  • 并行运行:浏览器 MCP 是共享资源,只能顺序执行。