process-issues

SkillDev tools

Resolve all open GitHub issues. Each issue becomes exactly one shipped PR. Trigger when user says "process issues", "work through issues", "resolve issues", "handle open issues", "fix all issues", or asks to resolve GitHub issues end-to-end.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the process-issues skill

What this skill tells your AI

The instructions your AI receives, as published by everruns/bashkit in .agents/skills/process-issues/SKILL.md and read by ahel’s review.

Resolve all qualifying open GitHub issues. Each issue becomes exactly one merged PR. Do not stop until every issue is resolved or explicitly deferred.

Arguments

  • $ARGUMENTS - Optional: specific issue numbers (e.g. "42 55") or labels. If omitted, process all open issues.

Goal

Every qualifying open issue has a merged PR that resolves it. One issue = one PR. No bundling. No skipping.

Qualifying issues

Only process issues that meet ONE of:

  • Created by chaliy
  • Has a comment from chaliy approving it

Skip all others silently.

Per-issue outcomes

For each qualifying issue (ordered by issue number), achieve ALL of these before moving to the next:

1. Issue is understood and scoped

  • Classify: bug, feat, test, chore, refactor, docs
  • Identify affected areas: parser, interpreter, builtins, vfs, network, git, python, tool, eval, security
  • Branch created from latest main: fix/issue-{N}-{short-slug}

2. Failing test exists (bugs) or scaffold test exists (features)

  • A test that demonstrates the bug or validates the feature exists in crates/bashkit/tests/spec_cases/ or relevant module
  • For bugs: test fails before the fix, passes after

3. Fix or feature is implemented

  • Minimal, focused changes
  • Positive and negative tests pass
  • Security tests added if change touches parser, interpreter, VFS, network, git, or user input (per knowledge/security/security-testing.md)
  • Threat model updated if new attack surface (per knowledge/security/threat-model.md)

4. Ship via /ship

Invoke the /ship skill to handle all remaining steps: spec updates, artifact updates, code simplification, security review, smoke testing, quality gates, PR creation, CI, and merge.

Pass context: Closes #N — <short description of the fix/feature>

Do NOT duplicate any /ship steps manually — let the skill handle the full pipeline.

After /ship completes and the PR is merged, return to main before next issue: git checkout main && git pull origin main

After all issues

Scan for #[ignore] tests that may now pass. Un-ignore any that are green. Single PR for all un-ignored tests.

Rules

  • One issue = one PR. Non-negotiable. Never bundle multiple issues.
  • Never close a half-done issue. If the PR only implements a subset of the issue's tasks, do NOT use Closes #N or Fixes #N in the PR body. Instead use Partial #N or Part of #N and list what remains. Only use closing keywords when every task/checkbox in the issue is complete.
  • If an issue is unclear or not reproducible, comment asking for clarification and skip to next.
  • If a fix would be >500 lines, split into sub-issues and link them.
  • Never skip the failing-test-first step for bugs.
  • Always rebase on latest main between issues.

Signals

GitHub stars
269
Forks
23
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
process-issues
Source
github.com/everruns/bashkit