AI Agent Layer Routing Decision Checklist
Summary
这页把 [[hermes-agent-workflow-layering-and-adoption-order]] 再往前推进一层,变成可执行的路由判定清单。它不是要求在 wiki、memory、skill、cron 与 MCP 中五选一,而是把需求拆成五个可组合维度:内容归属、执行方法、触发方式、外部能力和运行状态。具体能力以目标客户端的官方文档和实际工具列表为准;wiki 是独立知识层,不要求 Agent 原生内置。
Capability mapping before routing
下列名称是职责简称,不是所有 Agent 都内置的产品接口:
| 职责 | 可用载体 | 缺少原生能力时 |
|---|---|---|
| 稳定偏好与事实 | 宿主 memory、授权的偏好文件 | 使用当前任务显式提供的约束 |
| 可复用方法 | skill、项目 SOP、操作指南 | 直接查阅方法,不强制安装 Skill |
| 定时触发 | 宿主 scheduler、系统 cron、CI | 保持人工或按需触发 |
| 外部能力 | 已授权 API、CLI、连接器、MCP | 说明缺口,不假定必须新增 MCP |
| 正式知识 | 共享 Wiki | 使用文件搜索和阅读即可 |
本页是从已有知识边界与产品实例提炼的路由建议。Hermes 官方文档仅支撑其实现实例,不证明任何其他客户端具备相同接口、预算、隔离或权限语义。
One-screen routing rule
对同一需求分别回答五个问题,不在第一个“是”处停止:
- 内容归属:公开且长期可复用的正式知识进
wiki;短小稳定且适合默认保留的事实进memory;项目局部内容进项目文档或状态;临时、私有或一次性内容留在 session、项目记录或 Git 历史。 - 执行方法:重复、已验证的方法可形成
skill;一次性操作不必为了留痕而 skill 化。 - 触发方式:默认人工或按需触发;只有方法稳定、失败边界清楚且目标部署确认支持并授权时,才考虑
cron。 - 外部能力:需要动态外部数据或操作时,先确认已有且获准的连接方式;只有目标部署实际支持且适配时才选择
MCP。 - 运行状态:当前结果、队列、故障和执行进度从 live system、project state 或 logs 读取,不写成 Wiki 当前事实。
一个场景可以同时得到 wiki + skill + cron + MCP,但每层只承载自己的部分;组合不等于复制同一内容。
Guardrails kept in the quick path
本页不再重复维护 memory、skill、wiki 的完整正反例;内容归属以 hermes-memory-skills-wiki-boundaries 为准。快速判断时仍保留以下会改变行动的边界:
- 内容归属:私有、项目局部、一次性或运行中状态不因流程重要而进入公共 Wiki;公共准入以
SCHEMA.md为准。 - 执行方法:只有可重复、已验证且需要步骤与验收的方法才形成
skill;一次性指令保持一次性。 - 触发方式:
cron只决定何时启动。方法、输入输出和失败处理先稳定;任务输入应自包含,实际会话复用、重试和投递语义须按目标调度器核对。 - 外部能力:
MCP只解决外部动态数据或动作接入。先确认已有获准工具是否足够;具体协议、传输、过滤和权限以选用的实现为准,并保持最小暴露面。 - 运行状态:当前结果、故障和进度始终从 live system、project state 或 logs 读取,不从 Wiki 推断。
产品文档仅支撑相应产品的实例行为;本页的跨客户端路由是方法建议,不证明目标部署已启用或授权这些能力。
Anti-confusion rules
memory vs wiki
- 短小稳定事实 →
memory - 长期查阅知识 →
wiki - 如果需要多段结构、来源、链接、持续扩写,通常就不该进
memory
skill vs wiki
- 公开操作指南 → Wiki
operations/;需要宿主触发、工具与执行约束的复用方法 →skill - 回答“这是什么 / 为什么这样分层” →
wiki
skill vs cron
- 定义方法 → SOP 或
skill - 定义什么时候自动跑 →
cron
MCP vs wiki
- 外部实时能力 → 已授权 API、CLI、连接器或适配的
MCP - 整理后的稳定知识 →
wiki
MCP vs skill
- 接工具能力 → 复用已授权接入;
MCP是可选实现 - 用这能力怎么稳定做一类事 → SOP 或
skill
Synthetic examples
以下只演示职责组合,不表示某个连接器、任务或调度已经部署或获批。
例 1:周期性检查外部 CI 并形成摘要
- 内容归属:通用且适合公开的判定原则可进
wiki;目标仓库配置和收件人留在项目或私有配置 - 执行方法:重复且验证过的检查步骤可进
skill - 触发方式:先人工或按需运行;目标版本支持、风险可控且另有授权时才使用
cron - 外部能力:按实际部署选择已获准的工具;需要且已核验时才可能是
MCP - 运行状态:每次 CI 结果留在 CI、project state 或运行日志,不写成 Wiki 当前事实
例 2:一次私有故障暴露出通用恢复原则
- 内容归属:私有日志、会话和 closeout 留在原载体;只有去标识化、适合公开且长期可复用的原则才编译进对应 Wiki 正式页
- 执行方法:若恢复步骤重复验证后稳定,可另行形成
skill - 触发与外部能力:没有独立需求就保持为空,不为凑齐层次而增加
cron或MCP - 运行状态:故障是否仍存在必须实时核验
例 3:整理一篇公开 agent 架构文章
- 内容归属:有长期价值的来源与综合结论可进入
wiki - 执行方法:文章整理流程重复且已验证时可复用 SOP;需要宿主执行契约时再形成
skill - 其余维度:没有定时、外部动态操作或运行状态需求时,不需要
cron、MCP或状态页
Relations
- depends_on: hermes-memory-skills-wiki-boundaries