找技能

作者 admin

2026年11月4日 4 分钟阅读

0 0

下载地址

代码

https://www.zhengdianxue.com/wp-content/uploads/skills/org-bzwfrdvh--aipdd-find-skills.zip

将提示词发送给你的 AI 安装该 skills

代码

请根据 https://skillhub.cn/install/skillhub.md，安装 @org-bzwfrdvh/aipdd-find-skills。

意图驱动的技能发现工具。在与用户沟通意图的过程中主动识别技能需求：当用户用自然语言描述场景/需求（如&quot
我想做一个海报&quot
&quot
帮我分析股票&quot
），或对话中任务升级为高价值任务，或明确说&quot
安装技能/find skills/找个skill&quot
…（完整说明见下方「阅读全文」）

阅读全文（展开查看完整说明）

概述

find-skills（场景技能匹配器）

Overview

本技能用于场景驱动的技能发现引擎——用户用自然语言描述需求，系统自动理解意图，联合搜索并推荐最合适的技能。

与官方原 find-skills 插件的关系：

官方原 find-skills 插件的 description 已被标记为 DEPRECATED，不会主动触发
本技能已完全覆盖其所有能力，并新增了官方内置扫描 + 本地已安装扫描 + 场景语义理解 + 推荐理由输出

核心流程

Step 0：意图沟通与技能需求判定（主动发现）

本技能不止在用户"找技能"时触发——在与用户沟通意图的过程中，持续判断当前任务是否需要技能支持，一旦产生搜索需求就进入后续搜索流程。

沟通中何时产生搜索需求（高价值任务判定，满足任一即触发）：

任务复杂度高：多步骤、专业性强的任务（数据分析、内容生产、自动化流程）
存在明确产出物：海报、文章、PPT、视频、代码项目等
涉及专业工具/平台：股票、公众号、Excel、GitHub、设计工具等
用户表达出"有没有更好的方式/工具"
用户明确说"找技能/安装技能/找个skill"

何时不触发（避免打扰）：

纯闲聊、寒暄、答疑类对话
简单一次性任务（改个文件名、算个数）
当前任务已在使用技能且运行正常
用户明确表示不需要

三种触发方式：

任务开始：用户描述场景时 → 完整搜索 + 完整推荐（输出形态 A）
对话中途：任务执行中发现更合适的技能 → 不打断当前任务，在回复末尾追加轻量提示（输出形态 B）
显式请求：用户说"找个技能" → 完整搜索 + 完整推荐（输出形态 A）

Step 1：意图 → 搜索需求转换

从用户意图中提取要素，并生成多组差异化搜索词（各渠道用各自最合适的关键词，而不是共用一组）：

提取要素：

任务意图：用户想做什么？
领域标签：属于哪个领域？
产出物类型：海报 / 文章 / 数据报告 / 代码…
专业工具词：涉及的具体平台或工具

搜索词生成规则：

用途	生成规则	示例（"我想做海报"）
本地语义匹配	用户原话 + 任务意图描述	海报、设计、poster 生成
SkillHub 搜索	英文关键词 + 同义词	poster, design, poster maker
虾评搜索	中文关键词 + 领域词	海报, 设计, 封面
GitHub 搜索	英文技术词 + SKILL.md	poster SKILL.md

示例：

"我想做一个海报" → 意图：设计/制图；领域：内容创作；产出物：海报；关键词：poster, design, 海报, 设计
"帮我分析今天的大盘" → 意图：股票分析；领域：金融；产出物：分析报告；关键词：stock, A股, 大盘, 分析

Step 2：多渠道联合查询

查询策略：本地层串行快查（内置 → 已安装 → 缓存），远程层并行查询；本地有高匹配命中时直接推荐，无需等待远程结果。

2.1 本地层①：官方内置技能（WorkBuddy 自带，无需安装）

扫描官方内置技能目录，读取每个技能的 name 和 description：

BASH

ls /Applications/WorkBuddy.app/Contents/Resources/app.asar.unpacked/resources/builtin-skills/

用 Read 工具读取每个技能的 SKILL.md YAML frontmatter，与用户场景做语义匹配。

匹配规则（按优先级）：

用户场景关键词直接出现在技能 description 中 → 高分
技能 name 与用户意图高度相关 → 高分
技能 description 与用户领域相关 → 中分

2.2 本地层②：本地已安装技能

扫描以下两个位置的已安装技能：

BASH

# 用户级技能
ls ~/.workbuddy/skills/

# 项目级技能（当前工作区）
ls .workbuddy/skills/ 2>/dev/null || echo "无项目级技能"

用 Read 工具读取每个技能的 SKILL.md YAML frontmatter，提取 name 和 description，与用户场景做语义匹配。

注意：如果本地已安装技能在 Step 2.1 官方内置中也出现，去重，只保留最高优先级的记录。

2.3 本地层③：本地 marketplace 缓存（原 `find-skills` Step 5 逻辑）

BASH

ls ~/.workbuddy/skills-marketplace/skills 2>/dev/null

如果缓存目录中存在与用户需求匹配的技能，直接复制安装，无需远程下载：

BASH

cp -r ~/.workbuddy/skills-marketplace/skills/<skill-folder-name> ~/.workbuddy/skills/<skill-folder-name>

2.4 远程层：并行搜索远程技能市场（完全替代 `find-skills` 的搜索能力）

如果本地层无高匹配结果，并行发起以下远程搜索（各渠道使用 Step 1 生成的差异化关键词，互不等待）：

渠道	使用关键词
SkillHub	英文关键词（主渠道）
虾评	中文关键词（中文技能重点）
GitHub	英文技术词 + SKILL.md
ClawHub / Vercel	英文关键词（fallback）

① SkillHub 官方市场（主渠道）：

BASH

curl -s "https://lightmake.site/api/v1/search?q=<URL-encoded 中文关键词>&limit=10"
curl -s "https://lightmake.site/api/v1/search?q=<URL-encoded English keywords>&limit=10"

过滤 score < 0.05 的低相关结果。

② 虾评技能市场（中文技能重点来源）：

虾评 API Base URL：https://xiaping.coze.com（注意：不是 coze.site）

搜索技能：

BASH

# 搜索技能（按关键词）
curl -s "https://xiaping.coze.com/api/skills/search?q=<URL-encoded 关键词>&limit=10"

# 获取技能详情
curl -s "https://xiaping.coze.com/api/skills/<skill-id>"

# 获取技能下载链接
curl -s "https://xiaping.coze.com/api/skills/<skill-id>/download"

需要先加载 虾评指南 技能（路径：~/.workbuddy/skills/虾评指南/SKILL.md），按其中 §1.1 + §1.2 的规范执行搜索和下载。

重要：虾评是中文技能的核心来源，对于中文场景的技能搜索，虾评的结果往往比 SkillHub 更相关。

③ GitHub 技能仓库（开源技能来源）：

搜索 GitHub 上包含 WorkBuddy / Claw 技能的文件。

认证说明：GitHub 搜索 API 需要认证。如果环境变量 GITHUB_TOKEN 已设置，自动带上认证（5000次/小时）；否则使用匿名访问（60次/小时，可能不够用）。

BASH

# 如果有 GitHub Token，带上认证
if [ -n "$GITHUB_TOKEN" ]; then
  AUTH_HEADER="-H "Authorization: Bearer $GITHUB_TOKEN""
else
  AUTH_HEADER=""
fi

# 搜索包含 SKILL.md 的代码
curl -s $AUTH_HEADER "https://api.github.com/search/code?q=filename:SKILL.md+<关键词>&per_page=10"

# 搜索技能相关仓库
curl -s $AUTH_HEADER "https://api.github.com/search/repositories?q=<URL-encoded 关键词>+skill+in:name,description&per_page=10"

注意：GitHub Code Search API 的 filename:SKILL.md 搜索需要认证才能使用。如果没有 GITHUB_TOKEN，退化为只搜索 repositories（仓库搜索匿名可用）。

安装方式：

BASH

# 从 GitHub 克隆技能仓库
git clone "https://github.com/<user>/<repo>.git" <target-skills-dir>/<skill-name>/

# 验证安装
ls <target-skills-dir>/<skill-name>/SKILL.md

注意：GitHub 搜索结果需要人工判断是否为有效技能（检查是否包含 SKILL.md），因为是代码搜索，可能返回非技能文件。

④ ClawHub / Vercel Skills（Fallback 来源，SkillHub + 虾评 + GitHub 均无结果时使用）：

BASH

# Vercel Skills CLI
npx skills find [query]

# ClawHub
npx clawhub search [query]

重要：远程搜索结果只作为补充推荐，优先级低于本地已安装技能。

Step 2.5：客户端检测（安装前必须执行）

