Foundation Models App Builder 是一个自包含的 Foundation Models 应用构建手册，用于在 Swift、SwiftUI、iOS 和 macOS 应用中构建或修改 Apple Foundation Models 功能。其配方内置于技能中，因此智能体无需检查 Foundation Lab 仓库即可在任何 Swift 应用中应用这些模式。
用途
该技能面向应用功能交付，而非复述 API 文档。它旨在将 Foundation Models 转化为具有清晰 Swift 类型的可复用应用能力，并将模型编排与 SwiftUI、App Intents、权限和持久化保持分离。它帮助选择最小可用的模式：文本、结构化输出、动态模式、工具、RAG、语音或特定领域集成，并让每个功能都具备可用性处理、取消、恢复和验证。
主要能力
技能覆盖以下功能形态：可用性、一次性文本、流式输出、结构化输出、动态模式、工具调用、RAG、语音、HealthKit、多语言、App Intent 或可复用能力提取。它提供参考路由，包括：可复用应用架构、提供程序、用例和 SwiftUI 适配器（references/architecture.md）；可用性、会话、指令、生成选项、流式输出和预热（references/availability-and-sessions.md）；使用 @Generable 和 @Guide 的编译时结构化输出（references/structured-generation.md）；使用 DynamicGenerationSchema 和 GeneratedContent 的运行时模式（references/dynamic-schemas.md）；Foundation Models 工具和权限感知的应用集成（references/tool-calling.md）；检索增强生成和基于事实的提示（references/rag.md）；语音识别、文本转语音和语音状态机（references/voice.md）；由共享 Foundation Models 能力支持的 App Intents（references/app-intents.md）；HealthKit 支持的 AI 功能和安全措辞（references/healthkit.md）；支持的语言、语言选择和代码切换（references/multilingual.md）；生成错误、护栏、重试和验证检查（references/common-errors.md）。
使用方式
工作流为：首先识别功能形态（可用性、一次性文本、流式输出、结构化输出、动态模式、工具调用、RAG、语音、HealthKit、多语言、App Intent 或可复用能力提取）；仅加载该功能对应的参考文件；从打包的 Swift 配方开始，然后根据目标应用调整命名、UI、权限和领域模型；当功能将被应用屏幕、App Intents、CLI 命令、小组件或测试共享时，将可复用的 Foundation Models 编排保持在 SwiftUI 视图之外；为不可用的 Apple Intelligence、不支持的语言、被拒绝的权限、上下文窗口溢出、速率限制、解码失败和护栏拒绝添加优雅的降级行为；使用覆盖变更表面的最窄构建或测试命令进行验证。
核心规则
当输出类型在编译时已知时使用 @Generable；仅当模式在运行时构建时使用 DynamicGenerationSchema；为无关的一次性任务创建新的 LanguageModelSession，仅在对话记忆重要时保留会话；将权限和用户确认放在应用边界，而非模型提示内部；保持流式 UI 更新可取消且主 actor 安全；避免仅 App Intent 的提示逻辑，共享任务应可从应用 UI 调用；优先使用紧凑的领域特定指令而非巨型提示；不要假设 Foundation Models 可用，应检查 SystemLanguageModel.default.availability。
功能契约
添加 Foundation Models 功能时，应留下以下部分：命名任务输入的 Swift 类型、命名任务输出的 Swift 类型、小型生成提供程序或用例、调用用例的 UI、App Intent 或服务适配器、模型不可用路径、流式或长时间运行工作的取消路径、生成错误的用户可见恢复路径，以及窄验证命令或手动检查。
适用场景
适用于在 Swift、SwiftUI、iOS 和 macOS 应用中添加或审查 LanguageModelSession 流程、模型集成及相关功能时。
限制
资料未提供具体的收费、价格、平台支持范围或效果保证信息。