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

translate · ai-driven-dev — скилл для Claude Code: что делает и как установить

Скилл собирает конвейер перевода канонического исходника в нативный контент для каждого инструмента: трансформы, PluginContentTranslator и стратегии сборки за aidd translate и aidd sync.

MIT ★ 571 обновлён 2026-10-29

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

Что делает translate

Скилл отвечает за слой, который превращает канонический исходник в формате Claude в нативный контент для каждого инструмента. Трансформы, зависящие от целевой платформы, лежат в domain/formats/. PluginContentTranslator в domain/content-translator.ts отдаёт файлы плагина в rewriteContent самого инструмента, а не повторяет эту логику у себя. FrameworkBuildUseCase (это aidd translate) читает ToolBuildContract для пары «инструмент + режим» и выбирает MarketplaceBuildStrategy или FlatBuildStrategy. Ветвлений по инструментам и типам артефактов в них нет. Реестр сборки "<target>:<mode>" собирается в runtime/wiring/translate.ts обходом зарегистрированных инструментов, вручную его никто не ведёт.

Границы тут важны. Трансформ, который нужен ровно одному профилю, живёт в каталоге этого профиля. Общий для двух и более профилей, но одинаковый для всех — в contexts/tools/domain/formats/. В translate/domain/formats/ попадает только тот, который знает, под какую цель пишет.

Импортировать отсюда может лишь контекст framework, и только модули из списка PUBLIC_MODULES.translate. Следит за этим архитектурный тест. Новый инструмент в сборке — это объявленный контракт в tools, а не ещё одна ветка здесь.

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

  • добавить трансформ, который пишет контент по-разному под каждый целевой инструмент
  • поменять PluginContentTranslator, не переписывая логику инструмента
  • завести новую стратегию сборки для aidd translate
  • подключить инструмент в реестр сборки без ручных строк
  • проверить, какие модули другие контексты вправе импортировать из translate

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

  • Добавь target-aware трансформ для Cursor в domain/formats/ и юнит-тест на входе с маркером, который он переписывает.
  • Новый инструмент объявляет ToolBuildContract в tools — подключи его в runtime/wiring/translate.ts.
  • Объясни, почему PluginContentTranslator вызывает rewriteContent инструмента, а не делает перезапись сам.

Как установить translate

1Через Skills CLI (Vercel)

npx skills add ai-driven-dev/framework --skill translate -a claude-code

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

~/.claude/skills/translate/SKILL.md

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

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

Вопросы о translate

Как установить translate в Claude Code?

Выполните npx skills add ai-driven-dev/framework --skill translate -a claude-code. Скилл встанет по пути ~/.claude/skills/translate/SKILL.md.

Что делает translate?

Собирает конвейер перевода канонического исходника в нативный контент под каждый инструмент: target-aware трансформы, транслятор файлов плагина и стратегии сборки за aidd translate и aidd sync.

Чем translate отличается от скиллов tools, distribution и framework?

Профиль инструмента, классы возможностей и контракт сборки — это tools. Откуда берётся контент — distribution. Оркестрация манифестов и установки — framework. Здесь только то, что зависит от целевой платформы.

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

SKILL.md · MIT
---
name: translate
description: >
  Builds the canonical-source-to-target-native translation pipeline under src/contexts/translate/
  — target-aware content transforms, the plugin content translator, and the build strategies
  behind `aidd translate` and `aidd sync`. Use when adding a target-aware transform, changing
  `PluginContentTranslator`, adding a build strategy, or wiring a new tool into the build
  registry. Do NOT use for a tool's own profile, capability classes, or build contract — use
  `tools`. Do NOT use for where content is fetched from — use `distribution`. Do NOT use for
  manifest/install orchestration — use `framework`.
---

# Translate

`translate` is the core: it turns the canonical, Claude-format framework source into
target-native content for every tool at once. It reaches two places and no others: `tools`, its
one outbound context edge, and `kernel`. Everything it reaches in `tools` is that context's
declared public surface (`contracts.ts`, `registry.ts`, `build-contract.ts`, and the handful of
capability and port modules listed as public), never an internal file. The whole graph is in
`.claude/rules/00-architecture/0-contexts.md`.

## What goes in

| Concept | Location |
|---|---|
| A transform whose behavior differs by target tool | `domain/formats/` |
| The plugin-files-to-installed-files translator | `domain/content-translator.ts` (`PluginContentTranslator`) |
| The canonical framework-doc shape | `domain/canon.ts` |
| The canonical single-plugin shape | `domain/plugin-distribution.ts` |
| Build targets and modes | `domain/build-target.ts` |
| The `aidd translate` use-case | `application/translate-source.ts` (`FrameworkBuildUseCase`) |
| A build orchestrator (one per mode, never per tool) | `application/strategies/` |
| Schema validation for marketplace/plugin manifests | `infrastructure/schema-validator.ts` |

A transform used by exactly one tool profile does not belong here — it lives in that profile's
own directory. A transform shared by ≥2 profiles but identical regardless of target lives in
`contexts/tools/domain/formats/` instead. What belongs in `translate/domain/formats/` is a
transform that is *aware* of which target it is producing for.

## How

- `PluginContentTranslator` takes one plugin's canonical files and one tool's `AiTool<C>`, and
  calls the tool's own `rewriteContent` — it does not reimplement a
  tool's rewrite logic, it invokes what `tools` declared. That function is one-way and has no
  inverse; the `tools` skill's `references/content-rewrite.md` says why, and names the trap an
  identity rewrite sets.
