fixing-accessibility

fixing-accessibility 技能概览

fixing-accessibility 技能帮助你在 HTML 无障碍问题上线前进行审查和修复。它最适合设计师、前端工程师，以及正在处理影响键盘操作、屏幕阅读器、表单、对话框和视觉状态清晰度的 UI 变更的 AI 代理。如果你需要 fixing-accessibility for UX Audit，这项技能会把粗略检查变成一次聚焦的修复流程，而不是泛泛而谈的无障碍讲座。

fixing-accessibility 实际会做什么

这个 fixing-accessibility 技能会关注一些具体问题，例如缺少可访问名称、键盘导航失效、焦点处理薄弱、对话框行为不正确、表单错误提示不清晰，以及对比度或状态表达问题。它的核心价值不在于铺开讲 WCAG 理论，而在于提供一个实用的审查框架，帮你抓住最可能阻碍真实用户的问题。

最适用的场景和明确边界

当你在新增或修改按钮、输入框、菜单、标签页、下拉框、模态框，或仅图标动作这类控件时，最适合使用它。它不太适合做完整的企业级无障碍审计、法律合规复核，或需要人工政策判断的视觉设计评估。这个技能最强的场景是修复 UI 代码，而不是撰写报告。

为什么值得安装这个技能

fixing-accessibility install 的最大优势，是它会把代理的行为约束到最小、最有针对性的修复，而不是重写整个 UI。对于正在运行的代码库来说，这一点尤其重要：你需要的是安全改动、精确到行的发现，以及对无障碍缺陷的快速迭代。

如何使用 fixing-accessibility 技能

安装并在上下文中触发它

先在你的技能管理器里运行 fixing-accessibility install，然后在聚焦 UI 的对话或评审中直接调用它。仓库里的标准用法是使用 /fixing-accessibility 将指导应用到当前讨论，或者用 /fixing-accessibility <file> 来对某个文件进行带具体发现的审查。提问时要始终围绕你正在修改的组件或页面。

给技能一个它能真正处理的任务

高质量的 fixing-accessibility usage 一定是从具体目标开始，而不是笼统地说“检查无障碍”。要说明改了什么、代码在哪里、交互类型是什么。好的提示会包含 UI 模式、预期行为，以及对修改范围的约束。

示例提示：
/fixing-accessibility src/components/Modal.tsx Review for keyboard access, focus trap, aria labeling, and escape handling. Keep fixes minimal and preserve existing design.

先读对文件

先看 SKILL.md，因为里面写着规则优先级和交互模型。然后再检查组件或页面文件，以及附近的表单、模态框，或共享交互工具。由于这个仓库没有额外规则、参考文件或脚本，这个技能本身非常轻量；真正的收益来自把这些指导谨慎地应用到你自己的代码库里，而不是去找隐藏的辅助工具。

能提升输出质量的工作流

1. 先识别交互类型：表单、对话框、菜单、标签页、图标按钮，或隐藏内容。
2. 按技能的优先级类别，要求一次聚焦审查。
3. 对每一项违规都要求给出精确的代码片段或行号。
4. 只要求最小可行的代码级修复，不要让它重做设计。
5. 修改后重新运行，检查键盘流、标签、焦点是否回归异常。

fixing-accessibility 技能常见问题

fixing-accessibility 是用于 UX Audit 还是代码修复？

两者都可以，但它本质上更偏向修复导向的审查技能。用于 UX Audit 时，它能帮你找出无障碍阻塞点，并把它们转化为可执行的修复建议。如果你需要的是带严重等级评分的叙述型审计文档，可能还要配合更全面的审查流程。

这和普通无障碍提示词有什么不同？

普通提示词往往只会给出一份泛化的检查清单。fixing-accessibility 技能更窄，也更偏操作层面：它会按固定顺序优先处理可访问名称、键盘可达性、焦点管理、语义、表单错误、提示播报和对比度。这种结构能帮助代理减少不相关建议。

新手能用吗？

可以。新手通常最能受益，因为这个技能会告诉他们先看什么、应该最小化修什么。主要限制在于，他们仍然需要提供具体组件或文件；这个技能无法猜出究竟是哪块 UI 最关键。

什么时候不该用它？

不要把它当成法律合规签字工具、复杂无障碍政策判断工具，或者需要专门辅助技术验证的测试手段。它也不适合你想要的是广泛的重设计建议，而不是对现有 UI 代码做定向修复。

如何改进 fixing-accessibility 技能

输入要比“让它更无障碍”更具体

最好的结果来自对组件、交互和用户风险的明确描述。比如，“Review DatePicker.tsx for keyboard navigation, focus return, and announced errors after validation” 就比“fix accessibility”有效得多。这样能给技能一个清晰的失效面，减少表面化输出。

要求证据，而不只是建议

当你想得到真正有用的 fixing-accessibility guide 输出时，要让助手引用违反规则的准确代码片段或行号，简要说明为什么重要，再给出最小可行修复。这样不仅更容易落地，也更容易确认问题是否真实存在。

先迭代高风险类别

如果第一轮发现很多问题，修复顺序应该是：可访问名称、键盘可达性、焦点与对话框，然后是语义和表单。这些类别通常用户影响最大，而且代码层面的修复路径最清晰。之后再对更新后的文件重新运行技能，检查状态、对比度或播报是否出现回归。

要避免的常见失败模式

最常见的错误，是在没有说明 UI 模式或文件的情况下，笼统要求无障碍反馈。另一个问题是允许大范围重写，而这项技能本来就是为定向编辑设计的。第三个问题是忽略输入上下文，比如模态框是否需要焦点陷阱，或者按钮是不是仅图标按钮；这些信息缺失时，输出很容易变成泛泛建议，而不是代码真正需要的精确修复。