К основному содержанию
скилл CX Codex

app-intents-code-review — скилл для Claude Code: что делает

Скилл app-intents-code-review проводит ревью кода Swift с фреймворком App Intents, проверяя таймауты, локализацию фраз и совместимость версий iOS.

Apache-2.0 124 установок ★ 89 обновлён 2026-09-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add existential-birds/beagle --skill app-intents-code-review -a claude-code
Открыть на GitHub

Что делает app-intents-code-review

Скилл подключается при ревью кода с import AppIntents, @AppIntent, AppEntity или AppShortcutsProvider. Он проверяет выполнение метода perform(): укладывается ли логика в лимит 30 секунд и вынесены ли обращения к UI под @MainActor. Отдельно оценивается передача моделей SwiftData — передавать их нужно строго через persistentModelID, а не напрямую.

В проверку заложены строгие правила совместимости: на таргетах iOS 16 вызов @IntentParameterDependency приводит к крэшу, а сами интенты до iOS 17 обязаны лежать в бандле приложения, а не в Swift Package. Скилл также следит, чтобы фразы шорткатов содержали .applicationName и переводились в файле AppShortcuts.strings, иначе локализация через стандартный Localizable.strings не сработает.

Перед выдачей замечаний агент обязан пройти четыре жёстких фильтра: привязать находку к строке [FILE:LINE], прочитать тип целиком и подтвердить претензию конфигурацией проекта (например, IPHONEOS_DEPLOYMENT_TARGET). Без подтверждённого таргета замечание понижается до открытого вопроса.

Какие задачи решает

  • найти блокировки главного потока и утечки за 30-секундный лимит в методе perform()
  • выявить несовместимый с iOS 16 макрос @IntentParameterDependency
  • проверить локализацию фраз шорткатов в правильном файле AppShortcuts.strings
  • проконтролировать безопасную передачу моделей SwiftData через persistentModelID

Примеры запросов агенту

  • Проверь реализацию App Intents в файле OrderIntent.swift по чек-листу
  • Сделай ревью сущностей AppEntity и запросов EntityQuery перед релизом на iOS 16
  • Проверь шорткаты в AppShortcutsProvider на корректность фраз и имя приложения

Как установить app-intents-code-review

1Через Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill app-intents-code-review -a claude-code

2Вручную: положить файлы

~/.claude/skills/app-intents-code-review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/app-intents-code-review/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об app-intents-code-review

Как установить app-intents-code-review в Claude Code?

Выполните в терминале команду npx skills add existential-birds/beagle --skill app-intents-code-review -a claude-code.

Что проверяет скилл app-intents-code-review?

Он инспектирует протоколы AppIntent, сущности AppEntity, параметры с макросом @Parameter и фразы быстрого вызова в AppShortcutsProvider.

Почему скилл обращает внимание на минимальную версию iOS?

Потому что вызов @IntentParameterDependency на iOS 16 роняет приложение, а сборка интентов внутри Swift Package поддерживается только начиная с iOS 17.

Исходный текст

SKILL.md · Apache-2.0
---
name: app-intents-code-review
description: Reviews App Intents code for intent structure, entities, shortcuts, and parameters. Use when reviewing code with import AppIntents, @AppIntent, AppEntity, AppShortcutsProvider, or @Parameter.
---

# App Intents Code Review

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| AppIntent protocol, perform(), return types | [references/intent-structure.md](references/intent-structure.md) |
| AppEntity, EntityQuery, identifiers | [references/entities.md](references/entities.md) |
| AppShortcutsProvider, phrases, discovery | [references/shortcuts.md](references/shortcuts.md) |
| @Parameter, validation, dynamic options | [references/parameters.md](references/parameters.md) |

## Review Checklist

- [ ] `perform()` marked with `@MainActor` if accessing UI/main thread resources
- [ ] `perform()` completes within 30-second timeout (no heavy downloads/processing)
- [ ] Custom errors conform to `CustomLocalizedStringResourceConvertible`
- [ ] `EntityQuery.entities(for:)` handles missing identifiers gracefully
- [ ] `EntityStringQuery` used if Siri voice input needed (not plain `EntityQuery`)
- [ ] `suggestedEntities()` returns reasonable defaults for disambiguation
- [ ] `AppShortcut` phrases include `.applicationName` parameter
- [ ] Non-optional `@Parameter` has sensible defaults or uses `requestValue()`
- [ ] `@IntentParameterDependency` not used on iOS 16 targets (crashes)
- [ ] Phrases localized in `AppShortcuts.strings`, not `Localizable.strings`
- [ ] App Intents defined in app bundle, not Swift Package (pre-iOS 17)
- [ ] `isDiscoverable = false` for internal/widget-only intents

## When to Load References

- AppIntent protocol implementation -> intent-structure.md
- Entity queries, identifiers, Spotlight -> entities.md
- App Shortcuts, phrases, discovery -> shortcuts.md
- Parameter validation, dynamic options -> parameters.md

## Review Questions

