Соберите первый плагин

Этот гайд использует самый сильный путь по умолчанию и специально держит сценарий узким:

• target: codex-runtime
• runtime: go
• readiness gate: validate --strict

Узость этого tutorial нужна только для первого запуска. Если вам сразу важна более широкая multi-target модель, после него идите в Один проект, несколько target’ов.

1. Установите CLI

brew install 777genius/homebrew-plugin-kit-ai/plugin-kit-ai
plugin-kit-ai version

2. Создайте проект

plugin-kit-ai init my-plugin
cd my-plugin

Путь init по умолчанию уже является рекомендуемой стартовой точкой для продакшена.

3. Сгенерируйте target-файлы

plugin-kit-ai generate .

Не редактируйте сгенерированные target-файлы вручную как главный источник истины. Держите исходное состояние проекта в package-standard layout.

4. Прогоните проверку готовности

plugin-kit-ai validate . --platform codex-runtime --strict

Используйте это как главную проверку готовности для локального проекта.

5. Когда менять путь

Переходите на другой путь только когда это действительно нужно:

• выбирайте claude для плагинов Claude
• выбирайте --runtime node --typescript для основного стабильного пути без Go
• выбирайте --runtime python, когда проект остаётся локальным для репозитория, а команда осознанно Python-first
• выбирайте codex-package, gemini, opencode или cursor, только если ваша модель поставки действительно требует эти target’ы

Это не означает, что репозиторий должен навсегда остаться single-target: начинайте с самого важного target'а сегодня и добавляйте остальные только по реальной необходимости.

Следующие шаги

• Прочитайте Выбор runtime, прежде чем уходить с пути по умолчанию.
• Прочитайте Один проект, несколько target’ов, если для вас важен multi-target путь как основная идея продукта.
• Используйте Стартовые шаблоны, когда нужен проверенный пример репозитория.
• Откройте Справочник CLI, когда нужно точное поведение команд.