$ loading_
Triages bug batches and drives related PRs to a mergeable state.
Copy the install command and let the AI configure it · recommended for beginners
Please install the "batch-bug-shepherd" skill from askskill: 1. Download https://raw.githubusercontent.com/microsoft/apm/main/.agents/skills/batch-bug-shepherd/SKILL.md 2. Save it as ~/.claude/skills/batch-bug-shepherd/SKILL.md 3. Reload skills and tell me it's ready
Process this batch of suspected bugs in microsoft/apm: triage each issue as LEGIT, UNCLEAR, or FIXED-AT-HEAD; run a PRINCIPLES.md strategic alignment check for every LEGIT issue; check for related open PRs; if it is a greenfield bug, open a fix PR with TDD and a mutation-break gate; maintain plan.md as the source of truth.
A triage result set, an updated plan.md table, linked or newly opened fix PRs, and next actions for each item.
For all current bug-related community PRs, run shepherd-driver on each one: execute the review panel, fold in non-blocking recommendations, push changes while preserving authorship, and watch CI until green; if there are conflicts or mergeability issues, re-probe and resolve them.
Per-PR review outcomes, handled recommendations, CI status, and final mergeability results.
Run a weekly sweep: scan bug-labeled issues and in-flight related PRs in microsoft/apm, refresh triage decisions, strategic alignment, duplicate or related-PR checks, and drive all PRs toward mergeable status; then consolidate everything in plan.md.
An updated sweep report with issue classifications, PR progress, blockers, and the refreshed plan.md.
This skill is an A10 ORCHESTRATOR-SAGA over fan-out waves (triage,
strategic-alignment, PR-cross-reference, fix, drive-to-merge,
conflict-resolution) with a persisted ground-truth table between
phases. It COMPOSES the
shepherd-driver skill as the per-PR
drive-to-merge engine -- it does NOT re-implement the review +
fold + push + CI loop. shepherd-driver transitively COMPOSES
apm-review-panel; this skill inherits
that edge and never reaches into panel internals directly. It also
COMPOSES the apm-ceo persona (host-repo agent at
.apm/agents/apm-ceo.agent.md) for the strategic-alignment gate,
which checks every LEGIT bug against PRINCIPLES.md before allowing
fix / drive work to proceed. Per-PR shepherding is delegated to
shepherd-driver; per-issue verification, strategic alignment,
PR-in-flight branching, greenfield fix dispatch, post-wave
mergeability re-probe, and the cross-session table are owned here.
The skill is ADVISORY at the panel layer and EXECUTIVE at the
orchestrator layer: it WILL push commits, open PRs, post comments,
close superseded PRs. Every consequential write goes through a
deterministic CLI (gh, git, uv run ruff) wrapped in plan +
execute + verify (A9 SUPERVISED EXECUTION).
These 17 rules bind every wave. The one-line essence is below; the
FULL binding text (rationale, edge cases, inherited-from-driver
detail) lives in references/invariants.md. Load
references/invariants.md before planning Phase 0 -- the summaries
here are dispatch anchors, not the complete contract.
LEGIT); UNCLEAR -> human, FIXED-AT-HEAD -> close.gh pr list every legit
issue before any fix; duplicating community work is the worst
failure mode this skill defends against.microsoft/apm and returns superseded.ruff check +
ruff format --check silent before any git push.assets/progress-diagram.md).mergeStateStatus
before claiming ready; Phase 5 resolves conflicts with
--force-with-lease (bare --force prohibited).apm-ceo subagent per LEGIT row; demoted rows skip Phase 2-5; the…
Audit an entire docs corpus against code and propose precise fixes.
Improve CLI output, logs, errors, and terminal diagnostic user experience.
Plan doc TOC changes and outline stubs when PRs require structural updates.
Plan Python architecture, refactor class hierarchies, and design multi-file code changes.
Triage microsoft/apm issues and produce one unified resolution comment.
Guide APM positioning, release communication, and breaking-change strategy decisions.
Triage APM issues in batches and drive approved ones to mergeable PRs.
Drives one selected APM PR from review handling to merge readiness.
Run a multi-expert advisory review for labelled microsoft/apm pull requests.
Write complete, evidence-backed PR descriptions for microsoft/apm pull requests.
Review code deeply across correctness, tests, security, performance, and product quality.
Systematically triage failures and fix broken builds or unexpected runtime issues.