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

watchos-code-review — скилл для Claude Code: обзор и установка

Скилл watchos-code-review для Claude Code проверяет watchOS-код на ошибки жизненного цикла, осложнений, WatchConnectivity и ограничения производительности.

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

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

Что делает watchos-code-review

Скилл разбирает watchOS-код, связанный с WatchKit, WKExtension, WKApplicationDelegate и WCSession. Он проверяет жизненный цикл приложения, фоновые режимы, расширенные сессии, осложнения на базе ClockKit и WidgetKit, обмен данными между iPhone и Apple Watch, расход памяти и батареи.

Внутри есть чек-лист и справочные разделы по жизненному циклу, осложнениям, связности и производительности. Для каждого найденного дефекта скилл требует указать [FILE:LINE], прочитать окружающий код и подтвердить релевантное правило watchOS или связки устройств. Поэтому замечание без точного расположения и проверки полного участка кода не должно попадать в отчёт.

Отдельно проверяются порядок назначения делегата WCSession перед activate(), выбор URLSessionDownloadTask для фоновых запросов, будущие записи в таймлайне и восстановление workout-сессий. Формат результата задан явно: [FILE:LINE] ISSUE_TITLE.

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

  • проверить обработку жизненного цикла watchOS-приложения
  • найти ошибки в ClockKit и WidgetKit-таймлайнах
  • проверить обмен данными через WCSession
  • выявить проблемы с памятью, батареей и фоновыми задачами
  • сверить формат и доказательность замечаний ревью

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

  • Проверь этот watchOS-код и укажи каждую проблему в формате [FILE:LINE] ISSUE_TITLE.
  • Проверь, правильно ли здесь настроены WCSession, фоновые задачи и передача файлов между iPhone и Apple Watch.
  • Сделай ревью осложнения на базе WidgetKit: проверь будущие записи таймлайна и приоритизацию для Smart Stack.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/watchos-code-review/SKILL.md

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

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

Вопросы о watchos-code-review

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

Выполните npx skills add existential-birds/beagle --skill watchos-code-review -a claude-code, затем проверьте файл ~/.claude/skills/watchos-code-review/SKILL.md.

Что делает watchos-code-review?

Скилл ревьюит watchOS-код: жизненный цикл, фоновые режимы, осложнения ClockKit и WidgetKit, WatchConnectivity, память, батарею и производительность. Замечания оформляются с указанием файла и строки.

Какие правила WCSession проверяет скилл?

Он проверяет, что делегат назначен до activate(), перед sendMessage проверяется isReachable, для критичных данных используется transferUserInfo, а полученные файлы перемещаются до возврата из callback.

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

SKILL.md · Apache-2.0
---
name: watchos-code-review
description: Reviews watchOS code for app lifecycle, complications (ClockKit/WidgetKit), WatchConnectivity, and performance constraints. Use when reviewing code with import WatchKit, WKExtension, WKApplicationDelegate, WCSession, or watchOS-specific patterns.
---

# watchOS Code Review

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| App lifecycle, scenes, background modes, extended runtime | [references/lifecycle.md](references/lifecycle.md) |
| ClockKit, WidgetKit, timeline providers, Smart Stack | [references/complications.md](references/complications.md) |
| WCSession, message passing, file transfer, reachability | [references/connectivity.md](references/connectivity.md) |
| Memory limits, background refresh, battery optimization | [references/performance.md](references/performance.md) |

## Review Checklist

