SuperAPI AI 工具集

osaf-community

通用与其它

查看项目

更新于 10-31 18:43

技能介绍

用途 osaf-community 用于在一个仓库中实施开源无障碍框架的“社区阶段”。该阶段包含六项行动,技能可执行全部六项,也可只执行用户指定的行动。由于该阶段大多涉及实践与协作关系,技能主要产出文档和草稿,发布与否由维护者决定。相关事实与行动索引见 kb-open-source-accessibility-framework。

主要能力 技能按阶段顺序处理六项行动:

  1. 邀请社区帮助参与无障碍工作(invite-community-help-on-accessibility-work,持续进行,参考 references/action-01.md)。要求公开可参与的无障碍贡献机会、议题包含范围/背景/验收标准、贡献者可获得指导与维护者支持、项目保持持续的反馈或顾问实践。
  2. 建设性回应无障碍报告(respond-constructively-to-accessibility-reports,持续进行,参考 references/action-02.md)。要求在 ACCESSIBILITY.md 中记录回应最佳实践,对报告给予尊重的确认、状态说明和下一步回应,记录解决结果,并尽可能与受影响用户一起验证修复。
  3. 提供无障碍且相互尊重的贡献与协作方式(provide-accessible-and-respectful-ways-to-contribute-and-collaborate,初始设置加持续进行,参考 references/action-03.md)。要求贡献指南记录可同步和异步参与的途径、审查协作工具与流程的重大无障碍和可用性障碍并在需要时记录替代方案、采用并执行行为准则或同等政策、贡献者可在无需不必要公开披露的情况下申请便利安排。
  4. 公开认可无障碍贡献(recognize-accessibility-contributions-publicly,持续进行,参考 references/action-04.md)。要求表彰尊重贡献者偏好并保护个人信息,且经贡献者同意后方可公开认可。
  5. 发布无障碍进展更新(publish-accessibility-progress-updates,持续进行,参考 references/action-05.md)。要求通过至少一个公开项目渠道发布进展,更新内容包含已完成工作、剩余工作、已知障碍或限制及相关链接,并保持可重复的更新实践。
  6. 分享无障碍资源(share-accessibility-resources,持续进行,参考 references/action-06.md)。要求公开有用的无障碍资源,资源包含足够背景以便其他项目使用,并明确资源的维护责任归属。

使用方式

  • 范围:按阶段顺序处理每个行动,或仅处理用户按编号、标题或 ID 指名的行动;若未指名任何行动,技能会在改动文件前先询问;遇到未知行动时报告并列出有效行动。
  • 内置要求:各行动的“完成定义”(Definitions of Done)为最低要求,来自 metadata.osaf-commit 所指的阶段文档,可离线使用;仅在行动在范围内时才阅读其参考文件。
  • 在线检查:仅在用户要求时进行。抓取 metadata.osaf-source,若其 SHA-256 前 12 个十六进制字符与 metadata.osaf-digest 不同,则报告变更并在使用前询问;抓取失败不会阻塞工作。
  • 编辑前检查:逐项判断为已满足(引用文件、行号或 URL)、需要修改、或需要维护者输入/外部配置/人员参与。
  • 编辑规则:按阶段顺序编辑,遵循仓库约定,扩展 ACCESSIBILITY.md 而非替换。
  • 隐私与选择:绝不推断同意、披露残障相关或便利安排信息、替残障社群代言,或未经授权发布表彰与社区消息。
  • 草稿不直接发布:评论、讨论、发布说明和更新在维护者逐项批准前均为草稿。
  • 验证与呈现:逐行动报告已满足、未满足、持续工作、后续事项,并在提交或发布任何内容前提交审阅。
  • 不声称合规:该框架用于改进,不是认证。
  • 移交:适合其他技能完成的工作以移交方式返回,各行动参考文件中注明移交对象,由 github-hub 分派;所有行动的原则见 Accessibility Toolkit 的 references/principles.md。

适用场景 适用于希望按开源无障碍框架改进社区协作与沟通的开源项目维护者,包括搭建贡献入口、回应无障碍问题报告、改善协作工具可达性、制定行为准则、设计贡献认可机制、发布进展更新和整理可复用资源等。

限制 该技能不提供合规认证,不推断贡献者同意,不披露残障或便利安排相关信息,不替残障社群发声,未经授权不发布表彰或社区消息;评论、讨论、发布说明等须经维护者批准后才能发布;未指名行动时需先询问;在线检查仅在要求时进行且失败不阻塞工作。输出需按示例 examples/sample-output.md 的格式报告文件改动、待批准草稿及发布位置、完成定义逐项状态与证据、移交事项以及可勾选的跟踪议题行(不直接编辑议题)。许可证见 references/LICENSE-OSAF.md,共享规则、分派约定与模式见 skills/a11y-core/SKILL.md,权威规范见 skills/a11y-core/references/sources.md。