Agent Skill

@yoooclaw/cli 随包发布了一组 Skill（SKILL.md）—— 用自然语言描述「何时该调哪些 yoooclaw 命令」，让 Agent 不必你逐条教学就能自己驱动 CLI。

与插件形态的区别

在 openclaw 插件里，这些 Skill 由 openclaw.plugin.json 的 skills 字段自动注册，宿主启动即加载。独立 CLI 没有宿主代劳，Skill 只随 npm 包躺在 <pkg>/skills/，需要手动安装到当前 Agent 的 skills 发现目录。

内置 Skill

CLI 曾经给通知查询和每种录音加工各配一个独立 Skill，数量一多反而互相抢触发。现已收敛成 4 个按路由分工的 Skill：查询统一走 yoooclaw-context-query，录音加工统一走 yoooclaw-recordings-process，灯效规则和链路排错各自单独一个。旧的 yoooclaw-notification-query、yoooclaw-recording-query、yoooclaw-recording-meeting-minutes、yoooclaw-recording-interview、yoooclaw-recording-entity-extraction、yoooclaw-recording-translation、yoooclaw-recording-mindmap 已合并进新 Skill，不再单独随包发布；升级后执行 yoooclaw skills install --force 会顺带清理已安装的旧同名 Skill。

Skill	触发场景
yoooclaw-context-query	查询本机已同步数据的唯一入口——通知/消息（"最近有什么通知"）、录音/转写（"有哪些录音"）、已收藏/已同步网页（"查一下我最近一天收藏的文章"）、图片（"同步图片"），以及跨来源的"哪里提到过 X"。覆盖 list / search / get / answer / summarize / statistics 各类意图，纯读磁盘，不需要 daemon。通用的联网搜索/时事类请求会被排除在外，交给联网工具处理。
yoooclaw-recordings-process	把录音/转写（或提供的文本/文件）加工成结构化产物——会议纪要、翻译（含两阶段术语表）、Markdown 思维导图、采访整理、实体提取。共用一套"录音来源定位"流程，只加载被请求的产物分支。单纯查录音列表、查转写、搜内容、看已有摘要，走 yoooclaw-context-query 而不是这个。
yoooclaw-lightrule-create	"收到/当某类通知时亮灯/闪灯"这类持久规则——规则由 Notification Intelligence 云端 Agent 编译、评估并触发，lightrule 管理命令直连云端 API，需先配置账号 API key（不依赖本地 daemon）。
yoooclaw-tunnel-debug	"手机推送收不到 / 通知没同步 / 检查隧道 / daemon 还活着吗"——组合 doctor / auth status / daemon status / tunnel status / tunnel +test / gateway test / daemon logs 自检本地环境、daemon、ingest 鉴权与 Relay WebSocket 链路。多数命令需要 daemon 在跑。

yoooclaw-context-query 内部按来源拆成独立 reference 文档（notifications / recordings / web-pages / images），只加载命中的那一份；yoooclaw-recordings-process 同理按产物类型拆分 reference。这两个 Skill 本身不会一次性把所有文档都塞进上下文。

yoooclaw skills list                 # 列出随包发布的内置 Skill 及触发说明
yoooclaw skills targets              # 查看支持的 Agent 目标和探测结果

安装

yoooclaw skills install              # 自动探测唯一 Agent 后软链安装
yoooclaw skills install --agent codex
yoooclaw skills install --agent claude
yoooclaw skills install --copy       # 复制而非软链
yoooclaw skills install --target ~/.config/agent/skills --force

flag	说明
--agent <agent>	安装目标 Agent，支持 auto / claude / codex / custom，默认 auto。
--target <dir>	安装目标目录；传入后优先于自动探测，适合任意兼容 SKILL.md 目录结构的 Agent。
--copy	复制目录而非创建软链。Windows 无管理员权限创建软链失败时用它。
--force	目标已存在同名 Skill 时覆盖；否则跳过并在 skipped 中报告。

auto 模式只在检测到唯一 Agent 时自动安装。如果同时检测到 Claude Code 和 Codex，或一个都没检测到，CLI 会返回候选目标并要求显式传 --agent 或 --target，避免悄悄装到错误宿主。

内置 Agent 默认目录：

Agent	默认 skills 目录
claude	~/.claude/skills
codex	${CODEX_HOME}/skills，未设置时为 ~/.codex/skills

默认软链 vs 复制

默认创建软链指向包内的 skills/：yoooclaw update self 升级 CLI 后，Skill 内容自动跟随新版本，无需重装。--copy 得到的是快照，升级后需要重新 install --force。

安装后重启 Agent 会话即可被发现。之后说一句"看看最近的通知"，Agent 就会按 yoooclaw-context-query 的指引调 yoooclaw notification 命令。

幂等与排错

• 不确定该装到哪里时，先执行 yoooclaw skills targets 看 detected 和 target。
• 重复执行 skills install（软链模式）对已指向同一来源的链接视作「已安装」，不报错、不计入 skipped。
• 输出里 installed 是本次新装/已就绪的 Skill，skipped 列出因已存在而跳过的（附原因），加 --force 覆盖。
• 创建软链报 YOOOCLAW_STORAGE_UNAVAILABLE（EPERM/EACCES，多见于 Windows）时，改用 --copy。