portal-router 是一个跨智能体能力解析工具。当能力分散在多个智能体生态（Claude、Codex、Gemini、OpenCode、OpenClaw、共享 .agents 池、技能分发）中时，真正昂贵的问题不再是“我如何做 X”，而是“我的哪个智能体已经拥有做 X 的技能，以及我如何加载它”。portal-router 从一个地方回答这个问题。
用途
它把每个生态都视为一个能力来源，将其异构的单元形态规范化为一条记录，按意图对匹配项排序，并加载选中的单元。它是编排器在编写新技能之前会先使用的技能——用来检查整个智能体群是否已经拥有该能力。
适用场景
- “哪个智能体有用于 PDF 提取 / k8s / 数据清洗的技能？”
- “给我找一个能做 Y 的能力”——跨所有智能体，而不仅是当前这一个。
- 在锻造新技能之前：确认整个智能体群还没有这样的技能。
- 把任务路由到拥有正确工具的那个智能体。
加载路径
参考实现是操作者的 ~/_arms/arm portal（_arms 跨智能体技能生态）。它暴露：
arm find <query…> # 按相关性对 ALL 生态中的能力排序 arm list [ecosystem] # 门户索引（实时计算；永不陈旧） arm show <eco> <name> # 通过门户 LOAD 一个能力（打印其正文） arm status # 门户健康状态
示例——无论哪个智能体拥有该能力都能找到它，然后加载：
arm find pdf extraction arm show claude pdf-processing # 能力通过门户加载进上下文
解析方式（引擎）
references/resolve.py（仅用标准库的 Python——无依赖）是可移植引擎。它：
- 发现每个生态的技能主目录（跟随符号链接——find -L / followlinks=True；镜像条目是符号链接，不跟随它们门户会读成空——这是唯一的关键细节）。
- 规范化异构单元——带 YAML frontmatter 的 Claude/Codex/Gemini SKILL.md 目录、OpenCode 扁平命令 .md（name = 文件名）、a-i--skills 的 *.skill/category 目录——统一为一条 {ecosystem, type, name, description, path, invoke} 记录。
- 对匹配项排序（name > triggers > description > path），并在 show 时打印该单元以及该智能体自身加载器的精确 invoke 提示。
把它指向任意生态目录（默认 ~/_arms/mirror/ + ~/_arms/skills/），它会实时索引它们。索引在每次调用时从来源计算，因此永远不会偏离现实——没有会陈旧的存储索引。
关于覆盖范围的诚实说明
对于同一智能体的单元（例如 Claude 加载 Claude 的 SKILL.md），show 是真正的上下文加载。对于其他智能体，它打印该单元以及该智能体加载器的精确 invoke 提示——门户把你路由到门口；每个智能体仍然自己开门。跨智能体执行是编排器的职责（见 agent-swarm-orchestrator）；portal-router 是其下的发现与路由层。