composable-architecture — скилл для Claude Code: функции и установка
Скилл помогает строить функции на The Composable Architecture (TCA): организовывать редьюсеры, состояние, эффекты, навигацию и тесты. Пригодится при разработке или проверке TCA-функций.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает composable-architecture
Скилл разбирает устройство TCA: @Reducer, Store, Effect, композицию редьюсеров и работу с зависимостями. Для разных задач в нём есть справочные файлы о состоянии, представлениях, навигации, эффектах и тестировании. При настройке редьюсера он подсказывает, какой материал загрузить.
Можно обратиться к нему за помощью с TestStore, @Shared, отменой эффектов или навигационным состоянием. В тестах важно проверять эффекты через утверждения TestStore; пропущенные проверки могут скрыть ошибки. Эффекты, которые не отменяются при изменении состояния, способны привести к устаревшим данным и гонкам.
Какие задачи решает
- создать редьюсер с состоянием и действиями
- разделить функцию на связанные дочерние редьюсеры
- обработать асинхронную работу и отменить эффект
- настроить навигацию через состояние родительской функции
- проверить изменения состояния и эффекты с помощью
TestStore
Примеры запросов агенту
- Создай редьюсер TCA для этой функции и укажи, какие справочные файлы нужны.
- Проверь обработку асинхронного эффекта: где нужна отмена и как покрыть её тестом?
- Помоги написать тест
TestStoreдля действий и изменений состояния этой функции.
Как установить composable-architecture
1Через маркетплейс плагинов
/plugin marketplace add johnrogers/claude-swift-engineering/plugin install swift-engineering@claude-swift-engineeringКоманда ставит плагин swift-engineering целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill composable-architecture -a claude-code3Вручную: положить файлы
~/.claude/skills/composable-architecture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/composable-architecture/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill composable-architecture -a codex2Вручную: положить файлы
.agents/skills/composable-architecture/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill composable-architecture -a cursor2Вручную: положить файлы
.cursor/skills/composable-architecture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/composable-architecture2Вручную: положить файлы
.github/skills/composable-architecture/SKILL.md1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill composable-architecture -a gemini-cli2Командой платформы
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/composable-architectureВручную: положить файлы
.devin/skills/composable-architecture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о composable-architecture
Как установить composable-architecture в Claude Code?
В Claude Code добавьте маркетплейс командой /plugin marketplace add johnrogers/claude-swift-engineering, затем установите плагин командой /plugin install swift-engineering@claude-swift-engineering.
Что делает composable-architecture?
Скилл помогает создавать и тестировать функции на TCA: работать с редьюсерами, состоянием, эффектами и навигацией.
Почему важно отменять эффекты при изменении состояния?
Без отмены эффект может вернуть устаревшие данные или вызвать дублирующий запрос и гонку. Скилл описывает применение .cancel и .concatenate.
Исходный текст
SKILL.md · MIT
--- name: composable-architecture description: Use when building features with TCA (The Composable Architecture), structuring reducers, managing state, handling effects, navigation, or testing TCA features. Covers @Reducer, Store, Effect, TestStore, reducer composition, and TCA patterns. --- # The Composable Architecture (TCA) TCA provides architecture for building complex, testable features through composable reducers, centralized state management, and side effect handling. The core principle: predictable state evolution with clear dependencies and testable effects. ## Reference Loading Guide **ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake. | Reference | Load When | |-----------|-----------| | **[Reducer Structure](references/reducer-structure.md)** | Creating new reducers, setting up `@Reducer`, `State`, `Action`, or `@ViewAction` | | **[Views - Binding](references/views-binding.md)** | Using `@Bindable`, two-way bindings, `store.send()`, or `.onAppear`/`.task` | | **[Views - Composition](references/views-composition.md)** | Using `ForEach` with stores, scoping to child features, or optional children | | **[Navigation - Basics](references/navigation-basics.md)** | Setting up `NavigationStack`, path reducers, pushing/popping, or programmatic dismiss | | **[Navigation - Advanced](references/navigation-advanced.md)** | Deep linking, recursive navigation, or combining NavigationStack with sheets | | **[Shared State](references/shared-state.md)** | Using `@Shared`, `.appStorage`, `.withLock`, or sharing state between features | | **[Dependencies](references/dependencies.md)** | Creating `@DependencyClient`, using `@Dependency`, or setting up test dependencies | | **[Effects](references/effects.md)** | Using `.run`, `.send`, `.merge`, timers, effect cancellation, or async work | | **[Presentation](references/presentation.md)** | Using `@Presents`, `AlertState`, sheets, popovers, or the Destination pattern | | **[Testing - Fundamentals](references/testing-fundamentals.md)** | Setting up test suites, `makeStore` helpers, or understanding Equatable requirements | | **[Testing - Patterns](references/testing-patterns.md)** | Testing actions, state changes, dependencies, errors, or presentations | | **[Testing - Advanced](references/testing-advanced.md)** | Using `TestClock`, keypath matching, `exhaustivity = .off`, or time-based tests | | **[Testing - Utilities](references/testing-utilities.md)** | Test data factories, `LockIsolated`, `ConfirmationDialogState` testing, or `@Shared` testing | | **[Performance](references/performance.md)** | Optimizing state updates, high-frequency actions, memory, or store scoping | ## Common Mistakes 1. **Over-modularizing features** — Breaking features into too many small reducers makes state management harder and adds composition overhead. Keep related state and actions together unless there's genuine reuse. 2. **Mismanaging effect lifetimes** — Forgetting to cancel effects when state changes leads to stale data, duplicate requests, or race conditions. Use `.concatenate` for sequential effects and `.cancel` when appropriate. 3. **Navigation state in wrong places** — Putting navigation state in child reducers instead of parent causes unnecessary view reloads and state inconsistencies. Navigation state belongs in the feature that owns the navigation structure. 4. **Testing without TestStore exhaustivity** — Skipping TestStore assertions for "simple" effects or "obvious" state changes means you miss bugs. Use exhaustivity checking religiously; it catches regressions early. 5. **Mixing async/await with Effects incorrectly** — Converting async/await to `.run` effects without proper cancellation or error handling loses isolation guarantees. Wrap async operations carefully in `.run` with `yield` statements.
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering