visionos-design-guidelines

visionos-design-guidelines 技能概览

这个技能适合做什么

visionos-design-guidelines 技能可以帮助你在决定空间 UI 的布局、眼手输入方式，或者某个沉浸式概念是否符合 visionOS 规范时，套用 Apple Vision Pro 的设计规则。它最适合的场景不是单纯找灵感，而是需要真正影响舒适度、可达性和平台正确性的设计约束。

适合谁安装

如果你正在设计或评审 visionOS 应用、RealityKit 体验、volume、基于窗口的界面，或者混合现实原型，就应该安装 visionos-design-guidelines。它对 UI 设计师、产品工程师，以及需要产出可直接落地实现建议的 AI agent 尤其有用，而不是只会给出泛泛的“做得更沉浸一些”这类建议。

它的优势在哪里

这个技能更强调实操性的边界条件，而不是宏观产品理论：内容该放哪里、gaze + pinch 怎么配合、哪些元素不该 head-lock、以及怎样避免舒适度或可访问性问题。visionos-design-guidelines 技能最强的地方在于，你可以在真正开始构建之前，先用它快速检查关键的空间设计规则。

如何使用 visionos-design-guidelines 技能

安装并加载正确上下文

先通过 skills manager 走 visionos-design-guidelines install 流程，然后优先阅读技能入口文件：SKILL.md、AGENTS.md、metadata.json 和 rules/_sections.md。这个技能不依赖脚本，真正有价值的是规则集和分类摘要。

从具体的空间需求开始

visionos-design-guidelines usage 在你的提示词包含界面类型、用户目标和物理场景时效果最好。好的输入会像这样：“为一个效率类应用设计 visionOS onboarding 流程，使用一个窗口和一个 ornament”，或者“检查这个沉浸式 dashboard 的舒适度、目标尺寸以及眼手交互风险。” 诸如“让它更 Apple 一点”这样的弱输入，通常只会得到很泛的结果。

把粗略想法改成更好的提示词

在使用 visionos-design-guidelines for UI Design 时，建议把这些信息写清楚：

• app 表面：window、volume、immersive space，或混合布局
• 主要任务：阅读、选择、操作、导航，或状态展示
• 交互模式：gaze、pinch、拖拽、手势、语音，或混合输入
• 约束条件：固定窗口数量、可访问性需求、舒适度限制，或已有的 RealityKit 代码

更强的提示词可以是：“基于 visionOS 指南，审查这个双面板 dashboard 是否存在眼疲劳、视野范围内的布局问题和控件尺寸风险；然后把它重写成一个更符合空间舒适度的布局。”

按这个顺序阅读文件

把 visionos-design-guidelines guide 当作仓库阅读路径来用：

1. rules/_sections.md：按严重级别排序的规则地图
2. SKILL.md：详细规则和反模式
3. AGENTS.md：用途、范围和使用提示
4. metadata.json：参考资料和版本上下文

如果时间有限，先看最关键的类别：空间布局、眼手输入、可访问性。

visionos-design-guidelines 技能 FAQ

这只适用于 Apple Vision Pro 吗？

大体上是的。visionos-design-guidelines 技能的核心是 visionOS 和 Apple Vision Pro 的规范，不过这些规则对于任何使用 gaze、手部输入或 world-anchored 布局的空间计算 UI 也同样有参考价值。

它和普通提示词有什么不同？

普通提示词可能只给你一个风格答案；这个技能提供的是基于规则的设计视角：距离、位置、目标尺寸、悬停反馈、可访问性覆盖范围，以及沉浸边界。这让它更适合评审、实现，以及避免平台特有的错误。

它适合新手吗？

可以，只要你能描述自己想要的屏幕或体验就行。使用 visionos-design-guidelines 不需要很深的 visionOS 知识，但你确实需要提供足够上下文，让技能能够准确判断空间布局和交互模式。

什么时候不该用它？

不要把它用于通用移动端 UI、纯 Web 界面，或者非空间化的产品文案。若你需要的是代码生成而不是设计评审，或者任务里根本没有 visionOS、RealityKit 或混合现实组件，它也不是合适选择。

如何改进 visionos-design-guidelines 技能

把真实的界面形态说清楚

最能提升质量的，还是明确屏幕上有什么、它在空间中的位置在哪里。说明你的是单窗口、多窗口、浮动 volume 还是沉浸式场景，并补充用户在前 5 秒必须完成什么。

提前把会影响答案的约束讲出来

visionos-design-guidelines 在你事先说明舒适度、可访问性和输入约束时表现更好。把最小目标尺寸、界面是否必须支持 VoiceOver 或指针控制、以及设计是否需要避免频繁头部移动这类信息写进去。

先要审查，再要重写

一个很实用的流程是：先让它指出规则违规点，再让它给出修正版。比如：“按舒适度、gaze 反馈和可访问性规则审查这个 visionOS onboarding；然后重写布局和交互顺序。” 这样通常比直接要一个泛泛的设计方案更有可执行性。

用第一轮结果收窄下一轮范围

如果第一次输出太宽泛，就按类别继续细化：空间布局、眼手输入、窗口，或者可访问性。visionos-design-guidelines 技能在你一次只迭代一个失败模式时最容易变强，比如内容摆放、hover 状态，或者 world anchoring。