Back to search
design-hawkeye
SkillWorks with Claude CodeGitHub
UI 走查 skill。当用户要求检查界面问题、做 UI/交互走查、审查页面或设计的可用性缺陷时使用。输入 URL、本地 HTML 或截图,按规则库输出带实测证据的问题清单。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/ellisonnnnnnn--design-hawkeye-skill)HTML
<a href="/listings/ellisonnnnnnn--design-hawkeye-skill"><img src="/api/listings/ellisonnnnnnn--design-hawkeye-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 95 lines
- ---
- name: design-hawkeye
- description: UI 走查 skill。当用户要求检查界面问题、做 UI/交互走查、审查页面或设计的可用性缺陷时使用。输入 URL、本地 HTML 或截图,按规则库输出带实测证据的问题清单。
- ---
- # 设计火眼金睛
- ## 0. 当前能力边界(v0.1,务必先读)
- 规则库共 29 条,**目前只有 2 条转成了机器规则**(`rules/rules.sample.json`)。因此:
- - 可自动执行:`UI-001` 表单标签基线、`UI-029` 破坏性操作与常规操作同组同样式
- - 其余 27 条:只能在人工判断后引用其 `fix` / `why`,**不得声称已检测**
- - 探针执行器尚未实现:当前需手工在页面上下文执行 `rules[].dom.js`
- 报告里必须把"未检测"和"检测通过"分开写,不许沉默跳过。
- ## 1. 何时用
- 用户提出以下诉求时使用:UI 走查、界面问题检查、可用性审查、交互缺陷排查、给定页面或截图要求挑毛病、要求按规范评审界面。
- 不适用:视觉设计创新、品牌风格建议、纯代码 review(无界面)、性能与安全问题。
- ## 2. 输入
- 三种,能力不同,不得混判:
- | 输入 | 通道 | 限制 |
- |---|---|---|
- | URL 或本地 HTML 路径 | DOM + 截图 | 可给像素值,`confidence` 可达 high |
- | 截图(多张) | 仅视觉 | 禁止给像素值,最高 medium |
- | 设计稿图片 | 仅视觉 | 只能判结构与层级,不能判交互实现 |
- ## 3. 工作流
- 1. **确认作用域**:页面哪一块要查(整页 / 某个弹窗 / 某个列表)。作用域不清就先问,不要整页扫。
- 2. **读规则**:按 `component` 字段先过滤,只加载与当前页面组件类型相关的规则。
- 3. **校验前提**:逐条过 `scope.when` / `selector` / `minItems` / `state`。前提不成立 → 记 `skipped` 并写明原因,**不运行**。
- 4. **执行检测**:
- - L1:在页面上下文跑 `dom.js`,拿返回值比 `threshold`
- - L2:先截取 `visual.region`,按 `visual.signal` 判读,并用 `visual.counter` 排除误判
- - L3:先执行必要交互(勾选、提交、翻页)再检测
- 5. **收集证据**:每条命中都要能回答"凭什么"。缺证据降级为 `suspect`。
- 6. **出报告**:按 §4 格式,先给结论摘要,再列明细,最后写跳过的规则和原因。
- ## 4. 输出契约
- ```json
- {
- "target": "file:///.../dialog.html",
- "channel": "dom+visual",
- "summary": { "hit": 2, "p0p1": 1, "skipped": 27, "suspect": 0 },
- "findings": [
- {
- "ruleId": "UI-029",
- "title": "破坏性批量操作与常规批量操作同组同样式",
- "severity": "P1",
- "confidence": "high",
- "channel": "dom",
- "evidence": {
- "values": { "clearBtn": { "bg": "rgba(0,0,0,0)", "gapToPrev": 24, "disabled": true } },
- "selector": ".tools button",
- "crop": "crop-001.png"
- },
- "fix": "……",
- "verify": "……"
- }
- ],
- "conflicts": [],
- "skipped": [{ "ruleId": "UI-014", "reason": "页面无表格,scope.minItems 不满足" }]
- }
- ```
- 硬性要求:
- - **每条结论必须带 `evidence`**,取不到就标 `suspect`,不许用"看起来""建议优化"代替
- - **`skipped` 必须写原因**,"没报"不等于"没问题"
- - 严重度按 `P0 阻断发布 / P1 上线前修 / P2 排期修 / P3 可选` 排序与措辞
- - 多个问题落在同一元素时合并成一条,不重复计数
- ## 5. 判定纪律
- - 阈值取 `rules[].dom.threshold`,不得自行放宽或收紧;认为阈值不合理就照实报,并在报告里单列一条"规则本身待调整"
- - 视觉判读时先读 `visual.counter`,命中反例就**不报**。误报一次比漏报三次的代价更高
- - 同一元素在同一规则下只报一次,不因滚动或重渲染重复计数
- - 不确定就标 `suspect` 交给人,不要用措辞把它包装成确定结论
- ## 6. 引用文件
- | 文件 | 用途 |
- |---|---|
- | `rules/schema.md` | 字段定义与判定规则,改规则前先读 |
- | `rules/rules.sample.json` | 已实现的 2 条规则,也是新规则的转写模板 |
- | `library/issues.json` | 完整 29 条,含 `fix` / `why` / `ref`,用于解释和给修改建议 |
- | `examples/` | 已知答案的样本页,改规则后拿它回归 |
README.md · README · 109 lines
- # 设计火眼金睛 · Design Hawkeye
- 把人工 UI 走查的经验,整理成**机器可执行、结论可复核**的规则库,供 AI skill 调用。
- 不是给人看的检查清单,是给 agent 跑的判据。
- ---
- ## 当前状态
- `v0.1` · 2026-11
- | 项 | 状态 |
- |---|---|
- | 问题入库 | ✅ 29 条,11 个分类,P0–P3 分级 |
- | 规则格式 | ✅ schema v0.1 已定稿,双通道字段齐备 |
- | 机器规则 | 🟡 已转 2 条(1 条数值型 L1、1 条判读型 L2),均在真实页面上验证可跑 |
- | 探针执行器 | ⬜ 未实现 |
- | 报告生成 | ⬜ 未实现 |
- **这个仓库现在能做什么**:查、筛选、当 checklist 用、看规则怎么写。
- **还不能做什么**:自动跑一个页面并出报告。
- ---
- ## 目录
- ```
- rules/
- schema.md 规则格式规范:字段定义、双通道写法、证据要求、level 分档
- rules.sample.json 2 条已实测的样例规则,可作为转写模板
- library/
- issues.json 29 条问题的唯一数据源(人查阅 / 原始记录)
- build.py 由 json 生成查询页与纯文本版
- index.html 查询页:问题库 / Checklist / 设计标准 / 标注规范 / 维护说明
- issues.md 纯文本镜像,便于 grep 与贴进 wiki
- examples/
- adding-step-dialog.html 「添加 Step」弹窗优化:前后对照 + 8 处原位红点标注
- tab-overflow.html 顶栏多页签溢出的 5 种交互方案对比
- ```
- `library/index.html` 与 `library/issues.md` 都是 `issues.json` 的产物,**不要直接改**,下次构建会被覆盖。
- ```bash
- python3 library/build.py # 重新生成 index.html 与 issues.md
- open library/index.html
- ```
- ---
- ## 三个核心设计
- ### 1. 人和机器看的是同一批问题,但格式不同
- `issues.json` 里的 `check` 字段是给人看的动作("沿标签左边界画一条竖线,看是否压线")。
- 机器需要的是另一套东西:**取什么值、阈值多少、什么情况不算**。同一个问题在 `rules/` 里被写成:
- ```json
- "dom": { "probe": "labelBaseline", "js": "...", "threshold": { "maxLeftSpreadPx": 2 } },
- "visual": { "signal": "标签顶边呈阶梯状", "counter": "分组标题不算字段" },
- "evidence": ["每个 label 的 left / top 实测值", "命中的容器选择器", "区域裁切图"]
- ```
- 只写"怎么查"这种动作不够用——agent 会自己补一个听起来合理的结论,而那个结论你没法验。
- ### 2. 双通道,且不许互相顶替
- | 情况 | 处理 |
- |---|---|
- | DOM 可用 + 视觉可用 | DOM 判定为准,视觉只补充描述 |
- | 只有截图 | 最高 `confidence: medium`,**禁止给像素值**,只描述相对关系 |
- | 两通道结论相反 | 输出 `conflict`,不裁决,两份证据都附上 |
- ### 3. 无证据不下结论
- 每条命中必须带 `evidence`:DOM 给数值和选择器,视觉给裁切图。取不到证据只能报"疑似"。
- ---
- ## 规则的执行难度分三档
- | level | 含义 | 检测方式 | 数量 |
- |---|---|---|---|
- | L1 | 可量化,算出来就知道对错 | 纯 DOM 探针 | 约 11 |
- | L2 | 需判读,得看版面 | 视觉为主 + DOM 辅助数值 | 约 15 |
- | L3 | 需交互才暴露(必填未校验、误关无撤销) | 先执行动作再检测 | 约 3 |
- 探针在真实页面上踩过三个坑,已写进 schema:模糊选择器重复命中(要 Set 去重)、命中包裹层取到合并文本(要排除含子 button 的元素)、禁用态颜色伪装成"已区分"(要 `scope.state` 前置状态)。
- ---
- ## 路线图
- - [x] 29 条问题入库,带判据、改法、检查动作
- - [x] 规则格式 v0.1,含双通道与证据要求
- - [x] 2 条样例规则,真实页面验证可跑
- - [ ] L1 的 11 条转成机器规则
- - [ ] 探针执行器 `run.py`:打开页面 → 跑规则 → 出 JSON
- - [ ] 用 `examples/` 里的页面做回归测试(期望命中项已知)
- - [ ] L2 视觉规则,重点是补 `counter` 反例
- - [ ] L3 交互脚本
- - [ ] 报告模板:JSON + 带红点标注的 HTML
- ---
- ## 说明
- - `library/issues.json` 里 15 条标 `baseline` 的是通用高频问题,**尚未在具体系统上确认过**,与 `walkthrough` 有明确区分,不要混用。
- - 许可证暂未指定。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.