om-pr-autopilot

Extends the shared PR autopilot workflow with Open Mercato label taxonomy, QA gates, and diff-scope classification.

1.7k|382|Updated Sep 10, 2025
One-click install
npx skills add https://github.com/open-mercato/open-mercato --skill om-pr-autopilot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: om-pr-autopilot
Source: https://github.com/open-mercato/open-mercato/tree/main/.ai/skills/om-pr-autopilot
Command: npx skills add https://github.com/open-mercato/open-mercato --skill om-pr-autopilot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing pull requests in the Open Mercato repository requires repo-specific rules—label taxonomy, QA approval gates, diff-scope classification, and permission-aware claiming—that a generic PR automation skill cannot know. This extension layers those rules onto the shared om-pr-autopilot skill so automated PR triage, review, and merge decisions follow this repository's exact conventions.

Core Features & Use Cases

  • Diff-scope classification: Categorizes PR changes as spec-only, docs-only, UI-touching, migration/schema, or contract-surface, driving risk levels and review depth.
  • Label taxonomy and QA gate enforcement: Applies the repo's label rules, blocks merges when needs-qa lacks qa-approved, and treats qa-failed, blocked, and do-not-merge as hard stops.
  • Permission-aware claiming: Handles triage-permission 403 errors gracefully for outside-contributor accounts, degrading the claim to a comment and reporting intended labels to maintainers.
  • Use Case: An AI agent triaging an incoming PR classifies its diff as UI-touching, applies needs-qa, refuses to merge until qa-approved appears, and—if running as a contributor without triage rights—records the intended labels in a summary comment instead of failing.

Quick Start

Ask the agent to run the PR autopilot workflow on an open pull request in this repository, applying the Open Mercato label and QA gate rules.

Frequently Asked Questions about om-pr-autopilot

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

FAQPage Schema
How do I automate PR triage in the Open Mercato repository?

Use the shared om-pr-autopilot skill together with this repo-local extension, which adds Open Mercato's label taxonomy, QA gate, and diff-scope classification. Install missing companion skills with yarn install-skills before running the workflow.

What diff-scope categories does Open Mercato PR review use?

Pull requests are classified as spec-only, docs-only, UI-touching, migration/schema, or contract-surface. UI-touching changes trigger the needs-qa label, while contract-surface changes force risk-high and deeper review.

Can a PR merge with needs-qa but without qa-approved?

No. The QA-approval merge gate is hard: a PR carrying needs-qa without qa-approved must not merge even when everything else is green. The skip-qa label is the explicit opt-out and must never be combined with needs-qa or qa-approved.

What happens when the PR autopilot account lacks triage permissions?

When assign or label mutations return a 403, the claim degrades to a claim comment alone, and the intended label set is listed in a summary comment addressed to a maintainer. The failed mutation is never retried and labels are never reported as applied when they were not.

Why is the om-pr-autopilot skill missing references like diagnose.md?

The shared skill's references live under .agents/skills/om-pr-autopilot/ and are not committed to this repo. Run yarn install-skills to install them, and never improvise substitute procedures for claim, worktree, diagnosis, or setup mechanics.