📋 它是什么？把飞书 OKR 装进你的终端

用过飞书 OKR 的人都知道，想查一个目标的进展、更新一条关键结果的进度，至少得经历“切到飞书→找到 OKR 应用→翻到对应周期→找到目标→编辑”这一连串操作。如果一天要更新好几次，光来回切换就够烦人的。

lark-okr 解决的就是这个问题。它是飞书官方团队 larksuite 发布的一款 AI Agent Skill，专门为 Claude Code、Cursor、Codex CLI 等 AI 编程环境设计。安装之后，你不需要离开终端，直接通过命令行或者自然语言对话，就能完成几乎所有 OKR 相关的操作。

具体能做什么？简单说就是：

  • 查看 OKR 周期：获取自己或他人的 OKR 周期列表，按时间筛选
  • 查看目标与关键结果：获取某个周期内所有 Objective 和 Key Result 的完整内容
  • 创建和编辑 OKR：批量创建 Objective 和 KR 骨架，或者单独新增一条 O 或 KR
  • 更新量化指标：直接更新目标或关键结果的指标当前值，无需手动查询指标 ID
  • 记录进展：为目标或关键结果创建、更新、删除进展记录
  • 管理对齐关系：查看和删除 OKR 之间的对齐关系
  • 调整顺序和权重：调整 Objective 或 KR 的展示顺序和权重

核心逻辑就一句话：把飞书 OKR 的管理能力，用命令行的方式搬到你的开发环境里。 它不负责待办任务管理（那是 lark-task 的事），也不管日程会议（那是 lark-calendar 的活）——只专注做好 OKR 这一件事。

🛠️ 第一次使用：两步完成安装

安装 lark-okr 非常简单，本质上就是一条命令的事。

第一步：打开终端

打开你的终端或命令行工具（Terminal、iTerm、Windows Terminal 等）。

第二步：执行安装命令

npx skills add https://github.com/larksuite/cli --skill lark-okr

如果你是 Claude Code 或 Codex 用户，也可以直接把这条命令的相关信息交给 AI 助手，让它帮你完成安装。

验证安装

安装完成后，lark-okr 会自动配置到你的 AI 编程环境中。你可以在终端输入以下命令确认是否安装成功：

lark-cli okr --help
💡 小提示： 在使用 lark-okr 之前，建议先阅读 lark-shared 中的认证和权限配置说明。OKR 操作默认使用 --as user 身份（查看当前用户或上下级的 OKR），也支持 --as bot 查看他人的 OKR（需要相应权限）。

🎯 谁适合用？三个典型场景

lark-okr 不是给所有人用的，它解决的是特定人群的特定痛点。

场景一：工程师兼产品经理

白天写代码、晚上写 OKR 的日子不好过。lark-okr 让你在终端里敲几行命令就能完成 OKR 更新，不用在 IDE 和飞书之间来回切。对于“代码写到一半突然想起要更新 OKR 进展”的场景，尤其好用。

场景二：追求效率的 OKR 管理员

团队 OKR 的管理员经常需要帮成员查看对齐关系、汇总进展、调整权重。这些操作在飞书界面上要点很多下，但用 lark-okr 的命令行可以批量完成，效率提升非常明显。

场景三：AI 辅助开发的重度用户

如果你已经在用 Claude Code 或 Cursor 做开发，习惯用自然语言和 AI 对话来完成各种任务，那么 lark-okr 是自然延伸——你只需要对 AI 说“帮我看看我这个季度的 OKR 进展怎么样了”，它就能自动调用 lark-okr 帮你查出来。

⚠️ 不适合谁： 如果你平时很少用终端、不习惯命令行操作，或者 OKR 管理频率很低（比如一个季度只写一次），那么直接用飞书 App 可能更方便。lark-okr 是为高频操作者设计的效率工具。

💡 一个真实的使用案例

