openclaw-pr-maintainer
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseOpenClaw PR Maintainer
OpenClaw PR 维护者
Use this skill for maintainer-facing GitHub workflow, not for ordinary code changes.
本技能适用于面向维护者的GitHub工作流,不适用于普通代码变更。
Apply close and triage labels correctly
正确应用关闭与分类标签
- If an issue or PR matches an auto-close reason, apply the label and let handle the comment/close/lock flow.
.github/workflows/auto-response.yml - Do not manually close plus manually comment for these reasons.
- labels can be used on both issues and PRs.
r:* - Current reasons:
r: skillr: supportr: no-ci-prr: too-many-prsr: testflightr: third-party-extensionr: moltbookr: spaminvalid- for PRs only
dirty
- 如果问题或PR符合自动关闭条件,应用对应标签,由处理评论/关闭/锁定流程。
.github/workflows/auto-response.yml - 请勿针对这些原因手动关闭并手动评论。
- 标签可同时用于问题和PR。
r:* - 当前可用的原因标签:
r: skillr: supportr: no-ci-prr: too-many-prsr: testflightr: third-party-extensionr: moltbookr: spaminvalid- (仅适用于PR)
dirty
Enforce the bug-fix evidence bar
严格执行bug修复的验证标准
- Never merge a bug-fix PR based only on issue text, PR text, or AI rationale.
- Before landing, require:
- symptom evidence such as a repro, logs, or a failing test
- a verified root cause in code with file/line
- a fix that touches the implicated code path
- a regression test when feasible, or explicit manual verification plus a reason no test was added
- If the claim is unsubstantiated or likely wrong, request evidence or changes instead of merging.
- If the linked issue appears outdated or incorrect, correct triage first. Do not merge a speculative fix.
- 绝不能仅基于问题描述、PR文本或AI推理就合并bug修复PR。
- 合并前必须满足以下要求:
- 症状证据,如重现步骤、日志或失败测试用例
- 代码中已验证的根因,需包含文件/行号
- 修复需触及相关代码路径
- 可行时添加回归测试,或明确说明未添加测试的原因并完成手动验证
- 如果声明无实质依据或可能有误,应要求提供证据或修改,而非直接合并。
- 如果关联的问题已过时或不正确,应先修正分类,切勿合并推测性修复。
Handle GitHub text safely
安全处理GitHub文本内容
- For issue comments and PR comments, use literal multiline strings or for real newlines. Never embed
-F - <<'EOF'.\n - Do not use when the body contains backticks or shell characters. Prefer a single-quoted heredoc.
gh issue/pr comment -b "..." - Do not wrap issue or PR refs like in backticks when you want auto-linking.
#24643 - PR landing comments should include clickable full commit links for landed and source SHAs when present.
- 撰写问题评论和PR评论时,使用字面多行字符串或来实现真实换行,切勿嵌入
-F - <<'EOF'。\n - 当内容包含反引号或Shell字符时,请勿使用,优先使用单引号 heredoc。
gh issue/pr comment -b "..." - 若要实现自动链接,请勿将这类问题或PR引用包裹在反引号中。
#24643 - PR合并评论应包含可点击的完整提交链接(若存在已合并和源提交的SHA)。
Search broadly before deciding
决策前进行全面搜索
- Prefer targeted keyword search before proposing new work or closing something as duplicate.
- Use with
--repo openclaw/openclawfirst.--match title,body - Add when triaging follow-up discussion.
--match comments - Do not stop at the first 500 results when the task requires a full search.
Examples:
bash
gh search prs --repo openclaw/openclaw --match title,body --limit 50 -- "auto-update"
gh search issues --repo openclaw/openclaw --match title,body --limit 50 -- "auto-update"
gh search issues --repo openclaw/openclaw --match title,body --limit 50 \
--json number,title,state,url,updatedAt -- "auto update" \
--jq '.[] | "\(.number) | \(.state) | \(.title) | \(.url)"'- 在提议新工作或标记重复内容前,优先使用精准关键词搜索。
- 首先使用搭配
--repo openclaw/openclaw进行搜索。--match title,body - 处理后续讨论分类时,添加参数。
--match comments - 当任务需要完整搜索时,不要仅查看前500条结果。
Examples:
bash
gh search prs --repo openclaw/openclaw --match title,body --limit 50 -- "auto-update"
gh search issues --repo openclaw/openclaw --match title,body --limit 50 -- "auto-update"
gh search issues --repo openclaw/openclaw --match title,body --limit 50 \
--json number,title,state,url,updatedAt -- "auto update" \
--jq '.[] | "\(.number) | \(.state) | \(.title) | \(.url)"'Follow PR review and landing hygiene
遵循PR评审与合并规范
- If bot review conversations exist on your PR, address them and resolve them yourself once fixed.
- Leave a review conversation unresolved only when reviewer or maintainer judgment is still needed.
- When landing or merging any PR, follow the global process.
/landpr - Use for scoped commits instead of manual
scripts/committer "<msg>" <file...>andgit add.git commit - Keep commit messages concise and action-oriented.
- Group related changes; avoid bundling unrelated refactors.
- Use for PR submissions and
.github/pull_request_template.mdfor issues..github/ISSUE_TEMPLATE/
- 如果你的PR上存在机器人评审对话,修复后需自行处理并标记为已解决。
- 仅当仍需评审者或维护者判断时,才保留未解决的评审对话。
- 合并任何PR时,遵循全局流程。
/landpr - 使用进行范围提交,而非手动执行
scripts/committer "<msg>" <file...>和git add。git commit - 提交信息应简洁且以行为导向。
- 相关变更应分组,避免捆绑无关的重构内容。
- PR提交使用,问题提交使用
.github/pull_request_template.md下的模板。.github/ISSUE_TEMPLATE/
Extra safety
额外安全注意事项
- If a close or reopen action would affect more than 5 PRs, ask for explicit confirmation with the exact count and target query first.
- means: if the tree is dirty, commit all changes with a sensible Conventional Commit message, then
sync, thengit pull --rebase. Stop if rebase conflicts cannot be resolved safely.git push
- 如果关闭或重新打开操作会影响5个以上PR,需先提供确切数量和目标查询,请求明确确认。
- 的含义:如果工作树存在未提交变更,使用合理的Conventional Commit消息提交所有变更,然后执行
sync,再执行git pull --rebase。如果无法安全解决变基冲突,应停止操作。git push