Перейти к содержанию

Поддерживаемые харнессы

Харнесс — CLI-среда, в которой работает coding agent. ai_stp не заменяет харнесс и не вызывает модели: он помогает собрать проверяемый сетап для конкретного target, а применяет итоговое состояние только provider этого харнесса.

Статусы MVP

Харнесс Статус в MVP Что доступно Что помнить
Claude Code beta паспорта, совместимость, сборка сетапа, provider-план входит в открытую бету вместе с остальными шестью
Codex beta паспорта, совместимость, сборка сетапа, provider-план входит в открытую бету вместе с остальными шестью
Grok Build beta паспорта, совместимость, сборка сетапа, provider-план входит в открытую бету вместе с остальными шестью
Pi beta паспорта, совместимость, сборка сетапа, provider-план входит в открытую бету вместе с остальными шестью
OpenCode beta паспорта, совместимость, сборка сетапа, provider-план входит в открытую бету вместе с остальными шестью
Cursor beta паспорта, совместимость, сборка сетапа, provider-план plugin pack распознаётся по манифесту .cursor-plugin
Antigravity beta паспорта, совместимость, сборка сетапа, provider-план конфигурация лежит внутри ~/.gemini, а не в собственном каталоге
undefined ограниченный режим чтение, импорт, локальные проверки автоматическая установка не считается безопасной

Что означает “поддерживается”

Поддержка в ai_stp состоит из нескольких уровней. Харнесс может проходить один уровень и ещё не быть готовым к следующему.

Уровень Что проверяется Зачем пользователю
Detection CLI понимает, что за target перед ним чтобы не применить сетап не туда
Compatibility компоненты объявляют поддержку харнесса чтобы отсеять очевидно неподходящее
Projection сетап можно превратить в нативную структуру чтобы файлы и настройки попали в правильный формат
Provider plan provider строит план изменения target чтобы увидеть diff до применения
Apply provider применяет изменения и пишет журнал чтобы был rollback и проверяемый результат

Claude Code, Codex, Grok Build, Pi, OpenCode, Cursor и Antigravity выпускаются вместе. Найти сетап, проверить совместимость, увидеть план и применить через provider. Отсутствующее доказательство помечается not_verified; харнесс из продукта не вычёркивается.

Этот режим нужен, чтобы не терять объект, когда харнесс неизвестен. Он подходит для чтения, импорта и локального анализа, но не для уверенной автоматической установки.

Почему сетап принадлежит одному харнессу

Потому что одинаковые слова в разных CLI часто означают разные файлы, права и события. skill для Codex и skill для Claude Code могут иметь похожий смысл, но разные нативные поверхности. Поэтому сетап создаётся для одного харнесса, а перенос делается через явную новую версию или адаптацию.

Что оказывается на диске у семи харнессов

ai_stp не копирует файлы в target. Сборщик строит нативный пакет; provider его записывает. Точные пути на машине даёт ai-stp component discover --json (source_path, layout_source) и план provider. Виды, которые discovery будет искать:

Вид Claude Code Codex Grok Build
instruction global и project global и project нативный layout инструкции не объявлен
skill global и project общий skill (включая .agents/skills) global и project
mcp global и project имена внутри файла настроек (config.toml), если есть ключ mcp_servers имена внутри config.toml, если ключ есть
hook в матрице discovery нет top-level layout project: .codex/hooks.json или hooks/hooks.json внутри доказанного plugin global и project
command global и project global command/prompt общий command, global
agent global и project project: .codex/agents нативный layout агента не объявлен
plugin global и project; pack — plugin только через .claude-plugin/plugin.json корень plugin, skill и hooks-directory; pack через .codex-plugin/plugin.json global и project; plugins/marketplaces — не plugin
setting global и project global и project (config.toml) global и project (config.toml)

Каталог plugins/ без манифеста поддерживаемого харнесса не является plugin. CODEX.md — не официальный layout инструкции Codex; discovery возвращает unsupported_manifest и указывает на AGENTS.md.

Общие .agents/skills не принадлежат ни одному харнессу и возвращаются с harness_id=null.

После apply подтвердите:

ai-stp target status --project <id> --harness <id> --json
ai-stp target diff --project <id> --harness <id> --json

Официальная документация харнессов

Это документация вендоров, а не страницы ai_stp. Layouts, с которыми ai_stp будет работать, — только те, что component discover вернул с layout_source.

Харнесс Официальная документация
Claude Code документация Claude Code
Codex документация ChatGPT / Codex (нативный файл инструкции: AGENTS.md)
Grok Build документация xAI Build
Pi документация Pi
OpenCode документация OpenCode
Cursor документация Cursor
Antigravity документация Antigravity

Если классификация неясна, покажите поле layout_source из component discover. Не выдумывайте путь только потому, что соседний харнесс так устроен.

Как выбрать target

  1. Запустите ai-stp doctor --json.
  2. Проверьте, какой харнесс обнаружен: ai-stp toolchain harnesses --json.
  3. Откройте сетап или компонент в каталоге.
  4. Сверьте поддержку харнесса и линию доверия.
  5. Смотрите provider-план до применения.
ai-stp doctor --json
ai-stp toolchain harnesses --json
ai-stp toolchain harness-capabilities --json

Для MVP

Если вы не уверены, начинайте с Claude Code, Codex или Grok Build. Для beta-линий сохраняйте план установки и не удаляйте backup до проверки результата.

Связанные страницы