design-accessibility

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Principles

原则

Use semantic HTML first — ARIA is a last resort, not a first tool
Proper heading hierarchy — one h1 per page, never skip levels
Alt text on all meaningful images
Maintain 4.5:1 minimum color contrast ratio
Use
```
<button>
```
for actions,
```
<a>
```
for navigation — never a styled
```
<div>
```

优先使用语义化HTML——ARIA是最后手段，而非首选工具
正确的标题层级——每页一个h1，切勿跳过层级
所有有意义的图片添加替代文本（Alt text）
保持至少4.5:1的最小颜色对比度
使用
```
<button>
```
实现操作，
```
<a>
```
实现导航——切勿使用样式化的
```
<div>
```

Rules

规则

See rules index for detailed patterns.

详见规则索引获取详细模式。

Examples

示例

Positive Trigger

触发场景

User: "Audit this form for WCAG AA issues and keyboard traps."

Expected behavior: Use

design-accessibility

guidance, follow its workflow, and return actionable output.

用户：“审查此表单的WCAG AA问题和键盘陷阱。”

预期行为：使用

design-accessibility

指南，遵循其工作流程，并返回可执行的输出结果。

Non-Trigger

非触发场景

User: "Optimize SQL indexes for this analytics query."

Expected behavior: Do not prioritize

design-accessibility

; choose a more relevant skill or proceed without it.

用户：“优化此分析查询的SQL索引。”

预期行为：不优先使用

design-accessibility

；选择更相关的技能或直接处理。

Troubleshooting

故障排除

Skill Does Not Trigger

技能未触发

Error: The skill is not selected when expected.
Cause: Request wording does not clearly match the description trigger conditions.
Solution: Rephrase with explicit domain/task keywords from the description and retry.

错误：技能未按预期被选中。
原因：请求措辞未明确匹配描述中的触发条件。
解决方案：使用描述中的明确领域/任务关键词重新措辞后重试。

Guidance Conflicts With Another Skill

指南与其他技能冲突

Error: Instructions from multiple skills conflict in one task.
Cause: Overlapping scope across loaded skills.
Solution: State which skill is authoritative for the current step and apply that workflow first.

错误：多个技能的指令在同一任务中冲突。
原因：已加载的技能存在范围重叠。
解决方案：指定当前步骤的权威技能，并优先应用其工作流程。

Output Is Too Generic

输出过于笼统

Error: Result lacks concrete, actionable detail.
Cause: Task input omitted context, constraints, or target format.
Solution: Add specific constraints (environment, scope, format, success criteria) and rerun.

错误：结果缺乏具体、可执行的细节。
原因：任务输入遗漏了上下文、约束条件或目标格式。
解决方案：添加具体约束（环境、范围、格式、成功标准）后重新运行。

Workflow

工作流程

Identify whether the request clearly matches
```
design-accessibility
```
scope and triggers.
Apply the skill rules and referenced guidance to produce a concrete result.
Validate output quality against constraints; if gaps remain, refine once with explicit assumptions.

识别请求是否明确匹配
```
design-accessibility
```
的范围和触发条件。
应用技能规则和参考指南生成具体结果。
根据约束条件验证输出质量；若仍存在差距，基于明确假设优化一次。