Skip to content

Commit 03fed90

Browse files
yepzdkclaude
andcommitted
feat: update skill to autonomous workflow
- Restructure phases for minimal user interaction - Add autonomous testing phase with type-specific instructions - Add autonomous code review with priority-based fixing - Add merge polling loop for Phase 5 - Consolidate to 6 phases (removed separate PR creation phase) - Add important rules section for autonomous behavior Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent ca18926 commit 03fed90

1 file changed

Lines changed: 79 additions & 42 deletions

File tree

skills/github-issue-workflow.md

Lines changed: 79 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,58 +1,95 @@
11
---
22
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.
3+
description: Autonomous GitHub issue workflow: develop, test, review, merge. Use this skill to work through GitHub issues with minimal user interaction - only pausing when user review/merge is required.
44
---
55

66
# GitHub Issue Workflow
77

8-
You are working through GitHub issues following the ITK-dev workflow. Execute these steps:
8+
You are an autonomous developer working through GitHub issues. Work with MINIMAL user interaction - only pause when user review/merge is required.
99

1010
## 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)
11+
1. Run `gh issue list --state open --limit 10` to show open issues
12+
2. If user provided an issue number, use that. Otherwise, present the list and ask which issue to work on.
1313
3. Run `gh issue view <number>` to get full details
14-
4. Summarize the issue and confirm understanding with the user
14+
4. Briefly summarize the issue and START WORKING IMMEDIATELY - do not ask for confirmation.
1515

16-
## PHASE 2: Development
16+
## PHASE 2: Development (AUTONOMOUS)
1717
1. Switch to main branch and pull latest: `git checkout main && git pull`
1818
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
19+
3. For non-trivial tasks, use EnterPlanMode to plan implementation
20+
4. Implement the solution following CLAUDE.md guidelines
2121
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
22+
6. Run `task ci` and fix any issues until CI passes
23+
7. Commit changes with descriptive message referencing the issue
24+
8. Push branch and create PR with proper format
25+
26+
## PHASE 3: Automated Testing (AUTONOMOUS)
27+
Automatically test based on the type of change:
28+
29+
**For UI changes:**
30+
- Use dev-browser skill to navigate to the affected page
31+
- Test the specific functionality that was changed
32+
- Take screenshots if helpful
33+
- Document any issues found and fix them
34+
35+
**For API/backend changes:**
36+
- If there's a UI component (like a download button), test it via dev-browser
37+
- Verify the fix works as expected
38+
39+
**For PDF/report changes:**
40+
- Navigate to a scan results page
41+
- Click the PDF download button
42+
- Verify no errors occur
43+
44+
**For form/validation changes:**
45+
- Navigate to the relevant form
46+
- Test with valid and invalid inputs
47+
48+
Fix any issues found during testing, commit, and push.
49+
50+
## PHASE 4: Automated Code Review (AUTONOMOUS)
51+
1. Run Task tool with subagent_type='pr-review-toolkit:code-reviewer'
52+
2. Run Task tool with subagent_type='pr-review-toolkit:silent-failure-hunter'
53+
3. If HIGH priority issues are found, fix them automatically
54+
4. For MEDIUM/LOW issues, use judgment - fix if straightforward, otherwise note them
55+
5. Push any fixes made
56+
57+
## PHASE 5: User Review & Merge (WAIT FOR USER)
58+
Present a summary to the user:
59+
- What was implemented
60+
- What was tested
61+
- Code review results and any fixes made
62+
- PR link
63+
64+
Then say: "PR is ready for your review and merge. I'll wait for the merge to complete."
65+
66+
Wait for merge using:
67+
```bash
68+
while true; do
69+
pr_state=$(gh pr view <PR_NUMBER> --json state -q '.state')
70+
if [ "$pr_state" = "MERGED" ]; then
71+
echo "PR merged!"
72+
break
73+
fi
74+
sleep 10
75+
done
76+
```
77+
78+
## PHASE 6: Next Issue (AFTER MERGE)
79+
1. Switch to main and pull: `git checkout main && git pull`
80+
2. Check for remaining open issues: `gh issue list --state open --limit 5`
81+
3. If there are open issues, suggest the next one to tackle:
82+
"Merge complete! Here are the remaining open issues:
83+
[list issues]
84+
85+
I suggest we tackle #XX next because [reason]. Should I start working on it?"
86+
4. If user confirms, immediately start Phase 1 with that issue number.
87+
88+
## Important Rules
89+
- Work AUTONOMOUSLY through phases 1-4 without asking for confirmation
90+
- Only pause at Phase 5 for user review/merge
5491
- Always follow CLAUDE.md guidelines
5592
- Never commit directly to main
5693
- 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
94+
- Fix issues found by automated testing and review without asking
95+
- Be efficient - don't ask unnecessary questions

0 commit comments

Comments
 (0)