SKILL.md
$27
格式说明
- OKR 业务实体 获取 OKR 实体结构，定义和关系，帮助你更好的使用 OKR 功能
- ContentBlock 富文本格式 — Objective/KeyResult/Progress 中 Content/Note 字段使用的富文本格式说明
- 强烈建议 在操作 OKR 前，阅读OKR 业务实体以了解基础概念
API Resources
lark-cli schema okr.<resource>.<method> # 调用 API 前必须先查看参数结构
lark-cli okr <resource> <method> [flags] # 调用 API重要：使用原生 API 时，必须先运行 schema 查看 --data / --params 参数结构，不要猜测字段格式！
alignments
delete— 删除对齐关系
get— 获取对齐关系
categories
list— 批量获取分类
cycles
list— 批量获取用户周期
objectives_position— 更新用户周期下全部目标的位置
- 请求中必须同时修改对应周期下全部目标的位置，且不允许位置重叠，否则会参数校验失败。
objectives_weight— 更新用户周期下全部目标的权重
- 请求中必须同时修改对应周期下全部目标的权重，且所有权重值的和必须等于 1 ，否则会参数校验失败。
cycle.objectives
create— 创建目标
list— 批量获取用户周期下的目标
indicators
patch— 更新量化指标
key_results
delete— 删除关键结果
get— 获取关键结果
patch— 更新关键结果
key_result.indicators
list— 获取关键结果的量化指标
objectives
delete— 删除目标
get— 获取目标
key_results_position— 更新全部关键结果的位置
- 请求中必须同时修改对应目标下全部关键结果的位置，且不允许位置重叠，否则会参数校验失败。
key_results_weight— 更新全部关键结果的权重
- 请求中必须同时修改对应目标下全部关键结果的权重，且所有权重值的和必须等于 1 ，否则会参数校验失败。
patch— 更新目标
objective.alignments
create— 创建对齐关系
- 对齐不允许对齐自己的目标，且发起对齐的目标和被对齐的目标所在周期时间上必须有重叠，否则会参数校验失败。
list— 批量获取目标下的对齐关系
objective.indicators
list— 获取目标的量化指标
objective.key_results
create— 创建关键结果
list— 批量获取目标下的关键结果
权限表
方法
所需 scope
alignments.delete
okr:okr.content:writeonly
alignments.get
okr:okr.content:readonly
categories.list
okr:okr.setting:read
cycles.list
okr:okr.period:readonly
cycles.objectives_position
okr:okr.content:writeonly
cycles.objectives_weight
okr:okr.content:writeonly
cycle.objectives.create
okr:okr.content:writeonly
cycle.objectives.list
okr:okr.content:readonly
indicators.patch
okr:okr.content:writeonly
key_results.delete
okr:okr.content:writeonly
key_results.get
okr:okr.content:readonly
key_results.patch
okr:okr.content:writeonly
key_result.indicators.list
okr:okr.content:readonly
objectives.delete
okr:okr.content:writeonly
objectives.get
okr:okr.content:readonly
objectives.key_results_position
okr:okr.content:writeonly
objectives.key_results_weight
okr:okr.content:writeonly
objectives.patch
okr:okr.content:writeonly
objective.alignments.create
okr:okr.content:writeonly
objective.alignments.list
okr:okr.content:readonly
objective.indicators.list
okr:okr.content:readonly
objective.key_results.create
okr:okr.content:writeonly
objective.key_results.list
okr:okr.content:readonly