Feishu Cli Platform

飞书平台能力

先判断意图，再读取对应工作流。不要一次加载全部 reference。 加载后，将工作流中的 references/、scripts/、templates/、examples/ 相对路径按该 workflow.md 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

路由

涉及身份选择，或遇到 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。

执行规则

1. 仓库开发优先使用刚编译的 bin/feishu-cli（make build）或 ./feishu-cli；安装环境使用 PATH 中的 feishu-cli。技能与 CLI 版本不一致时（命令或 flag 对不上），以 --help 为准，并用 feishu-cli skills read <技能> <相对路径> 读取与当前二进制配套的文档；每个命令 --help 末尾会列出相关技能与工作流。
2. 先确定执行身份。auth check --scope 只检查当前 profile 的本地 User Token，不能验证 Bot 权限或显式 Token；应用侧是否开通（区分 99991672 应用未开通与 99991679 用户未授权）用 auth scopes --scope，Bot 能否访问具体资源以实际接口结果为准。不要回显真实 Token。
3. 多 Bot / 不确定当前应用时先 profile list --json；单次用 --profile <name>，不改默认指针。环境变量覆盖了目标 App 时，沿用已有授权在本次进程移除对应覆盖，或用 --bot-app-id/--bot-app-secret 指定正确凭证，不修改用户全局环境。
4. api 的所有写请求均可先用 CLI 本地 --dry-run 预览；预览不代表服务端接受。其他命令按各自帮助选择验证方式。
5. 搜索与通讯录结果默认只读取；用户要求后续写操作时再切换到对应领域 Skill。
6. 退出码、确认门禁（退出码 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。