- [ ] SwiftUI App protocol used with `@WKApplicationDelegateAdaptor` for lifecycle events
- [ ] `scenePhase` read from root view (not sheets/modals where it's always `.active`)
- [ ] `WKExtendedRuntimeSession` started only while app is active (not from background)
- [ ] Workout sessions recovered in `applicationDidFinishLaunching` (not just delegate)
- [ ] Background tasks scheduled at least 5 minutes apart; next scheduled before completing current
- [ ] `URLSessionDownloadTask` (not `DataTask`) used for background network requests
- [ ] WidgetKit used instead of ClockKit for watchOS 9+ complications
- [ ] Timeline includes future entries (not just current state); gaps avoided
- [ ] `TimelineEntryRelevance` implemented for Smart Stack prioritization
- [ ] WCSession delegate set before `activate()`; singleton pattern used
- [ ] `isReachable` checked before `sendMessage`; `transferUserInfo` for critical data
- [ ] Received files moved synchronously before delegate callback returns

## When to Load References

- Reviewing app lifecycle, background modes, or extended sessions -> lifecycle.md
- Reviewing complications, widgets, or timeline providers -> complications.md
- Reviewing WCSession, iPhone-Watch communication -> connectivity.md
- Reviewing memory, battery, or performance issues -> performance.md

## Output Format

Report issues using: `[FILE:LINE] ISSUE_TITLE`

Examples:

- `[WatchApp.swift:18] WKExtendedRuntimeSession started while app not active`
- `[ConnectivityManager.swift:42] WCSession.activate() before delegate assignment`
- `[ComplicationTimeline.swift:67] Timeline has no future entries`

## 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 unit: the `View` body, `WKApplicationDelegate` / scene method, `TimelineProvider` implementation, `WCSessionDelegate` callback, or workout/background task handler that owns the behavior—not only a diff hunk.
3. **watchOS or pairing claim** (only if the finding depends on background modes, complication/timeline contracts, `WCSession` reachability or transfer semantics, workout or extended runtime rules, or device-specific limits) — You name one concrete artifact you inspected (for example `Info.plist` / target capabilities for background modes, the `WK*` / `WCSession` call order in source, entitlements, or a subsection you read in the matching doc from [Quick Reference](#quick-reference)) **or** you downgrade the item to an open question in [Review Questions](#review-questions).
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.

## Review Questions

1. Is the app using modern SwiftUI lifecycle with delegate adaptor?
2. Are background tasks completing properly (calling `setTaskCompletedWithSnapshot`)?
3. Is UI update frequency reduced when `isLuminanceReduced` is true?
4. Are WatchConnectivity delegate callbacks dispatching to main thread?
5. Is `TabView` nested within another `TabView`? (Memory leak on watchOS)

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

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

Все скиллы по теме «Мобильная разработка» →
watchOS rshankras Инструкции по разработке под watchOS: проектирование интерфейсов на SwiftUI и настройка циферблатных виджетов WidgetKit. CX Codex +1 613установок axiom-watchos CharlesWiltgen Скилл axiom-watchos для разработки приложений под watchOS: структура, Smart Stack, complications, Watch Connectivity, фоновые задачи и миграция с ClockKit. CX Codex +1 1 000установок relevancekit dpearson2699 Скилл подсказывает агенту, как через RelevanceKit задавать контекст виджета на Apple Watch: время, место, тренировки, сон, подключённое железо. CX Codex +1 3 300установок watchos-design-guidelines platform-design-skills Скилл watchos-design-guidelines для Claude Code помогает проектировать интерфейсы watchOS, осложнения циферблата и функции тренировок. Активируется на задачах про Digital Crown и взаимодействия с Apple Watch. CX Codex +1 1 200установок release-review rshankras Скилл release-review прогоняет приложение для macOS и iOS по чек-листам релиза и выдаёт список проблем с готовыми правками. Пригодится перед отправкой в App Store или TestFlight. CX Codex +1 550установок widgetkit dpearson2699 Скилл widgetkit для Claude Code и других платформ: таймлайны, настраиваемые виджеты, интерактивные кнопки, Control Center. Покрывает виджеты на Home Screen и Lock Screen. CX Codex +1 4 400установок

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

Весь набор →
adr-decision-extraction Скилл adr-decision-extraction извлекает архитектурные решения из чатов и расшифровок, чтобы подготовить материал для ADR. Он распознаёт выбор технологий, компромиссы и явные метки. CX Codex +1 144установок deepagents-implementation Скилл deepagents-implementation для Claude Code даёт рецепты сборки агентов на Deep Agents: фабрика create_deep_agent, файловые бэкенды, субагенты и стриминг LangGraph. CX Codex +1 142установок llm-judge Скилл llm-judge сравнивает две и более реализации одной задачи по файлу спецификации: собирает факты, ставит оценки по пяти измерениям и выдаёт отчёт с победителем. CX Codex +1 141установок pydantic-ai-dependency-injection Скилл pydantic-ai-dependency-injection показывает, как передавать базы данных, API-клиенты и контекст пользователя в PydanticAI через RunContext и deps_type. CX Codex +1 141установок swiftdata-code-review Скилл swiftdata-code-review проверяет код SwiftData на ошибки в моделях, предикатах, миграциях и конкурентности. Запускается при ревью файлов со связками @Model и @Query. CX Codex +1 136установок howto-docs Скилл howto-docs помогает писать пошаговые how-to-гайды под конкретную задачу: с предусловиями, шагами, проверкой результата и разбором типичных проблем. CX Codex +1 135установок deepagents-code-review Скилл deepagents-code-review проверяет код на create_deep_agent: ловит забытый checkpointer, относительные пути и бэкенды без хранилища. CX Codex +1 134установок healthkit-code-review Скилл healthkit-code-review для Claude Code разбирает код с HealthKit по шагам: авторизацию, запросы, observer-запросы и фоновую доставку. Проверяет работу приложения с данными о здоровье. CX Codex +1 134установок

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

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