lark-okr
飞书 OKR:管理目标与关键结果。查看和编辑 OKR 周期、目标(Objective)、关键结果(Key Result)、对齐关系、量化指标和进展记录。当用户需要查看或创建 OKR、管理目标和关键结果、查看对齐关系时使用。
- License 许可
- MIT
- 最近更新
- 2026-11-01
- Stars
- ★ 3
- Forks
- 1
01 前言 Front Matter
- name
- lark-okr
- version
- 1.0.0
- metadata
- { "cliHelp": "lark-cli okr --help", "requires": { "bins": [ "lark-cli" ] } }
- description
- 飞书 OKR:管理目标与关键结果。查看和编辑 OKR 周期、目标(Objective)、关键结果(Key Result)、对齐关系、量化指标和进展记录。当用户需要查看或创建 OKR、管理目标和关键结果、查看对齐关系时使用。
02 资源文件 10
- 参考文档references/lark-okr-contentblock.md9.3 KB
- 参考文档references/lark-okr-cycle-detail.md2.5 KB
- 参考文档references/lark-okr-cycle-list.md3.7 KB
- 参考文档references/lark-okr-entities.md20.1 KB
- 参考文档references/lark-okr-image-upload.md3.4 KB
- 参考文档references/lark-okr-progress-create.md5.1 KB
- 参考文档references/lark-okr-progress-delete.md1.4 KB
- 参考文档references/lark-okr-progress-get.md2.1 KB
- 参考文档references/lark-okr-progress-list.md3.2 KB
- 参考文档references/lark-okr-progress-update.md4.2 KB
03 SKILL.md 正文
okr (v2)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证、权限处理
Shortcuts(推荐优先使用)
Shortcut 是对常用操作的高级封装(lark-cli okr +<verb> [flags])。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+cycle-list |
获取特定用户的 OKR 周期列表,可以按时间筛选 |
+cycle-detail |
获取特定 OKR 中所有目标和关键结果的内容 |
+progress-list |
获取目标或关键结果的所有进展记录列表 |
+progress-get |
根据 ID 获取单条 OKR 进展记录 |
+progress-create |
为目标或关键结果创建进展记录 |
+progress-update |
更新指定 ID 的进展记录内容 |
+progress-delete |
删除指定 ID 的进展记录(不可恢复) |
+upload-image |
上传图片用于 OKR 进展记录的富文本内容 |
格式说明
OKR 业务实体获取 OKR 实体结构,定义和关系,帮助你更好的使用 OKR 功能ContentBlock 富文本格式— Objective/KeyResult/Progress 中 Content/Note 字段使用的富文本格式说明- 强烈建议 在操作 OKR 前,阅读
OKR 业务实体以了解基础概念
API Resources
lark-cli schema okr.<resource>.<method> # 调用 API 前必须先查看参数结构
lark-cli okr <resource> <method> [flags] # 调用 API
重要:使用原生 API 时,必须先运行
schema查看--data/--params参数结构,不要猜测字段格式!
alignments
delete— 删除对齐关系get— 获取对齐关系
categories
list— 批量获取分类
cycles
list— 批量获取用户周期objectives_position— 更新用户周期下全部目标的位置- 请求中必须同时修改对应周期下全部目标的位置,且不允许位置重叠,否则会参数校验失败。
objectives_weight— 更新用户周期下全部目标的权重- 请求中必须同时修改对应周期下全部目标的权重,且所有权重值的和必须等于 1 ,否则会参数校验失败。
cycle.objectives
create— 创建目标list— 批量获取用户周期下的目标
indicators
patch— 更新量化指标
key_results
delete— 删除关键结果get— 获取关键结果patch— 更新关键结果
key_result.indicators
list— 获取关键结果的量化指标
objectives
delete— 删除目标get— 获取目标key_results_position— 更新全部关键结果的位置- 请求中必须同时修改对应目标下全部关键结果的位置,且不允许位置重叠,否则会参数校验失败。
key_results_weight— 更新全部关键结果的权重- 请求中必须同时修改对应目标下全部关键结果的权重,且所有权重值的和必须等于 1 ,否则会参数校验失败。
patch— 更新目标
objective.alignments
create— 创建对齐关系- 对齐不允许对齐自己的目标,且发起对齐的目标和被对齐的目标所在周期时间上必须有重叠,否则会参数校验失败。
list— 批量获取目标下的对齐关系
objective.indicators
list— 获取目标的量化指标
objective.key_results
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 |
04 同仓库更多 Skills
seedance-prompt-en
Write effective prompts for Jimeng Seedance 2.0 multimodal AI video generation. Use when users want to create video prompts using text, images, videos, and audio inputs with the @ reference system. Covers camera movements, effects replication, video extension, editing, music beat-matching, e-commerce ads, short dramas, and educational content.
onepage-pdf
Convert an HTML page into a single continuous-page PDF (one tall page, no pagination breaks), preserving desktop layout, backgrounds and selectable text. Use when the user asks to turn an HTML file/report/proposal into a "single-page PDF", "long PDF", "不分页 PDF", "单页 PDF", "长图式 PDF", or complains that an HTML-to-PDF export breaks into pages or cuts content. Supports optional string redaction with leak verification.
native-feel-cross-platform-desktop
Use when the user is designing, prototyping, or rewriting a desktop app that must run on multiple OSes (macOS + Windows, optionally Linux) AND feel indistinguishable from a native app to its users — fast launch, native windowing, native input handling, native materials. Trigger words include "cross-platform desktop", "Electron alternative", "Tauri vs native", "WebView wrapper", "near-native performance", "Raycast architecture", "WebKit/WebView2 quirks", "WKWebView", "system tray app", "global hotkey app", "launcher app". Do NOT trigger this skill for pure web apps, pure mobile apps, or for greenfield projects that have no native-feel requirement.
gstack
Router for the gstack skill suite. (gstack)
fireworks-tech-graph
Use when the user wants to create any technical diagram - architecture, data flow, flowchart, sequence, agent/memory, or concept map - and export as SVG+PNG. Trigger on: "画图" "帮我画" "生成图" "做个图" "架构图" "流程图" "可视化一下" "出图" "generate diagram" "draw diagram" "visualize" or any system/flow description the user wants illustrated.
dbs-video-extract
接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。