К основному содержанию
скилл CX Codex

engineering-conventions · zaxbyhub — скилл для Codex: правила и установка

Скилл engineering-conventions задаёт порядок действий перед изменениями, затрагивающими инженерные инварианты opencode-swarm. Он пригодится при работе с архитектурой, тестами и состоянием сессии.

MIT ★ 539 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a claude-code
Открыть на GitHub

Что делает engineering-conventions

Перед изменением кода скилл предписывает прочитать файлы по порядку: AGENTS.md, docs/engineering-invariants.md, затем .opencode/skills/engineering-conventions/SKILL.md. Если правите строки промптов агента или экранированные шаблоны, он также указывает свериться с разделом о проблемах экранирования в инструкциях скилла.

Для Codex описаны рабочие приёмы: применять apply_patch для ручных правок, выполнять команды через оболочку и запускать независимые чтения и поиски параллельно. После изменений нужно привести конкретные свидетельства соблюдения затронутых инвариантов. При конфликте импортированного скилла с AGENTS.md действует AGENTS.md.

Это требует сначала разобраться с правилами репозитория: скилл не заменяет их, а направляет работу по ним.

Какие задачи решает

  • Проверить правила репозитория перед изменением архитектуры
  • Выбрать порядок чтения инженерной документации
  • Подготовить свидетельства соблюдения затронутых инвариантов
  • Избежать ошибок экранирования в строках промптов

Примеры запросов агенту

  • Перед изменением инициализации плагина изучи инженерные правила репозитория.
  • Проверь порядок работы с тестами и test_runner перед правкой.
  • Подскажи, какие файлы читать перед изменением строк промптов агента.

Как установить engineering-conventions

1Через Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a claude-code

2Вручную: положить файлы

~/.claude/skills/engineering-conventions/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/engineering-conventions/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об engineering-conventions

Как установить engineering-conventions в Codex?

Выполните npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a codex. Скилл устанавливается в .agents/skills/engineering-conventions/SKILL.md.

Что делает engineering-conventions?

Он задаёт порядок чтения правил репозитория и рабочие указания для изменений, затрагивающих его инженерные инварианты. После правок нужно показать конкретные свидетельства их соблюдения.

Какие файлы нужно прочитать перед изменениями?

Сначала AGENTS.md, затем docs/engineering-invariants.md и .opencode/skills/engineering-conventions/SKILL.md. При конфликте правил источником истины остаётся AGENTS.md.

Исходный текст

SKILL.md · MIT
---
name: engineering-conventions
description: Codex adapter for opencode-swarm engineering invariants. Use before modifying plugin initialization, subprocesses, runtime portability, .swarm containment, plan durability, test_runner behavior, test-writing patterns, session/global state, guardrails/retry semantics, chat/system hooks, tool registration, release/cache hygiene, or related architecture.
metadata:
  audience: swarm-plugin
---

# Engineering Conventions

Use this adapter before any change that can touch a repository invariant.

Read, in order:

1. `AGENTS.md`
2. `docs/engineering-invariants.md`
3. `.opencode/skills/engineering-conventions/SKILL.md`

If editing agent prompt strings or escaped template text, pay attention to the "Agent prompt strings — escaping pitfalls" section, which is now carried in both the `.opencode` summary (item 3 above) and `.claude/skills/engineering-conventions/SKILL.md`.

Codex-specific execution notes:

- Use `apply_patch` for manual edits.
- Use the available shell execution tool for `rg`, `git`, build, smoke, and test commands.
- Use the runtime's parallel-execution capability for independent file reads and searches.
- Keep changes scoped and produce concrete invariant evidence for every touched invariant.

The source of truth is always `AGENTS.md`. If an imported skill conflicts with it, `AGENTS.md` wins.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — engineering-conventions от других авторов.

