combine-code-review — скилл для Claude Code: ревью Combine
Скилл combine-code-review проверяет код на Combine на ошибки в подписках, операторах, управлении памятью и обработке ошибок. Пригодится перед ревью Swift-кода с Combine.
Apache-2.0 123 установок ★ 89 обновлён 2026-09-15
npx skills add existential-birds/beagle --skill combine-code-review -a claude-codeЧто делает combine-code-review
Скилл разбирает цепочки Combine и сверяет их с чек-листом: проверяет, где хранятся AnyCancellable, могут ли sink и assign удерживать self, правильно ли выбраны операторы и обработаны ошибки. Отдельно обращает внимание на обновления UI не из главного потока и выбор между PassthroughSubject для событий и CurrentValueSubject для состояния.
В комплекте есть справочные материалы по publisher-ам, операторам, памяти и обработке ошибок. Перед выводами скилл требует определить, относится ли файл к Combine, проследить срок жизни подписок и обосновать утечки цепочкой захватов; для серьёзных замечаний нужны файл и строка. Если в фрагменте не видно, где хранится подписка, скилл просит показать окружающий код, а не объявляет её безопасной.
Какие задачи решает
- найти отброшенные или недолго живущие
AnyCancellable - проверить захват
selfв замыканияхsinkиassign - выявить неверный выбор между
flatMapиswitchToLatest - проверить обработку ошибок в цепочке publisher-ов
- найти обновления UI без перехода на главный поток
Примеры запросов агенту
- Проверь этот код Combine на утечки памяти и покажи цепочки захватов.
- Разбери операторы в этом поисковом publisher-е и проверь, нужен ли
switchToLatest. - Проверь обработку ошибок и хранение подписок в этом файле.
Как установить combine-code-review
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill combine-code-review -a claude-code2Вручную: положить файлы
~/.claude/skills/combine-code-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/combine-code-review/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill combine-code-review -a codex2Вручную: положить файлы
.agents/skills/combine-code-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill combine-code-review -a cursor2Вручную: положить файлы
.cursor/skills/combine-code-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install existential-birds/beagle plugins/beagle-ios/skills/combine-code-review2Вручную: положить файлы
.github/skills/combine-code-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill combine-code-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/existential-birds/beagle --path plugins/beagle-ios/skills/combine-code-reviewВручную: положить файлы
.devin/skills/combine-code-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill combine-code-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о combine-code-review
Как установить combine-code-review в Claude Code?
Выполните npx skills add existential-birds/beagle --skill combine-code-review -a claude-code. Файл скилла находится в ~/.claude/skills/combine-code-review/SKILL.md.
Что делает combine-code-review?
Проверяет Combine-код на проблемы с подписками, удержанием объектов, операторами и ошибками. Также смотрит, как цепочки обновляют UI.
Что скилл проверяет при поиске утечки памяти?
Он прослеживает, где хранится AnyCancellable и как замыкание захватывает self. Подтверждённая утечка должна содержать цепочку удержания; сомнительный случай отмечается как риск.
Исходный текст
SKILL.md · Apache-2.0
--- name: combine-code-review description: Reviews Combine framework code for memory leaks, operator misuse, and error handling. Use when reviewing code with import Combine, AnyPublisher, @Published, PassthroughSubject, or CurrentValueSubject. --- # Combine Code Review ## Quick Reference | Issue Type | Reference | |------------|-----------| | Publishers, Subjects, AnyPublisher | [references/publishers.md](references/publishers.md) | | map, flatMap, combineLatest, switchToLatest | [references/operators.md](references/operators.md) | | AnyCancellable, retain cycles, [weak self] | [references/memory.md](references/memory.md) | | tryMap, catch, replaceError, Never | [references/error-handling.md](references/error-handling.md) | ## Review Checklist - [ ] All `sink` closures use `[weak self]` when self owns cancellable - [ ] No `assign(to:on:self)` usage (use `assign(to: &$property)` or sink) - [ ] All AnyCancellables stored in Set or property (not discarded) - [ ] Subjects exposed as `AnyPublisher` via `eraseToAnyPublisher()` - [ ] `flatMap` used correctly (not when `map + switchToLatest` needed) - [ ] Error handling inside `flatMap` to keep main chain alive - [ ] `tryMap` followed by `mapError` to restore error types - [ ] `receive(on: DispatchQueue.main)` before UI updates - [ ] PassthroughSubject for events, CurrentValueSubject for state - [ ] Future wrapped in Deferred when used with retry ## When to Load References - Reviewing Subjects or publisher selection → publishers.md - Reviewing operator chains or combining publishers → operators.md - Reviewing subscriptions or memory issues → memory.md - Reviewing error handling or try* operators → error-handling.md ## Hard gates (before you report findings) Complete in order. Do not skip ahead while a prior gate is open. 1. **Scope** — **Pass:** You name at least one file or type under review that imports Combine or uses APIs from the Quick Reference (e.g. `AnyPublisher`, `@Published`, `PassthroughSubject`). If none apply, stop with “out of scope.” 2. **Subscription retention** — **Pass:** For each `sink`, `assign`, and `store(in:)` in scope, you state where the `AnyCancellable` is retained (property, `Set`, task lifetime) or mark **ephemeral** with a one-line reason (e.g. synchronous one-shot that cannot outlive caller). If you cannot tell from the snippet, say **unknown** and ask for surrounding storage, do not assume safe. 3. **Retain-cycle claim** — **Pass:** **Confirmed** leak findings state the capture chain (e.g. self → stored cancellable → closure strongly capturing self). Label suspected cases **risk** / **verify**, not confirmed leaks. When arguing safety, cite `[weak self]`, `[unowned self]`, or non-capturing patterns you relied on. 4. **UI / main thread** — **Pass:** For updates to UIKit/SwiftUI from a chain, you either point to `receive(on: DispatchQueue.main)`, `@MainActor`, or equivalent before the UI work, **or** flag missing scheduling with `file:line`. 5. **Severity and checklist** — **Pass:** Every **high** or **critical** item includes `file:line` (or exact pasted lines) and names which **Review Checklist** row it breaks. Lower-severity notes may omit line numbers but must still be reproducible from named files. ## Review Questions 1. Are all subscriptions being retained? (Check for discarded AnyCancellables) 2. Could any sink or assign create a retain cycle with self? 3. Does flatMap need to be switchToLatest for search/autocomplete? 4. What happens when this publisher fails? (Will it kill the main chain?) 5. Are error types preserved or properly mapped after try* operators?
© existential-birds · Apache-2.0 · existential-birds/beagle