在安装任何远程技能之前，必须先检测当前客户端，以决定技能安装到哪个目录：

BASH

echo $__CFBundleIdentifier

`__CFBundleIdentifier` 含	客户端	目标技能目录
`codebuddy`	CodeBuddy	`~/.codebuddy/skills/`
其他/空/未设置	WorkBuddy（默认）	`~/.workbuddy/skills/`

默认当作 WorkBuddy：如果该变量为空、未设置或包含 codebuddy 以外的值，一律当作 WorkBuddy 处理。

Step 3：智能排序与推荐

将多渠道搜索结果合并，按以下规则排序：

加分规则：命中技能若与当前对话上下文高度相关（用户正在进行的任务），排名上调一级。

优先级	来源	条件
1	官方内置技能	语义匹配高分（description 含场景关键词）
2	本地已安装	语义匹配高分（已安装，可直接用）
3	SkillHub 官方市场	score ≥ 0.3 且 downloads/installs 高
4	虾评技能市场	相关度高分（中文技能优先）
5	GitHub 开源仓库	相关度高分（含 SKILL.md）
6	ClawHub / Vercel Skills	相关度高分
7	本地已安装	语义匹配中分（name 相关）
8	SkillHub 官方市场	score ≥ 0.1
9	虾评技能市场	相关度中分
10	GitHub 开源仓库	相关度中分
11	ClawHub / Vercel Skills	相关度中分

去重规则：

如果同一个技能在多层都出现，保留最高优先级的那条记录
例如：本地已安装 AI图片生成无水印，同时 SkillHub 也有，只显示"✅ 已安装"

Step 4：输出推荐结果

两种输出形态：

形态 A：完整推荐（任务开始 / 显式请求时使用）——按以下格式输出完整推荐列表：

代码

🔍 为你找到 {N} 个相关技能（搜索范围：官方内置 + 本地已安装 + 远程市场）：

【官方·内置】✅ 无需安装
1. {技能名} — {一句话说明}
   匹配理由：{为什么适合这个场景}
   来源：WorkBuddy 内置

【本地·已安装】✅ 可直接使用
2. {技能名} — {一句话说明}
   匹配理由：{为什么适合这个场景}
   路径：~/.workbuddy/skills/{技能名}/

【远程·可安装】⬇️ 需安装
3. {技能名} — {一句话说明}
   匹配理由：{为什么适合这个场景}
   来源：{SkillHub/虾评/ClawHub/Vercel}
   下载量：{downloads} | 安装量：{installs}
   安装命令：回复"安装第3个"即可

形态 B：轻量提示（对话中途发现更优技能时使用）——不打断当前任务，仅在回复末尾追加一行：

Step 5：一键安装（如需）

如果用户选择安装远程技能，按以下流程执行：

安装前必须执行客户端检测（见 Step 2.5），确定目标目录 <target-skills-dir>。

5.1 从本地 marketplace 缓存安装（优先）

如果 Step 2.3 的本地缓存检查已找到匹配技能：

BASH

cp -r ~/.workbuddy/skills-marketplace/skills/<skill-folder-name> <target-skills-dir>/<skill-folder-name>

验证安装：

BASH

ls <target-skills-dir>/<skill-folder-name>/SKILL.md

如果目标目录已存在同名技能，明确询问用户：跳过 / 替换 / 重命名。

5.2 从 SkillHub 远程安装

BASH

TMPDIR=$(mktemp -d)
curl -L -o "$TMPDIR/skill.zip" "https://lightmake.site/api/v1/download?slug=<slug>"
mkdir -p <target-skills-dir>/<slug>
unzip -o "$TMPDIR/skill.zip" -d <target-skills-dir>/<slug>
rm -rf "$TMPDIR"
ls <target-skills-dir>/<slug>/SKILL.md

指定版本安装：

BASH

curl -L -o "$TMPDIR/skill.zip" "https://lightmake.site/api/v1/download?slug=<slug>&version=<version>"

5.3 从虾评远程安装

先加载 虾评指南 技能（路径：~/.workbuddy/skills/虾评指南/SKILL.md），按其中 §1.2 的下载安装流程执行：

BASH

# 1. 获取下载链接
curl -s "https://xiaping.coze.com/api/skills/<skill-id>/download"

# 2. 下载技能 ZIP
TMPDIR=$(mktemp -d)
curl -L -o "$TMPDIR/skill.zip" "<download-url>"

