关于 document
Document 是一项设计技能，用结构化记录保存功能相关的无障碍决策，便于团队持续追踪。它涵盖决策背景、取舍、补救计划和 WCAG 覆盖情况。
主要功能
- 01记录背景、选择、替代方案、影响和依据
- 02分析无障碍取舍并制定补救计划
- 03将决策对应到 WCAG 标准
- 04汇总决策日志、缺口和待办事项
适用场景
- 01在团队人员变动后保留无障碍决策依据
- 02审查用户需求与项目限制之间的冲突
- 03跟踪 WCAG 覆盖情况和未解决的无障碍工作
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/document确认已加载。
详细介绍
记录无障碍决策
将某项功能的所有无障碍决策记录在一份结构化文档中，确保团队变动或重新设计后仍能保留。
流程
步骤 1：识别决策
列出所有会影响无障碍性的设计或实现选择：
- 选定的交互模式
- 内容和语言方面的决策
- 视觉设计方面的决策
- 已纳入和延后的事项
- 在约束条件下做出的权衡
步骤 2：记录每项决策
使用 decision-documentation，为每项决策记录：
- 背景：决策的缘由
- 决策：做出了什么选择
- 替代方案：考虑过并予以否决的方案
- 影响：谁会受益，谁会受到影响
- 依据：支持该决策的证据
步骤 3：分析权衡
使用 tradeoff-analysis，针对任何无障碍性有所妥协或用户需求相互冲突的决策：
- 每种方案分别让谁受益
- 每种方案分别会损害谁的利益
- 严重程度差异（无法使用与操作不便）
- 为被排除的用户制定补救计划
- 复审日期
步骤 4：映射到标准
使用 compliance-mapping，将每项决策映射到相关的 WCAG 准则：
- 该决策满足哪些准则
- 该决策会影响哪些准则
- 是否存在符合性风险
输出
交付一份功能无障碍决策记录：
- 功能摘要 — 构建了什么，以及面向哪些用户
- 决策日志 — 按标准格式记录每项决策
- 权衡登记表 — 列出所有权衡及其补救计划
- 符合性映射 — WCAG 准则覆盖范围和差距
- 待处理事项 — 需要后续解决的延后决策
评论
支持 Markdown