同一套业务，放到 iPhone、iPad、Mac、Apple TV、Vision Pro 和 Apple Watch 上，界面却必须长得"不一样"：观看距离从手腕边的一脚，到客厅里的 8 英尺，再到无限延伸的 3D 空间；输入方式从手指触控、指针键盘，变成遥控器焦点和眼球+手势。HIGAgentSkills 是一个面向 AI Agent 的 Apple Human Interface Guidelines（HIG）参考库，收录157 份经过源码核对的平台设计指南，专门帮你回答"同一个 App 在六大平台该如何区分设计"这类问题。

为什么一个 App 不能"一套 UI 走天下"

苹果官方 HIG 把每个平台单独成篇，核心原因就是：平台的物理形态、使用场景和输入方式完全不同。HIGAgentSkills 把这六篇指南提炼成六个 Tier-2 平台参考文件，每个文件都包含"设备特征 + 最佳实践"两部分：

💡 注意：表里的每一个事实（距离、输入方式、系统特性）都能在这些参考文件中溯源到 Apple HIG 原文（2026-09-12 快照），而不是 AI 的"大概印象"。

六大平台的关键设计差异

iOS：内容优先，控制精简

手机屏幕中等尺寸、单手操作，所以指南要求：限制屏幕上的控件数量，让主内容突出；次要操作"一两下就能发现"；中下部控件更易够到；并支持方向、Dark Mode 和 Dynamic Type 自适应。

iPadOS：大屏不是放大版手机

iPad 的关键词是"大屏 + 多输入"：抬高重要内容，减少模态界面和全屏跳转；根据观看距离和输入模式调整内容密度；同时要支持触控、物理键盘/触控板、Apple Pencil 的组合输入，并考虑向 macOS 形态的过渡。

macOS：桌面级的效率与自由度

Mac 用户任务动辄数小时、多应用同开，设计要点是：用大屏减少嵌套层级和模态；窗口可自由缩放、移动、支持全屏；用菜单栏暴露全部命令；支持键盘快捷键和高精度选择，允许用户自定义工具栏与窗口。

tvOS：焦点系统与"影院感"

电视 App 是"远距离观看 + 遥控器操作"：必须拥抱 tvOS 的焦点系统——项目在移动间柔和地高亮和放大，让用户清楚"现在选的是什么、我在哪"；配合无边 artwork、流畅动效和沉浸式音频，并让登录少而简单、随观看者自动切换资料库。

visionOS：先找"最小沉浸"

visionOS 的 App 运行在真实环境里的 3D 空间中：应用默认启动在多应用Shared Space，可移入单应用Full Space；Digital Crown 调节 passthrough。设计上要优先舒适度（内容相对头部定位、避免眩晕式运动、手势让手能放松）；UI 密集型体验用带标准控件的窗口承载；并且"不要假设每个时刻都需要全沉浸"——为每个关键时刻找到最小沉浸等级即可。

watchOS：抬腕一瞥，一两步完成

手表屏幕极小、交互是"一天抬腕几十次、每次不到一分钟"：信息要简短关键，操作一两个手势完成；导航层级尽量浅，用 Digital Crown 滚动或换屏；而且complications、通知、Siri 往往比 App 本体被用得更多——App 必须能独立工作，但也得为抬腕场景设计好"钩子"。

📌 HIGAgentSkills 的底线规则：当同一行为在不同平台不一致时，必须逐平台写明各自的规则，禁止偷懒说"通常如此"。这正是多平台设计最容易踩的坑。

路由机制：Agent 如何"知道"你在问哪个平台

光有 157 份参考还不够——关键是怎么在提问时只加载需要的那几份，而不是把整个语料塞进上下文。HIGAgentSkills 用 routing-index.md 把参考文件分成四级：

• Tier 1（必载的 16 个基础）：accessibility、color、typography、layout、motion 等跨平台通用的设计基础；
• Tier 2（平台映射）：按关键词命中平台，例如iphone → designing-for-ios、apple tv → designing-for-tvos、apple watch → designing-for-watchos；
• Tier 3（组件触发词）：如siri remote、digital crown、menu bar等，精确命中对应组件指南；
• Tier 4（按需加载）：小众主题（CareKit、AirPlay、NFC 等），只有直接命中才加载。

SKILL.md 定义了完整的 7 步加载协议：解析平台 → 载入 Tier 1 → 匹配平台文件 → 关键词扫描 → 一跳关联扩展 → 按需加载 Tier 4 → 引用原文作答。有 Python 3.10+ 时可用 scripts/hig_route.py 路由助手自动解析匹配。

这套机制带来的直接好处是：当你问"我的记账 App 在 watchOS 上怎么展示收支"时，Agent 只加载 watchOS 平台文件、complications、notifications 等少量相关参考，就能给出引用原文条款、保留精确数值和推荐强度（must / prefer / consider）的答案。

进阶：让现有 App 适配新形态

除了六大平台的差异化指南，2026-09-27 版还内置了/duo引导式工作流（commands/duo.md），帮你把已经上线的 iOS App适配到折叠屏 iPhone Duo：评估现有界面 → 对照 Apple 的 Duo 指南 → 给出建议待你确认 → 在 SwiftUI/UIKit 中原生实现 → 在模拟器中验证。折叠状态下列表与详情并排展开，正是"同一 App 随形态自适应"的最佳示例。

小结：用"平台参考文件"取代拍脑袋

• 一个 App 六个平台，差异的根源是距离、输入与场景——先看清这三点，UI 差异自然水到渠成；
• HIGAgentSkills 的 references/hig/ 目录把六大平台指南 + 150 余份组件指南按关键词路由组织，回答可溯源到 Apple HIG 原文；
• 记住它的三条铁律：引用精确数值、逐平台区分行为、保留推荐强度——多平台设计评审时可以直接拿来当检查清单用 ✅