审查 App Intents 代码的意图结构、实体、快捷方式和参数。用于审查包含 import AppIntents、@AppIntent、AppEntity 等的代码。
app entents Code Review QQ快速引用 : 问题类型 : 参考 : appent 协议 , 执行 , 返回类型 : 参考 / intent
功能概述
app entents Code Review QQ快速引用 : 问题类型 : 参考 : appent 协议 , 执行 , 返回类型 : 参考 / intent是一项面向实际任务的技能，主要用于App 实体查询 , 标识符 : 参考 / 实体 . md.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
- 实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
使用与执行
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；
结果检查与注意事项
涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
App Intents 代码审查
快速参考
| 问题类型 | 参考文档 |
|---|---|
AppIntent 协议、perform() 方法、返回类型 |
references/intent-structure.md |
| AppEntity、EntityQuery、标识符 | references/entities.md |
| AppShortcutsProvider、短语（phrases）、发现机制（discovery） | references/shortcuts.md |
@Parameter、参数验证、动态选项 |
references/parameters.md |
审查清单
- 若需访问 UI 或主线程资源，
perform()已标注@MainActor -
perform()在 30 秒超时限制内完成（不执行重型下载或计算任务） - 自定义错误类型符合
CustomLocalizedStringResourceConvertible协议 -
EntityQuery.entities(for:)能优雅地处理缺失的标识符 - 若需支持 Siri 语音输入，请使用
EntityStringQuery（而非普通EntityQuery） -
suggestedEntities()返回合理的默认值以辅助消歧 -
AppShortcut的短语中包含.applicationName参数 - 非可选的
@Parameter具备合理默认值，或使用requestValue() - iOS 16 目标平台未使用
@IntentParameterDependency（该用法会导致崩溃） - 短语在
AppShortcuts.strings中本地化，而非Localizable.strings - App Intents 定义于应用 Bundle 中，而非 Swift Package（iOS 17 之前）
- 仅用于内部调用或 Widget 的 Intent 设置
isDiscoverable = false
何时查阅参考文档
- AppIntent 协议实现 → intent-structure.md
- 实体查询（Entity queries）、标识符、Spotlight 集成 → entities.md
- App Shortcuts、短语（phrases）、发现机制（discovery）→ shortcuts.md
- 参数验证、动态选项 → parameters.md
审查问题
perform()是否对长时间运行的操作设置了超时处理？- 实体查询是否自包含（即在 Siri 上下文中不依赖
@Dependency注入）？ - 短语是否自然通顺，并明确包含应用名称？
- SwiftData 模型是否通过
persistentModelID传递，而非直接传递模型实例？ - 从 SiriKit 迁移至 App Intents 是否会破坏用户已创建的快捷指令？
硬性准入条件（报告前必须满足）
对每个你计划报告的问题，请**按顺序**完成以下全部步骤。任一条件未满足前，不得继续后续操作。
- 位置凭证（Location artifact） —— 问题描述中包含来自当前文件内容的
[FILE:LINE]（或行号范围）；该路径在本仓库中可解析。 - 作用域通读（Scope read） —— 你已完整阅读被标记代码所在的整体类型定义：包括
AppIntent/AppEntity/EntityQuery/AppShortcutsProvider（或其等价类型），而不仅限于 diff 片段或代码片段。 - 平台或集成声明（Platform or integration claim）（仅当问题依赖最低 iOS 版本、Swift Package 与应用 Target 区分、
@IntentParameterDependency可用性、SiriKit 迁移影响，或isDiscoverable/ 扩展放置位置等上下文时适用）—— 你须明确指出一个你已查验的具体凭证（例如 Xcode 项目中的IPHONEOS_DEPLOYMENT_TARGET或 Target 成员关系、Package.swift中的platforms声明、Entitlements 文件，或 Intent 文件的实际存放位置）；或 将该问题降级为开放性问题（open question）并暂不报告。 - 协议合规（Protocol） —— 本项已满足 review-verification-protocol 中规定的预报告步骤（若未满足，则不得生成任何问题）。
每个报告的问题请严格采用格式：[FILE:LINE] ISSUE_TITLE。第 4 条硬性准入条件即为此技能对应审查类型的完整预报告检查清单。
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
2026.10.28
0
16
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
2026.10.28
0
15
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
2026.10.28
0
10
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.5万人学习
最新文章