openclaw-small-bugfix-sweep

OpenClaw 小型 Bug 修复扫尾

用于处理粘贴的 OpenClaw issue/PR 引用的批处理工作流。用户的顶层 对话仅负责协调，是父级；其有界协作子 Agent 负责动手执行。父级协调它们， 并报告已验证的结果。仅在获得授权后，工作者才能发布或合并。

协调者/工作者的强制边界

• 父级只负责分配 issue/PR 负责人和独立验证工作者， 协调共享检出目录/文件的所有权和修改时段，跟踪证据 与授权关卡，处理真正需要负责人决定的事项，并报告结果。
• 父级绝不直接发现或检查项目；读取受影响的源代码、 依赖项或同级 ../codex；诊断、编辑、复现或测试； 执行 Git/GitHub 操作；评论、关闭、提交、推送、监控 CI、 准备或合并。将每个操作步骤都委派给协作子 Agent。
• 为每个项目或重复问题/根因组指定一名职责范围明确的工作者负责。另行 指定工作者负责独立的关闭/合并验证；必要时也可指定工作者负责发现、 源代码历史、依赖契约、同级路径、回归证明和 CI 跟进。项目工作者只有在 根级明确授权特定助手，并跟踪其范围、所有权、容量和完成情况后，才能 派生助手；项目负责人仍须亲自执行，并在采取行动前亲自检查重要证据。
• 在任务分配中明确每名工作者的执行/验证职责、负责的项目、文件/检出目录 所有权、修改权限及报告义务。阅读此技能的受委派工作者应亲自完成 分配给自己的工作；不能将自己误认为仅负责协调的父级，也不能递归地 将整个任务再委派出去。
• 并行实现前，为工作者分配互不重叠的可写文件/检出目录。 对共享检出目录、引用/分支变更、重叠文件写入、提交、推送、GitHub 修改 和合并进行串行处理。其他工作者运行测试时，不要编辑共享检出目录。 未经用户明确授权，绝不创建新的工作树；明确要求全权无人值守或执行合并时， 即授权使用仓库管理的 PR 工作树以及必要的、由任务专属的隔离工作树。绝不 暂存、储藏、丢弃或覆盖无关的脏改动。
• 根据可用的 Agent 槽位（包括父级）以及主机/验证能力限制工作者并发数。 替换失败或中断的工作者前，保留其认领的项目、补丁、检出目录所有权和证据； 明确将这些交接给一名替代者，不得重复处理或丢弃未完成的工作。
• 执行前先对源代码的可信度分类。绝不在本地运行不可信的贡献者代码、 脚本、配置、钩子、测试或包装程序；应使用仓库的净化远程验证路径。 除非适用文档所述的可信后端回退方案，否则将繁重的可信验证交由选定的远程主机执行。
• 对于由 Codex 支持的行为，每名作出技术判定或采取相关行动的工作者， 都必须先亲自检查准确的同级 ../codex 源代码，并引用检查过的文件/行。 父级可以转述工作者的发现，但不得将其他 Agent 的检查结果说成自己的判定。
• 持续指派工作者，直到完成复现、修复、独立验证、针对确切提交的 CI、 获授权的关闭/合并以及已验证的最终状态。检查仍在等待或修改已提交， 都不算完成；应委派后续跟进。

这是 openclaw-autonomous-issue-sweep 使用的协作子 Agent 模型，并非邀请你创建 由用户负责的 Codex 应用任务，也不是让你在父级对话中执行扫尾工作。

范围与授权门禁

将本次排查限定为小范围、高确定性的根因修复。如果正确方案是在职责边界内进行逻辑连贯的清理或重构，则不要以变通方案替代；如果该修复超出明确要求的排查范围，应升级处理。

获得修复授权后的默认流程：

1. 深入审查每个问题，直至足以证明当前行为和根因。
2. 仅修复高置信度问题，并且其按职责边界实施的修复必须符合本次小范围排查的范围。
3. 未获得明确的发布或合入授权时，应停止操作，并提供未提交差异摘要、涉及文件和测试/门禁输出，供维护者复核。
4. 获得发布授权后，每个已接受的修复分别提交一次；面向用户的发布说明上下文应放入 PR 正文或提交消息中。绝不编辑仅供发布使用的 CHANGELOG.md。
5. 针对目标进行同步：目标为 main 时，必须基于最新 origin/main 变基，不得使用合并提交；PR 应遵循原生合入门禁，且仅在实际发生冲突、门禁或精确头部检查失败、用户明确要求，或有证据表明基线存在实质性陈旧风险时刷新/变基，绝不能仅因 main 有更新就执行。应推送、发表评论并提供证明，且仅关闭已授权、已修复或已明确分流为关闭的问题。

明确要求自主处理或解决指定的问题/PR 批次， 或要求修复并合入，即授权被指派的工作者执行范围内的 根因修复、提交、推送、PR 更新、附带证明的评论、有证据支持且 已在当前 main 上修复的关闭操作，以及解决这些 指定条目所需的精确头部合入。仅要求修复的请求允许本地修改和提供证明，但不允许发布 或合入；仅进行审查、分流或列出清单属于只读操作。绝不要将无关修复 批量合并到一个提交中、修改无关条目、超出所请求的排查范围， 或绕过负责人、安全、信任、授权或证明门禁。不要臆造 额外的个人复核门禁。

