|
| 1 | +--- |
| 2 | +name: github-issue-workflow |
| 3 | +description: Work through GitHub issues following the ITK-dev workflow. Use this skill when you need to pick an issue, develop a solution, create a PR, review code, and merge. Handles the complete development lifecycle from issue selection to merge. |
| 4 | +--- |
| 5 | + |
| 6 | +# GitHub Issue Workflow |
| 7 | + |
| 8 | +You are working through GitHub issues following the ITK-dev workflow. Execute these steps: |
| 9 | + |
| 10 | +## PHASE 1: Issue Selection |
| 11 | +1. Run `gh issue list --state open --limit 20` to show open issues |
| 12 | +2. Ask the user which issue to work on (or let them specify one) |
| 13 | +3. Run `gh issue view <number>` to get full details |
| 14 | +4. Summarize the issue and confirm understanding with the user |
| 15 | + |
| 16 | +## PHASE 2: Development |
| 17 | +1. Switch to main branch and pull latest: `git checkout main && git pull` |
| 18 | +2. Create feature branch: `git checkout -b feature/issue-<number>-<short-description>` |
| 19 | +3. Plan the implementation (use EnterPlanMode for non-trivial tasks) |
| 20 | +4. Implement the solution following project guidelines in CLAUDE.md |
| 21 | +5. Update CHANGELOG.md with the changes |
| 22 | +6. Run `task ci` to verify all checks pass |
| 23 | +7. Fix any issues until CI passes |
| 24 | + |
| 25 | +## PHASE 3: Create PR |
| 26 | +1. Commit changes with descriptive message referencing the issue |
| 27 | +2. Push branch: `git push -u origin <branch-name>` |
| 28 | +3. Create PR with `gh pr create` following this format: |
| 29 | + - Title: Brief description (Closes #<issue-number>) |
| 30 | + - Body: ## Summary (bullet points), ## Test plan (checkboxes) |
| 31 | + |
| 32 | +## PHASE 4: UI Testing (if applicable) |
| 33 | +1. Ask user if this change has UI components that need testing |
| 34 | +2. If yes, use the dev-browser skill or browser-feedback tools to test |
| 35 | +3. Document any UI issues found and fix them |
| 36 | + |
| 37 | +## PHASE 5: Code Review |
| 38 | +1. Use the Task tool with subagent_type='pr-review-toolkit:code-reviewer' to review the changes |
| 39 | +2. Also run 'pr-review-toolkit:silent-failure-hunter' for error handling review |
| 40 | +3. Present review findings to user |
| 41 | +4. Fix any issues identified in review |
| 42 | +5. Push fixes and re-run CI if needed |
| 43 | + |
| 44 | +## PHASE 6: Merge |
| 45 | +1. Confirm with user that PR is ready to merge |
| 46 | +2. Run `gh pr merge --squash --delete-branch` to merge |
| 47 | +3. Switch back to main: `git checkout main && git pull` |
| 48 | + |
| 49 | +## PHASE 7: Next Issue |
| 50 | +1. Ask user if they want to continue with another issue |
| 51 | +2. If yes, return to Phase 1 |
| 52 | + |
| 53 | +## Important Guidelines |
| 54 | +- Always follow CLAUDE.md guidelines |
| 55 | +- Never commit directly to main |
| 56 | +- Always run `task ci` before creating PR |
| 57 | +- All user-facing text in Danish, code/commits in English |
| 58 | +- Ask for clarification if requirements are unclear |
0 commit comments