| name | resolve-issues |
| allowed-tools | Bash(gh:*), Bash(git:*), EnterWorktree, ExitWorktree, Task |
| description | Resolves GitHub issues using isolated worktrees and test-driven development. This skill should be used when the user asks to "resolve an issue", "fix issue |
| 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:
- Review open issues from context and select based on priority and
$ARGUMENTS
- Check existing worktrees to determine if reuse is possible
- Use the EnterWorktree tool with a descriptive name (e.g.,
fix-456-auth-redirect) to create an isolated session
- Rename the auto-generated branch to match conventions: run
git branch -m <type>/<issue>-<description> (see references/workflow-details.md for naming)
- Verify issue acceptance criteria and dependencies
Phase 2: TDD Implementation
Goal: Implement fix using test-driven development with agent collaboration.
Actions:
- Plan implementation approach and assess architectural impact
- Write failing tests that verify issue is resolved (RED phase)
- Implement minimal code to make tests pass (GREEN phase)
- Refactor while keeping tests green (REFACTOR phase)
- Run quality validation commands (see
references/workflow-details.md for project-specific checks)
Phase 3: PR Creation and Cleanup
Goal: Create pull request, link issue, and clean up worktree after merge.
Actions:
- Push branch to remote with
git push -u origin <branch-name>
- Create PR using
gh pr create with auto-closing keywords (e.g., "Closes #456"). CRITICAL: Auto-closing keywords only trigger when the PR merges into the repository's default branch. If targeting a non-default branch (e.g. develop), warn the user that the issue will NOT close automatically on merge and must be closed manually.
- Consider using
--draft if the fix requires further feedback before review
- Report PR URL and status to user
- After successful merge: use the ExitWorktree tool with action "remove" to clean up worktree and branch
- Document resolution and any follow-up tasks
References
- Requirements:
references/requirements.md - Worktree setup, TDD, and commit standards
- Workflow Details:
references/workflow-details.md - Issue selection, TDD cycle, agent collaboration
- Examples:
references/examples.md - Commit message examples
