tomevault-io Run Issues Skill
Autonomous workflow for processing multiple GitHub issues in parallel with priority-based scheduling and verification.
Overview
This skill orchestrates the complete lifecycle of issue processing:
- Fetch open issues from GitHub
- Analyze and prioritize (P0 > P1 > P2)
- Detect dependencies between issues
- Spawn subagents for parallel execution
- Verify all results before reporting
When to Use
Use this skill when:
- User invokes
/run-issues - User requests batch processing of issues
- User wants autonomous issue handling
- Multiple issues need parallel processing
Workflow
Phase 0: Pre-Flight Check
IMPORTANT: Before starting, check if AWK principal workflow is active.
# Check for active AWK workflow
if [ -f ".ai/state/kickoff.lock" ]; then
echo "⚠️ WARNING: AWK principal workflow is active"
fi
If .ai/state/kickoff.lock exists:
- Warn the user:
⚠️ AWK principal workflow 正在執行中。 同時執行 /run-issues 可能導致： - 同一 issue 被重複處理 - 產生重複的 branch 或 PR - Merge conflicts 建議：等待 AWK workflow 完成後再執行。 確定要繼續嗎？(yes/no) - Only proceed if user explicitly confirms with "yes"
- If user says "no", abort gracefully
If lock file does not exist, proceed to Phase 1.
Phase 1: Fetch Issues
gh issue list --state open --json number,title,body,labels,assignees --limit 50
Parse the JSON output to get all open issues.
Phase 2: Analyze Issues
Read phases/analyze.md for detailed priority analysis rules.
For each issue:
- Extract priority from labels (P0/P1/P2)
- Parse dependencies from issue body
- Calculate priority score
- Build dependency graph
Phase 3: Plan Parallel Execution
Read phases/parallelize.md for parallelization strategy.
- Group issues by dependency chains
- Identify independent issue sets
- Determine optimal subagent count (max 3 concurrent)
- Create execution batches
Phase 4: Execute
For each batch of independent issues:
Spawn subagents using Task tool:
Task tool parameters: - subagent_type: general-purpose - description: "Work on Issue #<number>: <title>" - prompt: | Complete Issue #<number>. Requirements: <body excerpt>. CRITICAL - Follow .ai/rules/_kit/git-workflow.md strictly: Commit format: - Format: [type] subject - Subject MUST be lowercase (e.g., "add feature" not "Add feature") - NO colon after bracket - Valid types: feat, fix, docs, style, refactor, perf, test, chore Examples: ✅ [docs] update api reference ✅ [feat] add user authentication ❌ [Docs] Update API reference (uppercase = WRONG) ❌ docs: update api reference (colon = WRONG) PR requirements: - PR body MUST include: Closes #<number> - PR target: develop branch (or as specified)Wait for all subagents in batch to complete
Move to next batch (respecting dependencies)
Phase 5: Verify Results
Read phases/verify.md for verification checklist.
For each completed issue:
- Check if PR was created
- Validate commit format
- Verify tests pass
- Confirm branch is up-to-date
Phase 6: Report
Generate summary table:
| Issue | Title | Priority | Status | PR | Notes |
|-------|-------|----------|--------|-----|-------|
| #123 | Fix bug | P0 | Completed | #456 | Tests pass |
| #124 | Add feature | P1 | Completed | #457 | Ready for review |
| #125 | Update docs | P2 | Failed | - | Test failures |
Error Handling
- If a subagent fails, log the error and continue with other issues
- Failed issues are marked in the final report
- Dependencies of failed issues are skipped with note
Self-Check
On each phase entry, output:
[RUN-ISSUES] <timestamp> | <phase> | loaded: <filename>
Integration with AWK Workflow
⚠️ WARNING: Do NOT run /run-issues and awkit kickoff simultaneously.
This skill processes GitHub issues independently of AWK's spec-driven workflow.
- AWK uses
tasks.mdspecs →awkit dispatch-worker - This skill fetches from GitHub → Task subagents
Recommended workflow:
/create-issues → issues created
↓
Choose ONE:
├─ awkit kickoff (structured, spec-driven)
└─ /run-issues (autonomous, batch processing) ← this skill
Quick Reference
| Phase | Action | File |
|---|---|---|
| Pre-Flight | Check AWK workflow not active | (inline) |
| Analyze | Determine priorities and dependencies | phases/analyze.md |
| Parallelize | Plan execution batches | phases/parallelize.md |
| Verify | Check completed work | phases/verify.md |
Converted and distributed by TomeVault — claim your Tome and manage your conversions.