核心用法
rush-find-skills 是面向 reskill 生态的技能发现与安装助手，解决用户"如何完成某任务"或"寻找某能力"的扩展需求。其标准流程遵循搜索→展示→确认→安装四步原则，始终先呈现结果再征得用户同意。
渐进式搜索策略是本技能的关键设计：当多关键词查询无结果时，自动降级为连字符形式、再降级为最核心的单一关键词，必要时尝试同义词扩展，最大化匹配成功率。搜索返回结构化 JSON 后，Agent 需阅读 description 字段进行相关性过滤，避免盲目推荐。
智能 Agent 检测分四级优先级：显式指定的 --agent > skills.json 配置 > 目录扫描（.cursor/、.claude/ 等）> 主动询问用户。检测到多 Agent 环境时会列出选项供用户选择，确保技能安装到正确位置。
显著优点
- 注册表感知：默认指向 Rush 私有注册表
rush.zhenguanyu.com，同时兼容公共注册表回退，支持企业私有化部署 - 零配置开箱即用：未配置时自动追加
--registry参数，降低用户认知负担 - 多 Agent 生态适配：覆盖 Cursor、Claude Code、Codex、Windsurf、GitHub Copilot、Opencode 六大主流平台
- 快速推荐机制：对已知高频意图（如创建/发布技能）直接推荐
@kanyun/rush-reskill-usage，跳过搜索环节 - 安全确认机制：安装前必确认，
-y仅用于自动化场景，避免误操作
潜在局限
- 注册表检索能力有限：明确提示不支持多词模糊匹配，需依赖渐进式策略补偿
- 企业注册表依赖：默认 Rush 注册表若不可达，回退逻辑可能暴露公网请求
- Agent 目录硬编码：新增 IDE/Agent 需手动更新目录映射表
- 无本地缓存：每次搜索均请求注册表，离线场景不可用
适合人群
- 需要为团队统一配置技能仓库的技术负责人
- 频繁切换 Cursor/Claude Code 等多 Agent 环境的全栈开发者
- 希望将内部工具封装为可复用技能的平台工程师
- 寻求"对话即扩展"体验的 AI Agent 终端用户
常规风险
| 风险点 | 说明 |
|--------|------|
| 供应链安全 | 技能来自第三方注册表，建议企业启用私有注册表并审计来源 |
| 权限扩散 | `-y` 自动确认可能绕过人工检查，生产环境建议禁用 |
| Agent 配置污染 | 多项目嵌套时目录扫描可能误判，建议显式配置 `targetAgents` |
| 版本漂移 | 未锁版本时 `latest` 可能引入破坏性变更，关键项目应指定版本 |