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 |