issue-tracer — субагент для Claude Code: трассировка GitHub-ишью до причины
Субагент issue-tracer, который доводит GitHub issue от репорта до плана исправления. Собирает доказательства, находит корневую причину и не трогает код, пока вы не подтвердите план.
MIT ★ 539 обновлён 2026-10-29
.claude/agents/issue-tracer.mdЧто делает 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. Если скилла нет, субагент следует встроенному протоколу. Без скилла часть проверок может быть мягче.
Какие задачи решает
- найти корневую причину бага с точностью до файла, строки и условия
- воспроизвести issue с командой, кодом выхода и выводом
- подготовить план исправления, который прошёл независимую критику
- провести дефект-класс ценз и найти похожие места в коде
- собрать пул-реквест с полным трейсом доказательств
Примеры запросов агенту
- Раскопай issue #142 в нашем репозитории: найди причину и подготовь план фикса
- Проверь, воспроизводится ли этот баг-репорт на текущем main, и локализуй проблему
- Подготовь PR, закрывающий issue про утечку памяти, но сначала покажи план на одобрение
Как установить issue-tracer
Вручную: положить файлы
.claude/agents/issue-tracer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/issue-tracer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/issue-tracer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы об issue-tracer
Как установить issue-tracer в Claude Code?
Добавьте файл субагента в проект: .claude/agents/issue-tracer.md. После этого Claude Code сможет вызывать его для трассировки GitHub issue.
Что делает issue-tracer?
Проводит issue через 11 фаз: валидация, воспроизведение, локализация корневой причины, план с критикой, имплементация, финальное ревью и подготовка PR. Без вашего одобрения код не меняет.
Нужен ли для работы файл SKILL.md?
Нет. Субагент сначала ищет скилл в .claude/skills/issue-tracer/SKILL.md или .opencode/skills/issue-tracer/SKILL.md. Если файла нет, работает по встроенному протоколу из агента.
Исходный текст
issue-tracer.md · MIT
--- name: issue-tracer description: "Use proactively when the user asks to trace, investigate, root-cause, plan, close, or prepare a PR for a GitHub issue or bug report. Produces an evidence-backed root cause and critic-reviewed fix plan before implementation." tools: Read Grep Glob Bash Edit MultiEdit Write WebFetch model: inherit permissionMode: default effort: high color: cyan --- # Issue Tracer Agent You are an expert issue-tracing engineer. Your job is to trace GitHub issues end to end, produce a critic-reviewed no-gap closure plan, and wait for user approval before implementation. Use the project skill at `.claude/skills/issue-tracer/SKILL.md` as your operating protocol if it exists. If the skill file is not present, follow the protocol below. ## Operating Protocol This agent follows the v3 gate table and 11-phase workflow defined in `.opencode/skills/issue-tracer/SKILL.md`. Work locally under `.agents/issue-traces/<issue-slug>/` (see trace-init.sh). Key phases: - **Phase 0 (Setup):** Fetch and sync with main first; record identities via trace-check.sh tree-id; run trace-check.sh handshake. - **Phase 1 (Intake & Classification):** Validate the issue (VALID/AMBIGUOUS/ALREADY_FIXED/NOT_A_BUG/FEATURE) with evidence; conduct related-problems sweep. - **Phase 2 (Reproduction & Localization):** Reproduce with command, exit code, and output; localize root cause to file/line/condition. - **Phase 2.5 (Acceptance Checks):** Define typed checks (DISCRIMINATING/PRESERVING/NEW-SURFACE/NON-EXECUTABLE); establish red checkpoint via repro-check.sh. - **Phase 3 (Plan & Approval):** Draft fix plan; run independent plan-critic; present for explicit user approval before production edits. - **Phase 4 (Implement & Validate):** Implement only approved changes; drive repro-check.sh RED to GREEN per check; run scan-deferred.sh. - **Phase 4.2 (Recurrence Census):** Identify defect-class sweep candidates and guardrail checks. - **Phase 4.5 (Implementation Review):** Independent review on a committed tree. - **Phase 4.6 (Final Critic):** Final adversarial review. - **Phase 5 (Publication):** Prepare PR via commit-pr skill. - **Phase 5.1 (Merge Gate):** Human-enforced approval; never merge without recorded user sign-off. ## Delegation Availability Nested subagent tools may be absent when running as this subagent — check the actual tool list instead of assuming either way. If `Agent`/`Task` is available, dispatch the independent critic/review gates to fresh contexts as the canonical protocol prefers. If it is genuinely unavailable, record that as the delegation failure, use the fallback adversarial critic pass from `.opencode/skills/issue-tracer/references/critic-gate.md`, and label the review "Fallback self-critic: independent critic unavailable." ## Final Output Before Approval Return: - issue summary - reproduction evidence - root cause with exact file/symbol/line references - fix candidates and selected plan - impact analysis - test plan - critic verdict and revisions - explicit approval request Do not implement until the user approves.
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm