lark-okr

Q: How do I install lark-okr?

Run npx skills add https://open.feishu.cn --skill lark-okr in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/lark-okr/ (personal) or .claude/skills/lark-okr/ (project).

by open.feishu.cnProductivity & Automation

飞书 OKR：管理目标与关键结果。查看和编辑 OKR 周期、目标、关键结果、对齐关系、量化指标和进展记录。当用户需要查看或创建 OKR、管理目标和关键结果、查看对齐关系时使用。不负责：待办任务管理（lark-task）、日程/会议安排（lark-calendar）、绩效评估

Installs: 792.9K
Last 24h: +4.9K
Trending rank: #91
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://open.feishu.cn --skill lark-okr

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads lark-okr automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

okr (v2)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理

身份：OKR 操作默认使用 --as user（查看当前用户/上下级的 OKR 时）。也支持 --as bot 查看他人 OKR（需相应权限）。

快速决策

用户需求	操作路径	参考文档
查看自己/他人的 OKR	获取用户 ID -> `+cycle-list` -> `+cycle-detail` -> 按需查指标/进展记录	`cycle-list`, `cycle-detail`, `indicators`, `progress-list`
为自己写一组 OKR	优先用 `+batch-create` 创建 Objective/KR 骨架	`batch-create`, `contentblock`
只新增一条 O 或单条 KR	用 `+create`	`create`
编辑内容/备注/截止时间	用 `+patch`	`patch`
修改 OKR 分数	只有用户明确说“分数”“评分”“打分”“score”时才用 `+patch --score`；分数不是进度/完成度	`patch`
调整顺序或权重	用 `+reorder` / `+weight`	`reorder`, `weight`
更新数字进度/完成度	百分比或不带单位数字用 `+indicator-update`；需要改单位/目标值时查指标后用 `indicators patch`	`indicator-update`, `indicators`
写文字进展	用 `+progress-create`；如果文本和数字都有，百分比或默认单位可使用 `--progress-percent` 统一改，非百分比单位更新量化指标	`progress-create`, `progress-list`, `progress-update`
对齐目标	直接按对齐关系工作流处理	`alignments`
查询/创建/修改/解决 OKR 评论	获取周期下全部评论聚合用 `+comment-detail`，查询单个 O/KR/进展或仅查询周期全局评论用 `+comment-list`；	`comment`, `comment-create`, `comment-solve-reopen`

分类只在用户明确要求分类，或创建 Objective 返回 invalid parameters 且怀疑租户强制开启分类时处理：用 lark-cli okr categories list --params '{"owner_type":"user","page_size":100}' --as user 查可用分类，选择语义合适且enabled=true 的分类 ID；分类可后续调整，不必停下等待用户确认。

获取当前用户用 contact +get-user；按姓名/邮箱查他人用 contact +search-user，拿到 open_id 后再查 OKR。

lark-cli contact +search-user --query "张三" --has-chatted --as user

最常用 OKR 命令示例：

# 查用户周期，再用周期 ID 查详情
lark-cli okr +cycle-list --user-id "ou_xxx" --as user
lark-cli okr +cycle-detail --cycle-id 7000000000000000001 --as user

# 批量创建 Objective/KR
lark-cli okr +batch-create \
  --cycle-id 7000000000000000001 \
  --input '[{"text":"提升产品用户体验","notes":"关注核心流程和用户反馈","krs":[{"text":"核心流程满意度达到 4.8 分"}]}]' \
  --as user

# 更新数字进度/完成度
lark-cli okr +indicator-update \
  --level key-result \
  --id 7000000000000000003 \
  --value 75 \
  --as user

分数和进度不要混用：用户说“进度”“完成度”“当前做到 75%”时，通常是在改量化指标或写进展记录，不是在改 score。只有明确要求修改 OKR 分数/评分/打分时，才使用 +patch --score；score 取值是 0-1，最多一位小数。

进度判断规则：用户说“进度”“完成度”时，先判断是否是量化数字。数字进度通常对应量化指标；不可量化文本对应进展记录。需要修改指标单位时看 lark-okr-indicators.md

Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装（lark-cli okr +<verb> [flags]）。有 Shortcut 的操作优先使用。

