accessibility

该 Skill 是无障碍实现的知识路由层：按标签与描述、交互、结构与导航、用户偏好、事件/验证结果播报、验证审计等任务类型，指向对应知识契约，并声明设计规范与测试约定的归属方及停用条件。仅为路由说明，未包含所引用契约文档的正文。

caglarbaranbora

热度 0.00

最近更新 2026-10-18 16:48:01

分类：知识依赖：纯提示词应用场景：概念解释 / 教学辅导 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add caglarbaranbora/apple-agent-kit/accessibility

Metadata

name: accessibility
description: Route Accessibility API implementation tasks to the correct Knowledge Contracts — accessibility labels, traits, value/hint, custom actions, element grouping, VoiceOver navigation order, Dynamic Type API, Reduce Motion, Reduce Transparency/Increase Contrast, Full Keyboard Access and accessibility focus, hidden/decorative elements, announcements to assistive apps including announcement priority, and accessibility audits. Use when writing or reviewing VoiceOver support, custom-control accessibility, Dynamic Type handling, announcing an event or a form's validation result to VoiceOver, or accessibility test coverage in SwiftUI or UIKit. This is API-implementation guidance, not visual design — for the underlying design requirement (contrast ratio, text-scaling requirement, color-alone prohibition), see human-interface-guidelines. Triggers on VoiceOver, accessibilityLabel, accessibilityTraits, accessibilityValue, accessibilityHint, accessibilityAction, UIAccessibilityCustomAction, accessibilityElement, isAccessibilityElement, accessibilitySortPriority, Dynamic Type, ScaledMetric, UIFontMetrics, Reduce Motion, Reduce Transparency, Increase Contrast, Full Keyboard Access, AccessibilityFocusState, accessibilityHidden, AccessibilityNotification, AccessibilityNotification.Announcement, UIAccessibility.post, UIAccessibilityPriority, accessibilitySpeechAnnouncementPriority, announcement priority, performAccessibilityAudit, Accessibility Inspector.
id: skill.accessibility.foundations
title: Accessibility — Foundations
version: 1.0.0
status: Approved
artifact_type: skill
domain: Accessibility
routes: ["knowledge.accessibility.accessibility-labels","knowledge.accessibility.accessibility-traits","knowledge.accessibility.accessibility-value-and-hint","knowledge.accessibility.custom-accessibility-actions","knowledge.accessibility.accessibility-element-grouping","knowledge.accessibility.voiceover-navigation-order","knowledge.accessibility.dynamic-type-api","knowledge.accessibility.reduce-motion","knowledge.accessibility.reduce-transparency-increase-contrast","knowledge.accessibility.full-keyboard-access-and-focus","knowledge.accessibility.accessibility-hidden-decorative","knowledge.accessibility.accessibility-audits-testing","knowledge.accessibility.accessibility-announcements"]
related: ["skill.human-interface-guidelines.foundations","skill.swiftui.foundations"]
last_updated: "2026-08-08T00:00:00.000Z"

Accessibility — Foundations Skill

Purpose

Route Accessibility API implementation tasks to the minimum required Accessibility Knowledge Contracts, across both SwiftUI and UIKit.

Routing

Load only the contracts relevant to the task. All paths relative to knowledge/accessibility/.

Labeling & description -> accessibility-labels.md, accessibility-traits.md, accessibility-value-and-hint.md
Interaction -> custom-accessibility-actions.md, full-keyboard-access-and-focus.md
Structure & navigation -> accessibility-element-grouping.md, voiceover-navigation-order.md, accessibility-hidden-decorative.md
User preferences -> dynamic-type-api.md, reduce-motion.md, reduce-transparency-increase-contrast.md
Announcing an event or validation result that no element carries; announcement priority -> accessibility-announcements.md
Verification -> accessibility-audits-testing.md

Never load more than the contracts relevant to the specific question. For the underlying design requirement (why a 4.5:1 contrast ratio, why text must scale to 200%, why color can't be the only differentiator), route to skill.human-interface-guidelines.foundations instead. For SwiftUI view/state/navigation questions unrelated to accessibility, route to skill.swiftui.foundations instead.

Stop Conditions

Stop and report if the requested topic has no matching Knowledge Contract in knowledge/accessibility/ — do not guess or fall back to general knowledge.

Design-level accessibility guidance — owned by human-interface-guidelines
XCTest/Swift Testing conventions beyond accessibility audits — owned by testing
AccessibilityNotification.LayoutChanged/.PageScrolled, and .ScreenChanged posted without moving focus — Deferred