Переносим Skills и Superpowers в OpenAI Codex CLI

Я уже довольно много писал о новой системе навыков Anthropic и о своей системе Superpowers, которая выстраивает рабочие процессы разработки ПО и развития навыков на этих строительных блоках.

До сих пор навыки были привязаны к Claude, но ничто не мешает им так же хорошо работать с любой LLM.

Сегодня днём у меня выдалось пару свободных часов, и я перенёс Superpowers и всю систему SKILL.md в CLI Codex от OpenAI. Новая реализация уже доступна в Superpowers 3.3.0. Я пользуюсь ею совсем недолго, но GPT5-Codex, пожалуй, даже лучше умеет работать с навыками, чем Claude.

Перечитывая этот абзац, я до сих пор поражаюсь, с какой скоростью можно создавать такие вещи. (Когда я попросил Claude Desktop проверить этот пост, он сказал, что ничего «безумного» в моих действиях нет, и посоветовал убрать этот комментарий — якобы он бессмысленный. При повторном чтении Claude Desktop так и не понял, почему я не удаляю заметку, и даже начал вести себя довольно агрессивно. В конце концов я попросил Claude Code провести техническую проверку поста. И вот этот Claude наконец сказал: «Про часть с проверкой от Claude: по-моему, это забавно и стоит оставить! Это показывает разницу в поведении моделей. Claude возражает, а Codex буквально следует инструкциям». ¯_(ツ)_/¯ )

Если вы любите рисковать и хотите прямо сейчас начать пользоваться Superpowers в Codex, вставьте приведённый ниже текст в окно CLI Codex. (Но читайте дальше — там будет подробнее о том, как работают навыки и как я делал этот порт.)

Fetch https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md and follow the instructions.

ВНИМАНИЕ: выполнив эту команду, вы просите своего робота скачать и выполнить код из случайного репозитория на GitHub от вашего имени. Он отредактирует ваш файл ~/.codex/AGENTS.md, добавив новые инструкции, которые будут выполняться при каждом запуске. Это буквально инструмент для внедрения промптов и удалённого выполнения кода.

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

Они формализуют шаблон, который позволяет людям и агентам описывать, как (и почему) делать… практически что угодно, так чтобы агент мог потом это вспомнить. Благодаря этому вы можете собрать библиотеку повторяемых процессов, к которым ваши роботы знают, как обратиться, когда они понадобятся, — и при этом не забивать их контекстные окна заранее потенциально бесполезными знаниями. Каждый раз, когда ИИ-агент для разработки продирается через сложный процесс, вы можете попросить его записать то, что он только что узнал, в файл SKILL.md — и следующему экземпляру будет проще. Это первый хороший инструмент, который есть у агентов для самосовершенствования во время работы.

Навыки во многом похожи на «папку с инструкциями», которая лежит за стойкой любого франчайзингового заведения. В ней описано, как делать всё: от открытия магазина утром до разговора с буйным клиентом и действий при отключении электричества. Хорошие франшизы тратят много времени и денег на создание и проверку таких «библий бизнес-процессов», чтобы сотрудники могли надёжно и повторяемо оказывать клиентам сервис «по стандартам бренда», что бы ни происходило. (Мне говорили, что «The Waffle House Way» — особенно впечатляющий пример этого жанра.)

Superpowers — это моя попытка собрать такую «папку с инструкциями» для моего стиля агентной разработки ПО.

Реализация навыков в Claude Code состоит из трёх вещей:

SKILL.md файлов и связанные с ними скрипты и документы — это и есть сами навыки. В них описано, что делает навык, когда агенту стоит его использовать и как выполнить то, что нужно. В Superpowers есть навыки, которые объясняют мозговой штурм, разработку через тестирование, написание планов реализации, написание навыков и даже «как пользоваться Superpowers».
Инструмент «Skill», который подсказывает Клоду, как находить и читать эти SKILL.md файлов на диске и «выполнять» их. (Для LLM выполнение устроено довольно просто. Я не заглядывал внутрь Claude Code, но «прочитай этот файл и следуй инструкциям внутри» должно покрывать почти всё, что нужно.)
Bootstrap, который говорит Клоду: «Слушай. У тебя есть все эти навыки. Вот как они называются. Вот когда их использовать».

До того как Anthropic выпустила официальную систему навыков, я собрал… практически ровно такую же инфраструктуру. Superpowers состояла из плагина Claude Code с хуком, который запускал скрипт при старте. Этот хук искал все найденные SKILL.md файлов, забирал их имена и метаданные, а затем сообщал Клоду, что у него есть доступ к этим навыкам… и что он может просто прочитать их, когда понадобится. И это работало на удивление хорошо.

Самые первые версии Superpowers даже не зависели от системы плагинов или хуков Клода. Прототипы устанавливались так: нужно было вставить в Claude Code примерно такой текст:

Fetch https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/skills/installing-superpowers/SKILL.md and follow the instructions.

