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

composable-architecture — скилл для Claude Code: функции и установка

Скилл помогает строить функции на The Composable Architecture (TCA): организовывать редьюсеры, состояние, эффекты, навигацию и тесты. Пригодится при разработке или проверке TCA-функций.

MIT ★ 233 обновлён 2026-01-18

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Открыть на GitHub

Что делает 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-code

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

~/.claude/skills/composable-architecture/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Мобильная разработка» →
create-adaptable-composable github.com/vuejs-ai Скилл create-adaptable-composable для Claude Code учит создавать переиспользуемые Vue composable, принимающие значения, рефы или геттеры. Нормализует входы, чтобы composable работала одинаково с каждым типом. CX Codex +1 15 100установок composable-move-functions MystenLabs Скилл composable-move-functions для Claude Code задаёт правила оформления функций на языке Move в блокчейне Sui. Включается при проектировании публичных сигнатур, порядка параметров и возврата объектов для транзакций PTB. CX Codex +1 616установок flutter-apply-architecture-best-practices flutter Скилл flutter-apply-architecture-best-practices для Claude Code раскладывает Flutter-приложение по слоям UI, Logic и Data. Описывает архитектуру нового проекта и рефакторинг кода. CX Codex +1 47 000установок react-native-architecture Seth Hobson Скилл react-native-architecture для Claude Code, Codex и Cursor: подсказывает структуру проекта, навигацию, нативные модули и офлайн-синхронизацию в React Native на Expo. CX Codex +1 15 087установок android-clean-architecture affaan-m Скилл android-clean-architecture подсказывает агенту, как раскладывать Android- и KMP-проект по слоям: модули, зависимости, UseCase, репозитории, работа с Room, SQLDelight и Ktor. CX Codex +1 7 200установок cmux-architecture manaflow-ai Скилл cmux-architecture задаёт правила разделения кода cmux на пакеты Swift, инверсии зависимостей и многопоточности Swift 6. Помогает переносить модули без циклических связей. CX Codex +1 5 100установок

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

Весь набор →
swift-ui-design Субагент swift-ui-design анализирует скриншоты, макеты и текстовые описания интерфейсов, чтобы составить спецификацию для вёрстки на SwiftUI. CX Codex ★ 233звёзд репо foundation-models Подключает паттерны работы с Foundation Models Apple: суммаризацию, извлечение данных и классификацию текста на устройстве. Claude Code сверяется с ним при настройке LanguageModelSession и @Generable. CX Codex +1 ★ 233звёзд репо tca-engineer Субагент tca-engineer пишет код TCA-фичи по готовому дизайну: редьюсер, состояние, экшены и клиенты зависимостей с тестовыми реализациями. Вьюхи не трогает. CX Codex ★ 233звёзд репо sqlite-data Помогает проектировать базы данных на Swift с библиотекой SQLiteData, писать выборки через макросы и настраивать синхронизацию с CloudKit. CX Codex +1 ★ 233звёзд репо modern-swift Скилл modern-swift для Claude, который ведёт агента при работе с конкурентностью в Swift 6.2: async/await, акторы, Sendable и отмена задач. CX Codex +1 ★ 233звёзд репо swiftui-patterns Скилл swiftui-patterns внедряет архитектурные паттерны SwiftUI для iOS 17+: макрос @Observable, программную навигацию и связывание с UIKit. CX Codex +1 ★ 233звёзд репо swift-testing Скилл помогает писать тесты на Swift Testing, переносить проверки с XCTest и добавлять асинхронные и параметризованные сценарии. CX Codex +1 ★ 233звёзд репо tca-architect Субагент tca-architect проектирует архитектуру фич на The Composable Architecture: структуру State, таксономию Action, зависимости и навигацию. Работает в режиме read-only. CX Codex ★ 233звёзд репо

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

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