SuperAPI AI 工具集

well-actually

测试与质量

查看项目

更新于 10-15 10:24

技能介绍

用途

Well, Actually... 用于在你认为项目已经完成时,获得那种来自 Hacker News 评论者、排版洁癖、语法警察等“互联网挑刺者”的反馈。它专门捕捉专业审查者会跳过、但爱较真的人一定会拿来吐槽的小问题。

适用时机:

  • 公开发布任何内容之前(“人们会吐槽我什么?”)
  • 在你觉得自己已经做完之后(“我漏了什么?”)
  • 当你想要最后 5% 的打磨时
  • 当你需要动力去修复一直忽视的问题时

主要能力

默认面板包含 6 个“挑刺者”角色,每个角色专注于不同领域:

  1. The Typographer(排版师):字体搭配、字距、行高、孤行/寡行、垂直节奏。审查渲染后的网站 + CSS。
  2. The Grammarian(语法学家):每个逗号、破折号、大小写不一致、被动语态。仅审查渲染后的文本。
  3. The Standards Zealot(标准狂热者):语义 HTML、有效标记、ARIA 正确性、规范合规。审查渲染后的 DOM + 模板。
  4. The HN Commenter(HN 评论者):技术选型、打包体积、过度工程、“为什么不用纯 HTML?”。审查源代码 + 渲染后的网站。
  5. The Pixel Cop(像素警察):间距不一致、边框圆角不匹配、颜色差一个色阶。审查渲染后的网站 + CSS。
  6. The UX Reply Guy(UX 回复者):“作为一名 UX 专业人士……”——悬停状态、过渡、点击目标、流程。审查渲染后的网站。

可根据项目建议添加角色。例如电商项目可加“The Checkout Critic”,API 项目可加“The REST Pedant”,开源项目可加“The License Lawyer”。

每个角色有各自的代码访问规则,决定其可以浏览网站、检查 DOM、阅读 CSS 或阅读源代码。

每个角色必须找到至少 10 个问题,并以角色口吻撰写报告,使用角色专属的严重程度评级体系。例如:

  • 排版师:“Unforgivable / Deeply Troubling / Disappointing”
  • 语法学家:“1-5 Red Pens”
  • 标准狂热者:“Spec Violation / Accessibility Failure / Best Practice Breach”
  • HN 评论者:虚假的点赞数
  • 像素警察:“Pixel Crime / Misdemeanor / Infraction”
  • UX 回复者:“Unusable / Annoying / Suboptimal”

每个问题需包含:THE CRIME(问题是什么)、THE EVIDENCE(确切位置)、THE SENTENCE(应该怎么做)、SEVERITY(角色专属等级)。

使用方式

  1. 在派遣子代理前,先向用户展示默认面板,用户可调整。
  2. 使用代理提示模板为每个角色生成提示,包含角色名称、性格描述、背景故事、访问规则、任务、检查清单和评级体系。
  3. 如果可用,使用浏览器 MCP 工具访问目标网站。大多数角色需要看到渲染后的网站。
  4. 派遣模式:如果使用浏览器 MCP(共享浏览器实例),则顺序执行;如果某角色只需代码访问(罕见),可与使用浏览器的角色并行。
  5. 每个代理完成后,与用户分享最有趣的发现。
  6. 整合结果:先以每个角色的口吻呈现报告(这是有趣的部分),然后编译实用摘要。

最终输出分为两部分:

  • The Roast:每个角色的完整角色内报告。
  • Cross-Pedant Consensus:被 3 个以上角色标记的问题(这些是真正的问题),以表格呈现问题、谁抱怨了、实用修复方法。
  • The Practical Fixlist:剥离角色口吻,按工作量排序的修复清单,包含编号、修复内容、工作量、涉及文件。

报告之后:呈现吐槽和修复清单;许多是快速修复,可提议批量修复简单的;不要写完整实施计划——这些是吹毛求疵,不是架构问题。

适用场景

  • 网站或项目公开发布前的最后检查
  • 想要获得互联网风格的挑剔反馈
  • 需要动力修复被忽视的小问题
  • 追求最后 5% 的打磨

限制

  • 这不是专业审计。专业审查请使用 review-squad:experts 技能,它提供结构化、按严重程度排序的发现。
  • 不要与 review-squad:experts 重叠:专家面板给出专业发现,本技能给出专业人士跳过的吹毛求疵。
  • 常见错误包括:使用专业语气(这些是挑刺者,不是顾问)、只找到 3-4 个问题就停止(“至少找 10 个”规则存在是因为挑刺者能找到 10 个)、角色过于泛泛(“排版专家”不是挑刺者,需要具体背景故事来创造声音)、并行运行使用浏览器的代理(浏览器 MCP 是共享的,需顺序执行)。
  • 具体平台、收费、价格等信息暂未提供。