osaf-workflow 是一个面向开源仓库的无障碍工作流实施技能,对应开源无障碍框架(Open Source Accessibility Framework)中的 Workflow 阶段。其目标是在一个仓库内落实十项与无障碍流程相关的行动,可全部执行,也可只执行请求中指定的部分。
用途与范围 该技能按阶段顺序实施行动,或仅实施通过编号、标题或 ID 指定的行动。如果请求未指明任何行动,需先询问再改动文件。遇到未知行动时应报告并列出有效行动。它附带“完成定义”(Definitions of Done)作为最低要求,来源于 metadata.osaf-commit 所指向的阶段文档,可离线使用;仅当某行动在范围内时才读取其参考文件。
主要能力 十项行动覆盖:为贡献者明确无障碍期望(在 ACCESSIBILITY.md 中设“优先级”与“贡献者期望”章节,并在 CONTRIBUTING.md 中引导);创建无障碍缺陷报告路径并记录分流与响应流程;建立简单的无障碍分流方法(说明报告方式、所需信息、严重程度分类与响应预期);在拉取请求模板中加入无障碍栏目与检查清单;为初学者友好的无障碍问题打标签;为需要专家帮助的问题打标签;指派无障碍负责人并记录职责;让文档默认可访问(结构语义、图像/图表/视频替代文本、表格与代码块的无障碍呈现);设计无障碍界面(记录接口要求、审查新界面、处理键盘访问、焦点状态与标签);评估关键依赖与上游阻塞(记录相关依赖、采用前审查、链接跟踪上游阻塞、记录变通或缓解方案)。
使用方式 工作流程为:先检查每个条目状态(已满足需引用文件与行号、需要改动、需要维护者输入/外部配置/人员);按阶段顺序编辑并保持仓库惯例,扩展而非替换 ACCESSIBILITY.md;未经确认不进行标签、指派、评论或设置等外部更改;不编造维护者姓名、联系方式、时间表或测试结果,缺失处留标记占位并列为维护者输入;完成后逐行动报告已满足、未满足、重复性工作与后续事项,并在提交或发布前提交评审。仅在被要求时进行在线检查:抓取 metadata.osaf-source,若其 SHA-256 前 12 个十六进制字符与 metadata.osaf-digest 不同,应报告变化并在使用前询问;抓取失败不阻塞工作。
输出与限制 输出需写明文件及各改动作用、每项完成定义的满足情况与证据、交接事项(技能、任务、范围)以及可勾选的跟踪问题行(不编辑该问题)。不作出合规性声明,框架用于改进而非认证。更适合由其他技能完成的工作以交接形式返回,由 github-hub 分派。共享规则、分派契约与模式见 skills/a11y-core/SKILL.md,权威规范见 skills/a11y-core/references/sources.md。适用场景为开源项目维护者或贡献者在仓库中建立无障碍流程与文档规范;限制包括需仓库上下文、部分事项需人工或维护者输入、不提供认证结论。