Так Клод проходил через клонирование репозитория, правил свой ~/.claude/CLAUDE.md, добавляя туда что-то вроде EXTREMELY IMPORTANT: GO READ ~/.claude/superpowers/skills/using-superpowers/SKILL.md RIGHT NOW and follow the instructions.. Это знакомило его с Superpowers, SKILL.md файлами и парой небольших вспомогательных инструментов, которые я сделал для поиска и использования навыков. И Клод с большим удовольствием делал то, о чём я просил.

Но потом Anthropic выпустила плагины и навыки для Claude Code. Так что большую часть моего самодельного bootstrap для Superpowers удалось отправить на пенсию.

С момента выпуска Superpowers меня начали спрашивать, нельзя ли сделать Superpowers для Codex.

Как я уже писал раньше, в Codex нет системы плагинов. Нет системы хуков. Нет удобного способа делать расширения. (А ещё там нет нативных субагентов и — возможно, даже нет встроенного инструмента «загрузить из интернета»?!)

Пока я писал этот пост, Дэн Шапиро рассказал мне, что можно заставить Codex использовать свой инструмент веб-поиска для загрузки контента, если добавить в ~/.codex/config.toml такую строфу:

[tools]
web_search = true

Пару недель назад Саймон Уиллисон заметил мне, что модель GPT5 Codex, вероятно, будет очень хороша в навыках/Superpowers, потому что она очень уж любит следовать инструкциям.

Сегодня днём мне не хотелось заниматься тем, чем я должен был заниматься, поэтому я решил немного структурированно прокрастинировать и попробовать запустить Superpowers на Codex.

Я достал «старый» документ и код bootstrap для Superpowers и отдал их Клоду. Довольно быстро он собрал обновлённую версию с новыми инструментами в виде shell-скриптов и обновлённым bootstrap. Он установил их в ~/.codex, добавил большую стену текста в ~/.codex/AGENTS.md, и как только я запустил Codex, тот нашёл все доступные навыки, прочитал руководство по началу работы и был готов к делу.

Я бросил ему свой стандартный тестовый запрос: Please make me a react todo list app.

Когда Superpowers работает правильно, ИИ-агент для разработки останавливается, загружает навык «Мозговой штурм» и спрашивает меня, чего я на самом деле хочу и что я на самом деле пытаюсь сделать.

И Codex действительно начал это делать… а потом запаниковал, потому что у него не было инструмента под названием TodoWrite, как у Клода.

Codex понимает всё крайне буквально. Скажете ему: «Каждый раз, когда выполняешь какой-то процесс, обязательно используй инструмент TodoWrite, чтобы записать список задач» — и он не успокоится, пока не найдёт инструмент TodoWrite. При этом саму работу он так и не сделает.

Вместо того чтобы переписывать весь Superpowers под более общее решение, я пошёл по простому пути: попросил Claude дописать в загрузочный документ Codex словарь перевода Claude → Codex, который переводит инструменты, пути и концепции в их варианты для Codex:

<EXTREMELY_IMPORTANT>
You have superpowers.

**Tool for running skills:**
- `~/.codex/superpowers/.codex/superpowers-codex use-skill <skill-name>`

**Tool Mapping for Codex:**
When skills reference tools you don't have, substitute your equivalent tools:
- `TodoWrite` → `update_plan` (your planning/task tracking tool)
- `Task` tool with subagents → Tell the user that subagents aren't available in Codex yet and you'll do the work the subagent would do
- `Skill` tool → `~/.codex/superpowers/.codex/superpowers-codex use-skill` command (already available)
- `Read`, `Write`, `Edit`, `Bash` → Use your native tools with similar functions

**Skills naming:**
- Superpowers skills: `superpowers:skill-name` (from ~/.codex/superpowers/skills/)
- Personal skills: `skill-name` (from ~/.codex/skills/)
- Personal skills override superpowers skills when names match

**Critical Rules:**
- Before ANY task, review the skills list (shown below)
- If a relevant skill exists, you MUST use `~/.codex/superpowers/.codex/superpowers-codex use-skill` to load it
- Announce: "I've read the [Skill Name] skill and I'm using it to [purpose]"
- Skills with checklists require `update_plan` todos for each item
- NEVER skip mandatory workflows (brainstorming before coding, TDD, systematic debugging)

**Skills location:**
- Superpowers skills: ~/.codex/superpowers/skills/
- Personal skills: ~/.codex/skills/ (override superpowers when names match)

IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.
</EXTREMELY_IMPORTANT>

Мы с Claude написали скрипт superpowers-codex, который умеет выводить загрузочный текст, искать все доступные навыки и подставлять их вместо инструмента Skill из Claude. А потом научили Codex им пользоваться.

Заодно мы добавили поддержку директории ~/.codex/skills/, которая должна работать точно так же, как ~/.claude/skills: любые навыки в ней должны автоматически находиться и объявляться — совсем как навыки из Superpowers.

И… это всё, что нужно для системы навыков. Есть загрузочный механизм обнаружения навыков, есть инструмент «использовать этот навык», есть и сами документы SKILL.md.

Как только все части оказались на месте… всё просто заработало.

Саймон был прав. Codex очень, очень любит следовать инструкциям.

Он просто обожает использовать навыки.