Shortcut	说明
`+cycle-list`	分页获取特定用户的 OKR 周期列表，可以用 `--time-range` 对当前页后置筛选
`+cycle-detail`	获取特定 OKR 中所有目标和关键结果的内容
`+create`	创建单个 Objective（可带备注），或向已有 Objective 新增 KR
`+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 的当前进度指标。更复杂的量化指标操作见量化指标管理
`+patch`	部分更新 Objective 或 KR（content、notes、score、deadline）
`+comment-detail`	获取周期下 Cycle/Objective/KeyResult/Progress 的全部评论
`+comment-list`	分页获取单个 OKR 实体下的评论
`+comment-get`	获取单条评论详情
`+comment-create`	创建新评论或回复已有评论(仅支持 --as user)
`+comment-patch`	修改评论内容(仅支持 --as user)
`+comment-delete`	永久删除单条评论(仅支持 --as user)
`+comment-solve`	解决评论或划词评论串(仅支持 --as user)
`+comment-reopen`	重新打开评论或划词评论串(仅支持 --as user)

创建场景选择

单条创建优先用 +create：适合创建一个 Objective，或给已有 Objective 增加一个 KR。
批量创建用 +batch-create：适合一次创建多个 Objective，并可同时附带多个 KR。
如果你只需要修改已有 Objective / KR 的内容、备注、分数或截止时间，使用 +patch。

格式说明

OKR 业务实体 获取 OKR 实体结构，定义和关系，帮助你更好的使用 OKR 功能
ContentBlock 富文本格式 — Objective/KeyResult/Progress 中 Content/Note 字段使用的富文本格式说明，以及简化的半纯文本（SemiPlainContent）格式的进一步说明。
强烈建议 在操作 OKR 前，阅读OKR 业务实体以了解基础概念

API Resources

alignments

delete — 删除对齐关系
get — 获取对齐关系

操作指南： OKR 对齐关系管理包含 list/create/delete 完整工作流

cycles

list — 批量获取用户周期

cycle.objectives

list — 批量获取用户周期下的目标

indicators

patch — 更新量化指标

操作指南： OKR 量化指标管理包含目标/KR 指标查询和 patch 更新完整工作流

key_results

delete — 删除关键结果
get — 获取关键结果
patch — 更新关键结果

key_result.indicators

list — 获取关键结果的量化指标

操作指南： OKR 量化指标管理

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

list — 批量获取目标下的关键结果

不在本 skill 范围

待办任务管理 → 使用 lark-task
日程安排 → 使用 lark-calendar
绩效评估 → 使用 lark-openapi-explorer 查找原生接口

FAQ

What does the lark-okr skill do?

How do I install lark-okr?

Run npx skills add https://open.feishu.cn --skill lark-okr in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/lark-okr/ (personal) or .claude/skills/lark-okr/ (project).

Which AI agents can use lark-okr?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is lark-okr safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains lark-okr?

It is published by open.feishu.cn in open.feishu.cn. It has 792,875 recorded installs.

Source

open.feishu.cn $View on skills.sh

Works with

Claude CodeCodexCursorGitHub CopilotGemini CLIWindsurfClineOpenCodeRoo CodeGooseAmpKiro

Files 26 · 159.4 KB

SKILL.md14.8 KB
references/lark-okr-alignments.md5.3 KB
references/lark-okr-batch-create.md4.3 KB
references/lark-okr-comment-create.md8.0 KB
references/lark-okr-comment-delete.md2.8 KB
references/lark-okr-comment-detail.md4.1 KB
references/lark-okr-comment-get.md3.2 KB
references/lark-okr-comment-list.md4.5 KB
references/lark-okr-comment-patch.md4.2 KB
references/lark-okr-comment-solve-reopen.md3.7 KB
references/lark-okr-contentblock.md12.8 KB
references/lark-okr-create.md7.4 KB
references/lark-okr-cycle-detail.md3.5 KB
references/lark-okr-cycle-list.md4.9 KB
references/lark-okr-entities.md25.6 KB
references/lark-okr-image-upload.md3.4 KB
references/lark-okr-indicator-update.md3.5 KB
references/lark-okr-indicators.md11.2 KB
references/lark-okr-patch.md6.1 KB
references/lark-okr-progress-create.md5.6 KB
references/lark-okr-progress-delete.md1.4 KB
references/lark-okr-progress-get.md3.7 KB
references/lark-okr-progress-list.md4.0 KB
references/lark-okr-progress-update.md4.7 KB

+2 more files

More from open.feishu.cn

View all →

lark-doc

open.feishu.cn

飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由；/page/ 是妙搭应用，非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

Productivity & Automation815.7K installs

lark-base

open.feishu.cn

飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式（BaseApp/AppMode 页面与组件）、Workspace 目录、workflow、角色权限、模板中心（多维表格模板分类/列表/搜索）；遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps；文件导入/导出转 lark-drive，认证/授权转 lark-shared。

Productivity & Automation815K installs

lark-drive

open.feishu.cn

飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 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）。

Productivity & Automation815K installs

lark-shared

open.feishu.cn

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.

Productivity & Automation814.8K installs

lark-im

open.feishu.cn

飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶（添加/移除/查询置顶会话）、管理标签数据、处理卡片回调时使用。

Productivity & Automation814.1K installs

lark-calendar

open.feishu.cn

飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-meeting）、待办任务（走 lark-task）。

Productivity & Automation813.7K installs

Popular productivity & automation skills

View category →

agent-browser

vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

OfficialProductivity & Automation1.3M installs

research

mattpocock/skills

Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.

Productivity & Automation722.6K installs

google-agents-cli-workflow

google/agents-cli

This skill should be used when the user wants to "develop an agent", "build an agent using ADK", "run the agent locally", "debug agent code", "test an agent", "deploy an agent", "publish an agent", "monitor an agent", or needs the ADK (Agent Development Kit) development lifecycle and coding guidelines. Entrypoint for building ADK agents. Always active — provides the full workflow (scaffold, build, evaluate, deploy, publish, observe), code preservation rules, model selection guidance, and troubleshooting steps for ADK or any agent development.

Productivity & Automation513.5K installs

lark-okr

Install

Install

Describe the task

Review the result

SKILL.md

okr (v2)

快速决策

Shortcuts（推荐优先使用）

创建场景选择

格式说明

API Resources

alignments

categories

cycles

cycle.objectives

indicators

key_results

key_result.indicators

objectives

objective.alignments

objective.indicators

objective.key_results

不在本 skill 范围

FAQ

More from open.feishu.cn

Popular productivity & automation skills