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

Этот гайд теперь покрывает узкий legacy-compatible путь для Codex runtime на Go:

• target: codex-runtime
• язык: go
• readiness gate: validate --strict

Если вы ещё выбираете путь для нового repo, сначала откройте Что именно вы собираете или Соберите собственную логику плагина.

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
go mod tidy

Этот путь сохраняется ради backward compatibility, но уже не является рекомендуемым первым стартом для новых repo.

Один раз запустите go mod tidy после scaffold, чтобы starter записал go.sum до первой строгой валидации.

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

plugin-kit-ai generate .

Не редактируйте сгенерированные target-файлы вручную как главный источник истины. Держите исходное состояние проекта внутри обычного plugin-kit-ai workflow.

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

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

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

Что у вас теперь есть

• один plugin repo
• authored files под plugin/ для новых репозиториев
• generated output для Codex runtime
• понятная проверка готовности через validate --strict

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

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

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

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

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

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