К основному содержанию
субагент CX Codex

issue-tracer — субагент для Claude Code: трассировка GitHub-ишью до причины

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

MIT ★ 539 обновлён 2026-10-29

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/issue-tracer.md
Открыть на GitHub

Что делает 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 или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты 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

Похожие субагенты

Все субагенты по теме «Git и GitHub» →
fix-issue frappe Скилл fix-issue проводит агента от отчёта об ошибке до правки с тестом: субагент вытаскивает из issue только факты, догадки автора остаются в стороне. CX Codex +1 431установок codex-issue-coordinator owainlewis Скилл codex-issue-coordinator запускает отдельных AI-воркеров на каждую задачу из списка или вехи GitHub, следит за их PR и тестами, и сам мержит, когда всё готово. Подходит, когда нужно обработать пачку задач в одном потоке Codex. CX Codex +1 241установок issue-reporting manojbajaj95 Скилл issue-reporting для Claude Code собирает детали сбоя скилла из claude-gtm-plugin и готовит GitHub issue. Оформляет жалобы на неверный совет или несработавший скилл. CX Codex +1 118установок post-issue-comment dyoshikawa Скилл post-issue-comment для Claude Code собирает контекст GitHub issue, пишет короткий ответ на английском и публикует его. Учитывает всю дискуссию в ответе. CX Codex +1 ★ 1 636звёзд репо one-shot-feature-issue-planner официальный github Субагент one-shot-feature-issue-planner превращает краткий запрос на новую фичу в готовый черновик GitHub issue без уточняющих вопросов. Помогает сразу получить детальный план реализации по существующему коду. CX Codex +1 ★ 41 430звёзд репо create-issues FradSer Скилл create-issues автоматизирует создание GitHub issues с соблюдением принципов TDD, правильной разметкой и auto-closing ключевыми словами. Помогает документировать баги, требования и PR-scoped задачи по единым стандартам. CX Codex +1 116установок

Из того же набора121

Весь набор →
ci-failure-batching Скилл ci-failure-batching собирает все упавшие проверки PR, прежде чем планировать исправления. Помогает избежать отдельного цикла диагностики и отправки изменений для каждой ошибки. CX Codex +1 ★ 539звёзд репо mock-to-internals-migration Скилл mock-to-internals-migration для Claude Code помогает переносить моки с Vitest на Bun и проверять переход на seam _internals. Подключается к задачам миграции моков и изменения тестовой структуры. CX Codex +1 ★ 539звёзд репо gate-attribution Скилл gate-attribution связывает вердикты ревьюеров и тестировщиков с конкретными задачами плана в swarm-пайплайнах. Помогает избежать сбоев при пакетной проверке. CX Codex +1 ★ 539звёзд репо merge-queue-readiness Скилл merge-queue-readiness проверяет результат слияния PR с актуальной main до добавления в GitHub merge queue. Помогает поймать сбои интеграционных тестов, которых не видно при проверке ветки PR отдельно. CX Codex +1 ★ 539звёзд репо qa-reviewer Субагент qa-reviewer для строгого ревью пуллреквестов перед слиянием. Проверяет логику, безопасность, обработку ошибок, стиль и покрытие тестами без изменения кода. CX Codex +1 ★ 539звёзд репо durable-session-state Скилл durable-session-state сохраняет планы, решения, результаты проверок и вердикты ревью в файлах проекта. Он помогает продолжить долгую задачу после сжатия контекста или передачи работы. CX Codex +1 ★ 539звёзд репо swarm-pr-feedback Скилл swarm-pr-feedback для Claude Code собирает известные замечания к PR в реестр, проверяет каждое по коду и только после этого вносит правки. Разбирает замечания ревью, сбои CI и конфликты. CX Codex +1 ★ 539звёзд репо swarm-pr-feedback Скилл swarm-pr-feedback для автоматической обработки замечаний к pull request, падений CI и конфликтов слияния перед публикацией правок. CX Codex +1 ★ 539звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой