飞书 OKR:管理目标与关键结果。查看和编辑 OKR 周期、目标(Objective)、关键结果(Key Result)、对齐关系、量化指标。当用户需要查看或创建 OKR、管理目标和关键结果、查看对齐关系时使用。
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证、权限处理
Shortcut 是对常用操作的高级封装(lark-cli okr +<verb> [flags])。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+cycle-list | 获取特定用户的 OKR 周期列表,可以按时间筛选 |
+cycle-detail | 获取特定 OKR 中所有目标和关键结果的内容 |
ContentBlock 富文本格式 — Objective/KeyResult/Notes 字段使用的富文本格式说明OKR 业务实体 获取 OKR 实体结构,定义和关系,帮助你更好的使用 OKR 功能OKR 业务实体以了解基础概念lark-cli schema okr.<resource>.<method> # 调用 API 前必须先查看参数结构
lark-cli okr <resource> <method> [flags] # 调用 API
重要:使用原生 API 时,必须先运行
schema查看--data/--params参数结构,不要猜测字段格式!
delete — 删除对齐关系get — 获取对齐关系list — 批量获取分类list — 批量获取用户周期objectives_position — 更新用户周期下全部目标的位置
objectives_weight — 更新用户周期下全部目标的权重
create — 创建目标list — 批量获取用户周期下的目标patch — 更新量化指标delete — 删除关键结果get — 获取关键结果patch — 更新关键结果list — 获取关键结果的量化指标delete — 删除目标get — 获取目标key_results_position — 更新全部关键结果的位置
key_results_weight — 更新全部关键结果的权重
patch — 更新目标create — 创建对齐关系
list — 批量获取目标下的对齐关系list — 获取目标的量化指标create — 创建关键结果list — 批量获取目标下的关键结果| 方法 | 所需 scope |
|---|---|
alignments.delete | okr:okr.content:writeonly |
alignments.get | okr:okr.content:readonly |
categories.list | okr:okr.setting:read |
cycles.list | okr:okr.period:readonly |
cycles.objectives_position | okr:okr.content:writeonly |
cycles.objectives_weight | okr:okr.content:writeonly |
cycle.objectives.create | okr:okr.content:writeonly |
cycle.objectives.list | okr:okr.content:readonly |
indicators.patch | okr:okr.content:writeonly |
key_results.delete | okr:okr.content:writeonly |
key_results.get | okr:okr.content:readonly |
key_results.patch | okr:okr.content:writeonly |
key_result.indicators.list | okr:okr.content:readonly |
objectives.delete | okr:okr.content:writeonly |
objectives.get | okr:okr.content:readonly |
objectives.key_results_position | okr:okr.content:writeonly |
objectives.key_results_weight | okr:okr.content:writeonly |
objectives.patch | okr:okr.content:writeonly |
objective.alignments.create | okr:okr.content:writeonly |
objective.alignments.list | okr:okr.content:readonly |
objective.indicators.list | okr:okr.content:readonly |
objective.key_results.create | okr:okr.content:writeonly |
objective.key_results.list | okr:okr.content:readonly |