shepherd

Automate pull request governance to reach merge-ready state.

Updated Feb 24, 2021
One-click install
npx skills add https://github.com/roderik/roderik.github.io --skill shepherd-roderik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shepherd
Source: https://github.com/roderik/roderik.github.io/tree/main/.agents/skills/shepherd
Command: npx skills add https://github.com/roderik/roderik.github.io --skill shepherd-roderik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate the process of shepherding a pull request from open to merge-ready by systematically addressing reviews, stabilizing CI, and keeping the PR on track toward final merge.

Core Features & Use Cases

  • Review resolution loop: identifies unanswered comments and applies fixes to code or CI signals.
  • CI stabilization: monitors and responds to CI status rolls, re-runs tests when needed.
  • Merge readiness: continuously assesses mergeability and applies rebase or conflict resolution as needed. Use case: when a PR stalls due to failing checks or lingering reviews, the skill guides the PR to merge-ready state.

Quick Start

Drive the PR to merge-ready state by addressing reviews and stabilizing CI.

Frequently Asked Questions about shepherd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate resolving GitHub pull request reviews and failing CI checks?

Automating GitHub pull request review resolution and CI stabilization involves running a convergence loop that fetches unanswered comments, applies code fixes, re-runs failing checks, and pushes updates until the PR reaches a merge-ready state.

What is the best way to drive a stalled pull request to merge-ready state?

The best way to drive a stalled pull request to merge-ready state is to apply a systematic governance loop that identifies lingering reviews, stabilizes failing CI, and rebases conflicts until the PR is fully mergeable.

Can I automatically fix unresolved code review comments on a GitHub PR?

You can automatically fix unresolved code review comments on a GitHub PR by using an automation loop that fetches unanswered reviews, applies the necessary code modifications, and pushes updates directly to the branch.

How does CI stabilization work for an open pull request?

CI stabilization for an open pull request works by continuously monitoring CI status rolls, automatically re-running failed tests, and pushing necessary updates until all checks pass and the PR becomes mergeable.

Do I need any specific dependencies to automate GitHub PR mergeability checks?

You do not need any specific external dependencies to automate GitHub PR mergeability checks, as the skill operates independently to fetch reviews, assess merge readiness, and apply conflict resolutions without requiring additional components.

Why does my pull request automation loop fail to resolve merge conflicts?

Pull request automation loops may fail to resolve merge conflicts if the convergence mechanism encounters complex divergence requiring manual intervention, though it is designed to automatically apply rebase and conflict resolution for merge readiness.