sts团队给 AI 页面去「AI 味」
human-ui-copy skill 的安装、用法与本站审计实例
给 AI 页面去「AI 味」
让 AI 写页面很快，但写出来的东西常带着一股「AI 味」：到处汇报自己用了什么技术、每张卡片一样工整、数字口径对不上。human-ui-copy 是团队发布的开源 skill，装进 AI 编程 agent 后，它会在交付前把这类问题逐条找出来。仓库：github.com/wang11453/human-ui-copy。
它解决什么
三类最常见的症状：
| 症状 | 例子 |
|---|---|
| 实现注记泄漏 | 卡片角标写着「本地 ffmpeg - 无需上传」，用户并不关心代码跑在哪 |
| 自我夸赞 | 「一次大胆的尝试」「追求极致」这类自我评价 |
| 结构过度均匀 | 每个模块都是同宽卡片 + 同款圆角 + 同款渐变，整齐得发假 |
这些例子全部来自本站被审出来的真实问题。
三条核心原则
- 只讲用户收益，不汇报实现。「浏览器本地运行的 AI 工具，文件不上传」→「AI 工具，免费不限次」。
- AI 是均匀的，人是偏心的。真人排版会偏心：重点的地方大，次要的地方小。全都一样大，等于全都不重要。
- 防止过度修正。skill 自带反方向约束：不是把所有整齐都打破，更不能为了打破而打破产品本身。
怎么装
- Claude Code 等 agent：把仓库里的
SKILL.md按说明放进 agent 的 skills 目录即可，references/附录是给人读的资料，不用一起放 - 其它 agent：把
AGENTS.md片段粘进你项目的对应文件 - 没有 agent 也能用：当人工 code review 清单，照着逐条过
怎么用
两种模式，按页面性质选：
| 模式 | 适用 | 检查范围 |
|---|---|---|
| prototype | 草稿、demo | 只查 must 项 |
| delivery | 正式上线 | must + judgement 全查 |
报告分两级：must 是修了才算过的（比如实现注记泄漏），judgement 是看情况取舍的（比如把一组完全相同的卡片打破成不对称布局，值不值得）。agent 交付时会给出逐条定位和改法。
仓库里还有什么
| 文件 | 用途 |
|---|---|
| SKILL.md | 唯一需要安装的文件，agent 的判断规则都在里面 |
| check.py | 机械项自动检查脚本：调试残留、分隔符、绝对路径等，一条命令跑全站 |
| references/ | 给人读的附录：完整规则、审计报告样例、本站实战记录 |
| examples/ 与 tests/ | 一步步的改造走查示例与回归测试 |
check.py 还带页面档位（game、tool、marketing 等）：不同类型的页面白名单不同，比如赔率表里的分隔符是行业惯例，不该按违规报。
这些不算 AI 味
白名单里的内容改了反而错：
- 无障碍要求的标注（比如装饰图标的
aria-hidden） - 功能性技术参数（比如「模型约 7MB」，用户需要它估计流量）
- 基于真实用户意图的强调
案例：本站的实地审计
stsqz.com 全站用这个 skill 审过一遍，仓库 references/real-audit-static-site.md 记录了全过程。量最大的一项：全站 461 个 SVG 里 395 个装饰性图标缺 aria-hidden。这一条恰好贴着白名单边缘——它属于无障碍修复，值得做，但 461 个一把全改风险太高，最后按页面分批、改一批验一批。其余修复就是开头表格里的实现注记与自我夸赞清理。
参与进来
仓库以 MIT 协议开源：github.com/wang11453/human-ui-copy。遇到误报，或想加新的判断规则，欢迎提 issue 和 PR。