AGENT SKILL

merge-on-green

merge, ci, github, forgejo, exact-head, polling, safety

License 许可
BSD-3-Clause
所属仓库
lost-rob0t/skills
最近更新
2026-11-14
Stars
★ 0
Forks
0

01 前言 Front Matter

name
merge-on-green
description
merge, ci, github, forgejo, exact-head, polling, safety
compatibility
Git repository with gh or Forgejo API access (FORGEJO_TOKEN)

02 资源文件 1

03 SKILL.md 正文

Merge On Green

Goal

Merge only the exact pull-request head whose required gates and reviews were verified.

Workflow

Run scripts/merge-on-green <pr-number> from a checkout of the repository. The provider is detected from the origin remote: GitHub uses the gh CLI; Forgejo uses its REST API with FORGEJO_TOKEN. Override detection with --provider github|forgejo and pass --repo owner/name when the remote is ambiguous.

The helper records the PR head SHA, polls gate state with bounded exponential backoff, and honors Retry-After. Pending, cancelled, failed, conflicting, draft, closed, missing-review, and rate-limited states are reported and bounded; it never busy-loops.

Exact-head invariant

Immediately before merging it re-probes the head. If the head differs from the validated head, all green evidence is invalidated and validation restarts for the new SHA. The merged commit is always the verified commit.

Rules

  • Never equate an old-SHA green result with current green.
  • Never duplicate a PR across providers.
  • Forgejo review policies requiring team or stale-review evaluation fail closed.
  • Exit codes: 0 merged, 2 configuration, 3 provider failure, 4 blocked/timeout/head churn, 5 rate-limited beyond budget.
  • Use --dry-run to verify eligibility without merging.
  • On timeout or ambiguity, stop without merging and report the blocker.

04 同仓库更多 Skills