# 3. 解压到目标目录
mkdir -p <target-skills-dir>/<skill-name>
unzip -o "$TMPDIR/skill.zip" -d <target-skills-dir>/<skill-name>

# 4. 清理
rm -rf "$TMPDIR"

# 5. 验证安装
ls <target-skills-dir>/<skill-name>/SKILL.md

注意：虾评的下载流程可能需要认证（API Key / Token），具体参考 虾评指南 技能中的 §0.2 注册流程和 §1.2 下载安装流程。

5.4 从 ClawHub 远程安装

BASH

TMPDIR=$(mktemp -d)
curl -L -o "$TMPDIR/skill.zip" "https://clawhub.com/api/download?slug=<slug>"
mkdir -p <target-skills-dir>/<slug>
unzip -o "$TMPDIR/skill.zip" -d <target-skills-dir>/<slug>
rm -rf "$TMPDIR"
ls <target-skills-dir>/<slug>/SKILL.md

5.5 从 GitHub 开源仓库安装

先搜索确认仓库包含技能文件：

BASH

# 搜索包含 SKILL.md 的代码
curl -s "https://api.github.com/search/code?q=filename:SKILL.md+<关键词>&per_page=10"

找到目标仓库后，克隆安装：

BASH

TMPDIR=$(mktemp -d)
git clone "https://github.com/<user>/<repo>.git" "$TMPDIR/<skill-name>"
mkdir -p <target-skills-dir>/<skill-name>
cp -r "$TMPDIR/<skill-name>" <target-skills-dir>/

# 验证安装
ls <target-skills-dir>/<skill-name>/SKILL.md

# 清理
rm -rf "$TMPDIR"

注意：GitHub 搜索结果需要人工判断是否为有效技能（检查是否包含 SKILL.md）。

5.6 从 Vercel Skills CLI 安装（Fallback）

BASH

npx skills add <owner/repo@skill> -g -y

如果安装在 ~/.agents/skills/ 而不是 <target-skills-dir>，则创建软链接：

BASH

ln -s ../../.agents/skills/<skill-name> <target-skills-dir>/<skill-name>

安装完成后，提示用户："✅ {技能名} 已安装，现在可以直接用啦！"

触发词参考

用户表达/场景	触发方式
"我想做XXX"	任务开始 → 完整搜索 + 完整推荐
"帮我找XXX的技能"	直接触发多渠道搜索
"有没有能XXX的工具"	触发多渠道搜索
"这个场景应该用哪个技能"	触发匹配推荐
"我想做一个海报"	自然语言场景 → 匹配设计类技能
对话中任务升级为高价值任务（如"顺便帮我做个数据分析"）	高价值判定 → 主动搜索 → 完整或轻量推荐
任务执行中发现更合适的技能	不打断，回复末尾轻量提示
纯闲聊 / 简单一次性任务	不触发（避免打扰）

重要：

本技能是唯一的技能发现入口，已完全替代 find-skills（其 description 已被标记为 DEPRECATED）
所有"找技能/安装技能/发现能力"的请求都由本技能处理

示例对话

用户："我想做一个海报，有没有合适的技能？"

助手：

代码

🔍 为你找到 3 个相关技能（搜索范围：官方内置 + 本地已安装 + 远程市场）：

【本地·已安装】✅ 可直接使用
1. AI图片生成无水印 — 支持文生图、图生图，8通道（龙虾Lovart/即梦/通义等）
   匹配理由：海报设计属于图片生成场景，该技能支持多种风格生成
   路径：~/.workbuddy/skills/AI图片生成无水印/

【官方市场·可安装】⬇️ 需安装
2. poster-maker — 专为主题海报设计的技能
   匹配理由：专门针对海报设计场景
   来源：SkillHub 官方市场
   下载量：2.3K | 安装量：420
   安装命令：回复"安装第2个"即可

【社区·可安装】⬇️ 需安装
3. claw-poster-generator — ClawHub 上的海报生成技能
   匹配理由：支持批量生成海报
   来源：ClawHub 社区
   安装命令：回复"安装第3个"即可

需要我帮你安装第2或第3个，还是直接用第1个？

用户（对话中途，任务升级为高价值任务）："初稿不错，再帮我配几张配图吧"

助手（不打断当前配图任务，回复末尾轻量提示）：

代码

配图已生成 3 张，接下来可以帮你排版导出。
> 💡 发现更合适的技能：AI图片生成无水印 — 支持文生图、图生图，8通道（龙虾Lovart/即梦/通义等）（来源：本地已安装），回复"查看详情"可完整查看

