tools · ai-driven-dev — скилл для Claude Code: что делает и как установить
Скилл tools помогает описывать профили сред разработки и ИИ-ассистентов в кодовой базе фреймворка, их контракты сборки и поддерживаемые возможности.
MIT ★ 571 обновлён 2026-10-29
npx skills add ai-driven-dev/framework --skill tools -a claude-codeЧто делает tools
Скилл управляет каталогом целевых платформ в директории src/contexts/tools/. Каждая среда или ассистент описывается объектом AiTool<C> или IdeToolConfig в файле profiles/<tool>/profile.ts, где C задаёт пересечение интерфейсов возможностей Has*. Здесь же определяются правила трансформации текста rewriteContent и контракт сборки aidd translate.
Модуль строго изолирован: внешние части репозитория не могут импортировать файлы из contexts/tools/, пока они не внесены в список PUBLIC_MODULES в архитектурном тесте. Файлы-бочки index.ts запрещены стандартами проекта, поэтому любой публичный экспорт регистрируется напрямую. Вынос вспомогательной логики за пределы каталога профиля отслеживается отдельным тестом на стоимость добавления инструментов.
Для самой сборки и пайплайна трансляции скилл не предназначен: эту задачу берёт на себя translate. Также он не отвечает за оркестрацию установки плагинов и каталоги дистрибуции.
Какие задачи решает
- Добавить профиль нового ИИ-ассистента или IDE в директорию
profiles/<tool>/ - Настроить контракт сборки
aidd translateчерезToolBuildContract - Расширить список поддерживаемых возможностей
Has*вcontracts.ts - Задать правила преобразования контента в
rewriteContent
Примеры запросов агенту
- Создай профиль нового ИИ-ассистента в
src/contexts/tools/с контрактом сборки - Добавь новую возможность
HasCommandsвdomain/contracts.tsи настрой валидацию параметров - Опиши функцию
rewriteContentдля адаптера новой среды разработки
Как установить tools
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill tools -a claude-code2Вручную: положить файлы
~/.claude/skills/tools/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tools/
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill tools -a codex2Вручную: положить файлы
.agents/skills/tools/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill tools -a cursor2Вручную: положить файлы
.cursor/skills/tools/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework cli/.claude/skills/tools2Вручную: положить файлы
.github/skills/tools/SKILL.md1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill tools -a gemini-cli2Командой платформы
gemini skills install https://github.com/ai-driven-dev/framework --path cli/.claude/skills/toolsВручную: положить файлы
.devin/skills/tools/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill tools -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tools
Как установить tools в Claude Code?
Выполните команду npx skills add ai-driven-dev/framework --skill tools -a claude-code. Конфигурация сохранится по пути ~/.claude/skills/tools/SKILL.md.
Зачем нужен скилл tools?
Он формализует конфигурацию целевых редакторов и ИИ-помощников в репозитории фреймворка. Скилл помогает внедрять профили инструментов, их контракты сборки и классы возможностей.
Для чего этот скилл использовать нельзя?
Он не занимается запуском пайплайна трансляции в нативные форматы, оркестрацией установки плагинов или получением контента из каталогов. Для этих задач служат контексты translate, framework и distribution.
Исходный текст
SKILL.md · MIT
--- name: tools description: > Defines or modifies what the project targets, under src/contexts/tools/ — an AI/IDE tool profile, its build contract, the content-translation capability classes it composes (agents/skills/commands/rules/hooks), and its own native-plugin adapter. Use when adding a new AI or IDE tool, changing a tool's Has* capability intersection, adding or modifying a capability class, or declaring a tool's `aidd translate` build contract. Do NOT use for the canonical-to-native translation pipeline itself — use `translate`. Do NOT use for where plugin content comes from — use `distribution`. Do NOT use for manifest or install orchestration — use `framework`. --- # Tools `tools` is what the project targets and how each target is configured. Every AI assistant and IDE the CLI supports is one `AiTool<C>` or `IdeToolConfig` object in `contexts/tools/domain/profiles/<tool>/profile.ts`, where `C` is the intersection of `Has*` capability interfaces the tool actually supports. `translate` depends on `tools` (never the reverse) to call the tool's own `rewriteContent` and to read its build contract — a tool profile is data and behavior the rest of the CLI is handed, not a place that reaches out to fetch or install anything itself. ## What goes in | Concept | Location | |---|---| | A tool's identity, capabilities, content-rewrite | `domain/profiles/<tool>/profile.ts` | | A tool's `aidd translate` build behavior | `domain/profiles/<tool>/build.ts` (only if the tool is a build target) | | A string transform used by exactly one profile | that profile's own directory | | A string transform shared by ≥2 profiles | `domain/formats/` | | A content-translation capability class (agents/skills/commands/rules/hooks) | `domain/capabilities/` + a `Has*` entry in `contracts.ts` | | Catalog/manifest shaping shared by ≥2 tools' build contracts | `domain/marketplace-catalog.ts` | | A port only `tools` needs | `domain/ports/` | | A tool's own plugin-CLI driver | `infrastructure/` | ## How - `AiTool<C>` fields: read `domain/contracts.ts`. A list copied here aged at every field. - `Has*` interfaces live in `contracts.ts`, always `readonly`, never optional — a tool either includes `Has<Name>` in its `C` intersection or does not have the field at all. Guard presence with `"name" in tool.capabilities`, never `instanceof`. - `rewriteContent(content)` is one way, per tool, with no reverse and no shared base helper. See `references/content-rewrite.md`. - A capability class ends in `Capability`, takes one params object, all fields `readonly`, throws `CapabilityConfigError` (from `kernel/errors.ts`) on an invalid combination, carries no application/infrastructure imports. See `references/capability-conventions.md`. - `PluginsCapability` has three modes (`native`, `flat`, `unsupported`) and a `translationMode` (`marketplace` | `flat` | `null`) — see `references/plugins-capability.md`. - Build behavior is ONE artifact-symmetric `ToolBuildContract` per tool, read by the two mode-generic orchestrators (`MarketplaceBuildStrategy`, `FlatBuildStrategy`) in `translate` — never a per-tool strategy class, never a per-tool or per-artifact-kind branch in an orchestrator. See `references/build-contract.md`. - `registerTool(config)` is called once, at the bottom of `profile.ts`, never from a use-case. - Follow the port/adapter rule in `.claude/rules/00-architecture/` for the shape of a port and its adapter, and the shared-module rule there before promoting a helper out of a single profile. ## Public surface Nothing outside `contexts/tools/` may import a module this context has not declared public — `tests/architecture/context-boundary.arch.test.ts` holds the list (`PUBLIC_MODULES.tools`). A new module is invisible to `translate` and `framework` until it is added there; there is no `index.ts` and there never will be (barrels are forbidden by the export rule in `.claude/rules/01-standards/`). ## How it's tested - `tests/contexts/tools/` mirrors `src/contexts/tools/` — one profile's `profile.ts`/`build.ts` gets a unit test asserting the `AiTool<C>` type is satisfied and each rewrite rule holds. - `tests/architecture/tool-addition-cost.arch.test.ts` ratchets how many files outside a new tool's own directory must change to add it — keep new tool-specific logic inside the profile. - See the `test` skill for tier conventions; capability/format round-trip tests are unit-tier.
© ai-driven-dev · MIT · ai-driven-dev/framework
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — tools от других авторов.