Перейти к содержимому

Настройка potato-skill в Codex

Добавьте potato-skill в проект Codex одной командой npx, запускайте навык через $potato-skill и одобряйте команды, которые блокирует песочница по умолчанию.

Codex читает навыки из .agents/skills/ вашего репозитория, а npx skills add davidjurgens/potato-skill --agent codex копирует туда potato-skill. Codex подхватывает навык без перезапуска, а $potato-skill запускает навык в CLI и в расширении для IDE. potato-skill: создайте исследование с разметкой с помощью кодового агента описывает, что навык делает с исследованием, а Установка potato-skill в вашем кодовом агенте рассказывает о других агентах.

Перед установкой

Potato ставится в окружение Python, которое использует оболочка Codex. Вспомогательные скрипты навыка импортируют реестры Potato и вызывают команду potato, а первый шаг навыка проверяет, что Potato импортируется. Дополнение для браузера и Chromium позволяют potato preview --screenshot и скрипту сквозной проверки навыка открывать задачу в браузере без интерфейса:

bash
pip install 'potato-annotation[preview]'
playwright install chromium

У песочницы Codex по умолчанию нет доступа к сети. Установите оба компонента до начала работы, чтобы сэкономить один круг одобрений. skills CLI запускается через npx и требует Node.js 22.20 или новее.

Установка навыка

Выполните установку в своём репозитории:

bash
npx skills add davidjurgens/potato-skill --agent codex

Команда копирует SKILL.md, 30 справочных файлов и девять вспомогательных скриптов в .agents/skills/potato-skill/ и записывает источник в skills-lock.json в корне репозитория. Codex сканирует .agents/skills/ в каждой папке от текущей до корня репозитория, поэтому сессия, начатая в подпапке репозитория, тоже находит навык. Если закоммитить .agents/skills/, коллеги получат навык без установки.

Добавьте -g, чтобы вместо этого установить навык для всех репозиториев на машине:

bash
npx skills add davidjurgens/potato-skill --agent codex -g

Глобальная установка попадает в ~/.agents/skills/potato-skill/, пользовательскую папку навыков, которую читает Codex. Codex замечает новый навык без перезапуска. Если навык не появился, перезапустите Codex.

Проверка установки

В Codex CLI или расширении для IDE /skills перечисляет навыки, которые нашёл Codex, и potato-skill есть в списке. В настольном приложении ChatGPT раздел Skills на боковой панели показывает навыки всех ваших проектов.

Запуск исследования

Упомяните навык через $potato-skill и опишите исследование:

text
$potato-skill I want 200 tweets labeled for sentiment on a 5-point scale by three annotators each, with a consent page and two attention checks. Build it and start it.

Codex загружает навык и без упоминания, когда запрос соответствует описанию навыка, например просьба собрать задачу разметки, изменить config.yaml Potato или проверить идущее исследование.

Песочница и одобрения

Codex выполняет команды в песочнице. Режим по умолчанию, workspace-write, позволяет командам писать внутри рабочей области при отключённом доступе к сети. За сеть отвечает настройка sandbox_workspace_write.network_access, по умолчанию равная false. При политике одобрения on-request Codex работает внутри песочницы и спрашивает разрешения перед командой, которая выходит за её пределы.

При сборке навык заставляет Codex проверить конфигурацию, запустить сервер Potato на вашей машине, открыть задачу в браузере без интерфейса и выполнить вспомогательные скрипты навыка. Для pip install нужна сеть, а в песочнице по умолчанию её нет. Одобряйте команду вне песочницы, когда Codex спрашивает, после того как прочитали команду. В CLI /permissions открывает выбор разрешений. В расширении для IDE и в приложении те же варианты находятся под полем ввода как Ask for approval, Approve for me и Full access. Документация по песочнице Codex описывает каждый режим.

AGENTS.md

Codex читает AGENTS.md по имени файла. В репозитории potato-skill в корне лежит AGENTS.md, короткая сводка правил навыка. Если скопировать этот файл в корень своего репозитория, Codex получит правила без установки. Файл ссылается на справочные файлы и скрипты, которые попадают на диск только при полной установке. Для сборки исследования используйте установку через skills CLI. Если в вашем репозитории уже есть AGENTS.md, добавьте сводку в этот файл, а не заменяйте его.

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

skills CLI обновляет и удаляет навык по имени. Добавьте -g к любой из команд для глобальной установки:

bash
npx skills update potato-skill
npx skills remove potato-skill

update сверяет установленную копию с репозиторием GitHub и заменяет копию, если репозиторий изменился. remove удаляет .agents/skills/potato-skill/ и запись о навыке в skills-lock.json.

Чтобы отключить навык, не удаляя его, добавьте запись в ~/.codex/config.toml с абсолютным путём к SKILL.md навыка и перезапустите Codex. Документация по навыкам Codex перечисляет остальные настройки, которые принимает запись:

toml
[[skills.config]]
path = "/path/to/your/repo/.agents/skills/potato-skill/SKILL.md"
enabled = false

Дополнительные материалы