# issue-tracer

Субагент issue-tracer, который доводит GitHub issue от репорта до плана исправления. Собирает доказательства, находит корневую причину и не трогает код, пока вы не подтвердите план.

- субагент · `type=agent` · Claude Code, Codex, OpenCode, Cursor · ★ 539 у репозитория
- Автор: ZaxbyHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.claude/agents/issue-tracer.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/issue-tracer

## Что делает

issue-tracer проводит issue через жёсткий 11-фазный протокол: от валидации и классификации репорта до подготовки пул-реквеста. Каждый шаг оставляет след — команда воспроизведения, код выхода, вывод, файл, строка, условие, из-за которого всё ломается.

Работа идёт локально в каталоге `.agents/issue-traces/<issue-slug>/`. Перед началом субагент синхронизируется с main, фиксирует идентичность дерева через `trace-check.sh tree-id` и запускает handshake. Затем — проверки принятия: DISCRIMINATING, PRESERVING, NEW-SURFACE, NON-EXECUTABLE, для каждой фиксируется красная точка через `repro-check.sh`.

После черновика плана субагент запускает независимого критика. Если вложенные агенты недоступны, используется fallback-критик из `.opencode/skills/issue-tracer/references/critic-gate.md`, а ревью помечается как self-critic. Это важно: без критики план не идёт на согласование. Только после вашего явного одобрения начинаются правки. Мерж вообще не выполняется без записанного sign-off.

Протокол определён в `.opencode/skills/issue-tracer/SKILL.md`, при наличии скилла в проекте — `.claude/skills/issue-tracer/SKILL.md`. Если скилла нет, субагент следует встроенному протоколу. Без скилла часть проверок может быть мягче.

## Требования
- Работает с: GitHub

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/issue-tracer.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/issue-tracer.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/issue-tracer.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.claude/agents/issue-tracer.md

## Когда брать
- найти корневую причину бага с точностью до файла, строки и условия
- воспроизвести issue с командой, кодом выхода и выводом
- подготовить план исправления, который прошёл независимую критику
- провести дефект-класс ценз и найти похожие места в коде
- собрать пул-реквест с полным трейсом доказательств

## Примеры запросов агенту
- Раскопай issue #142 в нашем репозитории: найди причину и подготовь план фикса
- Проверь, воспроизводится ли этот баг-репорт на текущем main, и локализуй проблему
- Подготовь PR, закрывающий issue про утечку памяти, но сначала покажи план на одобрение

## Похожие
- [fix-issue](https://affpapa.org/nevibecode/skills/frappe-fix-issue.md) — скилл · 431 установка
- [codex-issue-coordinator](https://affpapa.org/nevibecode/skills/codex-issue-coordinator.md) — скилл · 241 установка
- [issue-reporting](https://affpapa.org/nevibecode/skills/issue-reporting.md) — скилл · 118 установок
- [post-issue-comment](https://affpapa.org/nevibecode/skills/post-issue-comment.md) — скилл · ★ 1636 у репозитория
- [one-shot-feature-issue-planner](https://affpapa.org/nevibecode/agents/one-shot-feature-issue-planner.md) — субагент · ★ 41430 у репозитория
- [create-issues](https://affpapa.org/nevibecode/skills/create-issues.md) — скилл · 116 установок

Из того же набора: [zaxbyhub/opencode-swarm](https://affpapa.org/nevibecode/by/zaxbyhub/opencode-swarm.md) — 121 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
