lark-okr

Installation
Summary

View, create, and manage OKR cycles, objectives, key results, alignments, and progress tracking.

  • Eight high-level shortcuts for common operations: listing cycles and progress records, retrieving cycle details, and creating or updating progress entries
  • Full API coverage for OKR entities including objectives, key results, indicators, alignments, and categories with create, read, update, and delete operations
  • Support for weighted and positioned objectives and key results within cycles, with validation enforcing weight sums and position uniqueness
  • Rich text content blocks for objective, key result, and progress notes, with image upload capability for progress records
  • Scope-based permission model distinguishing read-only access, write-only access, and settings access across OKR operations
SKILL.md

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
Installs
326.1K
Repository
larksuite/cli
GitHub Stars
16.0K
First Seen
Apr 17, 2026
lark-okr — larksuite/cli