Aegis → Hermes 完整吸收方案与边界协议

• HTML: https://decision.ht1072.top/2026-05-29-aegis-partial-absorption-plan.html
• Local HTML: [已移除本地路径]
• Generated: 2026-05-29T18:22:38+08:00

Aegis → Hermes 完整吸收方案与边界协议

结论

本方案不是“安装 Aegis”，而是把 Aegis 中已经验证有价值的 method-pack 纪律吸收到 Hermes 现有体系里。

最终方案：

吸收等级：L3 局部能力吸收
实施方式：Selective Method Absorption
治理原则：吸纪律、吸 contract、吸诊断链；不吸整包、不建平行系统、不授予 Aegis 权威

一句话：

Aegis 作为高质量 coding-agent workflow casebook 进入 Hermes；Aegis 不作为 Hermes 的运行时、默认路由器、记忆系统、项目管理系统或最终裁决系统进入。

背景

已完成对 GanyuanRan/Aegis 的独立评估：

• repo 已 clone 到隔离目录
• 已检查 README、docs/current、ADR、scripts、skills、tests
• 已运行 doctor / boundary 检查
• 已发布评估报告

评估结论：

Aegis = runtime-ready method pack
不是 runtime core
不是 daemon
不是 final completion authority
不是 memory / recall system

因此，正确吸收方式不是安装它，而是把它的成熟治理方法拆成 Hermes 可控的局部增强。

总体吸收边界

允许吸收

禁止吸收

目标状态

吸收完成后，Hermes 应新增的是一组“纪律增强”，不是新系统。

目标状态：

Hermes coding workflow
  + Evidence-before-completion 回执纪律
  + Subagent / codex-worker context packet
  + Trigger-health 排障框架
  + Rule-layering 分层治理框架
  + Optional project evidence bundle pattern

非目标状态：

Hermes
  -> Aegis router
  -> Aegis workspace truth source
  -> Aegis global config
  -> Aegis completion authority

体系落点

分阶段执行方案

Phase 0：基线冻结与安全边界

目标：确保吸收不会污染现有 Hermes 运行态。

动作：

1. 明确不运行 Aegis global install。
2. 不再在主 HOME 下运行：

bash python3 scripts/aegis-doctor.py --write-config

3. 如果必须运行，使用隔离 HOME：

bash HOME=/tmp/aegis-home-$(date +%s) python3 scripts/aegis-doctor.py --write-config --json

4. 当前已发现并处理过一次污染：

text backup: [已移除本地路径] disabled: [已移除本地路径] active_config_after: 0

验收：

• ~/.config/aegis/config.toml 不指向 /tmp/aegis_eval_*
• Hermes config / skill / gateway 没有新增 Aegis 运行依赖

Phase 1：Reference-only 吸收

目标：先把 Aegis 作为判例和方法参考纳入 Hermes 知识体系，不改运行路径。

已完成：

[已移除本地路径]

建议新增或补充：

[已移除本地路径]
[已移除本地路径]

验收：

• Aegis 的吸收边界可以被后续 skill 查到
• 不出现 Aegis 与 Hermes skill 的同名平行入口

Phase 2：P0 能力吸收

目标：先吸收收益最大、风险最低的两类能力。

2.1 Evidence Card 回执结构

标准字段：

Evidence Card:
- Command / Check:
- Exit Status:
- Covered:
- Not Covered:
- Residual Risk:
- Confidence: A | B | C

进入 Hermes 的位置：

• code review 完成回执
• PR/merge/deploy 前回执
• codex-worker 执行结果
• subagent 代码任务总结
• 测试/验证类任务最终回复

边界：

• Evidence Card 是证据组织，不是 completion authority。
• 低风险短任务可以压缩成 1–2 行，不强制展开完整卡。
• 用户明确要求极简回执时，保留核心证据即可。

验收：

• 典型 coding task 结束时能看到验证命令、退出码、覆盖范围、剩余风险。
• 不再出现“看起来好了 / 应该可以”式完成声称。

2.2 Subagent / Codex Worker Context Packet

标准字段建议：

Task:
Goal:
Stop condition:
Relevant files:
Relevant baseline refs:
Known facts:
Unknowns:
Non-goals:
Expected output:
Verification expected:
Unsafe assumptions:

进入 Hermes 的位置：

• delegate_task 调用前的 context 组织
• 走 codex-worker 的 task contract
• 长任务切片派发
• 多 agent review / implementation 分工

边界：

• Context Packet 是输入包，不是项目状态真相源。
• 不要求所有 subagent 任务都生成文件；多数情况下只作为 prompt contract。
• 不能把整段会话塞给子 agent；只传 bounded evidence。

验收：

• 子任务上下文更短、更准，有明确 non-goals 和 stop condition。
• subagent 输出更容易验证，减少“自称完成但不可核验”。

Phase 3：P1 治理能力吸收

目标：把 Aegis 更成熟的诊断和分层治理方法融入 Hermes 运维/skill 治理。

3.1 Trigger Health 诊断链

Hermes 化版本：

