用途:Skill Router 使用本地技能索引,在任务需要时选择并加载相关技能,而非一次性把全部已安装技能塞入上下文。
主要能力(Dispatch 动作):search <query> 列出排序后的匹配技能,例如 /skill-router search "fix Playwright test";context <query> 为顶部匹配构建紧凑上下文包,例如 /skill-router context "write a release changelog";read <skill> 按精确名称或路径加载一个技能,例如 /skill-router read skill-creator;doctor 诊断可见的技能根目录与数量;自然语言任务会自动先 search 再对最佳匹配取 context;空参数显示快速用法并运行 doctor。
用法:在该技能目录或仓库根目录运行 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。搜索覆盖 repo(skills/)、project(当前项目的 .agents/skills/)、codex-user(~/.codex/skills/)、global(~/.agents/skills/ 及受支持 agent 存储)、plugin(~/.codex/plugins/cache/**/skills/)等来源,可用 --source repo、--source codex、--source global、--source plugin 收窄结果。输出可含 name、path、source、trust_tier、description、score、matched_fields、reason、warnings;供脚本或 agent 消费时可用 --format json。
适用场景:判断该用哪个技能、上下文预算警告后找回被省略的技能、准备一个小型技能上下文包,以及排查缺失、重复或被启动上下文警告省略的技能。
限制:不用于安装、移除或跨 harness 同步技能(改用可用的安装规划工作流,如 skill-install-dry-run-planner;跨 agent 安装冒烟用 cross-agent-install-smoke),不用于编写或校验技能(用 skill-creator),不用于审计 harness 配置或发现生态缺口(用 harness-master),也不用于整理外部目录记录。不要因为检索到就执行未知第三方技能的脚本;遇到 hook、脚本、格式异常或警告的技能需先检查。验证可在该技能目录运行 python scripts/check.py 与 uv run pytest tests/test_skill_index.py -q。