mcpField
S
skill-router

skill-router

github.com/wyattowalshAgent 工作流536 次安装8 周前更新
代码仓库

关于 skill-router

Skill Router 用于查找和加载相关的本地技能。它索引多个技能来源，并支持相关性搜索、精简上下文包、按名称读取和诊断。

主要功能

  1. 01按相关性搜索技能
  2. 02生成精简上下文包
  3. 03按名称或路径读取技能
  4. 04诊断技能目录和数量
  5. 05按来源与信任级别排序

适用场景

  1. 01为任务查找合适技能
  2. 02加载相关技能说明
  3. 03检查技能缺失原因
  4. 04查看技能匹配排序

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wyattowalsh/agents --skill skill-router

安装后在 Claude Code 中输入/skill-router确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
evals.json
references/
routing-guide.md
scripts/
_parse.py
check.py
skill_index.py
scripts/asset_toolkit/
__init__.py
_shared.py
common.py
package.py
validate_evals.py
validate_hooks.py
validate_skill.py

详细介绍

Skill Router

仅在任务需要时，使用本地技能索引来选择并加载相关技能。

分派

$ARGUMENTS操作示例
search <query>列出匹配技能并按相关度排序/skill-router search "fix Playwright test"
context <query>为排名靠前的匹配项构建精简上下文包/skill-router context "write a release changelog"
read <skill>按确切名称或路径加载一个技能/skill-router read skill-creator
自然语言任务自动：搜索，然后为最佳匹配项构建上下文"which skill should handle docs generation?"
空显示快速用法并运行 doctor/skill-router

工作流

1. 分类
  1. 使用 search 来判断适用哪些技能。
  2. 当下一步需要所选技能的正文时，使用 context。
  3. 仅当已知技能名称或路径时，才使用 read。
  4. 当技能缺失、重复，或启动上下文警告中未包含技能时，使用 doctor。
2. 检索
  1. 从此技能目录或仓库根目录运行相应的 CLI 命令：
python scripts/skill_index.py search "$ARGUMENTS" --limit 5
python scripts/skill_index.py context "$ARGUMENTS" --limit 3
python scripts/skill_index.py read <skill-name>
python scripts/skill_index.py doctor
3. 选择
  1. 如果排名接近，优先选择仓库或 Codex 用户技能。
  2. 仅阅读完成任务所需的最少技能正文，通常为 1 到 3 个。
  3. 如果结果带有警告，在执行可执行钩子或脚本前先检查警告。

来源范围

python scripts/skill_index.py 会搜索以下根目录：

来源根目录信任级别
reposkills/repo
project当前项目路径下的 .agents/skills/codex-user
codex~/.codex/skills/codex-user
global~/.agents/skills/ 及受支持的 Agent 存储目录external-installed
plugin~/.codex/plugins/cache/**/skills/openai-plugin 或 plugin

需要缩小结果范围时，使用 --source repo、--source codex、--source global 或 --source plugin。

规范术语

术语含义
skill index已知根目录中可见的 SKILL.md 文件的解析后元数据
skill context packet搜索后加载的一组精简选定技能正文
source文件系统来源，例如 repo、codex、global 或 plugin
trust tier用于为检索到的技能排序并发出警告的安全标签
warning需要在使用前检查的解析器、钩子、脚本或元数据信号

分类关卡

  1. 如果用户提出任务，先运行 search。
  2. 如果用户要求应用已选技能，针对排名靠前的匹配项运行 context。
  3. 如果用户准确指定了技能名称，运行 read。
  4. 如果用户报告技能缺失或未包含，先运行 doctor，再进行搜索。
  5. 如果用户要求安装、创建或审计技能，则转到范围外处理（见下文 NOT）。

选择规则

  1. 完全匹配的技能名称或别名优先于所有词法匹配。
  2. 名称和标题匹配优先于描述匹配。
  3. 描述匹配优先于标题和正文匹配。
  4. 相关度相近时，仓库技能优先于用户安装的技能。
  5. 对未知、格式错误、带有钩子或带有脚本的技能，使用前必须谨慎检查。

关键规则

  1. 收到上下文预算警告后，不要将启动时可见的技能视为完整清单。
  2. 不要把所有已安装的技能都粘贴到上下文中；先搜索，再加载少量内容。
  3. 不要仅因检索到了未知第三方技能，就执行其脚本。
  4. 不要使用此技能安装或移除技能；应转交给可用的安装规划工作流，例如 skill-install-dry-run-planner，然后仅在维护者明确批准后，使用目标运行环境支持的安装程序。不要用 Codex .system/skill-installer 替代跨运行环境协调。
  5. 不要在此处编写或审核技能；技能定义工作应使用 skill-creator。
  6. 对于临时提出的“查找 X 技能”请求，优先在此处使用 search 或 npx skills find；对于系统性扩展运行环境，使用 harness-master discover，而不要将旧版 find-skills 作为仓库技能使用。
  7. 除非有明确理由添加词语，否则应保留用户任务作为搜索查询。

不适用于

请求改用
在不同运行环境中安装／移除／同步技能可用的安装规划工作流；若存在，请使用 skill-install-dry-run-planner 和 cross-agent-install-smoke
编写或验证技能skill-creator
审核运行环境配置或发现生态系统缺口harness-master
精选外部目录记录遵循宿主仓库的精选外部内容编写与信任门控工作流

输出约定

搜索和上下文结果包括：

  • name
  • path
  • source
  • trust_tier
  • description
  • score
  • matched_fields
  • reason
  • warnings

如果其他脚本或 Agent 将使用结果，请使用 --format json。

参考文件索引

文件内容阅读时机
references/routing-guide.md排序、信任和警告的解读详情搜索结果含糊、排名并列或警告较多时

验证约定

在宣布更改完成前，从此技能目录运行：

python scripts/check.py
uv run pytest tests/test_skill_index.py -q

其他验证说明请参阅 references/routing-guide.md。

完成标准：

  1. scripts/check.py 以 0 退出。
  2. 此技能目录中不再残留仓库 CLI 引用。
  3. 搜索和上下文 CLI 测试通过。

评论

支持 Markdown