
OKR(Objectives and Key Results,目标与关键结果法)是当下企业目标管理最常用的框架之一,源于英特尔、在谷歌被发扬光大。而 lark-okr 是一个专门用于管理飞书(Lark)OKR 的 AI Agent Skill,由 larksuite 官方维护。它让你可以通过命令行或 AI 助手直接操作飞书 OKR 系统中的所有核心数据——周期、目标、关键结果、对齐关系、量化指标和进展记录,统统都能在终端里搞定。
简单来说,lark-okr 把飞书 OKR 的管理能力从图形界面搬到了命令行和 AI 对话里。你不再需要打开飞书网页、一级级点菜单,一条命令就能完成过去几分钟的操作。
一、lark-okr 有哪些核心功能?
lark-okr 的功能覆盖了 OKR 管理的全流程,从查看周期到更新进展,几乎无所不包。
OKR 周期管理
查看 OKR 周期列表和详情是最基础的操作。+cycle-list 可以获取特定用户的 OKR 周期列表,支持按时间筛选;+cycle-detail 则能获取某个周期内所有目标和关键结果的完整内容。
目标与关键结果的增删改查
你可以创建、查看、更新和删除 Objective(目标)和 Key Result(关键结果)。cycle.objectives.create 创建新目标,keyresults.patch 更新关键结果的内容、备注、分数或截止日期。批量创建也支持——+batch-create 可以一次性创建多个目标和对应的关键结果。
对齐关系管理
OKR 的灵魂在于对齐。lark-okr 支持查询、创建和删除目标之间的对齐关系。一个目标对齐到另一个目标,意味着前者的完成有助于后者的实现。objective.alignments list 可以查看某个目标的所有对齐关系。
进展记录
更新进展是 OKR 日常使用中最频繁的操作。+progress-create 为目标或关键结果创建进展记录,+progress-list 获取所有进展记录列表,+progress-update 更新指定记录的内容。进展记录支持富文本格式,还可以通过 +upload-image 上传图片。
量化指标管理
OKR 中的 KR 通常需要量化。+indicator-update 可以快速更新指标当前值。更复杂的指标操作(如查询指标配置)也有对应的命令支持。
排序与权重调整
+reorder 可以调整目标或关键结果的显示顺序,+weight 调整权重。
权限控制
lark-okr 默认以当前用户身份操作(--as user),也支持以机器人身份查看他人 OKR(--as bot),前提是有相应权限。
二、怎么安装 lark-okr?
lark-okr 的安装非常简单,一条 npx 命令就能搞定。
在终端中执行以下命令:
npx skills add https://github.com/larksuite/cli --skill lark-okr
安装完成后,skill 会自动配置到你的 AI 编码环境中,可以在 Claude Code、Cursor 或 OpenClaw 中直接使用。
前置条件
使用 lark-okr 之前,需要先完成飞书 CLI(lark-cli)的认证配置。官方提供了 lark-shared 共享配置来处理认证和权限。简单说就是先让你的命令行能“登录”飞书账号,然后 lark-okr 才能正常操作你的 OKR 数据。
三、lark-okr 适合谁用?用在什么场景?
场景一:开发者用命令行管理 OKR
对于习惯命令行的开发者来说,打开浏览器点来点去本身就是一种效率损耗。lark-okr 让你可以在终端里一条命令完成 OKR 的查看和更新,和写代码、跑构建在同一个环境里,不用来回切换上下文。
场景二:AI 助手自动处理 OKR 事务
lark-okr 本质上是一个 AI Agent Skill,可以被 Claude、Codex 等 AI 助手调用。这意味着你可以直接对 AI 说“帮我看看这个季度的 OKR 进展怎么样了”,AI 会自动调用 lark-okr 去查数据、整理成报告给你。团队管理者用来做 OKR 巡检、生成周报,效率提升非常明显。
场景三:自动化 OKR 数据同步
通过 lark-okr 的命令行接口,你可以把 OKR 数据和内部系统、监控工具、数据看板打通。比如每天自动拉取 OKR 进展、推送到企业微信群,或者把 OKR 数据导入到自己的数据分析平台。
场景四:远程团队的目标对齐
飞书 OKR 本身支持在文档中直接更新进度并同步到系统。lark-okr 则让这种能力延伸到了命令行和自动化场景。远程团队可以通过脚本定期汇总所有人的 OKR 状态,减少沟通成本。
四、实战案例:用 lark-okr 完成一次 OKR 巡检
假设你是一个技术团队的负责人,每个周五下午需要检查团队成员的 OKR 进度。以前你可能要打开飞书、挨个点进每个人的 OKR 页面看。有了 lark-okr,事情可以这样简化:
第一步,查看当前周期的 OKR 列表
lark-cli okr +cycle-list --as user拿到周期 ID 后,查看这个周期下所有目标和关键结果:
lark-cli okr +cycle-detail --cycle-id "你的周期ID"第二步,查看某个目标的进展记录
lark-cli okr +progress-list --target-id "目标ID"第三步,批量更新进展(比如给自己团队的 OKR 统一记录本周进展)
lark-cli okr +progress-create --target-id "目标ID" --content "本周完成了XX功能的上线,进度从60%推进到80%"
如果每周都要做同样的事情,把这些命令写成脚本,每周五定时跑一下,自动汇总所有成员的 OKR 状态,生成一份报告发到群里。原来半小时的手工活,变成了全自动。
五、注意事项
lark-okr 只管 OKR 管理,不负责待办任务(那是 lark-task 的事)、日程安排(那是 lark-calendar 的事)和绩效评估。
操作前需要先完成飞书 CLI 的认证配置。另外,删除操作(如 +progress-delete)不可恢复,执行前确认清楚。
六、写在最后
lark-okr 把飞书 OKR 的管理能力从图形界面带到了命令行和 AI 对话中。对于习惯命令行的开发者、需要自动化 OKR 管理的团队、以及希望用 AI 助手提升效率的管理者来说,这是一个非常实用的工具。
安装只需一条命令,上手成本很低。如果你已经在用飞书 OKR,不妨试试用 lark-okr 把日常的 OKR 管理工作自动化起来。项目地址在 GitHub 上:github.com/larksuite/cli。


◯ 评论 0