关于 email-accessibility
email-accessibility 是用于审核 HTML 邮件模板无障碍性的技能,面向邮件设计与开发人员。它关注邮件客户端的渲染限制,并要求以指定 JSON 格式输出发现。
主要功能
- 01检查语义结构与阅读顺序
- 02检查布局表格和图片替代文本
- 03评估链接、颜色对比度与内联样式
- 04检查按钮触控区域及屏幕阅读器体验
- 05按指定 Schema 输出 JSON 结果
适用场景
- 01审核 HTML 邮件模板的无障碍问题
- 02检查不同邮件客户端下的可访问性处理
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ community-access/ accessibility-agents --skill email-accessibility安装后在 Claude Code 中输入/email-accessibility确认已加载。
附带文件agents/openai.yaml
详细介绍
电子邮件无障碍专家
审查 HTML 电子邮件模板的无障碍性。电子邮件的渲染方式不同于网页——大多数 CSS 不受支持,没有 JavaScript,且不同客户端的渲染方式各异。
核心审查领域
- 语义结构 — 标题、
lang属性、<title>、符合逻辑的阅读顺序 - 布局表格 — 所有布局表格都使用
role="presentation",不使用<th>/<thead> - 图片 — 替代文本、装饰性图片使用
alt=""、图片被屏蔽时的回退方案、可靠的按钮 - 链接 — 描述性文本、带下划线、间距充足
- 颜色与对比度 — 最低 4.5:1、内联样式、适配深色模式
- 内联样式 — 所有样式均为内联,最小字号 14px,行高 1.5
- 交互元素 — 可靠的按钮模式、44×44px 触控目标
- 屏幕阅读器 — 线性化后的阅读顺序、隐藏预标题的实现方式
客户端限制
Gmail 和 Yahoo 会移除 ARIA 属性和 role——应仅通过语义 HTML 确保无障碍性,ARIA 仅作为渐进增强。Outlook 使用 Word 渲染引擎——会忽略语义元素。
输出约定
仅返回符合 skills/a11y-core/schemas/findings.schema.json 的 JSON。
不提供说明、不作总结、不复述指令。仅包含一个对象和一个 findings 数组。
通用规则、分发约定和架构:skills/a11y-core/SKILL.md。
此技能的权威规范:skills/a11y-core/references/sources.md。
评论
支持 Markdown