SuperAPI AI 工具集

app-intents-code-review

测试与质量

查看项目

更新于 10-15 21:39

技能介绍

用途:审查基于 Apple App Intents 框架的代码,关注四类问题:AppIntent 协议与 perform()、AppEntity/EntityQuery/标识符、AppShortcutsProvider/短语与发现、@Parameter 校验与动态选项。

主要能力:提供 Quick Reference 索引,分别指向 references/intent-structure.md、entities.md、shortcuts.md、parameters.md;并给出 Review Checklist,例如 perform() 是否加 @MainActor、是否在 30 秒超时内完成、自定义错误是否符合 CustomLocalizedStringResourceConvertible、EntityQuery.entities(for:) 是否优雅处理缺失标识符、需 Siri 语音输入时是否用 EntityStringQuery、suggestedEntities() 是否返回合理默认值、AppShortcut 短语是否含 .applicationName、非可选 @Parameter 是否有默认值或 requestValue()、iOS 16 目标是否误用 @IntentParameterDependency、短语是否本地化在 AppShortcuts.strings、App Intents 是否定义在 app bundle、内部/小组件专用 intent 是否 isDiscoverable = false 等。

使用方式:按“When to Load References”在协议实现、实体查询、快捷指令、参数校验时加载对应参考文件;审查问题包括 perform() 是否处理超时、实体查询是否自包含、短语是否自然含 app 名、SwiftData 模型是否按 persistentModelID 传递、从 SiriKit 迁移是否破坏既有快捷指令。报告前需满足硬性门槛:给出 [FILE:LINE]、阅读完整外层类型、平台/集成类结论须指明具体检视物(如 IPHONEOS_DEPLOYMENT_TARGET、Package.swift platforms、entitlements 等),并满足 review-verification-protocol 的预报告步骤。

适用场景:代码评审 App Intents 实现,每条问题使用 [FILE:LINE] ISSUE_TITLE 格式。限制:资料未提供价格、安装命令与运行方式,亦未说明支持的具体平台版本细节。