明确授予完全权限并允许无人值守执行，即视为对被指派 工作者的长期授权，使其完成所有有证据支持且属于任务范围的调查、修复、 保留贡献者署名的 PR 重写/替换、附带证明的评论、CI 诊断/修复/重新运行、 归属该任务的发布操作/工作树、经证实基于当前 main 的关闭操作、按要求进行的 原生合入，以及最终远程验证。无需询问无法联系的用户，即可作出常规决策； 安全地从临时故障和锁中恢复。保留无关编辑，维护精确头部所要求的 CI 和来源可信性， 由实际执行工作者直接使用 Codex 检查，保留贡献者署名，遵守安全/负责人 门禁；对于超过 50 个关闭操作，须另行按准确数量和范围取得批准。 只有在用户明确允许省略无法获取的可选提供商/渠道 实时证明时，才可以用聚焦的责任边界回归测试失败/通过结果、来自 生产者/调用者/同级项/依赖项的直接证据、独立复核和精确头部 CI 全绿作为替代；并披露缺失的实时/排名提升证明。对于 外部 API、安全敏感、风险要求或用户明确请求的实时证明，绝不可豁免 强制性要求。仅报告确实存在的凭据、能力或明确安全 阻塞，不要等待用户。

配套技能

先使用 $gitcrawl，使用 $openclaw-pr-maintainer 进行 GitHub 实时维护，采用 $github-deep-review 的审查方式进行源追踪，并使用 $openclaw-testing 产出验证证据。

循环

对于每个 ref，指定的执行者执行操作循环；父级仅协调其进度并接收证据：

1. 使用 gh 读取实时目标。
2. 使用 gitcrawl 检查相关、重复、已关闭或已修复的讨论串。
3. 在相关时，读取正文、评论、关联的 refs、变更文件、当前代码、相邻测试和依赖契约。
4. 追踪真实运行时路径。
5. 如果当前 main 已修复所述缺陷，请提供当前源码/测试以及规范提交/PR 的证明。将其归类为 fixed-on-main；附上证明进行评论，且仅在获得授权后关闭。
6. 对于确认仍开放的问题，在所属模块中修复被违反的不变量；当小规模且连贯的清理/重构是最干净的根本原因修复方案时，将其纳入。
7. 对于 PR，独立验证缺陷、所属边界修复、同类路径以及精确 head 检查。获得修复/合入授权时，重写不充分且可编辑的 PR；否则报告所需修正。
8. 在切实可行时，为本地问题修复或 PR 就绪检查添加聚焦的回归证明。
9. 运行最小且有意义的门禁。
10. 持续执行，直到每个已粘贴的 ref 均已修复、已有证据证明已解决、已合入，或已归类并附有具体阻塞原因。

独立执行者会质疑拟议的 fixed-on-main 关闭结论以及复杂的修复/合入证明， 然后由获得授权的条目所有者执行最终变更。缺少共识、适用的源码/依赖证明、 精确 head CI、信任路由、所有权批准或授权中的任一项，都是具体阻塞项， 而不能作为父级接管工作的许可。

跳过条件

• 不是缺陷
• 配置/文档/工作流/发布/支持/依赖/产品工作
• 无法确定复现过程或根本原因
• 正确且连贯的根本原因修复超出明确要求的局部扫描范围；应归类为 needs-human 或记录具体的跟进事项，而不是合入变通方案
• 凭猜测推断依赖行为
• 无法提供聚焦证明

跳过时给出简短理由。不要用低置信度修复加以填充。

修复规则

• 优先处理所属模块；仅在必要时采用通用接缝
• 沿用现有模式、辅助函数和类型
• 在所属边界内进行连贯的清理/重构；不做无关的顺手重构
• 优先使生产代码 LOC 的净变化为零或为负；测试代码单独计数，并添加有用的回归覆盖
• 将测试置于故障代码附近
• 文档仅涵盖已变更的公开行为
• 审查/仅验证工作期间不得提交
• 获得交付授权时，每个已接受的修复使用一个提交；在 PR 正文或提交消息中记录面向用户的发布说明上下文，绝不写入 CHANGELOG.md
• 未经相应操作授权，不得 push/create PR/comment/close/label/land/merge

PR 规则

• ready-to-merge：根本原因修复干净，当前 head 已验证，且所需的精确 head 检查均为绿色；仅在获得合并授权时使用仓库原生合入工作流
• needs-ci：证明可靠，但所需的精确 head 检查仍在等待或不可用；对于已授权的合入请求，应监控这些检查，若通过则完成合入，否则报告具体的外部阻塞项
• needs-fixup：获得授权时修复/重写可编辑的 PR；否则列出具体的文件/测试及缺少的授权
• skip：已过时、推测性、明确不在范围内，或需要无法获得的产品/安全/发布批准
• 如果有用的原始 PR 不安全或无法编辑，仅在明确授权后创建替代 PR；保留贡献者署名，并且仅在替代 PR 存在后才关闭原始 PR

输出格式

台账：fixed-local、fixed-on-main、closed-fixed-on-main、ready-to-merge、needs-fixup、needs-ci、landed、skipped、needs-human。 跟踪每个条目的指定执行者、独立验证者、负责的文件/检出内容、证据、 精确 head、授权和终态。 最终：经执行者验证的本地修复或已合入修复、已有证据证明已修复的条目、 生产/测试代码 LOC 变化、测试/门禁，以及具体阻塞项或跳过原因。