- `FrameworkBuildUseCase` (`aidd translate`) reads a `ToolBuildContract` per target and mode from
  `tools`, and dispatches to `MarketplaceBuildStrategy` or `FlatBuildStrategy` — both implement
  `BuildOutputStrategy` and iterate the six artifact kinds generically, with zero per-tool or
  per-kind branching. Adding a build target means the target tool declares a contract in `tools`;
  it never means adding a case here. See the `tools` skill's `references/build-contract.md`.
- `runtime/wiring/translate.ts` derives the `"<target>:<mode>"` build registry by iterating every
  registered tool and reading its contract — there is no hand-maintained per-tool row.
- Follow the use-case and orchestration rules in `.claude/rules/00-architecture/` for the
  application layer's shape, and the shared-module rule there before promoting a helper used by
  only one strategy into `shared-plugin-helpers.ts`.

## Public surface

Nothing outside `contexts/translate/` may import a module this context has not declared public —
`tests/architecture/context-boundary.arch.test.ts` holds the list (`PUBLIC_MODULES.translate`).
`framework` is the only context that imports from here (`framework → translate`); a module used
by `framework` must be on that list.

## How it's tested

- `tests/contexts/translate/` mirrors `src/contexts/translate/` — formats, content-translator,
  canon, and the two build strategies each have unit or integration coverage.
- `tests/golden/framework-build-golden.e2e.test.ts` snapshots a full build across every target —
  see `test` skill's golden/machine-independence rules before touching a snapshot.
- A new target-aware transform gets a unit test over a representative input carrying the marker it
  is meant to rewrite. A transform that is the identity for the fixture it was given is
  indistinguishable from one that never ran.

© ai-driven-dev · MIT · ai-driven-dev/framework

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — translate от других авторов.

translate feiskyer Скилл translate для Claude Code переводит технические статьи и тексты с английского или японского на китайский, сохраняя форматирование и техническую точность. Переводит иностранные материалы на китайский. CX Codex +1 294установок translate vide Скилл translate для Claude Code добавляет новую строку интерфейса во все шесть файлов локализации Android-приложения. Обновляет локализацию при появлении нового пользовательского текста. CX Codex +1 1установок monorepo-setup patricio0312rev Скилл monorepo-setup разворачивает каркас монорепозитория на Turborepo и pnpm: приложения, общие пакеты, конфиги TypeScript и ESLint, пайплайн сборки. CX Codex +1 283установок hyperflow Mohammed Abdelhady Плагин hyperflow для Claude Code выстраивает из одной сессии конвейер: спецификация, задачи, параллельные воркеры с ревью и память проекта между сессиями. ★ 1 013звёзд репо unity-build-pipeline gamedev-skills Скилл unity-build-pipeline для Claude Code настраивает и автоматизирует сборку проектов в Unity 6.3 LTS через профили и скрипты. Запускается при автоматизации билдов или ошибках рефлексии в собранной игре. CX Codex +1 11 100установок game-ci-cd-pipeline akillness Скилл game-ci-cd-pipeline разбирает автоматизацию сборки и релиза в Unity или Unreal: сначала называет уровень сигнала, потом берёт один узкий пакет работ. CX Codex +1 297установок baoyu-translate JimLiu Скилл baoyu-translate переводит статьи, документы и тексты в трёх режимах качества с пользовательскими глоссариями. Срабатывает на команды перевода или при передаче URL либо файла с намерением перевести. CX Codex +1 26 300установок translate-book deusyu Скилл translate-book переводит книги из PDF, DOCX, EPUB или Markdown через параллельные субагенты и собирает результат в HTML, DOCX, EPUB или PDF. CX Codex +1 2 100установок

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

Весь набор →
01-bootstrap Скилл 01-bootstrap помогает спроектировать архитектуру нового SaaS и записывает решения в aidd_docs/INSTALL.md. Запускайте его в начале проекта, когда выбираете стек и архитектурный подход. CX Codex +1 ★ 571звёзд репо checker Субагент checker, который судит готовую работу по чеклисту, запускает валидацию и проверяет, служит ли код реальной потребности. Не правит код, только выносит вердикт с доказательствами. CX Codex +1 ★ 571звёзд репо 04-fact-check Скилл 04-fact-check проверяет фактические утверждения в тексте по источникам и переписывает его со сносками, помечая непроверенное. Скилл не оценивает программный код. CX Codex +1 ★ 571звёзд репо distribution Скилл distribution для Claude Code, Cursor и других редакторов, который отвечает за то, откуда приходит контент плагинов и маркетплейсов и как его загружать. CX Codex +1 ★ 571звёзд репо tools Скилл tools помогает описывать профили сред разработки и ИИ-ассистентов в кодовой базе фреймворка, их контракты сборки и поддерживаемые возможности. CX Codex +1 ★ 571звёзд репо framework Скилл framework для Claude Code, Cursor и других платформ, который отслеживает все установленные файлы проекта и управляет их жизненным циклом. Координирует установку, восстановление, диагностику и удаление через единый манифест. CX Codex +1 ★ 571звёзд репо 00-async-dev Скилл 00-async-dev для Claude Code проводит задачу по async-конвейеру: от настройки репозитория до запуска готовой задачи и разбора замечаний в PR. CX Codex +1 ★ 571звёзд репо aidd-qa Плагин aidd-qa проверяет критерии приёмки веб-приложения в браузере и записывает короткие видео для ревьюера. Пригодится перед сдачей готовой задачи. CX Codex +1 ★ 571звёзд репо

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

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