注：轻量提示只出现在回复末尾，不中断当前任务执行。

🔌 技能体系结合分析

🔗 协作链路

代码

对话中意图沟通 / 用户明确要找技能
   → find-skills（意图驱动的技能发现引擎）（本技能）← 唯一入口，已完全替代官方原 find-skills
       ├─ Step 0：意图沟通 → 技能需求判定（高价值任务才触发，避免打扰）
       ├─ Step 1：意图 → 差异化搜索词转换（各渠道专用关键词）
       ├─ 本地层：内置 + 已安装 + 缓存 → 串行快查
       └─ 远程层：SkillHub / 虾评 / GitHub / ClawHub → 并行查询

下游调用：

命中本地技能 → 直接调用对应技能
命中远程技能 → 按客户端检测结果安装 → 再调用

♻️ 与 `find-skills` 的关系

find-skills（官方插件目录）的 description 已被标记为 DEPRECATED，不会主动触发
本技能已完全覆盖 find-skills（官方插件）的所有能力：
- ✅ SkillHub 远程搜索
- ✅ ClawHub / Vercel Skills CLI fallback
- ✅ 客户端检测（CodeBuddy / WorkBuddy）
- ✅ 本地 marketplace 缓存检查
- ✅ 一键安装（SkillHub / ClawHub / Vercel / GitHub）
本技能新增官方 find-skills 不具备的能力：
- ✅ 官方内置技能扫描
- ✅ 本地已安装技能扫描
- ✅ 场景语义理解（不是关键词搜索）
- ✅ 推荐理由输出
- ✅ 意图驱动主动发现（对话中高价值任务自动产生搜索需求）
- ✅ 差异化搜索词 + 远程并行查询
- ✅ 轻量提示模式（不打断当前任务）

结论：官方 find-skills 插件文件可保留（官方插件目录，删除会被覆盖），但其 description 已失效，不会再被触发。所有技能发现请求都由本技能处理。

📊 体系优化建议

find-skills 的 SKILL.md 已被标记为 DEPRECATED，后续官方插件更新可能会覆盖此修改，需留意
建议定期确认 find-skills 的 description 是否被正确禁用

🎯 使用场景映射

业务线	典型场景	推荐的技能
自媒体	"我想做小红书封面"	`AI图片生成无水印` / `封面图生成`
自媒体	"帮我写公众号文章"	`写公众号` / `公众号长文创作`
量化交易	"帮我分析今天的大盘"	`A股数据获取` / `A股市场情绪分析`
公司经营	"我想记录今天的反思"	`每日反思` / `Get笔记`
公司经营	"帮我发邮件给客户"	`email-skill`

一	二	三	四	五	六	日
						1
2	3	4	5	6	7	8
9	10	11	12	13	14	15
16	17	18	19	20	21	22
23	24	25	26	27	28	29
30

找技能

下载地址

概述

find-skills（场景技能匹配器）

Overview

核心流程

Step 0：意图沟通与技能需求判定（主动发现）

Step 1：意图 → 搜索需求转换

Step 2：多渠道联合查询

2.1 本地层①：官方内置技能（WorkBuddy 自带，无需安装）

2.2 本地层②：本地已安装技能

2.3 本地层③：本地 marketplace 缓存（原 find-skills Step 5 逻辑）

2.4 远程层：并行搜索远程技能市场（完全替代 find-skills 的搜索能力）

Step 2.5：客户端检测（安装前必须执行）

Step 3：智能排序与推荐

Step 4：输出推荐结果

Step 5：一键安装（如需）

5.1 从本地 marketplace 缓存安装（优先）

5.2 从 SkillHub 远程安装

5.3 从虾评远程安装

5.4 从 ClawHub 远程安装

5.5 从 GitHub 开源仓库安装

5.6 从 Vercel Skills CLI 安装（Fallback）

触发词参考

示例对话

🔌 技能体系结合分析

🔗 协作链路

♻️ 与 find-skills 的关系

📊 体系优化建议

🎯 使用场景映射

标签：

其他文章

暂无评论！成为第一个。

发表回复 取消回复

您可能错过了

2.3 本地层③：本地 marketplace 缓存（原 `find-skills` Step 5 逻辑）

2.4 远程层：并行搜索远程技能市场（完全替代 `find-skills` 的搜索能力）

♻️ 与 `find-skills` 的关系

发表回复取消回复