codex-bug
Скилл codex-bug предназначен для диагностики bug report в GitHub-репозитории openai/codex. Он помогает определить следующий шаг по конкретному issue: проверить сообщение по исходникам репозитория, запросить недостающие сведения или объяснить, почему заявленное поведение не является ошибкой. Скилл не обещает автоматически исправить код и не превращает любой общий вопрос о Codex в подтверждённый дефект: входом должен быть URL issue из репозитория github.com/openai/codex/issues/. Первый этап — проверка входа. Если ссылка отсутствует или указывает не в openai/codex, workflow предлагает запросить правильный адрес. После этого сеть должна быть использована сразу, даже если кажется, что доступ может быть ограничен. Предпочтительный источник — GitHub API: endpoint issue и endpoint его комментариев. HTML-страница рассматривается как менее удобный запасной вариант, потому что она содержит больше шума. Из ответа нужно извлечь заголовок и описание, шаги воспроизведения, ожидаемое и фактическое поведение, окружение, логи и вложения, если они есть. При наличии thread ID его следует отдельно отметить и использовать для поиска связанных логов и сведений о сессии, если такой доступ действительно предоставлен. До глубокого чтения кода, документации и логов скилл требует кратко пересказать bug report своими словами. В таком резюме должны быть зафиксированы наблюдаемое поведение, ожидаемый результат, шаги воспроизведения, окружение и уже приложенные доказательства. Это ограничение полезно как контроль понимания: если в issue нет воспроизводимых шагов, окружения или логов, нельзя молча заполнить пробелы предположением. Дальше выбирается один из трёх маршрутов. Конкретный и вероятно воспроизводимый отчёт нужно проверять по источникам и релевантным файлам openai/codex. Расплывчатый отчёт с недостаточными шагами, логами или описанием окружения требует запроса дополнительной информации. Если текущая реализация или документированные ограничения противоречат заявлению, допустимо объяснить, почему это не подтверждённая ошибка, сославшись на проверенные факты. Выбор маршрута должен соответствовать evidence из issue, а не только формулировке заголовка. Финальный ответ должен кратко сообщить результаты проверки и следующий шаг. При сетевом сбое после разрешённых попыток можно честно описать offline-вариант, например подготовить шаблон ответа, но нельзя выдавать непроверенный диагноз за установленную причину. Практическое ограничение карточки такое: codex-bug задаёт процесс triage для issues openai/codex, а не общий мониторинг GitHub, не универсальный дебаггер и не замену maintainer-решению по исправлению или закрытию issue.
Для чего подходит
- Проверка GitHub issue Codex
- Сбор недостающих данных для воспроизведения
- Выбор следующего шага диагностики
Установка
Сначала прочитайте SKILL.md и scripts в исходном репозитории. Затем выполните команду в каталоге проекта:
npx skills add https://github.com/openai/codex/tree/main/.codex/skills/codex-bug