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

healthkit-code-review — скилл для Claude Code: ревью кода HealthKit

Скилл healthkit-code-review для Claude Code разбирает код с HealthKit по шагам: авторизацию, запросы, observer-запросы и фоновую доставку. Проверяет работу приложения с данными о здоровье.

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

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

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

Скилл ревьюит код, который работает с HealthKit в iOS-приложении: авторизацию, запросы, фоновую доставку и типы данных. Внутри чек-лист и четыре справочника по темам. Начинается всё с HKHealthStore.isHealthDataAvailable() — вызов должен стоять до любых операций с хранилищем, а разрешения запрашиваются только на нужные типы.

Разбор идёт в шесть шагов, они называются review gates. Сначала скилл требует назвать файлы и символы, которые трогают HealthKit, потом показать место вызова проверки доступности и разобрать ветки обработчика requestAuthorization. Замечание на следующем шаге не выдаётся, пока не выполнено условие текущего.

Успешный requestAuthorization не доказывает доступ на чтение: в HealthKit статус чтения не узнать, и скилл следит, чтобы код не пытался его выяснить. Ещё он смотрит на HKObjectQueryNoLimit без ограниченного предиката, ручное суммирование там, где нужен HKStatisticsQuery, и единицы вроде count/min для пульса. Фоновой доставке нужен entitlement на iOS 15+ и регистрация в application(_:didFinishLaunchingWithOptions:).

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

  • поймать обращение к HKHealthStore без проверки доступности данных
  • разобрать ветки requestAuthorization и не спутать успех с доступом на чтение
  • убедиться, что у каждого запроса есть предикат и лимит
  • найти observer-запрос, который не вызывает completionHandler() на части путей
  • свериться, что якоря хранятся отдельно по каждому типу выборки

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

  • Пройди по review gates в HealthStoreManager.swift и покажи, где авторизация разобрана неверно.
  • Проверь observer-запросы в этом диффе: вызывается ли completionHandler() на всех путях?
  • Найди все HKQuantityType в проекте и сверь единицы измерения.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

Выполните npx skills add existential-birds/beagle --skill healthkit-code-review -a claude-code. Файл скилла появится по пути ~/.claude/skills/healthkit-code-review/SKILL.md.

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

Проверяет код с HealthKit по чек-листу: доступность данных, минимальные разрешения, предикаты и лимиты запросов, observer-запросы, фоновую доставку и единицы измерения. Отдельно следит, чтобы статус чтения не пытались выяснить через authorizationStatus.

Что нужно, чтобы заработала фоновая доставка?

Entitlement на iOS 15+ и регистрация в application(_:didFinishLaunchingWithOptions:). Работу внутри фонового обработчика скилл советует держать в пределах примерно 15 секунд.

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

SKILL.md · Apache-2.0
---
name: healthkit-code-review
description: Reviews HealthKit code for authorization patterns, query usage, background delivery, and data type handling. Use when reviewing code with import HealthKit, HKHealthStore, HKSampleQuery, HKObserverQuery, or HKQuantityType.
---

# HealthKit Code Review

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| HKHealthStore, permissions, status checks, privacy | [references/authorization.md](references/authorization.md) |
| HKQuery types, predicates, anchored queries, statistics | [references/queries.md](references/queries.md) |
| Background delivery, observer queries, completion handlers | [references/background.md](references/background.md) |
| HKQuantityType, HKCategoryType, workouts, units | [references/data-types.md](references/data-types.md) |

## Review Checklist

- [ ] `HKHealthStore.isHealthDataAvailable()` called before any HealthKit operations
- [ ] Authorization requested only for needed data types (minimal permissions)
- [ ] `requestAuthorization` completion handler not misinterpreted as permission granted
- [ ] No attempt to determine read permission status (privacy by design)
- [ ] Query results dispatched to main thread for UI updates
- [ ] `HKObjectQueryNoLimit` used only with bounded predicates
- [ ] `HKStatisticsQuery` used for aggregations instead of manual summing
- [ ] Observer query `completionHandler()` always called (use `defer`)
- [ ] Background delivery registered in `application(_:didFinishLaunchingWithOptions:)`
- [ ] Background delivery entitlement added (iOS 15+)
- [ ] Correct units used for quantity types (e.g., `count/min` for heart rate)
- [ ] Long-running queries stored as properties and stopped in `deinit`

