Build Custom Plugin Logic

Выбирайте этот путь, когда плагин не просто подключает существующий сервис или локальный инструмент.

Это advanced path для repo, в которых ценность живёт в:

• runtime code, которым владеете вы
• hooks и orchestration logic
• policy, transformation или guardrail behavior
• custom behavior, которого не было бы без вашего кода

Если вы подключаете hosted service вроде Notion или Stripe, откройте Что именно вы собираете и начните с online-service. Если вы подключаете local tool вроде Docker Hub или HubSpot Developer, начните с local-tool.

Стартуйте отсюда

plugin-kit-ai init my-plugin --template custom-logic
cd my-plugin
plugin-kit-ai inspect . --authoring
plugin-kit-ai validate . --platform codex-runtime --strict
plugin-kit-ai test . --platform codex-runtime --event Notify

Что вы редактируете

Authored source of truth по-прежнему живёт под src/.

Обычно важны такие файлы:

• src/plugin.yaml
• src/launcher.yaml
• src/targets/...
• ваш runtime entrypoint вроде cmd/<name>/main.go или src/main.*

Используйте plugin-kit-ai inspect . --authoring, когда нужно точно увидеть границу между editable source, managed guidance files и generated target outputs.

Что генерируется

plugin-kit-ai generate по-прежнему владеет generated output files в корне repo.

Обычно это включает:

• root guidance files вроде README.md, CLAUDE.md, AGENTS.md и GENERATED.md
• native output для target'а, который вы ship'ите, например .codex/config.toml, hooks/hooks.json или gemini-extension.json

Редактируйте source под src/. Root outputs воспринимайте как managed outputs.

Почему этот путь более advanced

По сравнению с online-service и local-tool этот путь даёт:

• больше контроля над поведением
• больше ответственности за runtime contract
• больше пространства для tests, hooks и policy logic

Именно поэтому он остаётся на первом экране, но помечается как advanced path.

Первый запуск по runtime shape

Go runtime

go test ./...
plugin-kit-ai validate . --platform codex-runtime --strict
plugin-kit-ai test . --platform codex-runtime --event Notify

Node или Python runtime

plugin-kit-ai doctor .
plugin-kit-ai bootstrap .
plugin-kit-ai validate . --platform codex-runtime --strict
plugin-kit-ai test . --platform codex-runtime --event Notify

Куда идти глубже

• Откройте Быстрый старт, если хотите сравнить этот путь с более простыми job-first starter'ами.
• Откройте Создайте первый plugin, если вам нужен узкий legacy-compatible tutorial для Codex runtime.
• Откройте Выбор target, когда понадобятся конкретные решения по способу поставки.
• Откройте Один проект, несколько target'ов, когда repo будет готов расти в несколько outputs.