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

swift-code-review — скилл для Claude Code: проверка Swift-кода

Скилл swift-code-review для Claude Code проверяет Swift-код на ошибки конкурентности, обработки ошибок и управления памятью. Подключается при ревью файлов .swift, в том числе с async/await, actors и Sendable.

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

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

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

Скилл проверяет изменённый код по списку типичных проблем: принудительное извлечение значений, циклы удержания, обработку ошибок, отмену длительных задач и безопасность типов Sendable. Для каждого изменённого файла он требует прочитать содержащий правку тип или член целиком, а перед замечаниями — зафиксировать версию Swift и применимые разделы чек-листа.

Замечания оформляются с файлом и строкой, уровнем серьёзности и пояснением. Для проверки конкурентности, SwiftUI-наблюдения и ошибок скилл направляет к отдельным справочным файлам. Перед публикацией каждого finding требуется выполнить шаги review-verification-protocol; этот протокол должен быть доступен по пути ../review-verification-protocol/SKILL.md.

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

  • найти небезопасное использование Sendable и @unchecked Sendable
  • проверить отмену длительных задач и параллельный запуск async-операций
  • обнаружить циклы удержания в замыканиях и делегатах
  • оценить обработку ошибок и принудительное извлечение значений
  • оформить замечания с точными строками и уровнем серьёзности

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

  • Проведи ревью изменённых файлов Swift и укажи проблемы с конкурентностью.
  • Проверь этот код на циклы удержания и ошибки обработки.
  • Разбери изменения в Package.swift и проверь подходящие пункты чек-листа.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

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

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

Он проверяет Swift-код на проблемы с конкурентностью, управлением памятью и обработкой ошибок, а также формирует замечания с файлом, строкой и уровнем серьёзности.

Что проверяет swift-code-review перед выдачей замечаний?

Скилл требует определить версию Swift, прочитать окружающий изменённый символ и выбрать подходящие пункты чек-листа. Для каждого замечания также нужно выполнить review-verification-protocol.

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

SKILL.md · Apache-2.0
---
name: swift-code-review
description: Reviews Swift code for concurrency safety, error handling, memory management, and common mistakes. Use when reviewing .swift files for async/await patterns, actor isolation, Sendable conformance, or general Swift best practices.
---

# Swift Code Review

## Review Workflow

Follow this sequence **in order**. Do not emit findings until every **Pass** below is satisfied.

1. **Swift / toolchain baseline** — Establish language and tooling context: `Package.swift` `// swift-tools-version` and any per-target Swift language version or `swiftSettings` in the manifest; for Xcode, `SWIFT_VERSION` (or equivalent) in project or target build settings; note if review is single-file only.  
   **Pass:** You state a concrete Swift language version or mode (e.g. Swift 6 language mode, tools 5.10) *before* advice that depends on strict concurrency, migration-only syntax, or SDK availability.

2. **Read surrounding code** — For each changed `.swift` file, read the full enclosing type, function, method, or property that contains the edits, not only the diff hunk.  
   **Pass:** At least one full enclosing symbol (type or member) containing the change was read per changed file.

