mcpField
W
well-actually

well-actually

github.com/2389-research测试与质量1251 次安装29 周前更新
代码仓库

关于 well-actually

一项评审技能,会派遣不同角色的子 Agent 检查网站及代码中的设计、文案、规范和体验问题。它适用于发布前的细节打磨,输出角色化反馈和实用修复清单,而非专业审计。

主要功能

  1. 01派遣由六种评审角色组成的默认小组
  2. 02检查排版、语法、规范和用户体验
  3. 03按角色应用不同的访问规则
  4. 04以各自风格报告发现
  5. 05汇总可执行的修复清单

适用场景

  1. 01在公开发布前发现遗漏问题
  2. 02检查已完成网站的视觉和文案细节
  3. 03将细节问题整理为可执行的修复项

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/2389-research/review-squad --skill well-actually

安装后在 Claude Code 中输入/well-actually确认已加载。

详细介绍

好吧,不过……

概述

派出一组吹毛求疵的子 Agent,每个都执着于不同的领域。他们会挑剔一切——排版问题、语法错误、违反标准之处、值得商榷的技术选择、不一致的像素。其价值在于发现那些专业评审会忽略的小问题,而网上那些有强烈意见的人绝对会拿这些问题来嘲讽你。

这不是专业审计。 review-squad:experts 技能会提供结构化、按严重程度排序的发现。这个技能给你的反馈,则像是你的网站登上 Hacker News 首页后会收到的那些评论。

适用场景

  • 公开发布前(“大家会拿什么来嘲讽我?”)
  • 你觉得已经完成之后(“我漏了什么?”)
  • 想把最后 5% 打磨到位时
  • 需要动力来修复那些一直被你搁置的问题时

默认评审团(6 位挑剔者)

派出前先向用户展示此列表。用户可以调整。

#人设痴迷之处评审内容
1排版师字体搭配、字偶间距、行高、孤行/寡行、垂直节奏渲染后的网站 + CSS
2语法学家每一个逗号、破折号、大小写不一致、被动语态仅渲染后的文本
3标准狂热者语义化 HTML、标记有效性、ARIA 正确性、规范合规性渲染后的 DOM + 模板
4HN 评论员技术选择、包体积、过度设计、“为什么不用纯 HTML?”源代码 + 渲染后的网站
5像素警察间距不一致、边框圆角不匹配、颜色相差一个色阶渲染后的网站 + CSS
6UX 回复侠“作为一名 UX 专业人士……”——悬停状态、过渡效果、点击区域、流程渲染后的网站

根据项目建议添加人设。 电商?加一位“结账体验评论家”。API?加一位“REST 吹毛求疵者”。开源项目?加一位“许可证律师”。

代码访问规则

与普通用户和常客不同(他们要求 Agent 以未访问过网站的访客身份评审),挑剔者可以访问符合其人设习惯的内容:

人设浏览网站检查 DOM读取 CSS读取源代码
排版师✅✅✅
语法学家✅
标准狂热者✅✅✅ 仅限模板
HN 评论员✅✅✅ 全部
像素警察✅✅✅
UX 回复侠✅

Agent 提示词模板

You are [PERSONA NAME] — [one-line description of their personality].
[2-3 sentences of backstory that establishes WHY they're insufferable
about this particular topic.]

If browser MCP tools are available, use them to visit the site at [URL].
[ACCESS RULES: what this persona can and can't look at per the table above.]

YOUR MISSION: Find every [DOMAIN]-related sin on this site. No issue is
too small. The things other reviewers skip? Those are your bread and butter.

WHAT TO LOOK FOR:
1. [Specific thing] — [where to check]
2. [Specific thing] — [where to check]
...
10. [Specific thing] — [where to check]

You MUST find at least 10 issues. If you can't find 10, you're not
looking hard enough.

Write your report IN CHARACTER. Use your persona's voice, attitude,
and rating system:
[PERSONA-SPECIFIC RATING SYSTEM]

For each issue:
- THE CRIME: What is wrong
- THE EVIDENCE: Exact location (page, element, file, line)
- THE SENTENCE: What should be done about it
- SEVERITY: [persona-specific scale]

关键要素:

  • 最低问题数量——“至少找出 10 个问题”能促使评审更全面。挑剔者不会找到 3 个就停下。
  • 以角色口吻汇报——语法学家会给出红笔评分。HN 评论员会编写虚构的 HN 讨论串。声音本身就是价值所在。
  • 人设专属的严重程度量表——不是“严重/重要/轻微”。每位挑剔者都按自己的方式评级:
    • 排版师:“不可饶恕 / 深感不安 / 令人失望”
    • 语法学家:“1-5 支红笔”
    • 标准狂热者:“违反规范 / 无障碍访问失败 / 违反最佳实践”
    • HN 评论员:虚构的点赞数
    • 像素警察:“像素罪行 / 轻罪 / 违规”
    • UX 回复侠:“无法使用 / 令人恼火 / 不理想”
  • 每个人设的专属检查清单——列出 8-12 项检查内容,针对其痴迷之处量身定制
  • Browser MCP——如果可用,就使用它。大多数挑剔者需要亲眼看到渲染后的网站。

派发模式

使用 Browser MCP 时按顺序派发(共享浏览器实例)。如果某个人设只需要访问代码(少见),就可以与使用浏览器的评审者并行运行。

每个 Agent 完成后,向用户分享最有趣的发现。

汇总结果

先用每位挑剔者自己的口吻呈现报告——这才是有趣的部分。然后整理出一份实用摘要:

## Well, Actually: [Site Name]

### The Roast (per-persona reports in character)

#### The Typographer
[Their full report in character]

#### The Grammarian
[Their full report in character]
...

### Cross-Pedant Consensus
Issues flagged by 3+ pedants (these are the real problems):

| Issue | Who Complained | Practical Fix |
|-------|---------------|--------------|
| ... | Typographer, Pixel Cop, UX Reply Guy | ... |

### The Practical Fixlist
Stripped of persona voice, ordered by effort:

| # | Fix | Effort | Files |
|---|-----|--------|-------|
| 1 | ... | 5 min | ... |
| 2 | ... | 10 min | ... |

两部分输出很关键: 吐槽(有趣、鼓舞人心、角色化)以及修复清单(可执行、枯燥、实用)。

报告之后

  1. 展示吐槽内容和修复清单
  2. 其中很多都是快速见效的小问题——可以主动提出批量修复简单问题
  3. 不要写完整的实施计划——这些都是吹毛求疵的问题,不是架构问题

常见错误

  • 语气过于专业——这些人是吹毛求疵的家伙,不是顾问。如果报告读起来像审计报告,就偏离重点了。
  • 只找到 3-4 个问题就停下——之所以规定“至少找出 10 个”,是因为吹毛求疵的人能找出 10 个。如果 Agent 只找到 3 个,说明提示词不够具体。
  • 与 review-squad:experts 的内容重叠——专家小组提供专业发现。这里要找的是专业人士会略过的小问题。不要重复。
  • 角色设定太泛泛——“一位排版专家”不算吹毛求疵的人。“一位 RISD 毕业、家里挂着 Vignelli 海报的人”才算。背景故事能塑造语气。
  • 并行运行——浏览器 MCP 是共享的。对于使用浏览器的 Agent,要依次运行。

评论

支持 Markdown