name: agent-registry
version: 2.0.1
description: |
用于高效加载智能体的强制智能体发现系统。Claude 必须使用此技能，
而非直接从 ~/.claude/agents/ 或 .claude/agents/ 加载智能体。通过搜索和获取工具提供按需加载。
使用场景：(1) 用户任务可能需要专业智能体协助；(2) 用户询问可用智能体；(3) 启动历史上使用过智能体的复杂工作流。
与预先加载所有智能体相比，此技能可减少约 95% 的上下文窗口占用。
hooks:
UserPromptSubmit:
- hooks:
- type: command
command: "bun ${CLAUDE_PLUGIN_ROOT}/hooks/user_prompt_search.js"
timeout: 5

智能体注册表

Claude Code 智能体的按需加载系统。通过按需加载智能体，消除“约 16k 词元”的警告。

核心规则

切勿假设智能体已预先加载。 务必使用此注册表来发现和加载智能体。

工作流程

用户请求 → search_agents(意图) → 选择最佳匹配 → get_agent(名称) → 使用智能体执行

可用命令

先搜索模式

1. 提取关键词：从用户请求中提取意图关键词
2. 执行搜索：bun bin/search.js "<关键词>"
3. 审查结果：检查相关性分数（0.0-1.0）
4. 按需加载：bun bin/get.js <智能体名称>
5. 执行：遵循已加载智能体的指令

示例

用户：“你能审查我的身份验证代码是否存在安全问题吗？”

# 步骤 1：搜索相关智能体
bun bin/search.js "代码审查 安全 身份验证"

# 输出：
# 找到 2 个匹配的智能体：
#   1. security-auditor (分数: 0.89) - 分析代码中的安全漏洞
#   2. code-reviewer (分数: 0.71) - 通用代码审查与最佳实践

# 步骤 2：加载最佳匹配
bun bin/get.js security-auditor

# 步骤 3：遵循已加载智能体的指令执行任务

安装

步骤 1：安装技能

快速安装（推荐）：

# 使用 Skills CLI（推荐）
npx skills add MaTriXy/Agent-Registry@agent-registry

# 交互式发现技能
npx skills find

# 更新现有技能
npx skills update

传统安装：

# 用户级安装
./install.sh

# 或项目级安装
./install.sh --project

# 可选：安装增强的交互式 UI 依赖项
./install.sh --install-deps

install.sh 的功能：
1. 将技能文件复制到 ~/.claude/skills/agent-registry/
2. 创建空的注册表结构
3. 可选通过 --install-deps 安装依赖项（@clack/prompts 用于增强 UI）

步骤 2：迁移您的智能体

运行交互式迁移脚本：

cd ~/.claude/skills/agent-registry
bun bin/init.js
# 可选：启用破坏性迁移模式
bun bin/init.js --move

交互式选择模式：

• 使用 @clack/prompts（默认）：美观的复选框 UI，支持按类别分组、词元指示器和分页
  • 方向键导航，空格键切换，回车键确认
  • 视觉指示器：[绿色] <1k 词元，[黄色] 1-3k，[红色] >3k
  • 按子目录分组
• 备用模式：基于文本的数字输入
  • 输入逗号分隔的数字（例如 1,3,5）
  • 输入 all 迁移所有智能体

init.js 的功能：
1. 扫描 ~/.claude/agents/ 和 .claude/agents/ 中的智能体文件
2. 显示可用的智能体及其元数据
3. 允许您交互式选择要迁移的智能体
4. 默认将选中的智能体复制到注册表（--move 为显式选择移动）
5. 构建搜索索引（registry.json）

依赖项

• Bun（随 Claude Code 提供）—— 核心功能无需额外依赖
• @clack/prompts：可选的增强交互式选择 UI（通过 ./install.sh --install-deps 安装）

注册表位置

• 全局：~/.claude/skills/agent-registry/
• 项目：.claude/skills/agent-registry/（可选覆盖）

未迁移的智能体将保留在其原始位置并正常加载（会增加词元开销）。