engineering-conventions · zaxbyhub — скилл для Codex: правила и установка
Скилл engineering-conventions задаёт порядок действий перед изменениями, затрагивающими инженерные инварианты opencode-swarm. Он пригодится при работе с архитектурой, тестами и состоянием сессии.
MIT ★ 539 обновлён 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/engineering-conventions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/engineering-conventions/
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a codex2Вручную: положить файлы
.agents/skills/engineering-conventions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a cursor2Вручную: положить файлы
.cursor/skills/engineering-conventions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .agents/skills/engineering-conventions2Вручную: положить файлы
.github/skills/engineering-conventions/SKILL.md1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a gemini-cli2Командой платформы
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .agents/skills/engineering-conventionsВручную: положить файлы
.devin/skills/engineering-conventions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.