Agent Skills › openclaw/openclaw › openclaw-pr-maintainer

openclaw-pr-maintainer

GitHub

OpenClaw项目的PR维护技能,涵盖Issue/PR审查、分流、修复及合并。基于当前源码证据执行GitHub工作流,明确维护者权限与操作边界,确保代码质量与发布安全。

.agents/skills/openclaw-pr-maintainer/SKILL.md openclaw/openclaw

触发场景

需要审查或处理OpenClaw的Pull Request 需要调查、修复或关闭GitHub Issue 涉及OpenClaw仓库的CI冲突解决或自动合并验证

安装

npx skills add openclaw/openclaw --skill openclaw-pr-maintainer -g -y
更多选项

非标准路径

npx skills add https://github.com/openclaw/openclaw/tree/main/.agents/skills/openclaw-pr-maintainer -g -y

不安装直接使用

npx skills use openclaw/openclaw@openclaw-pr-maintainer

指定 Agent (Claude Code)

npx skills add openclaw/openclaw --skill openclaw-pr-maintainer -a claude-code -g -y

安装 repo 全部 skill

npx skills add openclaw/openclaw --all -g -y

预览 repo 内 skill

npx skills add openclaw/openclaw --list

SKILL.md

Frontmatter
{
    "name": "openclaw-pr-maintainer",
    "description": "Review, triage, repair, or land OpenClaw issues and pull requests with current-source evidence and the native maintainer workflow."
}

OpenClaw PR Maintainer

  • Requested issue/PR operation only. Root AGENTS.md: repair, product, source-trust, approval policy. This skill: GitHub workflow and maintainer authority.
  • Pasted ref ≠ publication permission or scope expansion.

Maintainer authority

  • Red main is an emergency. Push proven red-main fixes directly to main; inherited-only reds land via native admin exception, named in PR (policy).
  • Repair-and-land authority covers internal scheduling, database admission, lifecycle design, risk, verification. In-task bug fixes (including compatible SDK fixes) and backed-up repairs removing only invalid or unreachable data need no renewed approval.
  • Bulk close/reopen above 50 items needs explicit count and scope.
  • Advisory workflows need explicit security request.
  • Peter-instructed Team updates use the release deployer; never edit live state outside its owner. Notify Night Watch of every deploy/restart; it coordinates restart timing, not update approval.

Select the scope

  • Review/triage/list: read-only; explain change/findings/proof/uncertainty. Edits, assignment, labels, comments, closes need authority.
  • Fix only: investigate/repair/validate locally; publication needs ship/land or scoped equivalent.
  • Land/ship/autonomous repair: source proof → review → native submission → verified merge. Track pending requests; repair CI/conflicts under same authority. Accepted auto-merge ≠ done. Preserve credit/unrelated work; root gates remain, no repeat routine permission.
  • Queue/discovery: read triage. Batch live reads/shared discovery; named PR ≠ queue sweep.
  • Author/regression attribution: author and provenance research; account age/history conditional.
  • Lead hands-on; bounded useful workers, serialized checkout/refs + GitHub writes. No user-owned app tasks hiding internal subtasks. Preserve stalled worker patches/claims/proof before takeover/reassignment.

Inspect the actual item

  • Start git status -sb; preserve unrelated work. Local gitcrawl → bare PATH gh, narrow live JSON. Stale/missing archive → gh, no broad sync. PR source: gh pr view/diff + checkout, not web search.
gh pr view <pr> --repo openclaw/openclaw \
  --json number,title,state,body,author,assignees,baseRefName,headRefName,headRefOid,files,comments,reviews
gh issue view <issue> --repo openclaw/openclaw \
  --json number,title,state,body,author,assignees,comments
  • Assignment: triage, before deep work. Mention other assignees; preserve ownership. Account/activity research conditional.

Establish the outcome

  • Read owner, entry points, callers, siblings, tests, docs, history, current main; inspect determining dependency contracts. Codex: root's personal source inspection. Contrary evidence → investigate before defending. No invented matrix/alternative.
  • Already fixed: prove current-main repair; canonical commit/PR + matching source/runnable proof. Closure authority → comment evidence + close; otherwise report.
  • Real defect: reproduce → repair owning invariant → prove path/siblings. Simplification over symptom guard; size/LOC ≠ correctness gate.
  • Useful PR: improve editable branch; unsafe → authorized credited replacement before closure. Replaced ancestry → maintainer-owned replacement, never squash contributor PR.
  • Uncertain/product decision: state gap; no speculative merge/automatic out-of-scope close.
  • Proof + source-trust/host route: $openclaw-testing, landing. Focused proof → ready PR; PR CI = broad proof. Prefer bounded local proof on a qualified, available host. Deliberate remote proof can cover expensive checks or environment gaps; queues → stop task-owned allocation, use PR CI or a safe local scope, preserve uncovered requirements. Never execute untrusted source locally. Optional live gaps → meaningful boundary proof + limitation; explicit live, external API, authenticated-risk proof mandatory. Mocks/skips/old head ≠ live.
  • Behavioral changes: boundary-proof contract + $test-audit. Requested behavior and repo standards: check separately.

CODEOWNERS review

  • CODEOWNERS routes review; inspect live enforcement. Restricted/security paths + material product/behavior/security/ownership changes need listed-owner involvement.
  • ownership/review governance: verified active organization-admin direction also qualifies; repository admin/bypass alone does not. Neither route waives enforced reviews.

