opencode-config/docs/handoff/pr-120-agents-extract-skill-en.md

---

pr: 120 title: refactor(agents): extract bug-discovery skill, AGENTS.md to English, EN descriptions

Что сделано

• Новый скилл bug-discovery (.opencode/skills/bug-discovery/SKILL.md) — 6-шаговый протокол, извлечённый из AGENTS.md (проверка дубликатов → create-issue tool → EN title / RU body → продолжить задачу → отчёт оркестратору).
• AGENTS.md переведён на английский (все 8 секций). Bug Discovery Protocol сокращён с 8 строк до 1 строки + ссылка на скилл bug-discovery. Tools упрощён — убрана мягкая enforcement-фраза ("НЕ fallback на raw bash, НЕ обход через gh api"), оставлен только deny-list указатель.
• 10 skill descriptions переведены на английский (только frontmatter, тела НЕ трогались): run-pipeline, code-standards, memory, python-development, run-tests, get-project-map, release (убран дубль триггеров), tunnel, spec, issue.
• add-skill тело обновлено — инструкция про description: теперь явно требует EN. Формат Use when ... Also when user says "..." (RU фразы в триггерах OK, т.к. юзер говорит по-русски). Шаблон frontmatter обновлён.
• docs/project-map/README.md — добавлен bug-discovery/SKILL.md в дерево .opencode/skills/.
• Handoff + ADR-053 созданы.

Проверки: pytest tests/test_permissions.py 13 passed; ruff check OK; ruff format --check OK (40 files); check-permissions.py OK; кириллицы в AGENTS.md нет (verified via python regex).

Почему

AGENTS.md перегружен процедурными деталями (8-строчный Bug Discovery Protocol). RU descriptions мешают semantic matching (descriptions используются для skill selection). Мягкая enforcement ("НЕ fallback на raw bash, НЕ обход через gh api") не работает — реальный enforcement это deny-list в permission.bash файла opencode.json. Извлечение протокола в скилл держит AGENTS.md компактным (52 → 45 строк), а EN descriptions улучшают matching.

Pending

—

Watch out

• Глобальный ~/.config/opencode/AGENTS.md НЕ трогался — он монтируется через docker volume (Dockerfile/docker-compose), изменения project-local AGENTS.md подхватятся после rebuild/restart контейнера.
• add-skill теперь инструктирует EN descriptions для новых скиллов — существующие скиллы с RU description НЕ мигрированы принудительно (только 10 в этом PR). branch, repo-init, repo-readme, configure-opencode, add-skill уже имели EN descriptions — не тронуты.
• Тела скиллов (кроме add-skill) НЕ изменялись — остаются на русском с английскими техническими терминами (как было).
• bug-discovery появится в available_skills только после рестарта opencode (скиллы загружаются при старте).