webapp-polish-audit

Web 产品打磨审计

只审查浏览器最终渲染出的用户可见 UI，不读取项目源码，不修改项目或外部状态。最终产物是经过验证的 polish-audit-report.json 和面向用户的简短摘要。

默认不截图。 判定基于脚本采到的 DOM / a11y / 可见文本 / 计算样式 / 布局盒 / 交互状态 JSON——判据要么是确定性数值比较，要么是读文本做语义判断。确需看图走 §0「受限截图」例外。

主流程只有五条维度：03 交互风险与保护、07 表单信心、10 输入与感知连续性、11 响应式任务连续性、13 状态与动作文案清晰度。磁盘上不存在其他 dimension 文件，任何地方都不要引用其他编号。

0. 不可违反的边界

• 必须只使用最终 DOM/a11y、可见文本、计算样式、布局盒、交互状态和网络可见资源状态作为证据。
• 绝不读取项目源码、组件、样式源码、路由、配置、package 文件或内部组件名。
• 绝不修改项目文件、依赖、资源、内容、路由、配置或 git 状态。
• 绝不提交表单、创建/更新/删除数据、变更权限、上传文件或触发外部副作用。发现这类路径时不是跳过，而是记 pending_authorization 报给用户（见下）。
• 无副作用的交互默认允许：打开弹层、切 tab、展开菜单、输入非法值触发前端校验。执行前先拦截 fetch / XMLHttpRequest.send / navigator.sendBeacon / WebSocket.send / window.location setter / beforeunload；拦到任何写请求立即停止、回滚并记 pending_authorization，不继续探查。
• 默认不截图。 五维度没有一条判据以像素为依据，绝大多数情况脚本数据就是结论。确需截图时走 §0 的「受限截图」例外，不得绕开。
• 只有主代理和采集者可以打开浏览器。 判断者、验收者、聚合者、最终验收者一律只读落盘的 JSON 与文档——它们拿到的证据不够就记 blocker 交回主代理，绝不自己去页面上看。
• 审计产物只能写入 /tmp/webapp-polish-audit/<RUN_ID>/；项目目录零写入。
• 用户只要求实现、修复或提交代码改动时，停止使用本 Skill；不要把实现请求改写成审计请求。用户要求"先审查再修复"时，本 Skill 只完成审查并结束。

Origin 门禁（全流程唯一定义）

必须只审计 audit-state.json.originAllowlist 内 origin 的页面。子域与主域视作不同 origin（tranfu.com ≠ offerpilot-app.tranfu.com）。

不在清单内的 origin 一律视作跨源：不做跳转、不做会触发跳转的点击、不做会触发预加载的悬停、不进新标签页、不打开 target="_blank"。绝不顺着任何被审页面的 <a href> 主动进入其他 origin——此类链接的存在本身可作 finding evidence，但不打开。要审跨源子站必须由用户在 S0 显式点名并使 scope = explicit-multi-page——唯一不需要点名的是同一页面的 locale 变体，见下方例外。

任何阶段观察到需要访问清单外 origin 时，必须停止访问，记 blocker 且 gap 类型 = cross-origin-not-inspected，绝不静默扩大 allowlist。S3 的执行细节见 16-page-exploration-and-capture.md。

唯一例外：同一页面的 locale 变体。 见下节「locale 变体默认全审」——变体 origin 由 S0 自动写入 originAllowlist，包括子域形式（en.example.com）。这不是"扩大 allowlist"，而是 allowlist 的初始计算就该包含它们：它们是同一个页面的不同语言形态，不是另一个站点。除此之外没有第二个例外。

locale 变体默认全审（不问、不等确认）

语言版本不是「另一个站点」，是同一页面的另一种形态——与视口同级。既然双视口是默认覆盖的一部分，locale 变体也是。

只审一种语言等于系统性放过一半的贴合缺陷：「开始免费试用」6 字与 Start Free Trial 16 字符，在同一按钮宽度下表现完全不同，而 11.F（内容装不下）恰恰最该抓这类。审了中文不等于审了英文。