## When to Load References

- Reviewing authorization/permissions flow -> authorization.md
- Reviewing HKSampleQuery, HKAnchoredObjectQuery, or predicates -> queries.md
- Reviewing HKObserverQuery or `enableBackgroundDelivery` -> background.md
- Reviewing HKQuantityType, HKCategoryType, or HKWorkout -> data-types.md

## Review gates

Run in order. **Do not state a finding in a later step until the pass condition for the current step is satisfied** (each pass condition is answerable from the codebase under review).

1. **Scope** — **Pass:** Name the file path(s) and types/symbols using `HealthKit`, `HKHealthStore`, or `HK*` APIs (or state clearly that the diff touches none).
2. **Availability and store** — **Pass:** Cite the call site of `isHealthDataAvailable()` before HealthKit use, or document why omission is acceptable for the scoped code; cite where `HKHealthStore` is created or injected.
3. **Authorization semantics** — **Pass:** For each `requestAuthorization` / `getRequestStatusForAuthorization`, cite handler branches per [references/authorization.md](references/authorization.md) (e.g. success does not prove read access); do not infer read permission from `authorizationStatus` alone.
4. **Queries and limits** — **Pass:** For each query, cite predicate + limit (`HKObjectQueryNoLimit` only with a bounded predicate); for totals/aggregates, cite `HKStatisticsQuery` / collection vs manual summing per [references/queries.md](references/queries.md).
5. **Observers and background** — **Pass:** If `HKObserverQuery` or `enableBackgroundDelivery` appears, cite where the observer is started/stopped and where background delivery is registered; cite entitlements/Info.plist or flag missing config per [references/background.md](references/background.md). If absent, **Pass:** one line “no observer/background in scope.”
6. **Threading and lifecycle** — **Pass:** Cite main-queue (or documented pattern) for UI updates from query callbacks; cite retention/`stop()`/`deinit` for long-running queries per checklist above.

## Review Questions

1. Is `isHealthDataAvailable()` checked before creating HKHealthStore?
2. Does the code gracefully handle denied permissions (empty results)?
3. Are observer query completion handlers called in all code paths?
4. Is work in background handlers minimal (~15 second limit)?
5. Are HKQueryAnchors persisted per sample type (not shared)?

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

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

Все скиллы по теме «Мобильная разработка» →
healthkit dpearson2699 Скилл помогает настроить чтение, запись и агрегацию данных Apple Health через HealthKit на Swift. Пригодится при реализации тренировок, графиков активности и фонового сбора метрик. CX Codex +1 4 200установок capacitor-best-practices Cap-go Скилл capacitor-best-practices проверяет Capacitor-проект на ошибки, из-за которых ломаются сборки и утекают dev-настройки в релиз. Полезен перед выкладкой в стор. CX Codex +1 2 900установок flutter-dart-code-review affaan-m Скилл flutter-dart-code-review для Claude Code даёт чек-лист ревью Flutter/Dart-кода по виджетам, состоянию, идиомам, производительности и безопасности. CX Codex +1 6 600установок axiom-health CharlesWiltgen Скилл axiom-health для Claude Code помогает писать код с HealthKit и WorkoutKit на iOS и watchOS. Подключается к задачам с данными о здоровье, тренировками и разрешениями. CX Codex +1 1 100установок hig-technologies raintree-technology Скилл hig-technologies для Claude Code подсказывает, как встроить технологии Apple в приложение по рекомендациям Apple HIG. Он включается при вопросах о Siri, Apple Pay, HealthKit, ARKit и других сервисах Apple. CX Codex +1 748установок senior-mobile borghei Скилл senior-mobile для мобильной разработки, работает в Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 316установок

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

Весь набор →
watchos-code-review Скилл watchos-code-review для Claude Code проверяет watchOS-код на ошибки жизненного цикла, осложнений, WatchConnectivity и ограничения производительности. CX Codex +1 137установок 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установок 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установок

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

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