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

resolve-issues — скилл для Claude Code: GitHub issues

Скилл resolve-issues для Claude Code решает GitHub issues через изолированный worktree и TDD. Затем передаёт создание PR в workflow проверки и ревью.

MIT 112 установок ★ 597 обновлён 2026-11-06

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

Что делает resolve-issues

resolve-issues работает в Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Скилл выбирает issue, создаёт отдельный worktree и переименовывает ветку по соглашению. Затем он ведёт разработку по циклу TDD: сначала добавляет падающий тест, потом пишет код и делает рефакторинг.

После реализации ветка отправляется в remote. Создание PR передаётся через github:create-pr, а дальнейшее ревью ведёт github:review-pr; этот путь также запускает quality gate и связывает PR с issue через ключевое слово автозакрытия. Прямой вызов gh pr create запрещён, поэтому обычный сценарий с этим скиллом всегда проходит через указанный workflow.

Очистка worktree выполняется после фактического merge. Если остались незакоммиченные изменения, удаление через ExitWorktree требует отдельного подтверждения.

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

  • выбрать GitHub issue и подготовить отдельный worktree
  • написать падающие тесты для исправления issue
  • реализовать фикс по циклу red → green → refactor
  • передать готовую ветку в создание и ревью PR
  • удалить worktree после merge PR

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

  • Реши issue #123 по критериям приёмки и создай отдельный worktree.
  • Исправь GitHub issue про редирект авторизации через TDD, затем передай PR в github:create-pr.
  • Разбери эту задачу из GitHub, запусти проверки и доведи ветку до этапа ревью.

Как установить resolve-issues

1Через Skills CLI (Vercel)

npx skills add FradSer/dotclaude --skill resolve-issues -a claude-code

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

~/.claude/skills/resolve-issues/SKILL.md

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

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

Вопросы о resolve-issues

Как установить resolve-issues в Claude Code?

Выполните npx skills add FradSer/dotclaude --skill resolve-issues -a claude-code, затем проверьте файл ~/.claude/skills/resolve-issues/SKILL.md.

Что делает resolve-issues?

Скилл ведёт решение GitHub issue в изолированном worktree по циклу TDD. После этого он передаёт создание PR в github:create-pr, а ревью — в github:review-pr.

Почему resolve-issues не создаёт PR через gh pr create?

Скилл использует github:create-pr как единственный путь создания PR. Так сохраняются quality gate, связь с issue и обязательная передача в github:review-pr.

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

SKILL.md · MIT
---
name: resolve-issues
allowed-tools: Bash(gh:*), Bash(git:*), EnterWorktree, ExitWorktree, Task, Skill
description: Resolves GitHub issues using isolated worktrees and test-driven development, then delegates PR creation to /github:create-pr so the quality gate and the /github:review-pr loop always run. This skill should be used when the user asks to "resolve an issue", "fix issue #123", or needs to implement a solution for a specific GitHub ticket using a structured workflow.
argument-hint: [issue number or description]
user-invocable: true
---

# Resolve GitHub Issues

Execute issue resolution workflow using isolated worktrees, TDD methodology, and agent collaboration.

## Context

- Current git status: !`git status`
- Current branch: !`git branch --show-current`
- Existing worktrees: !`git worktree list`
- Open issues: !`gh issue list --state open --limit 10`
- GitHub authentication: !`gh auth status`

## Requirements Summary

Use isolated worktrees to avoid disrupting main development. Follow TDD cycle (red → green → refactor) with agent support. Reference issues in commits using auto-closing keywords. See `references/requirements.md` for protected PR workflow and commit standards.

## Phase 1: Issue Selection and Worktree Setup

**Goal**: Select target issue and prepare isolated development environment.

**Actions**:
1. Review open issues from context and select based on priority and `$ARGUMENTS`
2. Check existing worktrees to determine if reuse is possible
3. Use the EnterWorktree tool with a descriptive name (e.g., `fix-456-auth-redirect`) to create an isolated session
4. Rename the auto-generated branch to match conventions: run `git branch -m <type>/<issue>-<description>` (see `references/workflow-details.md` for naming)
5. Verify issue acceptance criteria and dependencies

## Phase 2: TDD Implementation

**Goal**: Implement fix using test-driven development with agent collaboration.

**Actions**:
1. Plan implementation approach and assess architectural impact
2. Write failing tests that verify issue is resolved (RED phase)
3. Implement minimal code to make tests pass (GREEN phase)
4. Refactor while keeping tests green (REFACTOR phase)
5. Run quality validation commands to keep the TDD cycle honest (see `references/workflow-details.md` for project-specific checks). `/github:create-pr` re-runs the full gate in Phase 3 and is the authoritative pre-PR check.

## Phase 3: PR Creation and Cleanup

**Goal**: Hand PR creation to `/github:create-pr` so the quality gate and the review loop run. Cleanup happens only after the merge, which may be many turns later.

**Actions**:
1. Push branch to remote with `git push -u origin <branch-name>`
2. **CRITICAL: Do NOT call `gh pr create` here.** Invoke `Skill("github:create-pr", "<issue reference>")` — e.g. `Skill("github:create-pr", "Closes #456")`. It is the plugin's only PR-creating path and owns the quality/security gate, the auto-closing-keyword linkage, the non-default-branch warning, and the mandatory `/github:review-pr` handoff. See `references/pr-creation-handoff.md` for the full contract. Creating the PR directly skips all of it.
   - Append `--draft` to the arguments if the fix requires further feedback before review
   - Append `--no-monitor` only when the user explicitly opts out of the review loop
