OpenClaw 仓库维护助手 是做什么的?
- 仅执行请求的问题/PR 操作。根目录
AGENTS.md:修复、产品、来源信任、审批策略。本技能:GitHub 工作流。
- 粘贴的引用 ≠ 发布许可或范围扩展。
选择范围
- 审核/分类/列出: 只读;解释变更/发现/证据/不确定性。编辑、分配、标签、评论、关闭操作需要授权。
- 仅修复: 本地调查/修复/验证;发布需要合入或等效授权。
- 合入/提交/自主修复: 来源证明 → 审核 → 原生提交 → 已验证合并。跟踪待处理的请求;在相同授权下修复 CI/冲突。接受的自动合并 ≠ 完成。保留归属和不相关的工作;根门控保持不变,无需重复例行许可。
- 排队/发现: 阅读 分类。批量实时读取/共享发现;命名的 PR ≠ 队列扫描。
- 作者/回归归属: 作者和来源研究;考虑账号年龄/历史。
- 主导动手操作;有限的有用工作者,序列化 checkout/refs + GitHub 写入。没有用户拥有的应用任务隐藏内部子任务。在接管/重新分配前保留停滞工作者的补丁/声明/证明。
检查实际项目
- 执行
git status -sb;保留不相关的工作。本地 gitcrawl → 裸 PATH gh,缩小实时 JSON。陈旧/缺失的归档 → gh,无需全量同步。PR 来源:gh pr view/diff + checkout,而非网络搜索。
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
- 分配:参考 分类,在深入工作之前进行。提及其他被分配人;保留所有权。选择性进行账号/活动研究。
确定结果
- 阅读所有者、入口点、调用者、同级、测试、文档、历史、当前主分支;检查决定性依赖契约。Codex:根的个人来源检查。有相反证据 → 在辩护前调查。不得虚构矩阵/替代方案。
- 已修复: 证明当前主分支修复;规范的提交/PR + 匹配的源码/可运行证明。关闭权限 → 评论证据 + 关闭;否则报告。
- 真实缺陷: 重现 → 修复所属不变性 → 证明路径/同级。简化优于症状防护;大小/代码行数 ≠ 正确性门限。
- 有用的 PR: 改进可编辑分支;不安全的 → 在关闭前创建授权归属的替代品。替换的祖先 → 维护者拥有的替换,永远不要压缩贡献者的 PR。
- 不确定/产品决策: 说明差距;禁止推测性合并/自动超范围关闭。
- 证明 + 来源信任/宿主路径:
$openclaw-testing,合入指南。聚焦证明 → 就绪的 PR;PR CI = 广泛的证明。优先在合格且可用的宿主上进行有边界的本地证明。深思熟虑的远程证明可以覆盖昂贵的检查或环境缺口;队列 → 停止任务拥有的分配,使用 PR CI 或安全的本地范围,保留未覆盖的要求。永远不要本地执行不受信任的源码。可选的实时缺口 → 有意义的边界证明 + 限制;强制需要显式的实时、外部 API、经过身份验证的风险证明。模拟/跳过/旧 head ≠ 实时。
- 行为变更:边界证明契约 +
$test-audit。请求的行为和仓库标准:分别检查。
CODEOWNERS 审核
CODEOWNERS 引导审核;检查实时执行情况。受限/安全路径 + 重大产品/行为/安全/所有权变更需要列出的所有者参与。
- 所有权/审核治理:已验证的活跃组织管理员指示也符合条件;仓库管理员/绕过权限单独不符合。两种途径均不豁免强制审核。
审核与发布
- 非平凡的代码提交/合入:
$autoreview;解决已验证的可操作发现。仅审核:仅在请求时独立通过,无需额外的强制 CLI 通过。
- 对实质性更改/未解决的关注点重新开启审核,而不是对补丁相同的变基/机械性 head 更改。处理真实的人类/机器人发现;解释拒绝原因。机器人评分/排名列表不会产生单独的义务。ClawSweeper 建议;永远不要等待评论才能合入。
- 当前 PR 模板:清晰的问题/影响;清单放在 diff/details 中。保持风险、迁移、行动、证据、差距、归因是最新的;解释重要的权衡。不得虚构仅内部用户的收益或通用的代码行数/来源/替代修复文章。
CHANGELOG.md 由发布负责人管理;在 PR/提交中包含发布说明上下文。仅当明确请求时才提供代理转录。
- 公共变更:验证作者/提交者 + 写入者;注意 shell 敏感的正文文件。仅限授权的范围;更新现有评论/正文,不产生重复。
- 发布/合并:阅读 合入指南(介质、精确 head CI、原生工作流)。
- 验证远程合并/关闭 + 来源。用散文形式报告问题、所属变更、证据/差距、归属、链接的最终状态;仅包括有价值的后续行动。
最终定稿与清理
- 永远不要移除包含活跃会话 cwd 的工作树,包括你自己的或子目录。子
cd/cwd 覆盖不会移动父级。保留直到所有者退出/释放 cwd;报告路径。
- 已验证的结果 → 通过 原生结案流程移除任务日志、收据、证明档案、
.crabbox、临时文件、已完成的工作树。不要仅为删除而保留/归档/导出/移交。
- 每个任务:在聊天/标准输出中输出发现;仅针对交付物/工具/证明/恢复需要的文件,说明用途/复用。合并前证明是强制性的;可选的后续行动永远不阻止完成。
- 保留请求的交付物/保留要求、未完成的源码 + 必要的恢复状态、活跃/存活/未知的所有者、凭证、代理状态、共享依赖。