Skip to content
Back to search

design-hawkeye

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
findsafeskills safety rating

Markdown

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

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.