Index of every page on this site: llms.txt
All skills
cat-xierluo avatar

/multi-agent-orca

@5fb69a0
Run it yourself

编排两个以上边界独立的本地 worker,使用 Orca Run/Task/Dispatch、独立 worktree/session 或 tmux 回退,由 PM 负责拆解、派发、巡检、429 停滞恢复、独立验收、PR 收口与临时资源清理;也用于用户明确要求“并行推进”“多个 worker”“PM 总控”“Wave Autopilot”或防止 PM 直接实现逃逸。不要用于单个短任务、纯状态同步,或仅需 Git 分支、提交、PR、merge 规则的工作。

Use this Skill: https://skilld.dev/gh/cat-xierluo/legal-skills/multi-agent-orca

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

references41-pm-merge-and-sync.md

≈3.8k tokens on demand. Your agent reads this file only when SKILL.md points to it.

PM 总管的 PR 合并与本地/云端一致性治理

适用于已获授权协调多个交付的 PM:从作者交回候选,到独审、云端合并、本机采用分别结算。接续 40 页 的写域与 canonical owner,不另建任务源或 Git 流程。

本页事件来自 2026-10-21—22 的 PM 治理交接;调用与扫描语义另核 git-workflow 源码。事件是已记录现场,不代表本次文档维护重演了真实合并、主目录同步或网关故障。私有原始回执留原任务;没有可复查证据的当前状态记 NOT_VERIFIED。

权威与授权:PR 合同、隐私合同、主目录合同与采用合同仍归 git-workflow。本页只补 PM 如何判读事故与组织证据。合并、本机维护、删分支各核原授权;下列示例不自动授权执行,也不绕过 runtime 拒绝。

A. 合并门禁:先分清本地路径与 GitHub 仓库标识

事件 A1:把 GitHub slug 传给 safe-pr.py --repo,其内部 git -C <slug> 失败,统一报 PRIVACY_GIT_READ_FAILED,容易被误判为瞬时 Git 故障。

什么情况 怎么判 做什么 不能做什么
PRIVACY_GIT_READ_FAILED 先核 --repo 是否为可读本地检出、真实根和 remote;错误文本不能区分传参错与真正 Git 读失败 用 git -C "$REPO_DIR" rev-parse --show-toplevel 核根;参数正确后再查对象、祖先链和权限 先归因瞬时故障、连续重试、把 slug 当本地路径
PR 仍为 draft 核同一 PR 的 number、head OID、base 名与 base OID 原授权和验收满足后 gh pr ready "$PR" --repo "$GH_REPO";回读 OPEN、非 draft、head/base 未变 关闭重建 PR;把 ready 当合并许可
准备合并 OPEN、非 draft、明确可合并;真实不同角色独审有明确 verdict;最终 head checks 通过;当前 head/base 与实际验证候选一致 冻结完整 OID、审查读集、验证命令/结果、最终文本;逐门核证后才调用 helper 作者自签、用旧 head 的绿灯、把未知/等待/读失败当通过

REPO_DIR 是本地路径,GH_REPO 是 <owner>/<repo>。helper 的全局选项放在子命令前;正确调用形态:

python3 "$GIT_WORKFLOW/scripts/safe-pr.py" --repo "$REPO_DIR" --remote origin \
  squash --number "$PR" --expected-head "$REVIEWED_HEAD" \
  --title-file "$TITLE_FILE" --body-file "$BODY_FILE"

helper 只守隐私和候选边界,不代 PM 判断 review、checks 或授权。无 GitHub approval 要求时,真实不同角色、绑定当前候选的独立审查可以作为 review;仓库要求他人 approval 时仍须满足保护规则。没有 checks 时先核项目与保护规则,不能自行判 PASS。合并后回读 MERGED/mergedAt/mergeCommit 及目标内容;网络结果不明先查原 PR,不重放 mutation。

B. base 前移:证明服务端只做了预期合并

事件 B1:main 在 PR 期间前进,head 不再包含新 main;scan_range(main, head) 的祖先检查按设计 fail-closed,不是隐私配置坏了。

