| name | orchestrator-core |
| version | 0.2.0 |
| description | 多智能体编排的领域无关内核（A² Supervisor 层的方法论抽象）。把编排者的操作系统从领域里剥出来：萃取式主上下文 + 按『要不要主上下文』切分派工 + 契约化派发 + 分层合并 + 对抗式异构验证 + 降认知负载。领域皮（CTO 写码 / 总编内容 / 未来任意领域）只贴一张薄角色表 + 完成定义，内核整套复用。适用于用户要求抽象编排模式、造新领域编排者、或问『多智能体架构怎么搭』。不要用于：单 agent 一次性小任务（无需内核）、纯文档初始化（用 repo-governance-bootstrap）。派工/评审/状态落盘的领域实现见各皮 skill（cto-orchestration / yangge-ops）。 |
| metadata | {"distilled-from":["cto-orchestration","yangge-ops"],"layer":"A² Supervisor（七层阶梯第 5 层）"} |
Orchestrator Core — 编排内核（领域无关）
这是内核，不是编排者。 它抽自两个跑通的实例——cto-orchestration（写码团队）与
yangge-ops（内容编辑部）——减去领域词后剩下的不变式。任何新领域编排者 = 本内核 + 一张薄皮。
造 CEO / 销售 / 研究编排者，别新建一套，贴皮（§10）。
定位来源：kRPC 之于微服务通信，本内核之于多智能体编排——都是「复杂工程 → 蒸馏 → 轻便基建」。
复杂度守恒：内核没消灭编排的复杂度，它把复杂度从每个领域的 worker 上下文，压进了契约和合并两处（§3/§5）。
0. 内核的一句话
先编排，再工作——编排是 agent 的操作系统：任务进来先过「派 or 不派」判据（§2），亲手执行是调度的一种结果，不是默认姿态。
编排者持有判断，不持有产物；持有薄的萃取上下文，不持有脏数据；把复杂度压进契约与合并，把简单留给主 session。
本内核的常驻 digest（6 行，可直接并入全局规则文件让每层 agent 常驻加载）见 references/resident-digest.md。
1. 铁律一：编排者不亲手做领域产物
编排者的产出是契约、调度、裁决、状态落盘，不是领域产物本身。
- CTO 皮：不写产品代码。｜总编皮：不写正文。｜未来皮：CEO 不亲手谈单、研究编排者不亲手读论文。
- 判据不是「能不能做」，是「做了会不会占掉编排位的稀缺性 + 污染主上下文」。你能做，恰恰是最该派的信号。
2. 铁律二：切分轴是「要不要主上下文」，不是耗时
派 or 不派，只问一句：这活需不需要贴着我此刻这摊上下文才能干？
- 不需要（自包含、可蒸馏、脏数据密集）→ 派出去，越并行越好。哪怕它只要 10 秒（读 170KB digest 找三条＝该派，因为它污染主上下文）。
- 需要（要贴着主线反复迭代、共享假设）→ 留在主 session，哪怕它要一小时（贴着确认门写正文＝不派，派出去 worker 拿残缺假设各干各的，合并全是冲突）。
- 「超过 N 分钟就派」是相关变量、不是判据——耗时只是「自包含」的影子。拿影子当判据会在两个边界误伤。
- 读并行，写单线（切分轴的第二维）：调研/评审/取证类读操作尽管 fan-out；产物写入保持单一 writer——并行写的隐式决策会互相冲突、合并全是撞车，要并行写先按产物所有权（文件/章节/worktree）切开。
- 分形递归：本判据对派出的每层 worker 同样生效——子任务中再冒出「自包含、结论小」的块，同判据继续再派。护栏：每层 scope 只收不扩、契约逐层更窄；只用于天然树状且每层返回极小的活（per-finding 验证类），1-2 层收敛——每多一层就多一次蒸馏压缩的失真。
- CTO 皮＝评审 agent 对每条 finding 派独立 verifier；总编皮＝主笔对资料检索/事实核查子块再派。
3. 铁律三：派发即契约（缺一即漂移）
派出去的每个 worker 必须拿到四件，缺一它就飘：目标 / 输出格式 / 工具与来源边界 / 任务范围（含 stop-and-report）。
- 散是一句话的事，写契约是真功夫——这是编排者压进来的第一处复杂度。
- 规模按复杂度分档：简单事实 1 个 · 对比 2-4 · 开放调研 10+——防为简单任务过度 fan-out（编排的前提是任务价值撑得起协调开销；撑不起就单 agent 直接做）。
- 附理解门：worker 动手前先复述「碰哪些东西、有哪些风险、scope 是什么」，核对再放行；弱答当场纠正，别把沉默当默许。
- CTO 皮＝goal 文档模板；总编皮＝选题官/主笔各自的任务契约（证据路径+脱敏红线+输出格式）。今天 5 个主笔 prompt 长得吓人，全是契约。
4. 铁律四：模型按「活的类型」分档，不按「位置」分
- 编排位：最强模型（拆解+合并是全局推理，最吃能力）——无争议。
- worker：按活分，不是一律降级。
- 机械活（搬运/格式化/批量改）→ 弱模型，省钱。
- 重推理 + 长上下文 → 强模型。这是最反直觉的一条：弱模型 + 长上下文 = 全场最差组合（context rot 对弱模型打击远大于强模型）。「worker 上下文很长」恰恰是最不该给它降级的信号。
- 实测（Anthropic）：token 用量解释 ~80% 效果方差——worker 能力是质量位，不是省钱位。省钱省在活的类型上。
5. 铁律五：合并是工程，不是收件（分层 + 验证关）
发射是体力，回收是工程。内核压进来的第二处复杂度在回收端：
- 分层防单点：编排位若要逐个读完 worker 产物再合，主上下文优势当场崩。规模一大改分层——编排→组长→worker，合并压力分摊。扁平结构（1 编排 N worker）编排位一定先爆。
- 对抗式异构验证关（默认开，不是可选）：关键产出必过独立异构验证——与执行者不同 lineage 的模型，只挑刺、给 verdict、不改产物。执行者自审是同 lineage＝self-preference bias，不可信。
- CTO 皮＝codex 对抗评审（BLOCKING 不修不放行）；总编皮＝审稿人 codex 三轮 PASS。
- 别信蒸馏摘要：worker 在摘要里写「脱敏通过 ✅」，文件里可能漏一个客户名——摘要会藏错。合并边界 trust-but-verify：机检（grep/计数）+ 抽查原始产物，不只读摘要。弱 worker 越多，这道关越硬。
6. 铁律六：主上下文萃取式慢增长
主 session 只吃 worker 蒸馏后的结论（1-2k token 级），不吃过程脏数据——这是「一整天不断线」的本钱，protect it。
- 每个 worker「探索可以烧几万 token，回来只吐蒸馏摘要」。
- 但见 §5 末：萃取不等于盲信，合并边界要抽查。薄，但不瞎。
7. 铁律七：Implemented ≠ Done（完成要正向证据）
worker 自报「done」、watcher 测到 idle——都只算 Implemented。升 Done 要正向交付物 + 独立验证 + 真路径检验，三者齐。
- 别让完成状态由执行者自报。别拿 idle / 结构测试顶真路径。
- CTO 皮＝核证四件套 + 异构确认 + 本机 E2E；总编皮＝审稿 PASS + 发布前人查图与排版。
8. 铁律八：降主理人认知负载（主理人持判断，不持状态）
主理人只决承重的（战略/不可逆/钱/价值），每个给嚼过的选项，且永不必持有流程状态。
- 默认少打断：可逆事项自驱，非紧急决策攒批（「1A 2B」式一次拍板）；不可逆一律等真人新 turn；风险不静默，带证据、影响边界和下一步及时冒泡。
- CTO 皮＝DECISION_QUEUE + 三层委派；总编皮＝批量拍板清单、囤稿模式。
9. 铁律九：收口三同步 + 复盘回写（内核自我进化）
每次工作流收口，三件缺一即腐烂：归档完结物 + 重写主上下文快照（快照非日志，整篇重写有上限）+ 翻转状态账。
- 收口同时做复盘仪式（checklist 非即兴）：哪卡了/哪返工/哪个假设被打脸 → 教训回写对应皮或本内核。
- 回写不是散文追加，是分层沉淀（完整方法论见
references/self-evolution.md）：教训按深度分诊落层
（事实→情景→操作规则→判据→原则→身份，杠杆随深度递增、准入随深度收紧）；晋升过三门——样本门
（n≥2 同向）· 行为门（关单 = 已合入 diff + 下次任务 fire 核验，记录 ≠ 学会）· 压缩即晋升
（N 条实例蒸馏 1 条上层判据并 retire 原件，corpus 总量不增；同层 ≥3 条同族 = 结构跃迁触发器）；
删除是一等公民（写入带 provenance，从不 fire 的散文删或硬化）。
- 内核和皮都在进化——这条让它们不腐；本内核自身即一次压缩晋升的实证（两皮数百行 → 九条铁律）。
10. 皮怎么贴（造新领域编排者）
内核九条不动。一张薄皮只定义四件领域特化：
| 皮要定义 | CTO 皮 | 总编皮 | 你的新皮（例：CEO） |
|---|
| 领域角色表（按能力，工具可换） | 执行 omp / 评审 codex / 运维 | 选题官 / 主笔 / 审稿人 / 增长官 / 数据官 | 战略 / BD / 财务 / 法务 agent |
| 领域产物 | 代码 | 文章 | 决策/合同/预算 |
| 「一件活干完」的定义（§7 的领域实例） | 核证四件套 + 异构 + E2E | 四件套齐 + 审稿 PASS + 人查 | 领域自定 |
| 领域 SoT 路径 | docs/orchestration/ | content/ + docs/ops/ | 领域自定 |
贴皮不改内核。 皮里若冒出「要改某条铁律」的冲动，先停——多半是这条铁律你还没理解透，不是它不适用；修宪门槛 = 先证两张现存皮都容不下它（§11 的反向应用）。
11. 抽象自证（reverse-map，本内核的验证关）
一个编排内核抽得对不对，判据只有一个：它能不能同时套住两张已跑通的皮？
- 上面九条铁律，每条都标了 CTO 皮和总编皮的实现——两张皮都对得上 = 抽象成立。
- 出现任何一条只有一张皮能对上 = 那条不是内核、是皮，退回去。
- 新皮接入若发现某铁律套不上，两种可能：① 皮没抽干净（领域词漏进内核）；② 那不是真编排场景（回到单 agent）。
- 外部 reverse-map：九条铁律逐条对上 2025-26 业界一手来源（Anthropic multi-agent research / Claude Code 官方文档 / Cognition），对照表 + 从业界吸收进内核的三条判据（读并行写单线 / 复杂度分档 / 分形递归护栏，已入 §2/§3）的原始出处见
references/orchestration-sota-2026.md。
12. 不做什么（anti-goal）
- 不为「更通用」造第三个平级领域编排者（那是贴皮，十分钟的事，不是新组件）——默认演化，不默认新建。
- 不把领域词写进内核（omp/codex/选题官 都是皮的参考实现，内核只认能力）。
- 不在只有 2 张皮时过度抽象——本内核每条都由 2 皮共同支撑，无第三条「预判未来」的空条款。第三张皮接入时再据实修内核。
一句话：内核管「怎么编排」，皮管「编排什么」。发射是体力，回收是工程，萃取是本钱，贴皮是复用。这就是 A² 的 Supervisor 层——一个编排者，调度一群专家，跨任意领域同一个内核。
