让你的应用中正确的部分对系统可见

App Intent 是让 iOS 应用在其自身 UI 之外变得更实用的最明确方式之一。与其将你的应用视为一个只有在用户启动并四处点击后才能正常运作的封闭目的地，不如使用 Codex 来暴露那些应可供“快捷指令”、Siri、聚焦搜索、小组件、控件以及更新的助理驱动系统体验使用的操作和对象。

这在当前对于可发现性和自动化非常有用，并且也是为未来更具助理驱动特性做准备的坚实一步。如果你的应用已经知道如何组合、打开、过滤、路由或总结有价值的内容，App Intent 就能为系统提供一种结构化的方式来调用该能力。

从操作和实体开始，而不是从每个屏幕开始

最佳的首次 App Intent 处理通常不是“镜像整个应用”。请要求 Codex 识别：

• 用户想要在无需导航完整界面的情况下触发的少数操作
• 系统为了正确路由这些操作而需要理解的应用对象
• 应该在特定状态下打开应用的工作流，与应该直接从系统界面完成的工作流

Apple 的 App Intent 指南在这里是一个很好的框架：定义操作，定义系统需要的实体表面，然后使这些操作在各种系统体验中可发现且可复用。最有用的参考是 使操作和内容可发现并被广泛使用, 创建你的第一个 App Intent，以及系统体验示例 采用 App Intent 以支持系统体验.

从系统界面思考，而不仅仅是从快捷指令思考

这个机会远比“添加一个快捷指令”更广泛。良好的 App Intent 表面能让你的应用在多个场景中发挥作用：

• 快捷指令，用户可以在其中直接运行操作或将它们组合成更大的自动化流程
• Siri，应用可以在其中暴露有意义的动词和深度链接，而不仅仅是常规地打开
• 聚焦搜索，应用实体和应用快捷指令会成为可发现的系统入口点
• 小组件、实时活动、控件以及其他 Intent 驱动的 UI 界面
• 更新的面向助理的体验，结构化的操作和实体比任意的 UI 流程更容易被系统理解

遵循真实的应用模式

当应用采用类似这样的结构时，通常效果最好：

• 一个专用的 App Intent target，而不是将 Intent 类型分散在不相关的应用文件中
• AppShortcutsProvider 用于高价值用户操作（例如撰写帖子或在特定标签页上打开应用）的条目
• 小型的 AppEntity 系统需要推理的事物类型，例如账户、列表和时间线筛选器
• 能干净地路由回主应用场景的 Intent 处理，以便被调用的 Intent 可以打开正确的撰写流程或将应用切换到正确的标签页

这是我会要求 Codex 为大多数应用遵循的模式：从一个面向系统的小型操作层开始，保持实体表面精简，并在 Intent 需要主 UI 时，配置一个可预测的运行时交接回应用。

要求 Codex 设计首个 Intent 表面

这里最有效的提示是向 Codex 提供你应用的核心对象和顶级用户操作，然后要求它选择最小但实用的首批 App Intent 表面，而不是盲目地暴露所有内容。

实用技巧

暴露用户真正想在应用外部使用的动词

优秀的首批 Intent 通常是诸如撰写、打开、查找、筛选、开始、继续或检查之类的操作。如果一个操作只有在漫长的应用内设置流程之后才有用，它可能不适合出现在首批 App Intent 处理中。

保持实体比你的模型层更小

系统通常不需要你完整的持久化模型。要求 Codex 定义最小的 app entity 表面，同时仍能为 Siri、快捷指令和聚焦搜索提供足够的上下文来正确路由和显示该操作。

将此视为助理基础设施，而不仅仅是快捷指令功能

即使你的首次发布仅在表面上改善了快捷指令或 Siri，更深层的意义在于你的应用开始以结构化的操作和实体进行表达。这使得应用比那些能力仅编码在点击和视图层次结构中的应用，更容易参与未来的系统和 AI 驱动的入口点。