explain-issue — скилл для Claude Code: разбор GitHub issue
Скилл объясняет, какую проблему описывает GitHub issue и какое решение предлагают. Пригодится, чтобы быстро разобраться в обсуждении задачи.
npx skills add dyoshikawa/rulesync --skill explain-issue -a claude-codeЧто делает explain-issue
Скилл собирает описание и метаданные issue командой gh issue view <issue_number>, а затем отдельно загружает комментарии через gh issue view <issue_number> --comments. На основе этих материалов он объясняет мотивацию задачи и предлагаемое направление решения, включая важные ограничения, если они упомянуты.
Если issue ссылается на связанные pull request, коммиты или файлы, скилл учитывает этот контекст. Когда номер задачи не задан, он сначала спрашивает, какой issue разобрать. Для сбора сведений нужен доступ к gh; без него команда просмотра issue не выполнится. Ответ будет на языке текущего разговора.
Какие задачи решает
- понять, какую проблему описывает GitHub issue
- разобрать мотивацию и предлагаемый способ решения
- учесть комментарии и связанные pull request
- выяснить, какие ограничения решения упомянуты
Примеры запросов агенту
- Объясни GitHub issue 123: опиши исходную проблему и предложенное решение.
- Разбери
owner/repo#42и учти комментарии и связанные pull request. - Суммируй, почему завели эту задачу и какой следующий шаг предлагают.
Как установить explain-issue
1Через Skills CLI (Vercel)
npx skills add dyoshikawa/rulesync --skill explain-issue -a claude-code2Вручную: положить файлы
~/.claude/skills/explain-issue/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/explain-issue/
1Через Skills CLI (Vercel)
npx skills add dyoshikawa/rulesync --skill explain-issue -a codex2Вручную: положить файлы
.agents/skills/explain-issue/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dyoshikawa/rulesync --skill explain-issue -a cursor2Вручную: положить файлы
.cursor/skills/explain-issue/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dyoshikawa/rulesync explain-issue2Вручную: положить файлы
.github/skills/explain-issue/SKILL.md1Через Skills CLI (Vercel)
npx skills add dyoshikawa/rulesync --skill explain-issue -a gemini-cli2Командой платформы
gemini skills install https://github.com/dyoshikawa/rulesync --path .rulesync/skills/explain-issueВручную: положить файлы
.devin/skills/explain-issue/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dyoshikawa/rulesync --skill explain-issue -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о explain-issue
Как установить explain-issue в Claude Code?
Выполните npx skills add dyoshikawa/rulesync --skill explain-issue -a claude-code. Файл скилла находится по пути ~/.claude/skills/explain-issue/SKILL.md.
Что делает explain-issue?
Он разбирает описание и комментарии GitHub issue, а затем объясняет проблему и предложенное решение. Связанные pull request, коммиты и файлы тоже учитываются, если они нужны для понимания.
Нужен ли explain-issue доступ к GitHub issue?
Для получения описания и комментариев скилл вызывает gh issue view <issue_number>. Если задача ссылается на связанные pull request, коммиты или файлы, он собирает и этот контекст.
Исходный текст
SKILL.md · MIT
--- name: explain-issue description: "Explain a GitHub issue: the background problem and the proposed solution" targets: - "*" --- target_issue = the user's request If target_issue is not provided, ask the user which issue to explain. ## Step 1: Gather Issue Information Run the following in parallel: - Get the issue description and metadata: `gh issue view <issue_number>` - Get the issue comments: `gh issue view <issue_number> --comments` If the issue references related pull requests, commits, or files that are needed to understand the solution, gather that context as well. ## Step 2: Analyze and Explain Based on the issue content, explain the following two aspects: 1. **Background (Problem/Motivation):** What problem, limitation, or user need does this issue describe? Why does it matter? 2. **Proposed Solution:** What solution, direction, or next step is suggested in the issue discussion? Summarize the expected approach, scope, and important constraints if they are mentioned. If the issue does not contain enough information about the solution, explicitly say that the solution is still undecided or unspecified. Keep the explanation concise and focused. Use the language of the current conversation (follow the user's language).
© dyoshikawa · MIT · dyoshikawa/rulesync