技能介绍

要解决的问题

在 WorkBuddy 这类桌面 Agent 环境中，通知散落在各应用里，录音转写与灯效控制又各自依赖独立的 CLI。手动切换终端、复制参数、粘贴敏感凭据，既容易出错，也让「查一下最近的通知」「把重要信息记下来」这类高频操作变成负担。YoooClaw for WorkBuddy 试图把这些动作收敛为一条可追踪的命令链路，同时把密钥泄露的风险降到最低。

核心能力与执行方式

技能基于本机 yoooclaw CLI（短命令 yc 等价，但统一使用完整名称）。拿到请求后先按用户意图选择主分支，完整读取对应的 reference，覆盖接入配置、通知查询、通知沉淀到 memory、录音读取和灯效规则五条主线，外加一份错误处理手册。组合请求按顺序执行，每个分支都使用自己的完成判定。

进入业务命令前先做 preflight：接入类请求直接走 setup 的完整决策树；业务类请求先确认 yoooclaw --version 可执行，CLI 不存在时说明能力缺失，征得同意后补装，而不是拿安装结果顶替原始任务。通知与录音读写本地数据，不要求 daemon；一次性灯效和持久灯效规则需要 API key 和网络，但同样不依赖 Relay。

调用时统一追加 --format json，同时检查进程退出码和 JSON 字段——业务 API 可能以退出码 0 返回 ok=false，通知 search 成功时也可能直接返回数组。实时状态每次重新调用 CLI，不复用上一轮结果。

敏感数据与边界

API key、gateway token 和消息正文按最小必要原则处理。凭据只通过执行工具的独立 stdin 通道传给 yoooclaw auth set-api-key -，不进入命令参数、环境变量、管道文本、临时文件、日志或 shell history；无法安全发送 stdin 时停止自动写入，交由用户在本机终端完成。错误转述前先脱敏，保留错误码和真实原因，并给出一个可执行的下一步。

技能仅运行在 WorkBuddy 桌面客户端的本地执行环境中；用户明确处于云上托管环境时会主动停止。它只描述公开 CLI 行为，不推测服务端实现；卸载、强制重建配置、删除灯效规则等破坏性操作，只在对应 reference 明确授权条件成立时执行。