Установка навыка для агента

Начиная с версии 0.2.6, пакет codex-ai содержит необязательный автономный справочник для агентов, которые используют библиотеку в другом проекте. Установка Python-пакета не меняет файлы проекта. Чтобы явно добавить навык, выполните:

python -m codex_ai.agent_skills install --project /path/to/project
python -m codex_ai.agent_skills status --project /path/to/project

В Windows PowerShell путь с пробелами нужно заключить в кавычки, например --project "D:\My Projects\game". Используйте среду Python, в которой установлен codex-ai. Установщик работает без сети и не требует дополнений [gemini] или [openai]; нужное дополнение следует установить отдельно перед использованием соответствующего провайдера.

Установщик создаёт .agents/skills/codex-ai/ в целевом проекте и добавляет один помеченный блок в AGENTS.md. Версия пакета и SHA-256-хеши управляемых файлов записываются в .agents/skills/codex-ai/.manifest.json. Остальные инструкции и файлы сохраняются. Установленные навык и манифест находятся под управлением установщика; правила конкретного приложения размещайте в отдельном навыке проекта.

Обновление и удаление

После обновления Python-пакета проверьте и обновите установленный справочник:

python -m codex_ai.agent_skills status --project /path/to/project
python -m codex_ai.agent_skills update --project /path/to/project

status сообщает, соответствует ли установленный навык текущему пакету, и возвращает ненулевой код, если навык отсутствует, устарел или повреждён. Для update требуется уже установленный управляемый навык. Само обновление Python-пакета не обновляет скопированные файлы навыка.

Чтобы удалить справочник и его помеченный блок в AGENTS.md, выполните:

python -m codex_ai.agent_skills delete --project /path/to/project

Команды update и delete отказываются менять управляемые файлы, если они были изменены или удалены вручную. Установщик также отклоняет повреждённый манифест, изменённый блок инструкций, небезопасные ссылки и конфликты с посторонними файлами. Перед повторной попыткой сохраните или восстановите локальные правки; не подменяйте манифест. Посторонние файлы рядом с навыком остаются на месте. При обычных ошибках файловых операций выполняется откат; если откат не удался, резервные копии сохраняются для восстановления.