关于 spatial-app-architecture
面向 visionOS 开发者的空间应用架构规划技能，帮助确定界面形态、状态归属及 SwiftUI 文件或模块结构，并将架构决策衔接到实现和安全重构。
主要功能
- 01选择界面形态
- 02规划状态归属
- 03设计文件与模块结构
- 04安排重构步骤
- 05确定后续实现技能
适用场景
- 01选择窗口、体积或沉浸空间
- 02划分应用、场景与视图状态
- 03规划 SwiftUI 模块结构
- 04在保留行为的前提下重构
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/spatial-app-architecture确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/anti-patterns.mdfile-layouts.mdrefactor-playbook.mdstate-ownership.mdsurface-selection.md详细介绍
Spatial App 架构
快速入门
将此技能用于架构问题，而非 API 问题。
适用于以下情况：
- 需要选择合适的呈现形式：窗口、体积空间、沉浸式空间或混合流程
- 正在确定哪些状态属于应用级、场景级、沉浸式空间级或视图本地
- 根文件承担了过多职责，需要制定重构方案
- 编写或拆分 SwiftUI 代码之前，需要规划文件或模块
在以下情况下加载参考资料
| 参考资料 | 使用时机 |
|---|---|
references/surface-selection.md | 选择窗口、体积空间还是沉浸式空间，以及确定它们的生命周期边界时。 |
references/state-ownership.md | 确定哪些内容属于应用、场景、功能协调器、RealityKit 所有者或视图时。 |
references/file-layouts.md | 规划分层或按功能切分的文件与模块结构时。 |
references/refactor-playbook.md | 应用已经存在，主要任务是在不破坏行为的前提下进行重构时。 |
references/anti-patterns.md | 需要指出结构性问题或解释某种做法为何不妥时。 |
工作流
- 根据用户任务以及当前或计划采用的呈现形式对功能分类。
- 选择所属的呈现形式模型：窗口、体积空间、沉浸式空间，或组合使用。
- 划定状态的归属边界：应用、场景、沉浸式空间、功能、视图。
- 选择与归属模型相匹配的文件／模块结构。
- 确定实现交接方向：SwiftUI、RealityKit、ARKit、SharePlay 或构建／调试。
- 如果这是重构，安排提取顺序，确保行为保持稳定。
- 完成第一个可用切片后，使用
build-run-debug验证结构。
何时切换技能
- 呈现形式和归属模型已选定，下一步要实现 SwiftUI API 时，切换到
spatial-swiftui-developer。 - 工作主要涉及实体、组件、系统或 RealityKit 运行时行为时，切换到
realitykit-visionos-developer。 - 架构选择取决于提供程序限制、锚点或追踪世界行为时，切换到
arkit-visionos-developer。 - 应用结构由群组活动或共享沉浸式体验驱动时，切换到
shareplay-developer。 - 第一个可用的架构切片完成并需要验证时，切换到
build-run-debug。
注意事项
- 不要仅仅因为新颖就选择沉浸式体验。
- 不要让临时视图负责长期的沉浸式生命周期或 RealityKit 修改。
- 如果仓库已有一致的约定，应予以保留。
输出要求
请提供：
- 选定的呈现形式模型及原因
- 归属关系图：应用、场景、功能模型／协调器、Reality 所有者、视图
- 建议的文件／模块结构
- 如果是棕地项目，列出重构切片
- 下一步实现交接方向：
spatial-swiftui-developer、realitykit-visionos-developer、arkit-visionos-developer、shareplay-developer或build-run-debug
评论
支持 Markdown