1. Does `perform()` handle timeout limits for long-running operations?
2. Are entity queries self-contained (no `@Dependency` injection in Siri context)?
3. Do phrases read naturally and include the app name?
4. Are SwiftData models passed by `persistentModelID`, not directly?
5. Would migrating from SiriKit break existing user shortcuts?

## Hard gates (before reporting)

Complete **in order** for each finding you intend to report. Do not advance until the pass condition is satisfied.

1. **Location artifact** — The finding includes `[FILE:LINE]` (or a line range) copied from the current file contents; the path resolves in this repo.
2. **Scope read** — You read the full surrounding type: the `AppIntent` / `AppEntity` / `EntityQuery` / `AppShortcutsProvider` (or equivalent) that contains the flagged code, not only a diff hunk or snippet.
3. **Platform or integration claim** (only if the finding depends on minimum iOS, Swift Package vs app target, `@IntentParameterDependency` availability, SiriKit migration, or `isDiscoverable` / extension placement) — You name one concrete artifact you inspected (for example `IPHONEOS_DEPLOYMENT_TARGET` or target membership in the Xcode project, `Package.swift` `platforms`, entitlements, or where the intent file lives) **or** you drop or downgrade the finding to an open question.
4. **Protocol** — Pre-report steps in [review-verification-protocol](../review-verification-protocol/SKILL.md) are satisfied for this item (no finding if they are not).

Use the issue format `[FILE:LINE] ISSUE_TITLE` for each reported finding. Hard gate 4 is the full pre-report checklist for this skill’s review type.

© existential-birds · Apache-2.0 · existential-birds/beagle

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
app-intents-specialist tartinerlabs Скилл app-intents-specialist для Claude Code загружает в контекст актуальные практики Apple App Intents: perform(), AppEntity, AppEnum, @Parameter, @Dependency, донирование и AppShortcut. CX Codex +1 183установок app-intents dpearson2699 Скилл по App Intents для iOS: помогает вывести действия и данные приложения в Siri, Shortcuts, Spotlight, виджеты и Control Center. CX Codex +1 4 300установок app-intents-whats-new-27 tartinerlabs Скилл app-intents-whats-new-27 для Claude Code и Codex помогает переносить код на новые API App Intents в iOS 26 и iOS 27. Подсказывает точные проверки @available и правила работы с публичными интерфейсами Apple. CX Codex +1 184установок capacitor-app-intents Cap-go Скилл capacitor-app-intents для Claude Code добавляет нативные App Intents в iOS-приложение на Capacitor и связывает их с веб-слоем. Он включается при работе с Siri, Shortcuts, Spotlight, виджетами и кнопкой Action. CX Codex +1 111установок ios-app-intents официальный OpenAI Скилл ios-app-intents для Codex и ChatGPT. Помогает проектировать App Intents, сущности и App Shortcuts для iOS — выносит действия приложения в Siri, Spotlight, шорткаты и виджеты. CX Codex GP ChatGPT +1 99установок app-store-review dpearson2699 Скилл app-store-review для Claude Code проверяет готовность iOS-приложения к отправке в App Store и ищет причины возможного отклонения. Запускается при подготовке релиза, ответе на отклонение или сверке данных о приватности. CX Codex +1 4 900установок

Из того же набора68

Весь набор →
cloudkit-code-review Скилл cloudkit-code-review проверяет Swift-код на ошибки работы с CloudKit: зоны, батчи, обработку CKErrorPartialFailure и лимиты CKAsset. CX Codex +1 127установок prometheus-go-code-review Скилл prometheus-go-code-review для Claude Code проверяет Prometheus-метрики в Go: типы, лейблы, имена и регистрацию. Ревьюирует код с prometheus/client_golang. CX Codex +1 126установок review-skill-improver Скилл review-skill-improver для Claude Code анализирует журнал отзывов о код-ревью и предлагает правки к скиллам. Выявляет повторяющиеся причины отказов по оценкам ACCEPT и REJECT. CX Codex +1 125установок elixir-code-review Скилл elixir-code-review проверяет код на Elixir по правилам OTP, безопасности и стиля. Помогает при разборе файлов .ex и .exs. CX Codex +1 124установок review-feedback-schema Скилл review-feedback-schema для Claude Code задаёт CSV-схему результатов код-ревью и помогает оценивать качество проверок. Ведёт журнал решений по найденным проблемам. CX Codex +1 124установок combine-code-review Скилл combine-code-review проверяет код на Combine на ошибки в подписках, операторах, управлении памятью и обработке ошибок. Пригодится перед ревью Swift-кода с Combine. CX Codex +1 123установок receive-feedback Скилл receive-feedback разбирает замечания из код-ревью по фактам, а не из вежливости: каждый пункт проверяется по коду, получает вердикт с доказательством и только потом правится. CX Codex +1 123установок reference-docs Скилл reference-docs помогает писать справочные страницы для API и функций: таблицы параметров, возвращаемые значения, ошибки, запускаемые примеры. CX Codex +1 121установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой