SuperAPI AI 工具集

feishu-cli-okr

办公与效率

查看项目

更新于 10-16 03:42

技能介绍

用途:通过 feishu-cli 操作飞书 OKR,支持查询租户级 OKR 周期、列出目标或关键结果下的进展记录、创建新的进展记录,适合周报/日报场景手动或脚本化同步进度。

主要能力与用法:

  1. okr cycle list:列出当前租户所有 OKR 周期,无必填参数,可用 --output json 输出。字段含 id、zh_name/en_name、start_time/end_time、cycle_status。周期为租户级,无 user_id 参数。
  2. okr progress list:列出某目标或关键结果下的所有进展,--objective-id 与 --key-result-id 二选一,可选 --user-id-type(open_id/union_id/user_id,默认 open_id)。
  3. okr progress create:创建进展。--content(纯文本)与 --content-json(ContentBlock JSON)二选一;目标 ID 二选一;可选 --progress-percent(0-100)与 --progress-status(normal/risky/overdue,必须配合百分比使用);可选 --source-title、--source-url,其中 source_url 为 API 强制必填,CLI 默认占位 https://www.feishu.cn/okr/progress。

身份与权限:OKR 模块强制使用应用 Token/Tenant Token,不支持 User Token(会返回 99991668),无需 auth login。需在开放平台开通相应 tenant scopes:cycle list 需 okr:okr:readonly 或 okr:okr.period:readonly;progress list 需 okr:okr:readonly 或 okr:okr.progress:readonly;progress create 需 okr:okr 或 okr:okr.progress:writeonly。本地配置 FEISHU_APP_ID / FEISHU_APP_SECRET 或 config.yaml。

限制:暂未实现 progress get/update/delete、图片上传、objective/key-result 的 list/get、评审复盘等能力。如未安装 feishu-cli,需前往 riba2534/feishu-cli 获取安装方式。