用途 osaf-foundational 用于实现开源无障碍框架的“基础阶段”(Foundational phase)。该阶段先于框架其余三个阶段,作用于单个代码仓库。技能负责完成该阶段的两项行动,或只完成请求中明确点名的那一项:
- 创建 ACCESSIBILITY.md。
- 使用无障碍标签跟踪相关工作。
主要能力
- 范围控制:可按阶段顺序处理全部行动,或只处理以编号、标题或 ID 指定的行动;若请求未指明任何行动,技能会先询问,之后才改动文件;若点名的行动不存在,会说明并列出有效行动。
- 内置要求:每项完成标准取自该阶段文档,可离线使用;只有当某项行动在范围内时才读取该行动的参考文档。
- 在线核对(仅在被要求获取最新指引时):抓取指定来源,取其 SHA-256 的前 12 个十六进制字符与摘要比对;若不一致,报告变化并在使用前询问。抓取失败不会阻塞工作。
- 编辑前检查:对每项完成标准判断为已满足(引用文件与行号)、需要修改,或需要维护者输入、外部配置或人工处理。
- 按阶段顺序编辑,遵循仓库既有约定;对已存在的无障碍文档采取扩展而非替换。
- 公开变更前询问:创建或应用标签、开启跟踪 issue 会改动 GitHub 而非文件,技能只准备命令,获得明确同意并具备所需权限后才执行。
- 逐项验证:已满足、未满足、持续进行的工作(第 2 项行动是持续的),以及需要人工或外部变更的后续事项。
- 在提交、推送或发布前先呈现以供复审。
- 不作合规声明:绝不声称完成该阶段即意味着项目无障碍、合规、符合规范或获得认证;该框架用于改进而非认证。
- 若请求是整体采纳该框架,还会准备跟踪 issue:向用户提供表单链接和参考技能列出的字段值;开启跟踪 issue 会公开项目参与情况,因此由用户决定。
两项行动的完成标准 行动 1:创建 ACCESSIBILITY.md(快速、一次性设置)
- 仓库中存在 ACCESSIBILITY.md。
- 文件包含一段简要说明,描述无障碍对本项目为何重要。
行动 2:使用无障碍标签跟踪相关工作(快速;初始设置加持续进行)
- 存在无障碍标签,或名称清晰的等效标签。
- 该标签已应用于项目相关的开放跟踪 issue。
使用方式 技能按阶段顺序写入行动所需文件,然后按以下顺序报告:
- 写入或修改的文件及每项变更的作用。
- 逐项行动的每项完成标准状态(已满足、未满足或需要人工),附证据:文件与行号、命令输出或 issue 编号。
- 交接项:技能、任务与范围,每行一项。
- 跟踪 issue:现在可以勾选的清单行;技能不自行编辑跟踪 issue。
交接 每项行动的参考文档会指出本技能包中能更好完成部分工作的其他技能;这些以交接形式返回而非直接派发:GitHub 相关交接由 github-hub 派发,Markdown 审阅交由 markdown-a11y-assistant。
适用场景 适用于希望在单个代码仓库中启动开源无障碍框架基础阶段的项目维护者,尤其是需要创建 ACCESSIBILITY.md 或建立无障碍标签跟踪机制的场景。
限制
- 不构成无障碍合规或认证声明。
- 涉及 GitHub 的标签创建与跟踪 issue 开启需用户明确同意及相应权限。
- 请求未指明行动时不会自行改动文件。
- 在线最新指引核对仅在被要求时进行。
- 框架改编文本采用 MIT 许可,声明文件见 references/LICENSE-OSAF.md;共享规则、派发约定与模式见 skills/a11y-core/SKILL.md,权威规范见 skills/a11y-core/references/sources.md。