| name | aipd-okr |
| description | AIPD OKR 目标管理入口。查看、创建、同步、删除或讨论 OKR 时使用;AIPD 中的 OKR 默认指飞书 OKR,覆盖 lark-cli、周期、O/KR、对齐关系、OKR 经验包和让子 Agent 获取 OKR 结果以节省主 Agent 上下文。
|
| allowed-tools | ["Read","Write","Edit","Bash","Glob","Grep","Agent","AskUserQuestion"] |
| inject-from-core | ["okr/guide.md","okr/feishu-cli.md"] |
AIPD OKR
aipd-okr 是 AIPD 的飞书 OKR 入口。AIPD 里提到 OKR 时,默认就是飞书 OKR;本 skill 负责把飞书查询、写入和对齐判断压缩成主 Agent 可用的结果。
职责边界
只做:
- 读取当前项目的
_adoc/index.md、_adoc/map.md 和 _adoc/okr/index.md,确认本项目 OKR 入口和协作边界。
- 按需读取
@references/okr/guide.md,理解 AIPD 的飞书 OKR 规则。
- 涉及飞书 OKR 或
lark-cli 时,读取 @references/okr/feishu-cli.md。
- 查看、创建、同步、删除或解释飞书 OKR。
- 把高噪声远端查询、CLI 输出和跨项目核对压缩成 OKR 经验包,交给主 Agent 决策。
- 写回
_adoc/okr/index.md 中必要的飞书入口、周期 ID、目标 ID、协作边界或操作经验。
不做:
- 不把 OKR 当 todo 列表,也不替代 case / work package。
- 不默认读取
_adoc/case/;只有用户明确要求 OKR 与 case 对齐,或当前任务本身需要判断某个 case 是否推进目标时才读取。
- 不把完整飞书 JSON、CLI 长日志、调试输出贴回主 Agent。
- 不在用户未确认时执行远端写入或删除。
默认流程
- 读取当前项目
_adoc/index.md 和 _adoc/map.md。
- 如果存在
_adoc/okr/index.md,读取它;如果不存在,只说明当前项目还没有记录飞书 OKR 入口。
- 判断用户任务类型:
- 只读查看 / 解释 / 对齐讨论:读取
@references/okr/guide.md,必要时查询远端。
- 飞书操作 / lark-cli / 周期查询:读取
@references/okr/feishu-cli.md。
- 写入 / 删除:先给操作方案、影响范围和待确认命令,用户确认后执行。
- 输出压缩结果或 OKR 经验包。
- 如果产生稳定飞书入口或 ID,询问是否写回
_adoc/okr/index.md;用户确认后再写。
子 Agent 与经验包
飞书远端查询、CLI 探测或单周期核对上下文可控时,Main Agent 可以直接完成。预计会产生长日志、大量原始 JSON,或存在多个可独立并发的周期 / 项目核对时,优先派 Child 隔离或并发;平台不可用时由 Main 回退执行,用户明确要求不派 Child 时遵循用户当前指令。Child 不因此获得额外的远端写入权限;写入和删除仍按下文规则确认。
派发给子 Agent 的任务应短,只传:
- 当前项目路径。
- 用户要解决的 OKR 问题。
- 是否允许远端写入;未说明时只能只读。
- 需要读取的参考:
@references/okr/guide.md、必要时 @references/okr/feishu-cli.md。
子 Agent 只返回 OKR 经验包,不返回完整工具输出。
【OKR 经验包】
- 来源:飞书 OKR / lark-cli / 用户讨论 / 子项目 ADOC / _adoc/okr 入口索引
- 任务:查看 / 创建 / 同步 / 删除 / 对齐 / 能力探测
- 已读上下文:...
- 远端状态:周期、O/KR 数量、关键 ID、必要链接;不贴完整 JSON
- AIPD 入口状态:_adoc/okr/index.md 是否记录飞书入口和关键 ID
- 判断:本次应该怎么处理,以及为什么
- 风险:权限、周期错配、重复 O/KR、远端写入风险、安装版 skill 版本差
- 建议动作:...
- 可写回字段:周期 ID、objective_id、KR id、协作边界、操作经验
- 原始输出位置:如必须保留长输出,写临时文件路径或说明未保留
飞书操作约束
- 执行写入前,必须让用户确认目标周期、O/KR 文本和是否创建 / 删除。
- 删除 Objective 必须使用
--yes,但只能在用户明确确认后执行。
- 查询远端时优先用
--jq 裁剪字段。
- 如果 CLI 能力与预期不一致,先返回能力探测结果,不继续猜测。
- 如果 AIPD 源码和已安装 skill 的 OKR 规则不一致,明确说明版本差,并以当前已加载的
aipd-okr skill 为准。
AIPD 记录规则
_adoc/okr/index.md 只保存对后续 Agent 有用的飞书 OKR 索引信息:
- 飞书 OKR 入口。
- 周期 ID。
- Objective / KR ID。
- 全局 O 与子项目 KR 的协作边界。
- 对 Agent 后续操作有用的最小经验。
需要复盘时,读取飞书 OKR 或输出 OKR 经验包。
典型用户说法
/aipd-okr 看一下当前 OKR
/aipd-okr 把这组 O/KR 创建到飞书
/aipd-okr 查一下飞书有哪些周期
/aipd-okr 给这个 KR 建一个子项目目标
/aipd-okr 删除这个测试 Objective
/aipd-okr 生成一个 OKR 经验包给主 Agent