feishu-cli-platform
飞书 CLI 平台基础能力,不是飞书请求的通用兜底:配置与多 Profile、Device Flow 登录、Token 与 scope 预检、应用侧 scope 开通诊断、doctor、技能安装与 CLI 升级、OpenAPI schema 查询与 api 透传、全局搜索(文档含文件夹/知识库/创建者筛选、消息、应用),按邮箱或手机号查用户、部门与机器人。用户提到登录飞书、Token 过期、99991672/99991679、切换 profile、技能与 CLI 版本漂移、调用未封装接口、跨飞书搜文档或消息、查 open_id 时使用;查 schema 或发 raw API 时即使端点属于审批或会议也用本 Skill。不用于文档、云盘与权限、消息、表格、可视化、日历/任务/审批/OKR、邮件和会议等业务操作,分别使用 feishu-cli-docs/storage/messaging/data/visual/work/mail/meetings。
How do I install this agent skill?
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-platformIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a secure interface for the Feishu (Lark) CLI, enabling authentication, document search, and API interaction. It includes proactive security features such as validation to prevent access to sensitive local files (e.g., SSH or AWS keys) and a mandatory confirmation gate for high-risk operations.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
飞书平台能力
先判断意图,再读取对应工作流。不要一次加载全部 reference。
加载后,将工作流中的 references/、scripts/、templates/、examples/ 相对路径按该
workflow.md 所在目录解析;执行脚本时使用解析后的实际路径,不要依赖当前 shell 目录。
路由
| 意图 | 读取文件 |
|---|---|
登录、登出、scope 预检、应用已开通 scope 诊断(auth scopes)、Token、profile、config、doctor、技能安装/漂移(skills)、CLI 升级(update) | references/workflows/auth/workflow.md |
调任意 OpenAPI、--as、分页、dry-run、multipart 上传(--file)与机器可读错误(--error-format json) | references/workflows/api/workflow.md |
| 查询本地 OpenAPI path、参数和 scope | references/workflows/schema/workflow.md |
全局搜索文档(含 drive search 按文件夹/知识库/创建者、编辑/评论/打开/创建时间窗精筛)、消息或应用 | references/workflows/search/workflow.md |
查询用户、邮箱、手机号、部门,搜索机器人(user search-bot) | references/workflows/directory/workflow.md |
涉及身份选择,或遇到 Token、身份、scope 报错(如 99991663/99991668/99991672/99991679)时读取 references/workflows/auth/references/identity.md,排错表见 references/workflows/auth/workflow.md;auth check 不是 Bot 权限检查。
判断命令成败、编写脚本或遇到退出码 10(需确认)时读取 references/workflows/auth/references/agent-contract.md。
Schema 只负责发现接口;API 负责执行请求。通常先查 schema,再调用 api。
执行规则
- 仓库开发优先使用刚编译的
bin/feishu-cli(make build)或./feishu-cli;安装环境使用 PATH 中的feishu-cli。技能与 CLI 版本不一致时(命令或 flag 对不上),以--help为准,并用feishu-cli skills read <技能> <相对路径>读取与当前二进制配套的文档;每个命令--help末尾会列出相关技能与工作流。 - 先确定执行身份。
auth check --scope只检查当前 profile 的本地 User Token,不能验证 Bot 权限或显式 Token;应用侧是否开通(区分 99991672 应用未开通与 99991679 用户未授权)用auth scopes --scope,Bot 能否访问具体资源以实际接口结果为准。不要回显真实 Token。 - 多 Bot / 不确定当前应用时先
profile list --json;单次用--profile <name>,不改默认指针。环境变量覆盖了目标 App 时,沿用已有授权在本次进程移除对应覆盖,或用--bot-app-id/--bot-app-secret指定正确凭证,不修改用户全局环境。 api的所有写请求均可先用 CLI 本地--dry-run预览;预览不代表服务端接受。其他命令按各自帮助选择验证方式。- 搜索与通讯录结果默认只读取;用户要求后续写操作时再切换到对应领域 Skill。
- 退出码、确认门禁(退出码 10 须经用户同意才追加
--yes)、stdout/stderr 约定与目标实体解析见references/workflows/auth/references/agent-contract.md。
领域边界
- 文档读写与导入导出:
feishu-cli-docs - 云盘、知识库、评论和权限:
feishu-cli-storage - 消息、群聊、卡片和事件:
feishu-cli-messaging - Sheet/Bitable:
feishu-cli-data - 画板、Slides、HTMLBox 与妙搭应用:
feishu-cli-visual - 日历、任务、审批、考勤和 OKR:
feishu-cli-work - 飞书邮箱:
feishu-cli-mail - 视频会议与妙记:
feishu-cli-meetings
查 schema 或用 api 透传未封装端点时即使端点属于上述业务域也留在本 Skill;业务命令本身交给对应领域 Skill。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/riba2534/feishu-cli/feishu-cli-platform">View feishu-cli-platform on skillZs</a>