关于 lark-cli
lark-cli 是使用 `lark` 命令行界面访问飞书/Lark 服务的技能，面向需要处理聊天、云盘、文档、表格和日历的用户与自动化流程，并支持表格或 JSON 输出。
主要功能
- 01访问多种飞书/Lark 产品
- 02租户与用户身份认证
- 03便于阅读的表格输出
- 04用于自动化的 JSON 输出
- 05分页与账号选择指南
适用场景
- 01列出聊天并搜索用户
- 02处理云盘文件、文档和表格
- 03使用机器可读结果运行自动化
- 04为应用或用户范围的任务选择凭证
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/lark-cli确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/AUTH.mdBASES.mdCALENDARS.mdCHATS.mdCOMPLETION.mdCONCEPTS.mdCONFIG.mdCONTACTS.mdDOCS.mdDRIVE.mdINSTALL.mdMAIL.mdMEETINGS.mdMESSAGES.mdMINUTES.mdRECIPES.mdSHEETS.mdTASKLISTS.mdTASKS.mdTROUBLESHOOTING.mdUSERS.mdWHOAMI.mdWIKI.md详细介绍
Lark CLI
此技能使用 lark CLI 操作飞书/Lark 产品（IM、Drive、Docs、Sheets、Mail、Calendar、Wiki、Bitable、Tasks 等），并提供最短路径示例和参考链接。
此仓库提供的内容
larkCLI：用于访问飞书/Lark 产品（IM、Drive、Docs、Sheets、Mail、Calendar、Wiki、Bitable、Tasks）的单个二进制文件。- 两种输出模式：默认输出人类可读的表格，使用
--json输出 JSON，便于自动化处理。 - 通过官方
oapi-sdk-go优先使用 SDK 实现。
快速入门（最简步骤）
- 安装 CLI（参见
references/INSTALL.md）。 - 进行身份验证：
- 租户令牌（仅应用，使用机器人/应用身份）：
lark auth tenant - 用户令牌（限定用户，代表用户操作）：
lark auth user login详情和权限范围请参见references/AUTH.md。
- 租户令牌（仅应用，使用机器人/应用身份）：
- 运行命令：
lark whoami
lark chats list --limit 10
lark users search "Ada" --json
核心概念（简要版）
- Feishu = Lark（全球品牌）。API 接口相同，API 端点不同。
- 大多数命令遵循以下格式：
lark <product> <action> [args] [flags]。 - 必填 ID 是位置参数（不需要必填的
--id标志）。 - 许多命令支持使用 Lark/Feishu 网页 URL 代替 ID。
--json将机器可读的输出写入 stdout；日志/错误写入 stderr。
更详细的介绍请参见 references/CONCEPTS.md。
何时使用租户令牌或用户令牌
- 租户令牌：以机器人/应用身份执行应用级操作。
- 用户令牌：代表特定用户执行限定用户的操作。
如果命令因权限范围错误而失败，请检查 references/TROUBLESHOOTING.md。
令牌类型用法
使用 --token-type 强制指定访问令牌类型：
--token-type auto：默认值，根据命令需求自动选择。--token-type tenant：强制使用租户令牌。--token-type user：强制使用用户令牌。
示例：
lark whoami --token-type tenant
lark drive list --token-type user
适合 Agent 的工作流
- 优先使用
--json，并在工具/脚本中解析。 - 对分页较多的命令使用
--limit/--pages。 - 在多用户场景中复用
--account或LARK_ACCOUNT。
面向用户的输出风格（重要）
代表用户执行 lark 命令时：
- 默认不要向用户输出原始 CLI 命令或冗长的终端输出。
- 使用人类可读的语言总结结果（发生了什么变化 / 找到了什么 / 下一步操作）。
- 仅在用户明确要求时，或调试/复现所需时，提供准确的命令/输出。
- 优先使用简短列表和直接链接（Docx/Sheet URL），而非 ID/令牌。
常见用法
常见任务（发送消息、搜索用户、阅读文档等）请参见 references/RECIPES.md。
深入参考
- 安装：
references/INSTALL.md - 身份验证和权限范围：
references/AUTH.md - 概念和 ID：
references/CONCEPTS.md - 用法示例：
references/RECIPES.md - 故障排除：
references/TROUBLESHOOTING.md - 补全：
references/COMPLETION.md - 文档：
references/DOCS.md - 表格：
references/SHEETS.md - Bitable 多维表格：
references/BASES.md - Drive：
references/DRIVE.md - 会议纪要：
references/MINUTES.md - 日历：
references/CALENDARS.md - 会议：
references/MEETINGS.md - 聊天：
references/CHATS.md - 消息：
references/MESSAGES.md - 联系人：
references/CONTACTS.md - 邮件：
references/MAIL.md - 任务清单：
references/TASKLISTS.md - 任务：
references/TASKS.md - 用户：
references/USERS.md - 配置：
references/CONFIG.md - 当前身份：
references/WHOAMI.md - Wiki：
references/WIKI.md
评论
支持 Markdown