From oh-my-feishu
Handles Lark/Feishu CLI shared basics: app config init, auth login, user/bot identity switching, scope/permissions management, Permission denied errors, safety rules. Triggers on first config, auth, permissions issues, or identity switches.
npx claudepluginhub yjzhang2003/oh-my-feishu --plugin oh-my-feishuThis skill uses the workspace's default tool permissions.
本技能指导你如何通过lark-cli操作飞书资源, 以及有哪些注意事项。
Guides selection of Lark (Feishu) CLI skills for chat messaging, calendars, docs, sheets, tasks, approvals, and workflows. Defines stdout vs lark-cli reply rules for chat assistants.
Configures Feishu/Lark channel credentials (app_id/app_secret), checks status, switches domains. Handles login/setup via CLI arguments in Claude Code.
Manages Lark/FeiShu resources including users, chats, emails, cloud documents, tables, tasks, calendars via OpenAPI MCP server. Useful for automating workflows with Lark integrations.
Share bugs, ideas, or general feedback.
本技能指导你如何通过lark-cli操作飞书资源, 以及有哪些注意事项。
首次使用需运行 lark-cli config init 完成应用配置。
当你帮用户初始化配置时,使用background方式使用下面的命令发起配置应用流程,启动后读取输出,从中提取授权链接并发给用户:
# 发起配置(该命令会阻塞直到用户打开链接并完成操作或过期)
lark-cli config init --new
两种身份类型,通过 --as 切换:
| 身份 | 标识 | 获取方式 | 适用场景 |
|---|---|---|---|
| user 用户身份 | --as user | lark-cli auth login 等 | 访问用户自己的资源(日历、云空间等) |
| bot 应用身份 | --as bot | 自动,只需 appId + appSecret | 应用级操作,访问bot自己的资源 |
输出的 [identity: bot/user] 代表当前身份。bot 与 user 表现差异很大,需确认身份符合目标需求:
--as bot 查日程返回 bot 自己的(空)日历auth loginauth login 授权,两层都要满足遇到权限相关错误时,根据当前身份类型采取不同解决方案。
错误响应中包含关键信息:
permission_violations:列出缺失的 scope (N选1)console_url:飞书开发者后台的权限配置链接hint:建议的修复命令--as bot)将错误中的 console_url 提供给用户,引导去后台开通 scope。禁止对 bot 执行 auth login。
--as user)lark-cli auth login --domain <domain> # 按业务域授权
lark-cli auth login --scope "<missing_scope>" # 按具体 scope 授权(推荐,符合最小权限原则)
规则:auth login 必须指定范围(--domain 或 --scope)。多次 login 的 scope 会累积(增量授权)。
当你作为 AI agent 需要帮用户完成认证时,使用background方式 执行以下命令发起授权流程, 并将授权链接发给用户:
# 发起授权(阻塞直到用户授权完成或过期)
lark-cli auth login --scope "calendar:calendar:readonly"
lark-cli 命令执行后,如果检测到新版本,JSON 输出中会包含 _notice.update 字段(含 message、command 等)。
当你在输出中看到 _notice.update 时,完成用户当前请求后,主动提议帮用户更新:
npm update -g @larksuite/cli && npx skills add larksuite/cli -g -y
规则:不要静默忽略更新提示。即使当前任务与更新无关,也应在完成用户请求后补充告知。
--dry-run 预览危险请求。