find-skills 使用说明

1. find-skills 是什么

find-skills 是一个“技能发现”类 skill。
它的核心作用不是直接完成编码任务，而是先帮你找到合适的技能，再安装对应 skill 去完成任务。

适合场景：

• 你不确定“这类任务有没有现成 skill”。
• 你希望先看候选方案，再决定安装哪个。
• 你需要按领域检索（如 React 性能、PR 评审、测试、部署、文档等）。

2. 快速开始

2.1 安装 find-skills

npx skills add https://github.com/vercel-labs/skills --skill find-skills

2.2 搜索技能

npx skills find [query]

示例：

npx skills find react performance
npx skills find pr review
npx skills find changelog
npx skills find playwright e2e

2.3 安装搜索到的目标 skill

搜索结果通常会给出类似 owner/repo@skill 的安装目标，执行：

npx skills add <owner/repo@skill>

示例：

npx skills add vercel-labs/agent-skills@vercel-react-best-practices

3. 推荐工作流（4 步）

1. 明确需求：先确认任务领域与目标（例如“React 首屏性能优化”）。
2. 执行搜索：使用精准关键词运行 npx skills find ...。
3. 评估候选：看 skill 描述、来源仓库、审计状态、适配工具。
4. 确认安装：选择一个最匹配的 skill 后执行 npx skills add ...。

4. 常用命令清单

npx skills find [query]   # 搜索技能
npx skills add <package>  # 安装技能
npx skills check          # 检查可更新项
npx skills update         # 更新已安装技能

5. 查询词怎么写更有效

推荐策略：

• 用“领域 + 任务”组合词：如 react testing、nextjs performance、api security。
• 同义词替换：deploy / deployment / ci-cd 可交替尝试。
• 从具体问题出发：比泛词更容易命中高质量 skill。

可参考分类与关键词：

• Web 开发：react nextjs typescript tailwind
• 测试：jest playwright e2e
• DevOps：deploy docker kubernetes ci-cd
• 文档：docs readme changelog api-docs
• 代码质量：review lint refactor best-practices
• 设计/可访问性：ui ux design-system accessibility

6. 没搜到结果怎么办

如果 find 没有命中：

1. 换关键词再试（缩短或改同义词）。
2. 先不依赖 skill，直接按通用工程方法完成任务。
3. 对高频任务可以考虑自建 skill：

npx skills init my-xyz-skill

7. 安全与风险提示（重要）

find-skills 本身会引导你搜索并安装外部 skill，因此要有以下意识：

• 安装前先看 skill 详情页与安全审计页（Agent Trust Hub / Socket / Snyk）。
• 不要盲目安装来源不明或审计告警明显的 skill。
• 对自动确认安装参数（如 -y）保持谨慎，优先人工确认后安装。

8. 一段可直接复用的实操模板

当你有任务“优化 React 页面性能”：

# 1) 搜索候选
npx skills find react performance

# 2) 安装选中的 skill（示例）
npx skills add vercel-labs/agent-skills@vercel-react-best-practices

# 3) 后续维护
npx skills check

9. 参考链接

• 技能页：https://skills.sh/vercel-labs/skills/find-skills
• 安全审计（ATH）：https://skills.sh/vercel-labs/skills/find-skills/security/agent-trust-hub
• 安全审计（Socket）：https://skills.sh/vercel-labs/skills/find-skills/security/socket
• 安全审计（Snyk）：https://skills.sh/vercel-labs/skills/find-skills/security/snyk