56 lines
No EOL
3.5 KiB
Markdown
56 lines
No EOL
3.5 KiB
Markdown
---
|
||
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
|
||
(скиллы загружаются при старте). |