lark-okr

SKILL.md

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

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