lark-okr
open.feishu.cn
Manage OKR cycles, objectives, key results, alignments, and progress tracking in Feishu.
What is lark-okr?
Feishu OKR skill enables viewing and editing OKR cycles, objectives, key results, alignment relationships, quantitative indicators, and progress records. Use this when you need to view or create OKRs, manage goals and key results, or track alignment relationships.
- View and list OKR cycles for specific users with time-based filtering
- Retrieve detailed objectives and key results within OKR cycles
- Create, update, and delete progress records for objectives and key results
- Create objectives and key results in batch operations
- Manage alignment relationships between objectives across cycles
- Update quantitative indicators and current values for objectives and key results
How to install lark-okr
npx skills add null --skill lark-okr- lark-cli installed and configured
- Read ../lark-shared/SKILL.md for authentication and permission handling
- Appropriate Feishu OKR permissions for the operations you plan to perform
How to use lark-okr
- 1.Read the OKR business entities reference to understand OKR structure and relationships
- 2.Use +cycle-list to retrieve OKR cycles for a user, optionally filtered by time
- 3.Use +cycle-detail to get all objectives and key results within a specific cycle
- 4.Create objectives with cycle.objectives create or use +batch-create for multiple objectives
- 5.Create key results under objectives using objective.key_results create
- 6.Manage alignment relationships with objective.alignments create and alignments delete
- 7.Update progress with +progress-create, +progress-update, or +progress-delete as needed
- 8.Use +indicator-update to modify quantitative indicator current values
Use cases
- Track quarterly OKR progress by viewing cycle details and updating progress records
- Create alignment relationships between team objectives and company-level goals
- Batch import multiple objectives and key results for a planning cycle
- Monitor key result indicators and update current values as work progresses
- Adjust objective priorities by reordering and modifying weights
- OKR managers and team leads
- Individual contributors tracking personal OKRs
- Strategy and planning teams
- Anyone managing goals and key results in Feishu
lark-okr FAQ
--as user (default) views OKR for the current user or their direct reports. --as bot allows viewing other users' OKRs if you have the appropriate permissions.
No, alignment is only allowed between objectives whose cycles have overlapping time periods, and an objective cannot align with itself.
Use +weight shortcut or the objectives_weight/key_results_weight API. All weights in a group must sum to 1.0 and you must specify all items in the group.
Refer to the ContentBlock rich-text format reference (lark-okr-contentblock.md) for supported formatting in Objective/KeyResult/Progress content and note fields.
Use lark-task for todo/task management and lark-calendar for scheduling and meetings. This skill focuses only on OKR management.
Full instructions (SKILL.md)
Source of truth, from open.feishu.cn.
name: lark-okr version: 1.0.0 description: "飞书 OKR：管理目标与关键结果。查看和编辑 OKR 周期、目标、关键结果、对齐关系、量化指标和进展记录。当用户需要查看或创建 OKR、管理目标和关键结果、查看对齐关系时使用。不负责：待办任务管理（lark-task）、日程/会议安排（lark-calendar）、绩效评估" metadata: requires: bins: [ "lark-cli" ] cliHelp: "lark-cli okr --help"
okr (v2)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
身份：OKR 操作默认使用 --as user（查看当前用户/上下级的 OKR 时）。也支持 --as bot 查看他人 OKR（需相应权限）。
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 进展记录的富文本内容 |
+batch-create | 批量创建 Objective 和 KR |
+reorder | 调整 Objective 或 KR 的顺位 |
+weight | 调整 Objective 或 KR 的权重 |
+indicator-update | 更新 Objective 或 KR 的指标当前值 |
格式说明
OKR 业务实体获取 OKR 实体结构，定义和关系，帮助你更好的使用 OKR 功能ContentBlock 富文本格式— Objective/KeyResult/Progress 中 Content/Note 字段使用的富文本格式说明- 强烈建议 在操作 OKR 前，阅读
OKR 业务实体以了解基础概念
API Resources
alignments
delete— 删除对齐关系get— 获取对齐关系
categories
list— 批量获取分类
cycles
list— 批量获取用户周期objectives_position— 更新用户周期下全部目标的位置- 请求中必须携带对应周期下全部目标的 ID，否则会参数校验失败。以传入的目标ID顺序重新排列目标。
objectives_weight— 更新用户周期下全部目标的权重- 请求中必须同时修改对应周期下全部目标的权重，且所有权重值的和必须等于 1 ，否则会参数校验失败。例如周期下有 2 个目标时：
- 正确指令示例如下：
lark-cli okr cycles objectives_weight --params '{"cycle_id": "7000000000000000001"}' --data '{"objective_weights": [{"objective_id": "7000000000000000002", "weight": 0.7}, {"objective_id": "7000000000000000003", "weight": 0.3}]}' --as user
cycle.objectives
create— 创建目标list— 批量获取用户周期下的目标
indicators
patch— 更新量化指标
key_results
delete— 删除关键结果get— 获取关键结果patch— 更新关键结果
key_result.indicators
list— 获取关键结果的量化指标
objectives
delete— 删除目标get— 获取目标key_results_position— 更新全部关键结果的位置- 请求中必须携带对应周期下全部关键结果的 ID，否则会参数校验失败。以传入的关键结果ID顺序重新排列关键结果。
key_results_weight— 更新全部关键结果的权重- 类似
objectives_weight, 请求中必须同时修改对应目标下全部关键结果的权重，且所有权重值的和必须等于 1 ，否则会参数校验失败。
- 类似
patch— 更新目标
objective.alignments
create— 创建对齐关系- 对齐不允许对齐自己的目标，且发起对齐的目标和被对齐的目标所在周期时间上必须有重叠，否则会参数校验失败。
list— 批量获取目标下的对齐关系
objective.indicators
list— 获取目标的量化指标
objective.key_results
create— 创建关键结果list— 批量获取目标下的关键结果
不在本 skill 范围
- 待办任务管理 → 使用
lark-task - 日程安排 → 使用
lark-calendar - 绩效评估 → 使用
lark-openapi-explorer查找原生接口
Related skills
More from open.feishu.cn and the wider catalog.
lark-approval
飞书审批：查询和处理审批待办/已办/实例，搜索可发起审批定义、查看定义详情并发起原生审批实例。当用户要处理审批任务、查看审批实例、搜索或发起审批时使用。审批待办不是飞书任务；非审批类待办走 lark-task。不负责创建审批定义；三方审批定义不走原生提单。
lark-doc
飞书云文档（Docx / Wiki 文档）：读取和编辑飞书文档内容。当用户给出文档 URL 或 token，或需要查看、创建、编辑文档、插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板，先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时，也应直接使用本 skill；路由依据是 URL 路径模式和 token，而不是域名。不负责文档评论管理，也不负责表格或 Base 的数据操作。
lark-base
飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、workflow、角色权限；遇到 Base/多维表格/bitable 或 /base/ 链接时使用。文件导入转 lark-drive，认证/授权转 lark-shared。
lark-calendar
飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-vc）、待办任务（走 lark-task）。
lark-drive
飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用；doubao.com 云空间 URL/token 也按资源路径和 token 路由，不回退 WebFetch。不负责：文档内容编辑（走 lark-doc）、表格/Base 表内数据操作（走 lark-sheets/lark-base）、知识空间节点/成员管理（走 lark-wiki）、原生 Markdown 文件读写/patch/diff（走 lark-markdown）。
lark-contact
飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名。当用户提到某人姓名要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用。不负责部门树遍历、按部门列员工、组织架构图,这类需求走原生 OpenAPI。