用途 该技能是“开源无障碍框架”(OSAF)的参考数据,不是审查器。当任务点名该框架、其中某个阶段或动作、跟踪问题或项目看板时,打开它查询事实而非猜测:某个 ID 属于哪个动作、其节奏、由哪个阶段技能实现、注册如何运作。四个阶段技能承载“完成定义”(Definition of Done),此文件是其上的索引。
框架是什么 开源无障碍框架帮助开源项目一次一个实际步骤地把无障碍融入项目运作方式。它采用 MIT 许可证(版权归 GitHub, Inc.),由 open-source-accessibility 组织托管、GitHub 与 Microsoft 赞助,网站为 open-source-accessibility.github.io,源码在 open-source-accessibility/Open-Source-Accessibility-Framework。它是改进框架,不是认证、评分或排名;参与项目是在公开、可跟踪地推进无障碍工作,并不宣称已无障碍。
可说:框架支持稳定、可见的改进;项目从小处开始并调整动作;进展与剩余障碍可见;自动化检查补充人工测试与社区反馈。不可说:参与即获认证、合规或完全无障碍;完成框架即保证符合任何标准;自动化测试能发现所有障碍;AI 输出可替代无障碍专业知识和残障人士反馈。
阶段与产出 四个阶段按框架列出顺序为:Foundational(让无障碍承诺可见,建立清晰的报告与跟踪路径,2 个动作/4 项任务,技能 osaf-foundational)、Workflow(把无障碍融入文档、设计、分类、拉取请求、归属与依赖决策,10/27,osaf-workflow)、Testing(为核心体验与文档增加可重复的自动与人工无障碍检查,6/17,osaf-testing)、Community(回应反馈、分享进展、邀请参与、支持无障碍协作,6/19,osaf-community)。Foundational 最先,其余可按项目适合的顺序跟进。
投入与节奏 Quick 指不足一小时,Moderate 一至三小时,Extended 超过三小时;随项目规模与成熟度变化。节奏:一次性设置(需要变化时再调整);初始设置+持续(建立后需维护或使用);持续(作为日常工作重复)。
动作索引 每个动作含精确 ID、任务数、典型初始投入与节奏;ID 是动作标题的 slug,阶段文档中的标题锚点为数字-连字符-ID。Foundational:1 create-an-accessibilitymd(2,Quick,一次性设置);2 use-an-accessibility-label-to-track-relevant-work(2,Quick,初始设置+持续)。Workflow:1 surface-accessibility-expectations-for-contributors(3,Moderate);2 create-an-accessible-path-for-reporting-accessibility-bugs(2);3 establish-a-simple-accessibility-triage-approach(3);4 add-an-accessibility-section-to-the-pull-request-template(3,Quick);5 tag-beginner-friendly-accessibility-issues(2,Quick);6 tag-accessibility-issues-where-you-need-expert-help(2,Quick);7 assign-accessibility-ownership(2,Quick);8 make-docs-accessible-by-default(3,Extended);9 design-accessible-interfaces(3,Extended);10 evaluate-key-dependencies-and-upstream-blockers(4,Extended)。Testing:1 add-at-least-one-automated-accessibility-check(3,Moderate);2 perform-a-keyboard-only-smoke-test-for-core-flows(3);3 perform-a-screen-reader-spot-check-for-core-flows(3);4 perform-manual-accessibility-checks(3,Extended);5 perform-accessibility-checks-for-documentation(3);6 document-supported-environments-and-known-limitations(2)。Community:1 invite-community-help-on-accessibility-work(4,Extended);2 respond-constructively-to-accessibility-reports(3);3 provide-accessible-and-respectful-ways-to-contribute-and-collaborate(4,Extended);4 recognize-accessibility-contributions-publicly(2,Quick);5 publish-accessibility-progress-updates(3);6 share-accessibility-resources(3)。除标注外,节奏多为持续或初始设置+持续。
ACCESSIBILITY.md 的构建 多个动作会向同一文件添加章节,因此按序运行的阶段应扩展而非重写它:开场陈述(Foundational 1)、优先级(Workflow 1)、贡献者期望(Workflow 1,Workflow 9 扩展,Testing 2/3/5 使用)、报告无障碍问题含严重程度(Workflow 2/3)、我们如何回应(Workflow 3,Community 2 扩展)、解决期望(可选,仅工具包)、归属与维护(Workflow 7)、依赖与上游阻塞(Workflow 10,框架未固定名称)、支持环境与已知限制(Testing 6)、反馈(可选)。
标签 框架命名:accessibility(所有无障碍问题与拉取请求,Foundational 2、Workflow 2 的问题表单应用);accessibility 加 good first issue(新手友好,Workflow 5、Community 1/3);accessibility 加 help wanted(需专家帮助,Workflow 6、Community 1/3);registered(自动应用于框架自身仓库的跟踪问题,绝不要添加或更改跟踪问题上的标签)。各标签允许“清晰易懂的等效物”。
跟踪问题与项目看板 采用框架始于在框架仓库通过“Track your project's progress”表单(.github/ISSUE_TEMPLATE/project-registration.yml)开一个公开跟踪问题。标题为 [Open Source Accessibility Framework] <项目名>。字段 ID:project-name(必填)、project-repository(必填)、project-url(可选)、maintainer-poc(可选)。表单应用 registered 标签,源码注释警告加标签可能破坏后续自动化。开启时工作流会前置参与说明、附加“Framework Progress”区(24 个动作各一复选框)与“Recap”表(按阶段统计完成/剩余),并评论 shields.io 徽章与四阶段链接;第二个工作流把问题指派给开启者并同步到框架项目看板(组织项目 1),设置项目名、仓库、URL、联系人与每阶段完成百分比。完成定义满足时勾选动作;每次编辑自动重算 recap(标记“请勿编辑”,只改复选框);每行末尾有 <!-- framework-action:workflow-3 --> 之类标记须保留。开启即公开参与;代理准备并给用户表单链接,用户或代理在明确同意后提交。进度清单说明进度为自报、非认证。
严重程度 Critical:阻止完成核心任务/完全阻断且无变通;Serious:显著困难但有变通/严重损害,变通可能不合理;Moderate:困扰或不一致体验/摩擦困惑,多数用户仍可完成;Minor:影响极小/润色项。写分类章节优先用项目自身定义,否则用框架定义;从发现创建问题时原样沿用严重程度,由维护者在分类中确认。
源码备注(固定提交) 维护者或需上报的上游事实:生成的 Community 阶段技能已过期(bundle 摘要 5bea61d03bf6,规范文档哈希 5c543d1d91eb,--check 失败,差异在两处推荐步骤措辞,本包遵循规范文档);工具包 CONTRIBUTING.md 链接的 ACCESSIBILITY.md#contributor-requirements 锚点不解析(章节名为“Contributor expectations”);工具包 community.md 的 Community 动作编号为旧顺序,应按标题而非编号匹配;framework/maintainers/framework-maintenance.md 链接的四文件在仓库中不存在,不要告知用户其存在;工具包社区资源页的 ../../phases/community-phase.md#... 链接在仓库内不解析。
链接 框架网站;四个阶段文档;项目看板;Accessibility Toolkit(ACCESSIBILITY.md、CONTRIBUTING.md、问题表单、PR 模板参考示例);Community Accessibility Resources;各阶段引用的 Open Source Guide;社区讨论 shoutout 与 show-and-tell。
源码与许可 固定于框架提交 b2ea31a2e38cbab3e774e4142575b78876b9b53f(2026 年 10 月 19 日)与工具包提交 139322792d83ade29271c9bd3b0f351f649d39aa(10 月 14 日)。阶段包摘要(规范文档 SHA-256 前 12 位十六进制):Foundational d6f531edfd4e、Workflow b5c553feeaf6、Testing b1fd16cfeb8b、Community 5c543d1d91eb。文本改编自两项目,均 MIT 许可,通知见 references/LICENSE-OSAF.md。