lark-cli 路由器
这个 Skill 只依赖官方 lark-cli。它适用于 Lark、飞书或兼容部署;
账号、区域和权限由用户当前配置决定,不在 Skill 中写死。
首次使用预检
command -v lark-cli >/dev/null 2>&1 || npx @larksuite/cli@latest install
lark-cli auth status
如果尚未登录,按 CLI 输出的官方流程完成 OAuth;不要把 App Secret、Token、 Cookie 或授权码贴到对话里。CI 使用环境变量或平台 Secret 注入凭据。
领域路由
| 用户意图 | CLI 前缀 |
|---|---|
| 多维表格、字段、记录、视图和表单 | lark-cli base |
| 云文档内容创建、读取和更新 | lark-cli docs |
| 云盘文件、版本、权限和评论 | lark-cli drive |
| 原生 Markdown | lark-cli markdown |
| 电子表格和单元格 | lark-cli sheets |
| 任务、清单和提醒 | lark-cli task |
| 知识空间和节点 | lark-cli wiki |
| CLI 未封装的接口 | lark-cli api |
先运行对应命令的 --help,再按官方文档确认参数和资源 token 类型:
lark-cli base --help
lark-cli docs --help
lark-cli api --help
URL 和资源 token
/wiki/路由到wiki,/sheets/路由到sheets。/docx/路由到docs,云盘 file/folder/bitable/slides 路由到drive。- 已知对象 token 后再进入对象内部操作;不要把 URL、document ID、spreadsheet token 和 file token 混用。
- 本地文件导入后先回读资源 ID,再进行后续编辑。
安全和完成条件
- 只读查询可以直接执行;创建、更新、移动、删除、导入和权限变更前确认目标、范围和是否可回滚。
- 不把凭据放在命令行参数、日志或仓库;优先使用 CLI 登录态、环境变量或忽略的本地配置。
- API 返回成功或 CLI 打印完成不等于业务完成;写操作后重新读取资源、版本或权限状态。
- 遇到 401/403、404 或资源不存在,先读取
lark-cli <domain> --help和官方错误说明,核对当前账号、租户、区域和 scope,不要重复创建资源。
Scan to join WeChat group