用途
better 用于改进单个已确定的屏幕、流程、功能或产品界面，涉及无障碍、布局、文案、排版、颜色和 UI 细节等方面。默认行为是实施：检查现状、识别具体修复点、直接应用修改，并在同一任务内验证结果。
主要能力与工作方式
- 将 $better、“better this UI”、“make this smarter”等表述视为实施请求，不会在列出问题后就停止，也不会只提议而不动手，或询问是否继续。仅在缺少无法从上下文推断的关键信息时才提问，等待期间继续可独立开展的工作。
- 尊重明确的 “audit”、“review only”、“read-only”、“plan only”、“no edits” 等要求，将其作为不可修改的边界。
- 对分支、PR、提交范围或未提交改动的显式变更审查，使用 interface-review 并保留其范围与状态标签；改进请求中的版本控制引用只标识实施范围，不使该请求变成只读审查。
- 简要说明范围；一次检查一个完整流程，覆盖存在的空、加载、错误和窄宽度状态。维护具体问题清单作为实施范围，应用所有可执行且范围内的修复，而不仅是 HIGH 级问题。报告按严重度排序，但报告不限制实际执行的工作。
- 识别技术栈、设计令牌、视口和预览命令；阅读项目界面文档（CONTRIBUTING.md、AGENTS.md、design-system、Storybook）。有文档约定的问题仍会报告；共享令牌导致的问题只针对该来源报告一次。
使用方式：指南加载顺序
按以下顺序加载可用指南，识别修复点后实施：
- references/accessibility/guide.md
- references/layout/guide.md
- references/writing/guide.md
- references/typography/guide.md
- references/colors/guide.md
- references/ui/guide.md
从各指南获取原则、参考与验证检查；严重度、排序和格式由本入口文件负责。缺失的指南标记为 Not reviewed 并附路径，不重建其规则。重叠问题归属底层规则的所有者，只报告一次。
引用 path/to/file:line 并展示当前实现。不单凭外观报告代码问题，也不单凭源码报告视觉问题（当运行时决定结果时）。运行项目安全可用的检查；无法运行的检查标记为 Not verified。
严重度分级
- HIGH：阻塞任务、误导用户、隐藏内容、有数据丢失风险或已确认触发条件，例如：未命名控件、缺少焦点、仅指针可达路径、忽略 prefers-reduced-motion、320px 或 200% 缩放下裁切、对比度不达标、仅用颜色传达含义、未确认的破坏性操作、被截断内容不可达、未披露的溢出、无恢复途径的错误、语义色违背其含义、仅靠动效表达的状态。
- MEDIUM：损害理解、效率、适应性或一致性。
- LOW：孤立的外观打磨。
先排触发条件，再看影响范围。修复优先级：删除 → 平台能力 → 现有令牌 → 正确取值 → 新增。一个根因对应一行记录，不堆砌列表。
适用场景与限制
使用现有组件和令牌实施，保留无关工作，修改后重新验证。区分已验证行为、未测试状态与无关检查失败。实施请求本身不授权部署、发送消息或其他外部操作。交付时简要说明改了什么、检查结果与剩余阻碍，有可用预览时附上渲染预览。对明确的仅审查请求或要求附带详细审查时，使用 references/review-format.md 格式。