engineering-conventions ZaxbyHub Скилл engineering-conventions задаёт обязательные инженерные инварианты для доработки opencode-swarm. Помогает избежать зависаний инициализации, утечек тестовых моков и поломок совместимости с Node ESM. CX Codex +1 ★ 539звёзд репо principal-engineering riekelt Скилл principal-engineering задаёт строгие инженерные правила перед правками: запрещает заглушать ошибки, требует чекпоинт рисков и проверку работы реальным кодом, а не догадками. CX Codex +1 25 700установок ai-first-engineering affaan-m Скилл ai-first-engineering задаёт правила работы команды, где большую часть кода пишут ИИ-агенты: что проверять на ревью, какие тесты требовать, как строить архитектуру. CX Codex +1 6 300установок nestjs-professional-software-engineering amirtaherkhani Скилл nestjs-professional-software-engineering для Claude Code и Cursor проектирует, реализует, рефакторит и проверяет код на NestJS и TypeScript. Запускается при разработке новых функций, исправлении багов и написании тестов. CX Codex +1 556установок engineering-code-review agentara Скилл engineering-code-review организует инженерное ревью пуллреквестов и локальных диффов по стандартам Google. Проверяет архитектуру, тесты, риски и выносит формальный вердикт. CX Codex +1 131установок 1-conventions ai-driven-dev Правило 1-conventions задаёт соглашения для TypeScript-файлов в src/ и tests/: структуру модулей, имена файлов и уровни тестов. Оно пригодится при добавлении кода и тестов в проект. CX Codex +1 ★ 571звёзд репо chaos-engineering kindlmann Скилл chaos-engineering помогает планировать контролируемые сбои и тестировать надёжность системы по гипотезам. Пригодится при подготовке к game day или внедрении хаос-тестов в стейджинге. CX Codex +1 1 300установок

Из того же набора121

Весь набор →
codebase-review-swarm Скилл codebase-review-swarm для Claude Code запускает аудит репозитория с опорой на цитаты кода. Проверяет безопасность, QA, доступность и AI-мусор без изменения файлов проекта. CX Codex +1 ★ 539звёзд репо add-path-type-assertions-or-realpath-resolve-calls-in-path-joini Скилл add-path-type-assertions-or-realpath-resolve-calls-in-path-joini для Claude Code добавляет проверки типов путей или вызовы realpath/resolve в утилиты, собирающие пути. Срабатывает при работе с path.join, realpath и fs path. CX Codex +1 ★ 539звёзд репо run-failing-tests-immediately-after-test-gate-failure Скилл run-failing-tests-immediately-after-test-gate-failure для Claude Code заставляет агента сразу прогнать упавшие тесты после сбоя test_gate и починить корневую причину, а не отчитываться о готовности. CX Codex +1 ★ 539звёзд репо run-tests-on-the-unmodified-codebase-before-starting-to-establis Скилл run-tests-on-the-unmodified-codebase-before-starting-to-establis для Claude Code требует запустить тесты на чистом репозитории до правок, чтобы зафиксировать сбои и отличать их от новых регрессий. CX Codex +1 ★ 539звёзд репо include-test-files-that-assert-on-behavior-being-changed-in-decl Скилл include-test-files-that-assert-on-behavior-being-changed-in-decl для Claude Code включает в scope задачи тесты изменяемого поведения, чтобы агент исправлял код вместе с проверками. CX Codex +1 ★ 539звёзд репо run-relevant-tests-after-logic-changes Скилл run-relevant-tests-after-logic-changes требует запускать релевантные тесты после правок логики и запрещает закрывать задачу без подтверждения их успешного прохождения. CX Codex +1 ★ 539звёзд репо pr-review-fix Скилл pr-review-fix проверяет замечания ревью к текущей ветке или версии PR и исправляет подтверждённые проблемы. Подключайте его, когда нужно разобрать комментарии ревьюеров или отчёт CI. CX Codex +1 ★ 539звёзд репо verify-skill-mirror-pairs-exist-in-both-opencode-skills-and-clau Скилл verify-skill-mirror-pairs-exist-in-both-opencode-skills-and-clau для Claude Code проверяет зеркальные копии скиллов и совпадение слага с именем каталога перед завершением задачи. CX Codex +1 ★ 539звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой