查找技能（reskill）

该技能帮助您从 reskill 生态系统中发现并安装技能。

安全性与可信度

该技能指导智能体通过 reskill 执行 CLI 命令——reskill 是一个开源、基于 Git 的 AI 智能体技能包管理器。

为何使用特定注册表？
reskill 支持多个注册表。本技能默认使用 Rush 社区注册表（https://rush.zhenguanyu.com/）——这是 reskill 生态系统的主公开注册表，其定位类似于 npm 默认使用 https://registry.npmjs.org。用户可通过 --registry 参数、RESKILL_REGISTRY 环境变量，或 skills.json 中的 defaults.publishRegistry 配置项随时覆盖该默认值。

CLI 执行方式：
为避免每次调用都下载远程代码，我们建议首先全局安装 reskill：

npm install -g reskill

若无法进行全局安装，可使用 npx reskill@latest 作为备用方案。智能体应在回退至 npx 前先检查是否存在全局安装。

核心原则：

1. 搜索 → 展示 → 提问 → 安装 —— 始终先展示结果，再征得用户同意后执行安装。
2. 注册表感知 —— 使用当前配置的注册表，并明确告知用户正在搜索哪个注册表。
3. 优先使用本地 CLI —— 若已全局安装 reskill，则直接调用；仅在必要时才回退至 npx。

何时使用该技能

当用户出现以下情况时，请使用该技能：

• 询问“如何实现 X”，而 X 是一项已有对应技能的常见任务
• 提出“为 X 找一个技能”或“有没有 X 相关的技能”
• 询问“你能做 X 吗”，而 X 是某项专业化能力
• 表达出拓展智能体能力的兴趣
• 希望创建、编写或向注册表发布技能
• 希望搜索工具、模板或工作流
• 提及希望在某个特定领域（如设计、测试、部署等）获得支持

快速推荐

对于以下广为人知的意图，跳过搜索步骤，直接推荐对应技能：

若该技能尚未安装，主动提供安装选项；随后照常进入第 4 步（确定目标智能体）。

什么是 reskill？

reskill 是一款基于 Git 的 AI 智能体技能包管理器，提供声明式配置、版本锁定以及跨项目和团队的技能无缝同步能力。

用于技能发现的关键命令：

• reskill find —— 按关键词搜索技能
• reskill find --json —— 以机器可读的 JSON 格式输出搜索结果
• reskill install —— 安装技能
• reskill list —— 列出已安装的技能
• reskill info —— 显示技能详情

如何协助用户查找技能

第 0 步：解析 CLI 与注册表

CLI 解析：检查 reskill 是否已全局安装。若存在，则直接使用 reskill；否则回退至 npx reskill@latest。

which reskill

注册表解析（优先级由高到低）：

1. --registry CLI 参数
2. RESKILL_REGISTRY 环境变量
3. skills.json 中的 defaults.publishRegistry
4. 默认值：https://rush.zhenguanyu.com/

若前三者均未设置，则需显式传入 --registry https://rush.zhenguanyu.com。同时请向用户说明当前所使用的注册表。

第 1 步：理解用户需求

当用户请求某项帮助时，请识别以下三点：

1. 所属领域（例如：React、测试、设计、部署）
2. 具体任务（例如：编写测试、创建动效、评审 PR）
3. 该任务是否足够常见，以至于很可能已有对应技能

第 2 步：技能搜索（渐进式策略）

使用 --json 获取结构化结果。以下示例均使用 reskill（若未全局安装，请替换为 npx reskill@latest）：

reskill find "" --json --registry https://rush.zhenguanyu.com

JSON 输出结构如下：

{
  "total": 2,
  "items": [
    {
      "name": "@scope/skill-name",
      "description": "该技能的功能说明",
      "latest_version": "1.0.0",
      "keywords": ["keyword1", "keyword2"],
      "publisher": { "handle": "author" },
      "updated_at": "2025-01-01T00:00:00Z"
    }
  ]
}

重要提示：采用渐进式搜索策略以最大化命中率。 注册表可能不支持多词模糊匹配，因此请按以下顺序执行：

第一轮：优先尝试自然语序查询

reskill find "frontend design" --json --registry https://rush.zhenguanyu.com

若 total > 0，则进入第 3 步（展示结果）。

第二轮：尝试连字符连接形式

技能名称常使用连字符。若第一轮返回零结果，请尝试将关键词用连字符连接：

reskill find "frontend-design" --json --registry https://rush.zhenguanyu.com

第三轮：收窄至最相关单个关键词

若仍未返回结果，请从用户原始查询中选取最具特异性的一个关键词单独搜索：

reskill find "frontend" --json --registry https://rush.zhenguanyu.com

应选择最能限定领域的关键词（例如：相比宽泛的 “design”，优先选用 “frontend”）。

第四轮（可选）：尝试同义词或替代词

若仍无结果，可尝试同义词或关联术语：

• "frontend" → "ui", "web", "react"
• "deploy" → "deployment", "ci-cd", "devops"
• "test" → "testing", "jest", "playwright"

智能体端过滤

当宽泛搜索返回大量结果时，请逐条阅读每项的 description 字段，并依据与用户原始请求的相关性进行筛选。仅呈现真正满足用户需求的技能，切勿盲目展示全部结果。

示例流程 —— 用户提问：“帮我处理前端设计相关事务”：

1. find "frontend design"    → 0 结果
2. find "frontend-design"    → 0 结果
3. find "frontend"           → 3 结果
4. 阅读描述 → 过滤 → 其中 1 项与 UI 设计切实相关
5. 仅向用户展示这 1 项结果

搜索查询示例：

一旦获得相关结果即可停止搜索，无需强制执行全部轮次。

第 3 步：展示结果并在安装前征询用户意见

当找到相关技能时，请清晰地向用户展示以下信息：

1. 技能名称与功能描述
2. 版本号与作者
3. 结果来源注册表（公共或私有）
4. 安装命令

然后询问用户希望安装其中哪些技能。

示例响应：

我找到了一个可能对您有帮助的技能！（来自注册表：rush.zhenguanyu.com）

**@scope/react-best-practices**（v1.2.0）  
React 与性能优化指南。

安装命令：
  reskill install @scope/react-best-practices -y --registry https://rush.zhenguanyu.com

是否需要我为您安装？

若返回多个结果，请仅展示最相关的前 2–3 项，并由用户自行选择。一旦用户确认（例如：“安装它”、“是”、“安装第 1 和第 3 项”），即批量安装所有已确认的技能，无需再次逐项确认。

第 4 步：确定目标智能体

安装前，请明确技能应安装到哪些智能体上。按以下优先级顺序判断：

优先级 1：用户显式指定了 --agent

若用户明确表示“安装到 cursor”或“安装到 claude-code”，请直接传递 -a 参数，跳过所有自动检测逻辑。

优先级 2：读取 skills.json → defaults.targetAgents

在当前目录及其向上最多 3 层父目录中查找 skills.json。若找到，检查其中是否存在 defaults.targetAgents 字段：

{
  "defaults": {
    "targetAgents": ["cursor", "claude-code"]
  }
}

若已配置 targetAgents，则直接使用这些智能体，并附加 -a 参数：

reskill install  -y -a cursor claude-code --registry https://rush.zhenguanyu.com

优先级 3：检测智能体目录

若未找到 skills.json，或其中未定义 targetAgents，则扫描当前目录及其向上最多 3 层父目录中是否存在已知智能体目录：

注意： 对于 GitHub Copilot，请检查 .github/skills/ 而非仅 .github/，因为单独的 .github/ 目录通常存放工作流或 issue 模板，不能代表 Copilot 已启用。

若检测到一个或多个智能体目录，请向用户说明检测结果并确认是否继续安装：

检测到智能体目录：.cursor/
将安装至 Cursor（.cursor/skills/）。是否继续？（或指定其他智能体）

若用户确认，则执行带 -a 参数的安装命令：

reskill install  -y -a cursor --registry https://rush.zhenguanyu.com

若检测到多个智能体目录，请列出全部选项，由用户选择要安装的目标。

优先级 4：向用户提问

若上述任一途径均未获取到智能体信息，请向用户提问目标智能体：

未找到智能体配置。您希望将此技能安装到哪个（些）智能体？

支持的智能体：cursor, claude-code, codex, windsurf, copilot, opencode

随后根据用户指定的智能体执行安装。

第 5 步：安装技能

# 安装至指定智能体
reskill install  -y -a  --registry https://rush.zhenguanyu.com

# 全局安装（用户级，对所有项目生效）
reskill install  -y -g --registry https://rush.zhenguanyu.com

-y 参数用于跳过 CLI 的交互式确认提示。

安装完成后，请通知用户该技能已就绪，并简要说明其新增能力。

常见技能分类

构建搜索查询时，可参考以下分类：

高效搜索技巧

1. 遵循渐进式策略：多词 → 连字符 → 单关键词 → 同义词
2. 选取最具特异性的关键词：优先选 “frontend” 而非 “design”，选 “playwright” 而非 “testing”
3. 尝试替代词：“deploy” → “deployment”, “ci-cd”, “devops”
4. 始终阅读描述字段：宽泛搜索返回大量结果时，依赖描述内容精准筛选
5. 技能名常用连字符：记得尝试 “code-review”、“best-practices” 等格式

未找到匹配技能时的处理

若在穷尽所有搜索轮次（多词 → 连字符 → 单关键词 → 同义词）后仍无相关技能：

1. 明确告知用户未发现现有技能，并简要说明已尝试的搜索词
2. 主动提出可直接利用自身通用能力协助完成该任务
3. 建议用户可自行创建新技能

示例：

我已在注册表中尝试多个查询（"frontend design"、"frontend-design"、"frontend"），
但未找到匹配的技能。

我仍可直接协助您完成此项任务！是否需要我立即开始？

若您经常执行此类操作，也可考虑创建专属技能并共享：
  mkdir my-skill && echo "---\nname: my-skill\n---\n# My Skill" > my-skill/SKILL.md

检查已安装技能

在搜索新技能前，可先查看当前已安装的技能：

# 列出所有已安装技能
reskill list

# 查看某项技能的详细信息
reskill info 

此举可避免向用户推荐其已拥有的技能。