假设你是一个技术负责人，正在用 Claude Code 开发一个新产品功能。写代码的间隙，你想起来今天该更新一下 OKR 进展了——你这个季度的目标是“完成 V2.0 版本的核心功能开发”，关键结果是“API 接口开发完成度达到 80%”。

传统做法：切到飞书 → 找到 OKR 应用 → 找到 Q3 周期 → 找到对应目标 → 找到关键结果 → 修改进度数值 → 保存。整个过程至少一分钟，注意力被打断两次。

用 lark-okr 的做法：在终端里直接对 AI 说：“帮我看看我这个季度的 OKR 进度。”lark-okr 会自动调用 +cycle-list 获取周期列表，再用 +cycle-detail 拉出所有目标和关键结果。

看到进度是 60%，你想更新到 75%。再对 AI 说：“把 API 接口开发完成度更新到 75%。”lark-okr 会调用 +indicator-update 直接更新指标当前值。

整个过程不到 30 秒，不需要切换任何窗口。

如果你想写一段文字进展说明，可以用 +progress-create 为目标或关键结果创建一条进展记录：

lark-cli okr +progress-create \
--target-id 1234567890123456789 \
--content "本周完成了用户认证模块和支付接口的联调，整体进度 75%"

🔍 它和飞书自带 OKR 有什么不同？

很多人会问：飞书本身就有 OKR 功能，为什么还需要这个插件？

答案是：渠道不同，场景不同。

飞书自带的 OKR 是图形界面，适合浏览、制定和深度编辑。它的优势是直观、完整、有可视化图表。

lark-okr 是命令行界面，适合快速查询和轻量更新。它的优势是速度快、可批量、能嵌入开发工作流。

维度 飞书 OKR（界面） lark-okr（命令行）
操作方式 鼠标点击 命令行 / 自然语言
适用场景 制定、浏览、深度编辑 快速查询、轻量更新、批量操作
速度 较慢（需切换窗口） 快（终端内完成）
批量能力 弱（逐条操作） 强（支持批量创建和更新）
学习成本 低 中（需熟悉命令）

两者不是替代关系，而是互补关系。制定 OKR 用飞书界面，日常追踪和更新用 lark-okr——这是最有效率的工作流。

📊 社区数据与口碑

lark-okr 由飞书官方团队 larksuite 维护，在开发者社区中积累了相当高的认可度。截至 2026 年中，仅在一个技能平台上，它的安装量就已超过 35 万次。GitHub 上 larksuite/cli 仓库的 Stars 数量超过 1.6 万，Forks 超过 1,300。

社区评价普遍认可它“把 OKR 管理带到命令行”的设计理念。一位用户在评测中提到：“对于每天都要更新 OKR 进展的人来说，lark-okr 省下的不是几分钟，而是几十次上下文切换的精神损耗。”

当然，也有用户指出它的局限性：需要一定的命令行基础，初次使用的学习曲线比图形界面略高。但对于已经习惯终端操作的开发者来说，这点门槛几乎可以忽略。

🚀 总结：什么时候该用它？

lark-okr 解决的是一个非常具体的问题：当你的 OKR 管理频率足够高时，如何把这件事从“切屏操作”变成“终端内的一行命令”。

如果你满足以下条件，它值得一试：

  • ✅ 你经常需要查看或更新 OKR（每周至少一次）
  • ✅ 你日常使用 Claude Code、Cursor 或 Codex CLI 等 AI 编程环境
  • ✅ 你习惯命令行操作，不排斥敲命令
  • ✅ 你希望减少在飞书和 IDE 之间切换的次数

如果你只是每个季度写一次 OKR、平时基本不碰，那直接用飞书 App 就够了——没必要为低频操作增加额外的工具。

工具的价值不在于功能多强大，而在于是否切中了你的工作流痛点。对于高频 OKR 追踪者来说，lark-okr 可能是你今年装过最不起眼、但最能省时间的插件之一。