什么情况 怎么判 做什么 不能做什么
base 前移、无内容冲突 固定旧受审 base B0、旧 head H0、新 main B1,核差异、owner、更新授权及同步策略 经授权走服务端 update-branch;回读新 head H1 与父提交,核原 H0 和本轮 B1 被纳入 状态不一致仍合并;force push/rebase 改写已发表历史来对齐
服务端返回新 merge commit 仅 API 成功不足;要核精确父提交及自动合并结果 本地 merge-tree 推算树,与服务端树逐字节一致才承接下一门 把 CLEAN 或 MERGEABLE 当作没有人工改动的证明
希望沿用旧内容审查 旧/新净变更的路径、状态、文件模式和 blob 身份一致,删除也显式列出;独审允许承接 保存映射及比较证据;原 review 仅承接等价内容,最终 checks、隐私历史扫描重新运行 只比文件数/标题/树摘要就免审;把内容等价扩大为 CI/隐私通过

在独占候选固定变量后,示例为:

gh api -X PUT "repos/$GH_REPO/pulls/$PR/update-branch" -f expected_head_sha="$H0"
git merge-tree --write-tree "$B1" "$H0"
git rev-parse "$H1^{tree}"

先 fetch 精确对象再比较。merge-tree 必须退出 0,首行 tree OID 与 H1^{tree} 完全相同,并以树清单/实际 blob 字节复核;有冲突的输出不能当预期树。API 等待结果不明时先查同一 PR。若操作期间 main 又前移,重新冻结基线,旧比较不证明当前候选。

净变更用 git diff --raw --no-abbrev --no-renames -z B0 H0 和 B1 H1 形成可回查清单,解析完整路径、增删状态、模式及旧/新 blob(--no-abbrev 保留完整 OID),核 blob 集合与映射一致。有交叠、模式变化、删除歧义或任何差异就交独审重审,不硬凑等价。服务端新增 merge patch/message 仍属隐私检查对象,旧例外不得自动套用。

C. 隐私例外:绑定内容,保留原脚本语义

事件 C1:当时 landline 使用 (?<!\d)0\d{2,3}-\d{7,8}(?!\d),没有 mobile 的标识符前缀负向后顾 (?<![A-Za-z0-9]),使证据目录 ID know-002-20261004、know-003-20261011 的日期片段误中座机规则。规则快照须核当前源码,不据此声称所有带前缀的命中都安全。

事件 C2:本次交接中的 local-user-path 例外仅针对已确认的合成占位符 /Users/你/ 与 /Users/alice。它们不是待放行的真实本机目录;名字看似普通也不能自动认定占位符。

事件 C3:为定位命中而 monkeypatch checker,会破坏 scan_patch 根据原 findings 切片抑制完整 hunk 内路径删除行的逻辑,造出原脚本不报的假命中。

什么情况 怎么判 做什么 不能做什么
疑似 ID 被识别为座机 由独立 reviewer 枚举全树所有命中,并核待发表历史的 message/patch/blob;逐条确认是标识符片段、零真实号码 留完整本地清单与 verdict,再按内容绑定登记本地例外 只查两个示例;按关键词/目录通配放行;为赶合并放宽正则
占位符路径命中 回读实际 blob/patch 原始字节,确认全部命中均为已审合成占位符,复算 content_sha256 对原脚本诊断的每种来源分别绑定,不以行片段摘要代替完整内容摘要 放行真实用户名、只核渲染后的文本、复用另一上下文的例外
插桩多报命中 先判断诊断是否改变扫描器状态或删除行抑制 在未插桩、未修改的原脚本复核相同候选;以原诊断为准 把插桩输出直接登记成例外或当成真实泄露
要写本地例外 核独审记录、准确来源与内容摘要及写入归属;例外文件可能被多个树共享 写前私密快照,记录条目数/字节数/SHA;写后解析回读、核条目数与字节数、验证旧条目保留,仅预期条目增加,再重跑原 checker 覆盖他人例外、盲目追加、把策略/快照或原始敏感命中提交公仓