3. **Scope the checklist** — Using [Quick Reference](#quick-reference), decide which [Review Checklist](#review-checklist) rows and [references](#when-to-load-references) apply; open those reference files; skip rows clearly unrelated to the diff.  
   **Pass:** The review (or working notes) lists which checklist areas you applied, or marks areas N/A with a one-line reason tied to the diff (e.g. “no SwiftUI / @Observable in change”).

4. **Pre-report verification** — Load and follow [review-verification-protocol](../review-verification-protocol/SKILL.md).  
   **Pass:** That skill’s **Hard gates (sequenced)** are satisfied for each finding you will report (full symbol read, usage search before “unused”, caller checked before “missing handling”, severity calibrated, `[FILE:LINE]` proof).

## Hard gates (same sequence, shorter)

| Step | Objective pass condition |
| --- | --- |
| 1 | Swift version/mode (or explicit single-file limitation) recorded before version- or SDK-gated advice. |
| 2 | Full enclosing symbol read per changed file, not diff-only. |
| 3 | Checklist areas + references listed or N/A with diff-tied reason. |
| 4 | `review-verification-protocol` completed for every reported issue. |

## Output format

Report findings as:

```text
[FILE:LINE] ISSUE_TITLE
Severity: Critical | Major | Minor | Informational
Description of the issue and why it matters.
```

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| async/await, actors, Sendable, Task | [references/concurrency.md](references/concurrency.md) |
| @Observable, @ObservationIgnored, @Bindable | [references/observable.md](references/observable.md) |
| throws, Result, try?, typed throws | [references/error-handling.md](references/error-handling.md) |
| Force unwraps, retain cycles, naming | [references/common-mistakes.md](references/common-mistakes.md) |

## Review Checklist

- [ ] No force unwraps (`!`) on runtime data (network, user input, files)
- [ ] Closures stored as properties use `[weak self]`
- [ ] Delegate properties are `weak`
- [ ] Independent async operations use `async let` or `TaskGroup`
- [ ] Long-running Tasks check `Task.isCancelled`
- [ ] Actors have mutable state to protect (no stateless actors)
- [ ] Sendable types are truly thread-safe (beware `@unchecked`)
- [ ] Errors handled explicitly (no empty catch blocks)
- [ ] Custom errors conform to `LocalizedError` with descriptive messages
- [ ] Nested @Observable objects are also marked @Observable
- [ ] @Bindable used for two-way bindings to Observable objects

## When to Load References

- Reviewing async/await, actors, or TaskGroups → concurrency.md
- Reviewing @Observable or SwiftUI state → observable.md
- Reviewing error handling or throws → error-handling.md
- General Swift review → common-mistakes.md

## Review Questions

1. Are async operations that could run concurrently using `async let`?
2. Could actor state change across suspension points (reentrancy bug)?
3. Is `@unchecked Sendable` backed by actual synchronization?
4. Are errors logged and presented with helpful context?
5. Could any closure or delegate create a retain cycle?

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

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

Все скиллы по теме «Код-ревью и рефакторинг» →
swift-concurrency-expert Dimillian Скилл swift-concurrency-expert проверяет и исправляет проблемы параллелизма в Swift 6.2+: добавляет Sendable, применяет @MainActor, решает предупреждения об изоляции акторов и переводит completion handlers на async/await. CX Codex +1 2 100установок migrating-to-swift-concurrency kylehughes Скилл migrating-to-swift-concurrency даёт агенту руководство Apple по миграции на Swift Concurrency. Пригодится при переходе на Swift 6, устранении гонок данных и настройке изоляции акторов. CX Codex +1 ★ 58звёзд репо modern-swift John Rogers (@johnrogers) Скилл modern-swift для Claude, который ведёт агента при работе с конкурентностью в Swift 6.2: async/await, акторы, Sendable и отмена задач. CX Codex +1 ★ 233звёзд репо swift-concurrency-pro Paul Hudson Скилл swift-concurrency-pro проверяет Swift-код на корректность конкурентности, современные API и типичные ловушки async/await. Пригодится при чтении и ревью асинхронного кода. CX Codex +1 13 100установок swift-concurrency dpearson2699 Скилл swift-concurrency помогает устранять ошибки Sendable и изоляции акторов в Swift 6.2+, настраивать фоновые задачи и применять SE-0466. CX Codex +1 4 600установок guide-swift-concurrency Prisma-Labs-Dev Скилл guide-swift-concurrency настраивает проверку конкурентного кода на Swift 6.2 со strict concurrency. Он помогает находить гонки данных, изолировать акторы и заменять вызовы GCD на группы задач. CX Codex +1 539установок

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

Весь набор →
bubbletea-code-review Скилл bubbletea-code-review для Claude Code проверяет Go-код BubbleTea-проектов: архитектуру Elm, цикл Update и стили Lipgloss. CX Codex +1 270установок zustand-state Скилл zustand-state для Claude Code помогает создавать хранилища Zustand, выбирать данные селекторами, сохранять их в localStorage и подключать devtools. CX Codex +1 261установок dagre-react-flow Скилл dagre-react-flow настраивает автоматическую раскладку направленных графов в React Flow с помощью dagre. Помогает строить иерархические деревья и выравнивать узлы по направлениям. CX Codex +1 257установок adr-writing Скилл adr-writing для Claude Code, который оформляет архитектурные решения в документы ADR по шаблону MADR и проверяет их полноту по чек-листу E.C.A.D.R. Работает также в Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 254установок review-verification-protocol Скилл review-verification-protocol обязывает проверить каждую находку перед тем, как внести её в отчёт — читать исходный код, искать контекст, отличать баги от стиля. Снижает ложные срабатывания в ревью. CX Codex +1 252установок pytest-code-review Скилл pytest-code-review проверяет тесты pytest на корректность асинхронных вызовов, скоуп фикстур, параметризацию и пути для моков. Помогает находить утечки и ошибки патчинга до запуска CI. CX Codex +1 239установок sqlalchemy-code-review Скилл sqlalchemy-code-review проверяет SQLAlchemy-код на ошибки в сессиях, связях, запросах и миграциях. Нужен при ревью проектов на SQLAlchemy 2.0 и Alembic. CX Codex +1 228установок pydantic-ai-common-pitfalls Скилл pydantic-ai-common-pitfalls разбирает типичные ошибки в агентах на PydanticAI и подсказывает, что править: декораторы инструментов, зависимости, схемы вывода, стриминг. CX Codex +1 221установок

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

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