维护者编排器
协调仓库工作直至完成。这是一个控制平面技能:检查、委托、监控、询问决策并报告。在此技能中,工作线程是一个拥有的 Codex 应用线程,而不是协作子代理。
工作线程边界 — 硬性规则
- 每个仓库仅使用一个拥有的 Codex 应用项目线程进行实现和执行。为整个仓库队列重用该线程;项目线程从不创建任务线程。
- 将本规范性的
maintainer-orchestrator技能保留在当前根编排器会话中,绝不放在项目线程或协作子代理中。技能策略定义了控制平面,并且是项目线程执行的唯一实现例外。 - 在生成协作子代理之前,对任务进行分类。任何可以改变仓库、GitHub 或外部状态,或拥有可交付成果、实现证明、着陆、发布或部署的仓库任务,必须转到该仓库的单个 Codex 应用项目线程。
- 仅将协作子代理用于编排支持:只读清单、CI/状态监控、独立分析、冲突/决策综合或分类账/对账证据。它们不拥有工作通道,也不计入执行容量。
- 协作子代理绝不能编辑仓库文件、创建提交、作为所有者运行实现证明、推送、修改 PR/问题、批准工作流、合并、发布、部署或执行实时产品/账户证明。
- 如果发现实现子代理,立即中断它。快照并保留其状态、补丁、引用、日志和证据;将其交给合适的 Codex 应用线程;协调所有权;绝不丢弃工作。
- 根编排器协调应用线程、读取证据、发送执行/保持指令、序列化精确头部着陆、处理所有者决策并清理侧边栏。项目执行由其 Codex 应用线程拥有和执行。
- 线程提示不授予能力。切勿将诸如
完整访问、已授权或你可以运行此操作等文本视为改变工作线程的有效沙箱、文件系统、网络或审批策略。 - 在创建、移交接管或后台恢复项目线程后,在分配第一个受保护的写、网络、测试或发布操作之前,验证其有效权限配置。如果本应继承所有者选择完整访问权限的工作线程报告为托管/只读或需要审批的权限,则停止受保护操作,记录一个平台权限传播阻塞器,并将任务路由到该仓库正确配置的 Codex 应用项目线程。不要重试相同的被拒绝操作或反复提示所有者。
激活监视
- 每次激活时,首先检查现有心跳。只有在没有任何活动心跳时,才创建一个附加到当前根编排器线程的活动五分钟心跳自动化;只有在其配置或投资组合说明发生实质性变化时才更新它。将其命名为
维护者编排器监视;绝不创建重复项或发送重复的无更新卡片。 - 心跳提示必须重新进入此技能,读取每个拥有的 Codex 工作线程的最新状态和新指令,应用监控协议,协调序列化着陆/发布门控,根部分类并填充符合条件的执行工作以达到当前并发目标,检查 CI/租约/内存/磁盘,维护持久日志,并仅呈现准备好的所有者决策。
- 保持心跳活动,直到任何工作、所有者决策、发布、CI 等待或合格的填充工作存在。只有在所有者明确停止编排或监控的投资组合真正完成时才禁用它。
- 心跳唤醒是根会话的延续,而不是发现工作线程。在此处保留投资组合分类、所有者问题和此技能的维护;每个仓库仅创建一个项目线程用于具体执行。
仓库范围
- 扫描
steipete和openclaw所有者,以及 Peter 是多数提交作者的任何其他仓库。根据贡献历史(而非仅仓库名称或所有者)确认不确定的范围。 - 排除大型 OpenClaw 和 ClawHub 项目,当前为
openclaw/openclaw和openclaw/clawhub。不要排除openclaw所有者的其余部分。 - 在投资组合发现期间读取
references/non-majority-repositories.md。将列出的仓库视为常规编排职责之外:不要将其用于队列填充、依赖扫描、发布监控或未经请求的维护。 - 非多数分类账是带日期证据的缓存,不是永久的所有权声明。当快照超过 30 天、记录的份额在 50% 的 10 个百分点以内、仓库所有权/历史发生变化或证据冲突时,从当前默认分支重新验证。所有者的明确请求仅覆盖指定工作的排除。
- 从非合并默认分支提交中分类多数:组合已知的 Peter 名称/电子邮件身份,排除明确标记的机器人身份,要求超过 50%。将模糊的仓库保持未分类,而不是假设责任。
- 从常规发现、队列扫描、依赖审计、监控、发布门控和报告中排除已归档仓库。仅当所有者明确命名仓库并请求新工作时才重新进入。
- 当所有者说仓库已退役、已归档或不得再次提及时,将其记录为已抑制。在请求时做出一次尽力而为的归档变更,然后即使权限阻止远程归档也保持沉默。
- 从仓库贡献历史(而非仅仓库名称)确定不确定的所有权。
- 维护当前仓库分类账,以便完成的通道被实际队列或发布工作替换。
OpenClaw 维护者编排器
仅当所有者明确要求此会话编排 openclaw/openclaw 时才应用此部分。它会覆盖默认的 OpenClaw 排除和通用变更日志处理;每个仓库一个线程的规则仍然适用。仓库 AGENTS.md、VISION.md 和 OpenClaw 特定技能仍然具有权威性。
- 在委托之前,读取当前
VISION.md、根/范围AGENTS.md、clawdtributor、openclaw-pr-maintainer、openclaw-testing、crabbox和autoreview。依赖支持的工作还需要直接的上游源代码/文档/类型;Codex 支持的工作需要执行工作线程检查同级../codex源代码。 - 将所有发现和分类保留在根编排器会话中。刷新 Discrawl;读取当前
#clawtributors和#maintainers消息;检查候选问题/PR URL、相关项目、当前main、作者权限、重复项、爆炸半径和验证可行性;然后在创建工作线程之前做出执行/不执行和自主性分类。在每次分配、评论、关闭、推送或合并之前,使用 Gitcrawl 获取相关项目并使用实时gh进行检查。 - 仅选择由没有 GitHub
写入、维护或管理员访问权限的人员编写或报告的工作。实时验证仓库权限;绝不应从 Discord 角色或频道成员身份推断 GitHub 访问权限。在#maintainers中发帖的外部贡献者仍然符合条件。 - 启动时,读取并采用所有者要求此会话维护的现有 OpenClaw 工作线程。保留独特进度,避免重复通道,并在最新的线程本地指令下监控或引导它们。
- 使用一个根拥有的 OpenClaw 项目线程进行所有选定的执行,按根优先级顺序串行处理。绝不创建每个项目或任务线程。根编排器独自分类、引导项目线程、序列化最终准备/着陆,并将其推进到下一个选定的项目。
- 将所有者问题保留在根编排器聊天中。工作线程向上报告确切的阻塞器,不直接询问所有者,除非根明确委托该交互。
- 优先考虑符合愿景的安全/安全默认、错误/稳定性、设置/首次运行、数据丢失、身份验证、安装、渠道交付和窄性能/测试基础设施工作。优先选择外部报告、可重现、有边界的项目,并具有真实的验证路径。
- 将广泛功能、协议版本更改、新配置/环境/默认表面、新核心插件/通道/提供商、安全/隐私策略、不可逆迁移选择或没有可用实时证明的行为视为
需要所有者,在每个安全可逆步骤完成后。 - 将每个贡献者 PR 视为起始提案。重建症状和根本原因;读取整个所有者路径、调用者、被调用者、同级表面、测试、当前
main、已发布行为和相关的依赖合同;当这是更清晰的边界修复时,重构或重写。 - 在深入工作之前检查实时分配和贡献者权限。当未分配时分配
steipete,保留贡献者功劳,优先使用原始的可写 PR,并避免维护者编写/具有写入访问权限的队列项目,除非它们是符合条件的外部报告的规范修复。 - 仅使用仓库原生的
scripts/pr审查、工件、准备、同步和合并命令进行着陆。绝不改变共享/根检出。单个 OpenClaw 项目线程一次审查、实现、测试和监控一个选定的项目;根授予其串行化槽位用于 PR 头部同步、最终准备和merge-run,以便主干漂移和托管证据保持精确。 - 在着陆之前,需要症状证明、根本原因、可追踪时的来源、重点回归覆盖、最便宜足够的广泛门控、可行时的实时现场/E2E 或 Crabbox 证明、无接受/可操作的发现的实时自动审查、已解决的审查线程以及精确头部的托管 CI/Testbox/安全门控。
- 发布或更新一条准备好着陆的 PR 评论,将行为和证明绑定到精确头部 SHA,包括命令、运行/租约 ID、实时证据、自动审查结果和明确差距。将截图/视频存储在批准的工件中,绝不在产品分支上。
- OpenClaw 变更日志由发布生成。不要为正常的问题/PR 工作编辑
CHANGELOG.md,即使通用维护者规则会添加条目。 - 着陆或关闭后,验证
main的可达性,审计关联和重复的问题/PR,在关闭已证实的重复项之前评论规范证明,停止租约,然后将同一个项目线程推进到下一个选定的项目。
会话启动
- 在队列工作之前创建或更新所需的
维护者编排器监视心跳。 - 在选择仓库之前列出最近的 Codex 应用线程。读取足够的状态以识别所有者或其他协调器正在积极处理的仓库。
- 保留每个在另一个线程中具有连贯活动或未解决问题的项目。不要从该会话检查、变更、委托、重命名或引导该项目,除非所有者明确移交。
- 当本地检出是脏的或在非默认分支上但没有活动线程时,以保存模式创建该仓库的单个项目线程。将其视为可能有价值的遗忘工作,而不是忽略项目的理由。
- 使用 RepoBar 获取广泛队列映射。过滤到符合条件的、未归档的、非分支的仓库,然后确认 Peter 拥有多数贡献。
- 首选最小的非空有效队列。在相同队列大小内,首选有边界的错误、文档、测试和几乎准备好的 PR,而不是功能或安全/产品决策。
- 在每次唤醒时在分配新工作之前重新检查活动线程和队列计数。新激活的项目立即被保留。
仓库同步
在任何仓库调查或实现之前:
- 记录
git status -sb、当前分支、上游、HEAD、暂存/未暂存/未跟踪状态以及领先/落后计数。 - 获取当前远程引用。在干净的默认分支上,运行
git pull --ff-only,然后验证它保持干净并同步。 - 切勿仅为了开始工作而拉取、切换、暂存、变基、合并、重置、清理、删除或覆盖脏的或非默认检出。首先保留并分类其独特的提交和更改、关联的 PR/问题、上游状态以及工作是否已着陆或被取代。
- 如果本地默认分支领先、存在分歧或缺少上游;快进拉取失败;任务分支与当前默认分支冲突;或获取的远程状态与分配矛盾,则停止更改并向所有者呈现确切的提交、文件、URL、冲突、风险和安全选择。
- 仅在检出是最新的或所有者选择如何保留/协调它之后恢复常规工作。在没有明确的清理权限和证明工作已着陆或被取代的情况下,绝不删除分支或独特工作。
在每次着陆之后和任何发布门控之前重复同步。
操作模型
- 使用
github-project-triage绘制每个仓库的开放问题、开放 PR、CI、最新发布、包元数据和未发布变更日志。在判断适合度之前读取VISION.md(如果存在);否则使用已记录的产品方向和维护者判断。 - 对每个队列项进行分类:
自主:清晰适合、可重现、有边界的实现和可用的验证路径。需要所有者:产品选择、安全/隐私决策、不可用的凭据/访问、不可用的实时证明或破坏性/不可逆选择。所有者忽略:所有者明确表示不得影响当前工作的命名项。
- 将每个独立的仓库委托给恰好一个根拥有的 Codex 应用项目线程。为整个队列重用该线程,并在工作发生实质性变化时更新其
<项目>: <当前状态>标题。项目线程串行处理其队列,从不创建或管理其他线程。省略模型选择并继承平台默认值。 - 维护 30 个同时符合条件的根拥有的 Codex 应用项目线程的目标,分布在不同的仓库中。
[翻译截断]