飞书全产品 CLI

要解决什么问题

在 Agent 里帮用户改飞书文档、查日历、发群消息时，最容易踩坑的不是「记不住 API」，而是文档和 CLI 版本脱节、授权身份选错（机器人拿不到个人日历/邮箱），以及把内嵌文档里的相对路径当成本机文件去 Read。本技能把飞书全产品线统一收敛到 lark-cli，并规定：先查再干——能力清单与完整说明都在 CLI 内，不要凭记忆拼命令。

技能如何工作

使用前必须走完前置检查：确认 lark-cli 已安装，再用授权相关命令查看 identity、verified 及 user/bot 状态。未授权时区分是否在 Agent 宿主环境（OPENCLAW_HOME / HERMES_HOME / LARK_CHANNEL）：在宿主内应复用已有飞书应用并让用户在 bot-only 与 user-default 间知情选择；非宿主则新建应用授权，必要时用 --no-wait --json 与二维码流程避免阻塞回合。

发现能力时先 skills list，选中后 skills read 再操作。文档、表格、多维表格、日历、审批、通讯录、云盘、妙记、IM 等分别对应 lark-doc、lark-sheets、lark-base 等子技能；权限与身份问题读 lark-shared。文档中的 ../lark-*/SKILL.md 等路径须翻译成 lark-cli skills read …，不要去读不存在的 scripts/、assets/ 文件。

执行上：参数不明先看 --help；高风险写操作需用户确认后加 --yes；不确定影响面用 --dry-run；大 JSON 用 --jq 裁剪。以 --as user 写入时，对外表现即为用户本人操作。

适用边界与注意点

• 本 SKILL.md 只做指路，各产品细节以 CLI 内嵌文档为准，随 lark-cli 版本变化。
• scope 不足或登录态异常时据实说明，需在飞书开放平台为应用开通权限，不要换命令绕过或编造结果。
• 绑定宿主已有应用可能覆盖既有绑定并锁定身份策略，绑定前必须征得用户确认。