Skip to content

refactor(aps): split branch protocols from controller - #8

Merged
zaurakworks merged 2 commits into
mainfrom
issue-56-aps-thin-controller
Aug 16, 2026
Merged

zaurakworks merged 2 commits into
mainfrom
issue-56-aps-thin-controller

Conversation

@zaurakworks

Copy link
Copy Markdown
Owner

问题

APS SKILL.md 同时承载常驻控制循环与受限调研、攻防、实验、安全门和长程验收的完整执行协议。0.2.11 主合同为 22,537 UTF-8 字节,接近机械上限,也让未命中分支长期占用 Agent 注意力。

关联实验:zaurakworks/agent-system#56

决定

采用“薄控制器+按命中条件加载 reference”,不拆成第二个控制器:

  • 主 SKILL.md 只保留进入/退出、问题恢复、O0/P1–P8/U 归型、选择资格、共用硬门指针、反思和结果返回
  • P3、P4、P6、G1–G3、长程验收分别下沉到五份 reference
  • 跨 Skill 调用改为可直接定位的文件路径;CF-5、CF-6 不再依赖章节号或隐含缩写
  • 所有插件清单同步到 APS 0.2.12,生成选型面随源码重建

复杂度结果

  • 主合同:22,537 B → 8,812 B(减少 60.9%)
  • 主合同+五份新 reference:19,406 B,仍低于拆分前主合同
  • 未命中分支不加载;方法登记面 INDEX.md 仍是进入后的共同路由面

行为对照

使用 agent-control#56 预注册的同一组 S1–S12 场景,对 0.2.11 单文件基线和 0.2.12 候选各运行 default/slow 两个模型。人工按入口、分支、硬门、退出和证据边界逐项裁定:

  • 基线:24/24 场景通过
  • 候选:24/24 场景通过
  • 零回退门:授权、明示同意、写入所有权、M0 选择资格、G1–G3、证据等级、攻防四席下限均保留
  • 候选还能在 S3/S4/S5/S6/S7–S9 中明确返回命中的 reference;S1 不加载 reference

边界:这是两种可用模型、预注册场景和当前长上下文下的直接探针,不外推为所有模型或未来版本的普遍保证。

验证

  • node tests/workflow-routing.test.ts → PASS: 12 个 Skill、7 个 Plugin、71 个验收场景
  • node plugins/orchestrated-collaboration/tests/verify-three-party-review.test.ts → PASS: CF-6 三方审阅验证器合同
  • git diff --check → 无输出

审查重点

  1. 主控制器是否仍足以决定何时加载每份 reference
  2. G1–G3、M0/M1、四席攻防与证据等级是否存在语义弱化
  3. 跨插件路径是否全部完成 clean cutover,是否残留旧章节号调用

@zaurakworks
zaurakworks marked this pull request as ready for review August 16, 2026 13:06
@zaurakworks
zaurakworks merged commit 759d75e into main Aug 16, 2026
1 check passed
@zaurakworks
zaurakworks deleted the issue-56-aps-thin-controller branch August 16, 2026 13:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant