需要决定产品交互、动作范围、可逆性与状态覆盖时…

当要设计流程、选择控件、判断删除是否可撤销、审查产品决策，或加固错误/权限/离线/过期/破坏性路径时，先完成产品设计决策，再路由到构建、验证和文案。

适用场景

解决思路

1. 先根据用户动词和产物判定一种模式：shape（默认）、spec、review、action、harden；意图模糊时使用动词支持的最窄模式。
2. 在每种模式都加载 references/rules.md；每个 finding 引用其中的 rule ID；没有该注册表时不能断言没有规则管辖某决策。
3. shape 模式：加载 references/product-judgment.md 和 references/surfaces.md，用于「design the flow for」「what control here」「how should this work」「is this the right pattern」或没有已定 UI 的 brief。
4. spec 模式：加载 references/product-judgment.md、references/surfaces.md、references/naming-and-copy.md；将构建 route 到 `ui-design`。
5. review 模式：加载 references/interface-quality.md；审查一个 flow 背后的产品决策是否正确，不审查已构建 artifact。
6. action 模式：加载 references/naming-and-copy.md；处理「what should this action affect」「should this be undoable」「do we need a confirm dialog」或可逆性未定；最终措辞 route 到 `ghostwriter`。
7. harden 模式：加载 references/surfaces.md、references/interface-quality.md、references/product-judgment.md；处理 error、permission、offline、expiry 和 destructive paths。
8. 模式可链式：shape 导入 spec；review 导入 harden；URL、screenshot、route、component 只识别 scope，不授权 edits。
9. references/lint-patterns.md 没有模式；当决定某标准应放入消费项目 linter 还是本技能时读取它。
10. evals/evals.json 从不在用户任务中加载；它是修改本技能者的回归集。
11. Workflow Step 1：将请求分类到一种模式。
12. Workflow Step 2：定位权威，包括用户约束、项目设计系统、AGENTS.md。
13. Workflow Step 3：加载 references/rules.md 以及该模式的 reference files。
14. Workflow Step 4：写内部 brief（shape、spec、harden）；如果 job、outcome、consequence 无法填写，停下并询问。
15. Workflow Step 5：对范围内每个 action 命名 object、scope、consequence、reversibility（spec、action、review）。
16. Workflow Step 6：枚举 reachable states 并检查 coverage（shape、spec、harden）。
17. Workflow Step 7：输出时每个 finding 或 decision 带 rule ID 或标注 coverage gap；把 follow-on work route 到 sibling skills。
18. Workflow Step 8：检查 decision contract 并识别未解决的产品决策。
19. Step 5 和 Step 6 按模式限定：纯 action pass 没有 state matrix 要枚举；shape pass 没有已构建 action 可命名。
20. 输出长度随工作，不随模板；单个已定决策就是短答案；删除该 pass 不需要的 sections，不要填充。
21. 按冲突顺序解决决策权威：1 用户明确目标与约束；2 已验证的用户和产品证据及系统实际行为；3 项目规范 guidance（AGENTS.md 或 CLAUDE.md、项目设计系统、routed sibling skills）；4 sibling-skill ownership：route，不 duplicate；5 本技能标准；6 通用 interface/platform conventions（WCAG 2.2、NN/g、Apple HIG、Material、GOV.UK），rules.md 按规则引用。
22. 当请求跨权威时，指出 owning skill 并 hand off。
23. Right interaction：根据 choice 的 shape 选择 control；保持 options 可见且可逆；优先 inline disclosure 而非 modal；每个 gesture 都有 control alternative；选择最小 coherent intervention；引用 rule/control-matches-cardinality、rule/navigation-vs-action、rule/inline-before-modal、rule/no-nested-modals、rule/gesture-has-control-alternative、rule/smallest-intervention；细节见 references/product-judgment.md。
24. Action naming and consequence：命名 object、scope、consequence；先解决 reversibility，再选 pattern；不可逆 action 要有 review、check 或 named confirmation；只有诚实可恢复时才提供 undo；引用 rule/name-object-scope-consequence、rule/destructive-names-action、rule/destructive-proportional、rule/irreversible-action-safeguard、rule/undo-only-when-honest、rule/preserve-user-input；细节见 references/naming-and-copy.md。
25. State coverage：设计每个 reachable state，不只 populated：empty states 命名 object 和 first action；errors 解释并提供 recovery；timers 在 discard 前警告；引用 rule/cover-reachable-states、rule/empty-state-action、rule/error-states-recovery、rule/loading-stable-labels、rule/time-limit-adjustable；细节见 references/surfaces.md。
26. Resilience：overflow、extreme data、localization and RTL、offline、network failure 是 designed states；每次 fetch 都落入一种状态；共享 rule/cover-reachable-states；细节见 references/surfaces.md > Resilience；构建后的 UI 是否渲染这些是 `ui-design` Audit mode 的检查。
27. Accessibility as task completion：每个 control 有 name；primary flow 能用 keyboard 完成并有 visible focus；已输入内容不重输；认证允许 assistance；state 和 consequence 可理解，不只是 labeled；引用 rule/accessible-name-required、rule/keyboard-complete-flow、rule/no-custom-focus-bypass、rule/no-redundant-entry、rule/auth-allows-assistance；细节见 references/interface-quality.md；Markup 和 target-size 检查 route 到 `ui-design` Audit mode。
28. Review output：在 review 和 harden 模式，先给按 user impact 排序的 findings（P0 到 P3），每个含 location、verification status、rule ID、user consequence，以及带 owning skill 的最小具体修复。
29. 保持 findings 在 decision altitude；line-level code 或 framework fix 是 `ui-design` Audit mode 的输出；Rubric 和 finding format 见 references/interface-quality.md > Severity rubric。
30. Pass self-check：每个 finding 和非机械 decision 都带一个在 references/rules.md 中逐字出现的 rule ID，或一个内联标注 proposed 的 coverage gap。
31. Pass self-check：对 shape、spec、harden，内部 brief 必须包含 job、desired outcome、consequence。
32. Pass self-check：范围内每个 destructive 或 consequential action 都要声明 reversibility 并有匹配 pattern。
33. Pass self-check：follow-on work 按名称 route（`ui-design`、`ui-animation`、`ghostwriter`），绝不在此做。
34. Gotcha：可逆 action（archive、remove from list、unsubscribe）上加 confirmation dialog 会训练用户点穿，使真正重要的 permanent delete confirmation 也被反射点击；应 act and offer undo；引用 rule/destructive-proportional。
35. Gotcha：undo toast 作为唯一恢复路径会约五秒消失，object 也没了；要么 object 保持可恢复（Trash、Archive），要么 action 不可逆并需要 safeguard；否则不要称 undo；引用 rule/undo-only-when-honest、WCAG 2.2.1。
36. Gotcha：swipe-to-delete 或 drag-to-reorder 没有 button 或 menu equivalent 会直接违反 WCAG 2.5.1 和 2.5.7，且对其他人不可发现；在把 physics route 到 `ui-animation` 前先 spec alternative；引用 rule/gesture-has-control-alternative。
37. Gotcha：segmented control 三个固定宽度英文标签：少于 10 字符的字符串翻译后会增长 200% 到 300%（W3C），如「Day / Week / Month」在德语中会换行或裁剪；在 spec 中决定 wrap 或 stack 行为。
38. Gotcha：不要把「No projects yet, Create project」empty state 重用于 filtered-to-zero list；用户会创建重复项，因为搜索项在 filter 后面；Three empties, three designs；见 references/surfaces.md。
39. Gotcha：checkout 或 sign-up 再次询问两步前已输入内容（billing address after shipping、email after account）会违反 WCAG 3.3.7，且是移动用户离开的步骤；引用 rule/no-redundant-entry。
40. Gotcha：不要输出 line-level fix（prop、hook、className）而不是 decision；它缺少验证渲染的检查，且未陈述应承载的产品决策；route 到 `ui-design` Audit mode。
41. Gotcha：不要引用看似合理但不存在的 rule ID（例如 rule/clear-labels）；该 citation 解析不到任何内容，无法与 `ui-design` audit 去重或追踪到规则；应记录 coverage gap。
42. Routing：`ui-design` 负责 visual direction 和把决定好的 interaction 写成代码；其 Audit mode 覆盖 built result、rendered quality、accessibility markup，并给 ship verdict。
43. Routing：`ghostwriter` 负责 names、errors、empty and loading copy 的 exact wording，按本技能拥有的 copy rule IDs 写。
44. Routing：`ui-animation` 负责两个状态之间的 passage（timing、easing、springs、gesture physics）；本技能决定 gesture 是否替代 control 及其 alternative；该技能构建 motion。
45. Routing：`ax-audit` 负责 built agentic feature 是否赢得 trust；本技能先决定它应该做什么。
46. Routing：`typography-audit` 负责 deep type。
47. Routing boundary：product-design 拥有 action semantics、scope、reversibility 和有争议的 state choices；`ui-design` 构建和样式化这些 states；`ui-animation` 拥有 timing、gestures、measured motion；常规缺失 loading 或 error state 留在 UI build；用 gesture 替代 control 需要产品决策和 accessible alternative，然后才做 physics。
48. 执行本技能时：从 brief、spec、mockup、intent 或现有 UI 出发，选择 interaction 和 control，命名每个 action 的 object、scope、consequence，解决 reversibility 及其隐含 safeguard，枚举每个 reachable state，设定 resilience expectations，并要求 accessibility 作为 task completion；然后 route build、verification、wording 出去。
49. 不要在本技能中判断功能是否值得投资或是否契合产品；将其作为 open product question 陈述。
50. 不要在本技能中构建或样式化 UI、做视觉方向、palettes、type；这些 route 到 `ui-design`。
51. 不要在本技能中审计已构建结果（rendered quality、a11y markup、keyboard、layout、performance、React 或 Next code-level UX with ship verdict）；这些是 `ui-design` Audit mode。
52. 不要在本技能中处理 copy wording、persuasion、AI-ism removal；这些 route 到 `ghostwriter`。
53. 不要在本技能中处理 motion、gesture physics、deep typography；这些 route 到 `ui-animation`、`typography-audit`。
54. 不要在本技能中判断 agentic feature 是否赢得信任；这些 route 到 `ax-audit`。

适用边界 · 注意事项

• 不适用于构建或样式化 UI、视觉方向、调色板、字体；这些应路由到 `ui-design`。
• 不适用于审计已构建结果（rendered quality、a11y markup、keyboard、layout、performance、React/Next code-level UX 的 ship verdict）或 component/UI/design QA；这些属于 `ui-design` Audit mode。
• 不适用于文案措辞/说服/去 AI 味、动效/手势物理/深度排版、判断 agentic feature 是否赢得信任、判断功能是否值得投资或契合产品；分别路由到 `ghostwriter`、`ui-animation`、`typography-audit`、`ax-audit` 或列为 open product question。