Skip to content

Commit ca18926

Browse files
yepzdkclaude
andcommitted
feat: add github-issue-workflow skill
Add a new skill that guides users through the complete GitHub issue workflow: issue selection, development, PR creation, code review, and merge following ITK-dev conventions. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 204b47d commit ca18926

1 file changed

Lines changed: 58 additions & 0 deletions

File tree

skills/github-issue-workflow.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
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

Comments
 (0)