К основному содержанию
скилл CX Codex

bug-issue — скилл для Claude Code: что делает и как установить

Скилл bug-issue для Claude Code воспроизводит ошибки проекта и создаёт отчёты в GitHub Issues. Включается при запросе расследования бага с публикацией задачи.

Apache-2.0 ★ 413 обновлён 2026-11-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ThinkFlowLab/OpenDirector --skill bug-issue -a claude-code
Открыть на GitHub

Что делает bug-issue

Скилл проверяет рабочее дерево, изолирует шаги воспроизведения бага на тестовых данных и отслеживает путь вызовов через UI, API или бэкенд. Он не вносит правки в рабочий код, не запускает платные внешние сервисы ради отчёта и не создаёт пулл-реквесты без отдельного запроса.

Перед публикацией агент ищет дубликаты среди открытых и закрытых задач через GitHub CLI (gh). Черновик формируется во временном файле с шагами воспроизведения, ожидаемым поведением и критериями приёмки, после чего отправляется командой gh issue create.

Какие задачи решает

  • воспроизвести баг на минимальном пути сценария
  • проверить открытые и закрытые задачи на дубликаты через gh
  • сформировать отчёт для GitHub с ссылками на ревизии файлов
  • задать критерии приёмки для будущего исправления

Примеры запросов агенту

  • Расследуй ошибку удаления ассета и создай issue в репозитории
  • bug-issue: воспроизведи падение при экспорте в изолированном окружении

Как установить bug-issue

1Через Skills CLI (Vercel)

npx skills add ThinkFlowLab/OpenDirector --skill bug-issue -a claude-code

2Вручную: положить файлы

~/.claude/skills/bug-issue/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/bug-issue/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о bug-issue

Как установить bug-issue в Claude Code?

Выполните команду npx skills add ThinkFlowLab/OpenDirector --skill bug-issue -a claude-code.

Что делает bug-issue?

Скилл воспроизводит проблему по шагам, собирает доказательства без правки исходников и публикует проверенный тикет в GitHub Issues.

Что нужно для работы bug-issue?

Понадобится установленный GitHub CLI (gh), авторизованный через gh auth status с доступом к созданию задач в целевом репозитории.

Исходный текст

SKILL.md · Apache-2.0
---
name: bug-issue
description: Reproduce and verify a reported OpenDirector bug, then publish an evidence-based GitHub Bug Issue. Use when the user invokes bug-issue or asks for bug investigation with Issue creation; not for implementation-only requests or discussion of the skill itself.
---

# Bug Issue

Turn a reported failure into a reproducible, actionable GitHub Issue. Use the
current conversation, including screenshots and prior investigation, but
independently verify claims that materially affect the report. Write the Issue
in Chinese by default, preserving code identifiers and the user's language
preference.

## Scope and evidence

- Invocation with a specific bug authorizes investigation and Issue creation.
  Skill design or discussion alone does not authorize publication. Honor any
  draft-only or no-publish instruction.
- Inspect the worktree before investigating. Preserve unrelated user changes.
  Prefer an isolated temporary project or existing test fixture for reproduction;
  do not alter real project data or invoke paid external services merely to
  produce a report.
- Reproduce the smallest meaningful user path when feasible. Record the exact
  action sequence, observed result (including status or error), expected result,
  and environment details that affect reproducibility. If only a lower-layer
  reproduction succeeds, state that limit plainly. Screenshots support the
  observation; they do not establish the cause by themselves.
- Trace the relevant UI/API/backend path and check competing explanations with
  focused evidence. Mark unverified mechanisms as hypotheses. Run existing
  targeted tests when useful; a passing test may document current behavior
  rather than validate the desired behavior. Stop once the report is supported.
- Do not implement a fix, change tests, stage, commit, or create a PR unless
  separately requested. Propose acceptance criteria that can verify a future
  fix without prescribing an unsupported implementation.

## Issue content

Use a focused title such as `[bug] 画布:移除上传节点后无法删除资产` and a concise body
with these sections, omitting any section that has no evidence:

```markdown
## 问题与影响

用户可见的现象及影响。

## 复现步骤

1. 可执行的最短步骤。

## 预期与实际

- 预期:……
- 实际:……

## 定位与证据

已验证的调用链、关键状态及必要的仓库文件链接;明确复现层级。

## 验收标准

- [ ] 可观察的修复结果。
- [ ] 关键兼容或回归行为。
```

