ship-adapter — скилл для Claude Code: адаптеры и установка
Скилл ship-adapter для Claude Code переносит схемы и контракты API в адаптеры. Запускается при создании адаптера базы данных, API-клиента или преобразователя данных.
MIT ★ 26 обновлён 2026-11-16
npx skills add wrg32786/aigent-os --skill ship-adapter -a claude-codeЧто делает ship-adapter
Скилл создаёт код адаптера между двумя известными интерфейсами: например, между схемой базы данных и типом ответа API. Он читает исходную и целевую схемы, ищет примеры адаптеров в проекте и учитывает их стиль обработки ошибок. До написания кода нужно прочитать обе стороны контракта.
Пустые и необязательные поля обрабатываются явно, а для неочевидного сопоставления полей добавляется комментарий. Результат включает журнал изменений: какие файлы затронуты, что осталось без изменений, где возникли сомнения и какие решения приняты. Скилл ограничивает работу самим адаптером; изменения инфраструктуры передаются вызывающему агенту.
Какие задачи решает
- перенести данные между двумя схемами
- обернуть API в клиентский интерфейс
- сопоставить поля базы данных с типом ответа
- учесть пустые и необязательные поля при преобразовании
Примеры запросов агенту
- Создай адаптер между схемой
UserRecordи типом ответаUserProfile. - Обёрни этот API в клиентский адаптер и учти существующие шаблоны проекта.
- Преобразуй эту схему в целевой интерфейс, не теряя поля.
Как установить ship-adapter
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill ship-adapter -a claude-code2Вручную: положить файлы
~/.claude/skills/ship-adapter/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ship-adapter/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill ship-adapter -a codex2Вручную: положить файлы
.agents/skills/ship-adapter/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill ship-adapter -a cursor2Вручную: положить файлы
.cursor/skills/ship-adapter/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wrg32786/aigent-os skills/ship-adapter2Вручную: положить файлы
.github/skills/ship-adapter/SKILL.md1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill ship-adapter -a gemini-cli2Командой платформы
gemini skills install https://github.com/wrg32786/aigent-os --path skills/ship-adapterВручную: положить файлы
.devin/skills/ship-adapter/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill ship-adapter -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ship-adapter
Как установить ship-adapter в Claude Code?
Выполни npx skills add wrg32786/aigent-os --skill ship-adapter -a claude-code. Файл скилла находится по пути ~/.claude/skills/ship-adapter/SKILL.md.
Что делает ship-adapter?
Он пишет адаптер между двумя интерфейсами или схемами, учитывая соглашения проекта. В конце возвращает журнал изменений и решений.
Что происходит с полями, которые нельзя сопоставить?
Скилл не отбрасывает их молча: для несопоставленных полей добавляется комментарий. Неочевидные преобразования также сопровождаются пояснением.
Исходный текст
SKILL.md · MIT
--- name: ship-adapter agent: lyra description: "Port schemas, interfaces, and API contracts into adapters. Use when writing a DB adapter, API client wrapper, interface adapter, or data transformer." allowed-tools: Read, Write, Edit, Bash, Grep, Glob, Agent user-invocable: true triggers: - ship adapter - port adapter - write adapter - DB adapter - API adapter - data transformer - schema migration - interface adapter - wrap this API - transform this schema --- # Ship Adapter You are Lyra shipping a bounded adapter — a translation layer between two data shapes, APIs, or storage systems. ## What this skill does Write an adapter that translates between two known interfaces. Inputs: source shape + target shape + any behavioral constraints. Output: working adapter code + honesty ledger. ## Protocol ### Step 1: Confirm the contract State in one sentence what is being adapted. Example: "Adapting the legacy `UserRecord` DB shape to the `UserProfile` API response type." Identify: - Source shape (where data comes from) - Target shape (what consumers expect) - Edge cases or nullability constraints called out in the spec If ambiguous, ask ONE question. Then build. ### Step 2: Read both sides - Read the source type/schema definition - Read the target type/schema definition - Grep for existing adapter patterns in the codebase to match style ### Step 3: Write the adapter - Handle nulls and optional fields explicitly — no silent drops - Add a comment for any non-obvious field mapping - Match the codebase's existing error handling pattern ### Step 4: Return honesty ledger ``` ## Honesty Ledger **Changed:** <files created or modified> **Untouched:** <files read but not changed> **Noticed-not-fixed:** <mapping issues seen but out of scope> **Residual uncertainty:** <fields that required a guess> **Tradeoffs:** <decisions made — e.g., lossy vs lossless, null coalescing strategy> **Stopped-short:** <anything the spec implied but wasn't confirmed> ``` ## Constraints - Read source and target types before writing a single line. - No silent field drops — every unmapped field gets a comment. - Scope boundary is the adapter itself. Infrastructure changes go back to the composer.
© wrg32786 · MIT · wrg32786/aigent-os