Открытый проект для Claude Code и Codex
Claude-Codex Skills
Библиотека навыков, в которых я собрал практические правила работы с ИИ-агентами: от постановки задачи до проверки результата.
Почему я создал этот проект
ИИ-агент может быстро написать много кода, но скорость сама по себе не гарантирует нужный результат. В работе мне регулярно приходилось возвращать внимание к цели задачи, границам изменений и доказательствам того, что решение действительно работает.
Я начал оформлять эти повторяющиеся требования как самостоятельные навыки. Каждый из них задаёт агенту конкретный результат, порядок работы и критерии завершения — без обязательного оркестратора или общего сценария на все случаи.
Как я использую навыки
Я выбираю один навык под текущую задачу, чтобы задать агенту порядок работы и критерии завершения. Репозиторий помогает мне сохранять одинаковую инженерную дисциплину в разных кодовых базах и на разных этапах работы.
Перед разработкой
Проверяю идею, требования, архитектурные ограничения и план, прежде чем изменения станут дорогими.
Во время реализации
Соблюдаю согласованные границы изменений, нахожу причину проблемы и место исправления в коде, требую проверки затронутого поведения.
При проверке результата
Отделяю подтверждённые факты от предположений. Указываю, какие проверки выявили ошибки, какие ещё не выполнены и какие риски остаются.
При публикации и эксплуатации
Разделяю готовность кода, публикацию и наблюдаемое состояние работающей системы.
Мой вклад
Я придумал структуру библиотеки, написал и развиваю инструкции, определил границы ответственности навыков и единый подход к проверяемому результату.
Я также подготовил плагины для Claude Code и Codex, проверки целостности каталога и сценарии поведенческой проверки. Репозиторий открыт, чтобы навыки можно было изучать, изменять и использовать независимо.
Что показало практическое использование
Узкая задача работает лучше
Один навык с понятным результатом легче применить и проверить, чем большой обязательный процесс.
Контекст важнее объёма инструкций
Навык приносит пользу, когда агент сначала изучает реальный код, ограничения и уже принятые решения.
Проверка должна быть видимой
Список выполненных действий не заменяет доказательства. Полезный результат показывает, что проверено и что осталось неизвестным.
Ответственность остаётся у инженера
Навыки помогают направлять работу агента, но выбор решения и оценка его достаточности требуют профессионального суждения.
Пример: исправление языка навигации
Учебный пример ограниченной задачи, а не замер производительности. Допустим, ссылка с испанской страницы открывает английскую версию.
Используй ln-41-surgical-change-implementer. Сделай так, чтобы внутренние переходы сохраняли язык из URL. Проверь прямые ссылки, перезагрузку и кнопки «Назад» и «Вперёд». Сохрани события аналитики. Не публикуй изменения.
Проверьте изменения и результаты проверок: адрес назначения, язык страницы и canonical должны согласовываться. Откройте ссылку без JavaScript, перезагрузите страницу и вернитесь назад. Успешная сборка сама по себе не доказывает работу этих сценариев.
Прочитать инструкции навыкаИспользование навыков
Claude-Codex Skills работает в Claude Code и Codex?
В репозитории есть плагины для обоих инструментов. Используйте актуальные инструкции установки для своей среды: навыки направляют агента, но не заменяют его инструменты и разрешения.
Нужно ли запускать весь набор?
Нет. Выберите навык под нужный результат. Для ограниченного исправления кода Surgical Change Implementer охватывает реализацию и необходимые проверки; отдельное ревью полезно, когда нужны дополнительные доказательства.
Чего навык не гарантирует?
Навык не гарантирует правильность кода, доступность тестовой среды или успешное развёртывание. Перед приёмкой результата проверьте доказательства и оставшиеся проверки для своего проекта.
Документация живёт рядом с кодом
Актуальный каталог, назначение каждого навыка и инструкции по установке находятся в README репозитория.