1. install/version：skill / profile / script 版本是否符合预期
2. discovery：Hermes 是否扫描到 skill/tool/config
3. activation/bootstrap：入口面是否加载对应规则
4. router entry：是否命中正确路由层
5. task-to-skill routing：任务是否匹配正确 skill
6. execution depth：skill 是否真正执行到关键步骤
7. context pressure/re-entry：压缩、长会话、resume 后是否丢触发
8. false positive：是否过度触发、干扰简单任务

进入 Hermes 的位置：

• hermes-skill-governance-audit
• hermes-runtime-effect-check
• hermes-cronjob-safe-update
• profile / gateway / WebUI / Feishu 行为不一致排查

边界：

• 触发失效时，不允许默认“加关键词”。
• 先定位失败层，再改 owner 层。

3.2 Rule Layering

Hermes 化版本：

Portable method rules：跨项目通用 skill 方法论
Host/Profile rules：WebUI / Feishu / CLI / cron / provider 特定行为
Repo rules：某个项目 AGENTS.md / CLAUDE.md / 本仓贡献约束
User preference：涛哥长期偏好
Runtime config：当前机器配置与运行态

进入 Hermes 的位置：

• skill authoring / governance
• AGENTS.md 注入规则审计
• 项目规则冲突诊断
• 外部项目吸收 stopline 判断

边界：

• 不把 repo-local 规则升级成全局 skill。
• 不把 host-specific 行为写进 portable method core。
• 用户显式指令永远高于方法包建议。

Phase 4：可选 Project Evidence Bundle 试点

目标：只在一个非核心项目里试 docs/aegis 风格 evidence bundle，看是否增强项目连续性。

建议试点对象：

• 不选 Hermes 主仓
• 不选 gateway / config 敏感项目
• 选一个低风险、任务边界清晰、需要多轮推进的小项目

目录可参考，但不照搬为标准：

docs/aegis/
  README.md
  INDEX.md
  work/
  plans/
  baseline/
  adr/

Hermes 化边界：

• docs/aegis 是项目内证据包，不是项目 registry。
• 项目状态仍以 [已移除本地路径] 和 project dashboard 为准。
• 长期知识仍进 wiki / skill / Hindsight。
• Decision Trace 仍负责决策归档。

验收：

• 是否减少长任务恢复成本
• 是否减少“项目状态散落在聊天里”
• 是否与现有 wiki/dashboard 重复
• 如果重复度高，停止试点，不推广

具体改造清单

必做 P0

应做 P1

可选 P2

验收标准

整体吸收不能以“写了方案”算完成，必须满足下面标准。

功能验收

• Hermes 现有 skill 没有出现 Aegis 同名平行 skill。
• codex-worker / delegate task 任务包能表达 goal、stop condition、known facts、unknowns、non-goals、verification expected。
• coding task 完成回执至少包含验证证据和 residual risk。
• skill 触发问题有 Trigger Health 诊断链可用。

边界验收

• 没有新增 ~/.config/aegis/config.toml active 依赖。
• 没有把 Aegis 作为默认 router。
• 没有把 docs/aegis 写入 Hermes 主项目或所有项目。
• 没有把 Aegis 文档当长期知识真相源。
• 没有让 Aegis 产生 completion authority。

回归验收

• 相关 Hermes skill frontmatter audit 通过。
• 修改后的 skill 可被 skills_list / skill_view 正常读取。
• 若 patch 影响 codex-worker，跑最小 codex-worker dry contract 检查。
• 若 patch 影响 subagent，跑一个 no-side-effect delegate packet 样例验证。

风险与对策

停止线

出现以下任一情况，停止吸收，不继续推进：

1. 需要把 Aegis 整包安装进主 HOME。
2. 需要让 Aegis 接管 skill routing。
3. 需要把 Aegis workspace 设为项目默认真相源。
4. 需要让 Aegis 输出 gate decision / completion authority。
5. 修改导致简单任务明显变慢或回复明显变重。
6. 与 Hermes 现有 skill / wiki / Hindsight / project dashboard 形成长期重复。

推荐执行顺序

建议按下面顺序实际落地：

1. 更新 codex-worker-routing：补 context packet + evidence card
2. 更新 subagent-driven-development：补 bounded context packet
3. 更新 verification/code-review/TDD 相关 skill：补 Evidence Card 最小口径
4. 新增 Trigger Health / Rule Layering references
5. 只在有需求时做 project evidence bundle 试点

不要一次性大改所有 skill。

最终边界声明

Aegis 进入 Hermes 的身份是：

method discipline donor
workflow governance casebook
artifact contract reference

Aegis 不进入 Hermes 的身份是：

runtime
router
memory
project registry
dashboard
completion authority
source of truth

最终建议：

做小、做准、做进现有 canonical skill；不要新建一套 Aegis-Hermes 平行治理系统。

关联记录

• 评估报告：[已移除本地路径]
• HTML：https://decision.ht1072.top/2026-05-29-aegis-absorption-evaluation.html
• Reference：[已移除本地路径]

更新时间：2026-05-29 08:45:47 CST