lark-shared

本技能指导你如何通过lark-cli操作飞书资源, 以及有哪些注意事项。 首次使用需运行 lark-cli config init 完成应用配置。 当你帮用户初始化配置时，使用background方式使用下面的命令发起配置应用流程，启动后读取输出，从中提取授权链接并发给用户： 两种身份类型，通过 --as 切换： 输出的 [identity: bot/user] 代表当前身份。bot 与 user 表现差异很大，需确认身份符合目标需求： 遇到权限相关错误时， 根据当前身份类型采取不同解决方案 。 错误响应中包含关键信息： 将错误中的 console_url 提供给用户，引导去后台开通 scope。 禁止 对 bot 执行 auth login 。 规则 ：auth login 必须指定范围（ --domain 或 --scope ）。多次 login 的 scope 会累积（增量授权）。 当你作为 AI agent 需要帮用户完成认证时，使用background方式 执行以下命令发起授权流程, 并将授权链接发给用户： lark-cli 命令执行后，如果检测到新版本，JSON 输出中会包含 _notice.update 字段（含 message 、 command 等）。 当你在输出中看到 _notice.update 时，完成用户当前请求后，主动提议帮用户更新 ： 规则 ：不要静默忽略更新提示。即使当前任务与更新无关，也应在完成用户请求后补充告知。 lark-cli 对高风险写操作（ risk: "high-risk-write" ）有强制确认门禁。当你不带 --yes 调用这类命令时，CLI 会退出码 10 、并在 stderr 返回如下结构化 envelope： 遇到这种情况，不要当普通错误放弃。 按以下流程处理： 绝对不允许 ： 提前预判：想先让用户 review 危险操作的具体请求，调用时加 --dry-run ——它不触发门禁，会打印完整请求详情（URL / body / params），你可以把这个预览给用户看过再去真正执行。 - Bot 看不到用户资源 ：无法访问用户的日历、云空间文档、邮箱等个人资源。例如 --as bot 查日程返回 bot 自己的（空）日历 - Bot 无法代表用户操作 ：发消息以应用名义发送，创建文档归属 bot - Bot 权限 ：只需在飞书开发者后台开通 scope，无需 auth login - User 权限 ：后台开通 scope + 用户通过 auth login 授权，两层都要满足 - permission_violations ：列出缺失的 scope (N选1) - console_url ：飞书开发者后台的权限配置链接 - hint ：建议的修复命令 - 告知用户当前版本和最新版本号 - 提议执行更新（CLI 和 Skills 需要同时更新）： npm update -g @larksuite/cli && npx skills add larksuite/cli -g -y - 更新完成后提醒用户： 退出并重新打开 AI Agent 以加载最新 Skills - 禁止输出密钥 （appSecret、accessToken）到终端明文。 - 写入/删除操作前必须确认用户意图 。 - 用...