例外只绑定 规则 + 来源字符串 SHA-256 + 完整内容 SHA-256。格式、七字段、可用 kind 与来源字符串以隐私合同为准。换文件、改正文或换 OID 都重审;即使 blob 未变,commit patch/message 来源改变也不能沿用旧记录。例外不替代独立内容审查,真实敏感信息不能靠 synthetic 自证安全。

D. 本地/云端收敛:先保护现场,再推进引用

事件 D1:update-ref + reset --mixed 推进 main 后,PR 的纯新增文件没有落盘,status 出现 D。只看 HEAD/index 会误以为已采用;直接恢复全部删除又可能覆盖他人真实删除。

本节是另行获授权的具名维护窗口中的受限方法,不是默认主目录操作许可。主目录门禁默认拒绝 reset、底层 ref/index 覆写;runtime 拒绝时记录具体原因、交原维护 owner,不绕过,不自行解锁。本次任务只有文档/PR 授权时,不执行下列维护命令。

什么情况 怎么判 做什么 不能做什么
希望本地 main 追上云端 fetch 后核 origin/main 是 HEAD 后继;ahead=0、behind>0;核真实主目录仍在 main 列 incoming 与 dirty(含 staged/unstaged/untracked/删除/rename 两端)的路径交集及文件/目录前缀冲突;交集为空只是必要条件 以落后为由 pull/checkout/reset --hard/stash/clean;分叉或本地领先时丢弃有效提交
主目录在他人分支上 实测分支与 owner,不按树名猜 登记待处理、保留现场交原 owner 自行切 main、回退他人分支
incoming 与 dirty 不重叠 还须核 index、HEAD、目标文件、锁及 writer;mixed reset 会替换 index 具名集成者冻结 old/new OID、原 index 与工作区快照;存在他人 staged 状态或不明 writer 时停止,交原 owner 处理 把空交集当充分授权;冲掉暂存状态;遇锁删除解锁
精确新增文件呈 D 旧 HEAD 无该路径、新 HEAD 有该路径,且写前就不存在、当前仍无文件/链接/目录冲突;核 sparse 范围 仅对已证纯新增精确路径用 checkout-index 落盘;逐文件核新 blob 字节 对全部 D 批量恢复;覆盖原有删除、untracked 或 ignored 材料

通过上述授权和准入后,由唯一维护 owner 顺序执行的形态为:

git update-ref refs/heads/main "$NEW_MAIN" "$OLD_MAIN"
git reset --mixed "$NEW_MAIN"
git checkout-index -f -- '<逐项核实的纯新增路径>'

update-ref 的 old OID 是比较交换条件;不能补救 index/工作区并发。两步间没有跨文件原子性:每步重核,任一步失败保留已发生状态,不自动回退或重放。reset --mixed 不动工作区字节,但会重建 index;只有原暂存状态可保留且维护 owner 独占 index 时才准入。checkout-index -f 可覆盖文件,故执行前再次核精确路径仍不存在,并由 owner 串行维护;出现竞态立即停,不能称它天然零覆盖。其他干净但已存在的 incoming 修改/删除也不会被 mixed reset 物化,须另按采用合同逐项采用和核验,不能只补新增就宣布整个工作区同步。

验收看字节:写前/后保留他人 dirty 路径集合,以及其真实编辑的 staged/unstaged diff block(固定 Git 参数、禁外部 diff/textconv)的 SHA-256;核原 index 语义、untracked/ignored 与删除状态。incoming 产生的暂态差异单列,不能混入他人集合凑数量相等。集合和 diff block 摘要都一致,incoming 的实际文件/删除/加载版本也逐项核实,才签本机采用。现场漂移无法归属则交回,不回滚他人新编辑。

云端合并、本机 main/ref 同步、工作区落盘与实际加载分别结算。删远端分支是另一次资源处置,沿生命周期合同核授权和占用;合并成功不隐含删分支。

E. 候选不一致:先看有效内容,再决定向哪边对齐

