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

ship-adapter — скилл для Claude Code: адаптеры и установка

Скилл ship-adapter для Claude Code переносит схемы и контракты API в адаптеры. Запускается при создании адаптера базы данных, API-клиента или преобразователя данных.

MIT ★ 26 обновлён 2026-11-16

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

Что делает ship-adapter

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

Пустые и необязательные поля обрабатываются явно, а для неочевидного сопоставления полей добавляется комментарий. Результат включает журнал изменений: какие файлы затронуты, что осталось без изменений, где возникли сомнения и какие решения приняты. Скилл ограничивает работу самим адаптером; изменения инфраструктуры передаются вызывающему агенту.

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

  • перенести данные между двумя схемами
  • обернуть API в клиентский интерфейс
  • сопоставить поля базы данных с типом ответа
  • учесть пустые и необязательные поля при преобразовании

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

  • Создай адаптер между схемой UserRecord и типом ответа UserProfile.
  • Обёрни этот API в клиентский адаптер и учти существующие шаблоны проекта.
  • Преобразуй эту схему в целевой интерфейс, не теряя поля.

Как установить ship-adapter

1Через Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill ship-adapter -a claude-code

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

~/.claude/skills/ship-adapter/SKILL.md

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

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

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

Все скиллы по теме «Бэкенд и API» →
prisma-driver-adapter-implementation prisma Скилл prisma-driver-adapter-implementation для Claude Code описывает реализацию SQL-адаптеров Prisma ORM 7. Включается при работе с транзакциями, savepoint-ами, маппингом значений и ошибками БД. CX Codex +1 425 600установок opencli-adapter-author jackwener Скилл opencli-adapter-author для Claude Code помогает создавать и улучшать JS-адаптеры OpenCLI по поведению сайта и данным браузера. Он включается, когда нужно добавить команду для сайта или доработать существующую. CX Codex +1 16 600установок migration JuliusBrussee Скилл migration задаёт правила безопасных миграций схем, данных и API с обязательным откатом. Пригодится при изменениях, где нельзя терять данные или ломать совместимость. CX Codex +1 127 700установок create-adapter harbor-framework Скилл create-adapter для Claude Code, Codex, Cursor и других агентов. Создаёт каркас бенчмарк-адаптера Harbor через harbor adapter init и передаёт работу руководству контрибьютора. CX Codex +1 113установок skill-adapter Jeremy Longshore Скилл skill-adapter для Claude Code находит установленные плагины репозитория, извлекает их сценарии и адаптирует к текущей задаче. Объединяет подходы разных инструментов в одном запросе. CX Codex +1 7установок nemo-fabric-build-adapter NVIDIA Скилл nemo-fabric-build-adapter помогает разрабатывать и проверять адаптеры NVIDIA NeMo Fabric по контракту платформы: от дескрипторов и маппинга конфигураций до реализации жизненного цикла и проверки спецификации. CX Codex +1 ★ 4 106звёзд репо

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

Весь набор →
solution-hunt Скилл solution-hunt для Claude Code ищет законные обходные пути, когда задача упирается в блокер. Он изучает локальные заметки и навыки, а затем ищет решения в GitHub и документации. CX Codex +1 ★ 26звёзд репо skill-recall Подбирает локальные навыки под текущую задачу. Команда /skill-recall также отмечает задачи, для которых совпадений не нашлось. CX Codex +1 ★ 26звёзд репо skill-hunt Скилл skill-hunt для Claude Code ищет навыки, которые закрывают пробел в возможностях агента. Он ранжирует кандидатов, проверяет выбранный скилл и устанавливает его в карантин. CX Codex +1 ★ 26звёзд репо Skill Audit Скилл Skill Audit для Claude Code проверяет, какие навыки вызываются и совпадают ли их описания с запросами. Он также ищет неиспользуемые навыки и повторяющиеся задачи без подходящего навыка. CX Codex +1 ★ 26звёзд репо setup Настраивает identity, приоритеты и границы полномочий aigent-OS. Запускается командой /setup для первичной или повторной настройки отдельных разделов. CX Codex +1 ★ 26звёзд репо semantic-search Скилл semantic-search для Claude Code ищет заметки в хранилище Obsidian по смыслу с помощью локальных эмбеддингов. Запускается для поиска похожих записей и воспоминаний о написанном. CX Codex +1 ★ 26звёзд репо Self-Review Скилл Self-Review для Claude Code запускает отдельную проверку кода перед завершением работы. Он включается для крупных или межфайловых изменений, горячих участков кода и при сомнениях в результате. CX Codex +1 ★ 26звёзд репо scout-vault Скилл scout-vault для Claude Code ищет связанные заметки, ссылки и определения кода. Запускается для инвентаризации хранилища или обхода цепочек вызовов. CX Codex +1 ★ 26звёзд репо

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

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