Files

T

Songhaoz666andClaude Opus 4.8 f2662e4268 复审整改(PR #26 )：删死开关 helper、文档对齐"无条件"、swarm.health 改内部、#6 降为 Refs

回应 Fasthei 终审三点：

1) [P1 文档/代码冲突 + 死代码] 删除从不被调用的 *_enabled() helper（autonomous_tasks.proposals_enabled
   / task_competition.task_competition_enabled / convergence.convergence_report_enabled）及其
   import os；模块 docstring 与四份协议文档（autonomous-task-generation / task-competition-protocol
   / review-loop-protocol / convergence-protocol）从"默认关/未接入/待 PR/cutover 转无条件"全部改为
   "无条件接入（无开关）"，删除引用死 helper 的过时集成代码样例；同步删除三个模块单测里的
   "flag default OFF" 断言。

2) [P1 验收] #6 "Closes" 降为 "Refs"：#6 DoD 需 ARB 决策记录链接，当前只有 owner 指示断言、无链接。
   product-positioning.md 改为如实记录决策来源（owner 指示 + 本 PR + 文档）并把"补 ARB 记录链接（或
   owner 明确接受断言）"列为关闭 #6 的前置；纠正其"flag 门控、默认行为不变"的过时表述（重构已无条件）。

3) [P2 契约卫生] assess_swarm_health 不再 emit_event("swarm.health")（避免向订阅全部的 Manager 回调
   投递未注册事件）；改为存 run.metadata["health"] + 内部 health_log。test-swarm-guard 相应断言
   "无 swarm.health 外发 + 内部 health_log 已记"。

本地受影响 11 套全绿。影响范围：agent_swarm（orchestrator 模块/文档/测试）；不改 Manager↔Swarm 契约。

Refs #6
Refs #7
Refs #8
Refs #11
Refs #12
Refs #18

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-10 16:48:27 +08:00

4.9 KiB

Raw Blame History

产品定位说明（Product Positioning）

状态：已选定 Path B 并完成去中心化重构（owner 指示）。本文回应工单 #6「蜂群模式产品定义偏差」：原实现为 Master 中心化，heicodeDocs 蜂群定义为弱中心；现已按 Path B 重构为弱中心自组织并设为唯一行为（无开关；计划见 swarm/decentralized-rework-plan.md）。

决策记录与 #6 关闭口径：路径选择的依据 = owner 在工单/会话中的指示 + 本重构 PR + 本文 + swarm-definition-gap.md。但尚无形式 ARB 决策记录的链接。故重构 PR 以 Refs #6（不自动关闭）引用本单；待补 ARB 记录链接（或 owner 明确接受上述断言为准）后由 owner 关闭 #6。两条路径取舍保留如下以备追溯。

配套：swarm-definition-gap.md（逐条差距与文件/行号引用）、README.md（能力边界表）、integration/runtime-contract.md、benchmark/IMPORTANT-metric-coverage-gaps.md。

1. 本系统当前「是什么」

一个可运行的多 Agent 工作流运行时（multi-agent workflow runtime）：分解 → 派发 → 执行 → peer 协作/移交 → 评审/重做 → 汇总，仓内可端到端跑通（见 README 工作流）。
一个 Master 中心化编排系统：认知决策（分解 / 评审 / 汇总）集中于单一主控实体 MasterAgent（orchestrator/master_agent.py），由编排器 task_dispatch_loop（orchestrator/main.py:290）执行其决策。
任务规划在无 Manager 分工时由单一 planner 回退生成（orchestrator/planner.py:62-85 静态计划、:87-116 LLM 计划），受 ENABLE_PLANNER_FALLBACK 门控。

2. 本系统当前「不是什么」

不是 Heicode 主链路的正式 Runtime Backend：尚未按 heicode-am-contract 注册接入（README 能力边界表标 🟡「待接入」；docs/integration/runtime-contract.md）。
不是 heicodeDocs 定义的弱中心蜂群：当前不存在「Agent 感知共享态势 → 自主生成/竞争任务 → peer 交叉评审 → 自组织收敛」的去中心机制。派发是中心驱动的能力子集匹配（orchestrator/task_queue.py:181-186 can_agent_run_task、:140-168 候选枚举），评审是中心化单点裁决（planner.py:118-171 review）。
不是已自证「优于基线」的蜂群：gain / S_swarm / Benchmark_Agent 仍 NaN（benchmark/IMPORTANT-metric-coverage-gaps.md §2）。
详见 swarm-definition-gap.md。

3. 两条 ARB 路径（取舍并列，不预设结论）

维度	Path A：对齐文档到现状	Path B：构建弱中心能力
做什么	把对外定位/文档收敛为「Master 中心化多 Agent 工作流运行时」，不再宣称弱中心蜂群	落地弱中心机制，使实现向 heicodeDocs 定义收敛（对应工单 #7/#8/#9/#11/#12）
改动面	仅文档与定位口径，零代码	编排器派发/评审/态势/收敛的实质性架构改造
成本	低（数小时级文档工作）	高（跨多工单的架构与验证工作，含基线对比）
风险	放弃「弃中心蜂群」对外叙事；需确认与 heicodeDocs 标准不冲突（冲突须按 CLAUDE.md 输出冲突点，不得自行选边）	周期长、引入分布式一致性/收敛终止/防活锁等新风险；需 Benchmark 自证
诚实性影响	立刻消除「宣称弱中心、实现中心化」的偏差（组织规则 #9）	偏差在 Path B 完成并验收前持续存在，期间文档须保持 🟡/🔴 标注
可逆性	高（后续仍可转 Path B）	中（架构改造沉没成本较高）

说明：两条路径并非互斥的二选一终局——可先取 Path A 止血定位偏差，再按工单排期推进 Path B。但采用哪条、是否并行、排期与验收门均属产品/架构决策，不在本仓 docs 自行决定。

4. 待裁定项（ARB 决策，非本仓自决）

已选定 Path B（owner 指示）并完成重构 —— 见 swarm/decentralized-rework-plan.md（swarm 已是唯一行为，无开关）。
关闭 #6 前置：补一个形式 ARB 决策记录链接（或 owner 明确接受「owner 指示 + 本 PR + 本文」为决策记录）。在此之前重构 PR 用 Refs #6 不自动关闭。
若选 Path A：确认收敛后的对外定位口径与 heicodeDocs 标准无冲突（如有冲突，按 CLAUDE.md 输出冲突点交标准源裁定）。
若选 Path B：确认 #7/#8/#9/#11/#12 的范围、依赖顺序与 Benchmark 验收门（基线对比，见 benchmark/IMPORTANT-metric-coverage-gaps.md §5）。

本文不代行 ARB 裁定；上述路径选择仍为 OPEN，由人类 owner 决定。

4.9 KiB Raw Blame History Unescape Escape

产品定位说明（Product Positioning）

1. 本系统当前「是什么」

2. 本系统当前「不是什么」

3. 两条 ARB 路径（取舍并列，不预设结论）

4. 待裁定项（ARB 决策，非本仓自决）

4.9 KiB

Raw Blame History