Hermes Decision Trace

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

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

HTML完整论证
Wiki可检索归档
Feishu短入口交付
🎯
核心结论

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

🧭
推荐路径

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

🛡️
关键边界

不调用真实 executor；生产动作另走审批。

关键判断

判断项摘要
推荐方案建议按下面顺序实际落地：
关键依据见完整记录中的评分依据、状态摘要和证据链。
落地方式建议按下面顺序实际落地：
风险边界不跨执行边界；真实执行需另走审批。

证据摘要

  • 由 Hermes 会话生成。证据点 1
  • 如涉及外部事实，应在正文中保留来源或验证路径。证据点 2

行动清单

建议按下面顺序实际落地：
不要一次性大改所有 skill。

边界 / 风险

风险点

未记录额外风险。

完整记录

本节目录结论背景总体吸收边界目标状态体系落点分阶段执行方案具体改造清单验收标准风险与对策停止线推荐执行顺序最终边界声明关联记录

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 可控的局部增强。

总体吸收边界

允许吸收

类型是否吸收原因
workflow discipline是对 coding-agent 稳定性有直接收益
evidence contract是与 Hermes 验证优先偏好一致
subagent context packet是可增强 delegate / codex-worker 任务边界
trigger health diagnostic chain是可改善 skill / profile / gateway 路由排障
rule layering model是可改善 skill、AGENTS.md、项目规则分层治理
project workspace advisory pattern有条件只做 evidence sidecar 参考，不做默认项目真相源
multi-host packaging pattern观察暂不落地，未来 Hermes skills 分发时再参考

禁止吸收

类型是否吸收原因
整包 global install否会引入平行 skill/rule 系统
Aegis 默认 router否Hermes 已有 skill routing / profile / tools
Aegis runtime core 概念否项目自身也没有 runtime core
Aegis completion authority否会越过 Hermes 和用户显式指令
~/.config/aegis 常驻配置否本次验证已证明会污染本机 active config
docs/aegis 默认植入所有项目否会与 project registry / wiki / dashboard 平行化
Aegis memory / recall 替代否Aegis 不是 memory system
全量导入 Aegis skills否与 Hermes 现有 skill 大量重名/重叠

目标状态

吸收完成后，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

体系落点

Aegis 能力Hermes 落点吸收方式
Verification Before Completionrequesting-code-review / test-driven-development / systematic-debugging / PR 回执补回执结构和验证口径
Evidence Cardcode-review / deploy / PR / codex-worker 结果回执模板化字段
SubagentContextPacketdelegate_task 使用规范 / codex-worker-routing任务包 contract
TaskIntentDraftplan / codex-worker task contract简化版字段
BaselineReadSetHintproject incubation / codebase inspection / debugging读前基线提示
ImpactStatementDraftDecision Trace / architecture decision / PR review风险影响面模板
ResumeStateHintlong task continuation / project dashboard恢复任务上下文
DriftCheckDraftmigration drift audit / project status closure漂移检查模板
Trigger HealthHermes skill / cron / profile / gateway routing 排障新 reference 或 skill patch
Rule Layeringskill governance / AGENTS.md / project rules治理准则
Project Workspaceproject dashboard evidence bundle非默认试点

分阶段执行方案

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

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

动作：

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

```bash

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

```

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

```bash

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

```

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

```text

backup: /home/ht/.config/aegis/config.toml.aegis-eval-polluted-20260529_082657.bak

disabled: /home/ht/.config/aegis/config.toml.disabled-aegis-eval-20260529_082657

active_config_after: 0

```

验收：

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

Phase 1：Reference-only 吸收

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

已完成：

/home/ht/.hermes/skills/integration/external-project-absorption-eval/references/aegis-method-pack-partial-absorb-2026-05-29.md

建议新增或补充：

/home/ht/.hermes/skills/software-development/subagent-driven-development/references/aegis-context-packet-mapping-2026-05-29.md /home/ht/.hermes/skills/devops/codex-worker-routing/references/aegis-evidence-contract-mapping-2026-05-29.md

验收：

  • 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。
  • 项目状态仍以 /home/ht/.hermes/projects/projects.yaml 和 project dashboard 为准。
  • 长期知识仍进 wiki / skill / Hindsight。
  • Decision Trace 仍负责决策归档。

验收：

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

具体改造清单

必做 P0

编号改造项文件 / skill类型风险
P0-1增加 Evidence Card 回执规范code-review / TDD / debugging 相关 skillskill patch低
P0-2增加 SubagentContextPacket 精简 contractsubagent-driven-developmentreference + skill patch低
P0-3增加 codex-worker task contract 字段codex-worker-routingreference + skill patch中低

应做 P1

编号改造项文件 / skill类型风险
P1-1Trigger Health Hermes 化skill governance / runtime effect checkreference低
P1-2Rule Layering Hermes 化skill lifecycle governancereference低
P1-3将 Aegis 判例纳入 casebookexternal-project absorption casebookreference index低

可选 P2

编号改造项文件 / skill类型风险
P2-1project evidence bundle 试点某个非核心项目trial中
P2-2多 host plugin packaging 观察暂无watch低

验收标准

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

功能验收

  • 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 样例验证。

风险与对策

风险表现对策
规则膨胀简单任务也被强制走复杂流程fast-path 保留，Evidence Card 可压缩
平行系统Aegis skill 与 Hermes skill 同名共存禁止全量导入，只 patch canonical Hermes skill
配置污染~/.config/aegis 指向临时 repo不运行 global write-config；必要时隔离 HOME
过度治理workflow 成本高于任务收益按风险分层：low / medium / high
知识分裂docs/aegis、wiki、dashboard 各说各话docs/aegis 只做 evidence sidecar，wiki/dashboard 仍为主
权威越界verification 被误当 final authority明确 evidence ≠ completion authority

停止线

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

  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 平行治理系统。

关联记录

  • 评估报告：/home/ht/llm-wikis/knowledge-ops/queries/aegis-absorption-evaluation-2026-05-29.md
  • HTML：<https://decision.ht1072.top/2026-05-29-aegis-absorption-evaluation.html>
  • Reference：/home/ht/.hermes/skills/integration/external-project-absorption-eval/references/aegis-method-pack-partial-absorb-2026-05-29.md

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

Generated 2026-05-29T18:22:38+08:00 · Hermes decision trace