Review and publish

  • Before committing or landing nontrivial code: fresh review through permitted workflow; resolve actionable findings unless user opts out. Actionable = likely or high-impact; decline unlikely, recoverable edge cases whose fix adds disproportionate complexity, with one-line reason.

  • Nontrivial code commit/landing: $autoreview; resolve verified actionable findings. Review-only: independent pass only when requested, no extra mandatory CLI pass.

  • Reopen review for substantive changes/unresolved concerns, not patch-identical rebase/mechanical head change. Address real human/bot findings; explain rejections. Bot scores/Rank-up lists create no separate obligations. ClawSweeper advisory; never wait for comment to land.

  • Current PR template: plain problem/impact; inventories in diff/details. Keep risks, migrations, actions, proof, gaps, credit current; explain material tradeoffs. No invented internal-only user benefit or universal LOC/provenance/alternate-fix essays.

  • CHANGELOG.md release-owned; release-note context in PR/commit. Agent transcripts only on explicit request.

  • Public mutation: verify author/committer + writer; shell-sensitive body files. Authorized scope only; update existing comment/body, no duplicates.

  • Publication/merge: read landing (media, exact-head CI, native workflow).

  • Verify remote merge/closure + source. Report problem, owning change, proof/gaps, credit, linked final state in prose; worthwhile follow-ups only.

Finalize and clean up

  • Never remove worktree holding live session cwd, including yours or subdirectories. Child cd/cwd override does not move parent. Retain until owner exits/releases cwd; report path.
  • Verified outcome → remove task logs, receipts, proof archives, .crabbox, scratch, finished worktrees via native closeout. No retention/archive/export/handoff just for removal.
  • Remove created worktrees once work/PR lands, unless immediately needed next; never remove a live-cwd worktree.
  • Every task: findings in chat/stdout; files only for deliverables/tool/proof/recovery needs, state purpose/reuse. Pre-merge proof mandatory; optional follow-ups never hold completion.
  • Preserve requested deliverables/retention, unfinished source + necessary recovery state, active/live/unknown owners, credentials, agent state, shared dependencies.

版本历史

  • 8b78b23 当前 2026-10-20 00:20

    将根AGENTS.md压缩至20K限制以适配启动引导;新增修复需附带测试用例要求及错误前提检查规则;移除对话风格等非仓库规则。

  • 8e18591 2026-09-23 04:22

    优化了 PR 描述规范,改进了对 GitHub 自动合并状态的追踪,简化了维护者技能配置并同步了共享工具。

  • 3374458 2026-08-20 13:29

同 Skill 集合

.agents/skills/agent-transcript/SKILL.md
.agents/skills/auto-qa/SKILL.md
.agents/skills/autoreview/SKILL.md
.agents/skills/channel-message-flows/SKILL.md
.agents/skills/claw-score/SKILL.md
.agents/skills/clawdtributor/SKILL.md
.agents/skills/clawsweeper/SKILL.md
.agents/skills/control-ui-e2e/SKILL.md
.agents/skills/crabbox/SKILL.md
.agents/skills/deslop/SKILL.md
.agents/skills/discord-clawd/SKILL.md
.agents/skills/discord-e2e/SKILL.md
.agents/skills/discord-user-post/SKILL.md
.agents/skills/discrawl/SKILL.md
.agents/skills/gitcrawl/SKILL.md
.agents/skills/graincrawl/SKILL.md
.agents/skills/notcrawl/SKILL.md
.agents/skills/openclaw-changelog-update/SKILL.md
.agents/skills/openclaw-ci-limits/SKILL.md
.agents/skills/openclaw-debugging/SKILL.md
.agents/skills/openclaw-docker-e2e-authoring/SKILL.md
.agents/skills/openclaw-ghsa-maintainer/SKILL.md
.agents/skills/openclaw-live-updater/SKILL.md
.agents/skills/openclaw-parallels-smoke/SKILL.md
.agents/skills/openclaw-performance/SKILL.md
.agents/skills/openclaw-qa-testing/SKILL.md
.agents/skills/openclaw-refactor-docs/SKILL.md
.agents/skills/openclaw-release-validation/SKILL.md
.agents/skills/openclaw-repair-sweep/SKILL.md
.agents/skills/openclaw-secret-scanning-maintainer/SKILL.md
.agents/skills/openclaw-test-heap-leaks/SKILL.md
.agents/skills/openclaw-test-performance/SKILL.md
.agents/skills/openclaw-testing/SKILL.md
.agents/skills/openclaw-update/SKILL.md
.agents/skills/parallels-discord-roundtrip/SKILL.md
.agents/skills/plugin-sdk-impact/SKILL.md
.agents/skills/pr-simplify/SKILL.md
.agents/skills/proof-video/SKILL.md
.agents/skills/prototype-openclaw-tui/SKILL.md
.agents/skills/release-openclaw-announcement/SKILL.md
.agents/skills/release-openclaw-ci/SKILL.md
.agents/skills/release-openclaw-mac/SKILL.md
.agents/skills/release-openclaw-maintainer/SKILL.md
.agents/skills/release-openclaw-nightly/SKILL.md
.agents/skills/release-openclaw-plugin-testing/SKILL.md
.agents/skills/security-triage/SKILL.md
.agents/skills/slack-e2e/SKILL.md
.agents/skills/slacrawl/SKILL.md
.agents/skills/solid/SKILL.md

元信息

文件数
0
版本
8b78b23
Hash
eb4eabaa
收录时间
2026-08-20 13:29

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-21 16:36
浙ICP备14020137号-1