Include exact error text only where it helps recognition. Redact credentials,
private paths, and sensitive project content. Link repository files using URLs
valid on the remote, preferably pinned to the inspected commit; do not place
local absolute paths in the Issue. Do not describe a cause as confirmed solely
because a test passes or an error message names it. Do not claim an attachment
is present unless the remote Issue actually contains it.

## Publish

1. Check `gh auth status` and resolve the repository explicitly named by the
   user; otherwise use `gh repo view --json nameWithOwner,url,isArchived,hasIssuesEnabled`.
   Confirm the target is accessible, active, and supports Issues. Use `--repo`
   for every later Issue command. Never print tokens or change authentication.
2. Search open and closed Issues in that repository for the same symptom and
   cause. Compare bodies, not only titles. Report an existing match instead of
   creating a duplicate; do not edit or reopen it without authorization.
3. When publication is authorized and the target is clear, create the Issue
   with `gh issue create --repo ... --title ... --body-file ...`. Write the exact
   Markdown body to a temporary UTF-8 file, pass that file to `--body-file`,
   and remove it after a definite outcome. Add labels or assignees only when
   requested and available.
4. Check the returned URL. If creation has an uncertain outcome, look up the
   same title and body before any retry; never blindly create a duplicate.
   If authentication, repository access, or publication fails, report the
   precise blocker and provide the complete draft in chat for later use.

After success, return the Issue URL and a short summary of the reproduced
evidence. Do not ask for an extra confirmation once publication was requested.

© ThinkFlowLab · Apache-2.0 · ThinkFlowLab/OpenDirector

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
issue-progress-tracking OrchestKit Скилл issue-progress-tracking регламентирует ведение задач на GitHub через утилиту gh CLI: переводит статусы, создаёт ветки под задачу, фиксирует прогресс и привязывает pull request. CX Codex +1 221установок create-scrap-issue dyoshikawa Скилл create-scrap-issue собирает заметки и наблюдения в один GitHub issue с контекстом, деталями и следующими шагами. Подходит для сохранения находок на потом. CX Codex +1 ★ 1 636звёзд репо issue-label toss Скилл issue-label читает содержание GitHub-ишью, выбирает подходящий лейбл из матрицы проекта и вешает его одной командой. CX Codex +1 206установок issue-create terrylica Скилл issue-create превращает черновое описание в оформленный GitHub issue: определяет тип, подбирает метки из таксономии репозитория и предупреждает о дублях. CX Codex +1 129установок github-issue-creator alex-ilgayev Скилл github-issue-creator для Claude Code создаёт задачи GitHub для MCPSpy. Он включается по просьбе оформить запрос на функцию, баг или технический долг. CX Codex +1 1установок draft-issue-to-external-repository dyoshikawa Скилл draft-issue-to-external-repository готовит GitHub issue для репозитория, которым вы не владеете: изучает шаблоны и стиль проекта, уточняет замысел с вами и сохраняет текст в файл. CX Codex +1 ★ 1 636звёзд репо

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

character-replacement Скилл character-replacement для Claude Code планирует замену персонажей в видео, пишет промпты Ref2VA и настраивает ComfyUI. Агент подключается к сегментной обработке и проверке результата. CX Codex +1 ★ 413звёзд репо feat-issue Скилл feat-issue для Claude Code превращает запрос на фичу в план и публикует его как GitHub Issue. Срабатывает по вызову feat-issue или просьбе спланировать фичу с созданием Issue. CX Codex +1 ★ 413звёзд репо git-commit Скилл git-commit для Claude Code создаёт коммит Git или готовит текст сообщения только по содержимому индекса. Включается при запросе на коммит или составление описания изменений. CX Codex +1 ★ 413звёзд репо install-opendirector Скилл install-opendirector для Claude Code ставит OpenDirector из исходников, проверяет запуск и выдаёт команды для старта. Он включается при первой установке или ремонте незавершённой. CX Codex +1 ★ 413звёзд репо opendirector-review Скилл opendirector-review для Claude Code проверяет коммит пулл-реквеста и выдаёт вердикт PASS, WITHHOLD или REQUEST CHANGES. Запускается при запросе ревью ветки перед слиянием. CX Codex +1 ★ 413звёзд репо

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

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