用途:解决 Claude Code 直接加载 ~/.claude/agents/ 下全部智能体导致的 token 开销问题,改为按需发现和加载。
主要能力:提供 list_agents.py(列出智能体总览)、search_agents.py(按意图关键词搜索匹配智能体)、search_agents_paged.py(大型注册表分页搜索)、get_agent.py(加载指定智能体的完整指令)。工作流为:用户请求 → 提取意图关键词搜索 → 查看相关性评分(0.0-1.0)→ 加载最佳匹配 → 按该智能体指令执行。
使用方式:安装可执行 npx add-skill MaTriXy/Agent-Registry,或 npm install -g @claude-code/agent-registry;传统方式运行 ./install.sh(用户级)或 ./install.sh --project(项目级)。随后进入 ~/.claude/skills/agent-registry 运行 python scripts/init_registry.py 迁移智能体,支持交互式选择(需 questionary,带复选框、分类分组与 token 指示)或文本模式回退。常用命令示例:python scripts/search_agents.py "code review security";python scripts/get_agent.py security-auditor。
适用场景:智能体数量较多、需要按任务意图动态选择与加载的 Claude Code 工作流,以及需要分页检索的大型注册表。
限制:依赖 Python 3.7 或更高版本及 questionary(安装失败时回退文本输入)。注册表位置为全局 ~/.claude/skills/agent-registry/ 或项目 .claude/skills/agent-registry/。未迁移的智能体仍留在原位置并照常加载,仍会产生 token 开销。