Skip to content

AI Agent Layer Routing Decision Checklist

以内容归属、执行方法、触发方式、外部能力和运行状态五个可组合维度判断 AI Agent 层间路由。

Updated View as Markdown

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

对同一需求分别回答五个问题,不在第一个“是”处停止:

  1. 内容归属:公开且长期可复用的正式知识进 wiki;短小稳定且适合默认保留的事实进 memory;项目局部内容进项目文档或状态;临时、私有或一次性内容留在 session、项目记录或 Git 历史。
  2. 执行方法:重复、已验证的方法可形成 skill;一次性操作不必为了留痕而 skill 化。
  3. 触发方式:默认人工或按需触发;只有方法稳定、失败边界清楚且目标部署确认支持并授权时,才考虑 cron。
  4. 外部能力:需要动态外部数据或操作时,先确认已有且获准的连接方式;只有目标部署实际支持且适配时才选择 MCP。
  5. 运行状态:当前结果、队列、故障和执行进度从 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

Navigation

Type to search…

↑↓ navigate↵ selectEsc close