Agent Skill

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

与插件形态的区别

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

内置 Skill

通知 / 灯效 / 链路

Skill	触发场景
yoooclaw-notification-query	"看看最近的通知 / 谁找过我 / 总结今天的消息 / 某 App 有什么通知"——流式查通知，小批量走 summary、大批量走 summary-job 分片总结，纯读磁盘，不需要 daemon。
yoooclaw-lightrule-create	"收到/当某类通知时亮灯/闪灯"这类持久规则——规则由 Notification Intelligence 云端 Agent 编译、评估并触发，lightrule 管理命令直连云端 API，需先配置账号 API key（不依赖本地 daemon）。
yoooclaw-tunnel-debug	"手机推送收不到 / 通知没同步 / 检查隧道 / daemon 还活着吗"——组合 daemon status / tunnel status / tunnel +test / gateway test 自检接收链路。

录音处理

围绕手机长录音的转写文件展开。这些 Skill 一律先通过 yoooclaw recording storage-path / recording list 定位转写文件的真实存储位置，严禁假设录音目录或用记忆/文档搜索代替，否则会造成遗漏。纯读磁盘，不需要 daemon。

Skill	触发场景
yoooclaw-recording-query	"有哪些录音 / 查一下录音 / 这段录音说了什么 / 根据录音回答问题 / 查看录音摘要/转写 / 搜索录音内容"——查询本地长录音记录与转写内容。
yoooclaw-recording-meeting-minutes	"整理一下会议纪要 / 总结这次会议 / 会议有哪些待办"——把会议录音转写整理成结构化会议纪要。
yoooclaw-recording-interview	"整理采访内容 / 提取核心观点 / 整理成问答 / 输出采访 Q&A"——把采访录音转写整理成结构化采访稿。
yoooclaw-recording-entity-extraction	"提取信息 / 找联系方式 / 有哪些人名 / 关键信息 / 从文件提取"——从转写或文本中提取人名、联系方式、机构、术语等实体，输出 sidecar JSON。
yoooclaw-recording-translation	"翻译录音 / 翻译成[语言] / 翻译文件 / 用[语言]整理"——把转写或文本翻译为目标语言，支持两阶段（先抽术语表再译）、保留时间戳，输出 Markdown sidecar。
yoooclaw-recording-mindmap	"生成思维导图 / 画个脑图 / 整理成思维导图 / 根据这个文件生成提纲"——生成 Markdown 格式的思维导图，可基于录音转写或任意文本。

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-notification-query 的指引调 yoooclaw notification 命令。

幂等与排错

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