3. **This skill does not resume here.** `/github:create-pr` reports the PR URL, and `/github:review-pr` then owns the PR for the rest of its life: a persistent Monitor spanning turns, the triage/fix/push rounds, and the merge decision it asks the user to make. Do NOT wait inline, do NOT re-report the URL, and do NOT run Phase 4 speculatively.

## Phase 4: Post-Merge Cleanup (later turn, fallback)

**Trigger**: The PR from Phase 3 has actually merged — normally a later turn, after `/github:review-pr` completed its merge decision. **`/github:review-pr`'s closeout now owns the post-merge cleanup** (worktree removal via `ExitWorktree action:"remove"`, switch to `main`, sync with origin), so this Phase runs only as a **fallback** when that cleanup was skipped: the user chose "Don't merge", an interrupt left the worktree behind, or this is a fresh session that cannot `ExitWorktree` the worktree created by an earlier session. Never assume the worktree is gone — verify first.

**Actions**:
1. Verify the merge with `gh pr view <PR#> --json state -q .state` returning `MERGED`; never assume.
2. Check `git worktree list` whether the issue worktree still exists. If `/github:review-pr` already removed it, skip straight to `git fetch --prune`.
3. If it persists: **CRITICAL: confirm still on the issue branch** before `ExitWorktree action:"remove"`. If checkout drifted onto `main`/`develop`, stop — removing would delete a long-lived branch. Remote head may already be gone; that is fine.
4. Use the ExitWorktree tool with action "remove" to clean up worktree and branch.
   - If uncommitted changes exist, ExitWorktree refuses; confirm with the user before setting `discard_changes: true`
5. `git fetch --prune` to sync remote-tracking branches.
6. Document resolution and any follow-up tasks

## References

- **Requirements**: `references/requirements.md` - Worktree setup, TDD, and commit standards
- **PR Creation Handoff**: `references/pr-creation-handoff.md` - Why PRs delegate to /github:create-pr
- **Workflow Details**: `references/workflow-details.md` - Issue selection, TDD cycle, agent collaboration
- **Quality Validation**: `references/quality-validation.md` - Node.js/Python validation commands (shared)
- **Examples**: `references/examples.md` - Commit message examples

© FradSer · MIT · FradSer/dotclaude

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

Все скиллы по теме «Git и GitHub» →
resolve-scrap-issues dyoshikawa Скилл resolve-scrap-issues проходит по свежим GitHub-issue с меткой maintainer-scrap, проверяет каждую и либо закрывает её, либо открывает один общий PR с исправлениями. CX Codex +1 ★ 1 636звёзд репо ce-resolve-pr-feedback EveryInc Скилл ce-resolve-pr-feedback для Claude Code разбирает комментарии ревьюеров в пул-реквесте, вносит правки и закрывает обсуждения. Накопившиеся замечания разбирает за один прогон. CX Codex +1 3 400установок resolve-backport-conflicts frappe Скилл resolve-backport-conflicts устраняет конфликты слияния в бэкпорт-пулл-реквестах от Mergify. Помогает очистить ветку от конфликтных маркеров и лишних правок при сбоях cherry-pick. CX Codex +1 680установок resolve-pr-conflicts jssblck Скилл resolve-pr-conflicts помогает агенту безопасно устранять конфликты слияния в ветке пулреквеста, обновляя её относительно целевой ветки через отдельный worktree и прогон тестов. CX Codex +1 669установок resolve-reviews pbakaus Скилл resolve-reviews разбирает замечания людей и ботов в текущем пуллреквесте. Исправляет баги, отсеивает ложные срабатывания и отвечает в треды GitHub. CX Codex +1 556установок resolve-agent-reviews pbakaus Скилл resolve-agent-reviews находит замечания ботов-ревьюеров в открытом PR, исправляет реальные баги, закрывает ложные срабатывания и ждёт завершения проверок коммита. CX Codex +1 498установок

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

Весь набор →
plugin-best-practices Скилл plugin-best-practices для проверки структуры, манифестов и архитектуры Claude Code плагинов по стандартам фреймворка. Помогает убедиться, что плагин соответствует требованиям до отправки в маркетплейс. CX Codex +1 121установок commit Скилл commit для Claude Code создаёт атомарные conventional-коммиты через git-agent. Оформляет изменения по краткому намерению. CX Codex +1 121установок optimize-plugin Скилл optimize-plugin проверяет структуру плагинов Claude, запускает Python-валидатор и исправляет найденные ошибки через агента. Пригодится при подготовке и рефакторинге расширений. CX Codex +1 117установок create-prd Скилл create-prd помогает собрать идею продукта в PRD: задаёт вопросы, выбирает формат и сохраняет готовый документ в Markdown или Feishu. CX Codex +1 117установок create-issues Скилл create-issues автоматизирует создание GitHub issues с соблюдением принципов TDD, правильной разметкой и auto-closing ключевыми словами. Помогает документировать баги, требования и PR-scoped задачи по единым стандартам. CX Codex +1 116установок best-practices Скилл best-practices задаёт правила качества кода и шаблоны под TypeScript, Python, Go, Swift и React. CX Codex +1 115установок refactor Скилл refactor запускает автоматический рефакторинг выбранных файлов, папок или недавних правок через агента упрощения кода. CX Codex +1 113установок create-pr Скилл create-pr создаёт GitHub pull request после проверок качества и безопасности, а затем передаёт его на мониторинг CI и разбор комментариев. CX Codex +1 109установок

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

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