事件 E1:safe-pr.py 两次 fail-closed 后核出 PR head 与本地 worktree HEAD 不同;本地多出的提交是有效的第三轮复审回执,并非垃圾。该诊断来自现场对账,不表示当前 helper 会直接比较本地 HEAD(它绑定 expected-head 与远端 head,并扫描精确范围)。

什么情况 怎么判 做什么 不能做什么
本地/远端/受审 head 不一致 固定三方 OID、各自独有提交和实际 diff,核回执/正文归属与是否有效 有效新增内容需交作者 safe-push、更新同一 PR 并重新绑定审查;确属另一候选则保留成果,交 owner 明确采用方向 上来就 reset 本地、重建任务或把多出的提交当垃圾
看似重复交付 按 40 页判重矩阵交叉核 cwd、写域、任务卡 ID、分支/提交、PR、产物路径与 SHA 达到证据门槛才指定唯一 canonical owner,保留其他会话成果与身份 按标题判重、擅自关闭/覆盖在途会话

F. 断联与限流:恢复原任务,限制并发

事件 F1:交接现场的 429、exceeded retry limit、stream disconnected、server busy 经网关状态核对属于 provider 容量问题;不是业务任务失败。错误字符串本身仍只是线索,别处的断联还可能来自网络/宿主,须核当次证据。

事件 F2:宿主曾拒绝直接唤醒 multi-agent v2 sub-agent 或已归档会话。实际拒绝是边界,不能由 40 页的工具存在性推断这些对象可接续;本次未测试其他宿主/版本。

什么情况 怎么判 做什么 不能做什么
provider/网关容量失败 对照 turn 错误、provider 状态、额度/并发观测和最后一次真实产物 有发送授权且通道可用时给原 owner 一次有界恢复指令;容量未恢复则保留等待,独立项继续 归为任务缺陷、重派整卡、反复发送“继续”
恢复执行 先只读核 git status、分支/HEAD、PR 状态与入口实际状态,确认原进度 从中断点继续,记录已完成、阻塞和下一步,保留原任务/会话/材料 重做、reset、丢弃现场、以回合结束当交付完成
宿主拒绝发送/唤醒 留原错误、目标身份和未送达状态 跳过该动作,交原 owner 或用户的合法接续入口;原任务保持待恢复 绕工具约束、擅自取消归档或新造任务冒充续跑
要追加并行 核当前 provider 容量、运行数与排队数;本次 workbuddy-ai 现场为 accountConcurrency=2、queueLimit=2 以当前配置为准压住在飞与队列上限,错峰提交;数字只作当次观测 将 2/2 固定为全局默认、为提速改 provider 配置、把队列额度当执行槽

恢复消息应自包含,例如:“原任务与 owner 保持;已完成的产物/候选为……;最后有效验证为……;当前阻塞为……;请先只读核现场,再从……继续;不重做、不 reset、不丢弃现场;下一回执绑定实际 head/产物和验证。”发送授权、收件回执与静默仍按 40 页;Orca 429 批量恢复走 20 页,不把本模板变成新的自动唤醒器。

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 alert18d3 checks · Risk HIGH
  • Gen Agent Trust Hub18d

    This skill is a highly sophisticated multi-agent orchestration framework designed to manage and parallelize local AI worker tasks using tools like Orca, tmux, and SSH. While it incorporates an extensive array of security features—including automated installation guards, file write scope guards, and a structured authority receipt system—it fundamentally relies on broad system permissions. It performs extensive command execution, dynamic script loading, and remote execution on network nodes via SSH. Users should review the configuration and security policies (e.g., config/harness-backend-policy.json) to ensure they align with their environment's security requirements.

  • Socket18d

    2 alerts: gptAnomaly

  • Snyk18d

    Risk: LOW · No issues

Signed by skilld at 5fb69a0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month
Other metadata
metadata
{
  "version": "3.1.1",
  "homepage": "https://github.com/cat-xierluo/legal-skills",
  "author": "杨卫薪律师(微信ywxlaw)"
}

README badge

README badge for cat-xierluo/legal-skills/multi-agent-orca