roacherm okr
用户的目标与任务追踪在 ~/.okr，命令行工具 okr 就在本 skill 目录的 scripts/okr.js（单文件，Node ≥ 20；仓库 github.com/RoacherM/Wayne-Skills）。下文所有 okr … 都指：PATH 上有 okr 就用它，否则 node <本 skill 目录>/scripts/okr.js …。规则全部在协议文档里，先读它再动手：
okr protocol
没有 ~/.okr/nodes.yaml：问用户是否 okr init，旧 goals.yaml 走 okr migrate。
本 skill 固定的事
- 写入一律带
--by <自己的名字> --json（Claude Code 用claude，Codex 用codex，Gemini 用gemini），读也--json，自己解析后用中文一句话回用户。 - 会话里第一次碰 okr 先按协议 §2 跑
okr brief --json，empty为 true 就不提，否则挑要紧的一句。 - 每次写之前
okr recent --node <id> --days 7 --json查重，语义重复不写。 - 指代歧义（退出码 2）列候选让用户选；需要
--confirmed的事先说清楚再等用户点头；被守卫拒绝（退出码 3）按协议 §10 处理，不自作主张--force。 - 数值（
--value、--hours）只写用户口述的。
意图 → 协议章节
| 用户在做什么 | 看协议 | 典型命令 |
|---|---|---|
| 汇报进展、指标、完成、阻塞、打卡 | §3 §4 | okr log done block check |
| 验收执行 agent 的 PR | §4 §9 | okr done / okr reject "意见" |
| 问进度、看板、哪些落后 | §2 | okr tree --json（task 的 flags / stage 只在这里和 show 里）、okr status --json（根节点）、okr show <id> --json |
| 评估某个目标到了几成 | §5 | 默认信推导；不同意才 okr assess --value --reason |
| 建目标、拆任务、做周计划、今日清单 | §6 §7 | okr week --json + okr candidates --json 取数 → 展示提案 → 用户点头 → 写 reports/<周>.plan.yaml + okr apply --from … --confirmed；否掉就 okr apply --dismiss |
| 写日报 / 周报、推到备忘录、装定时任务 | §11 | okr changes --since last-daily --json / okr report data --json 取数写 markdown → okr report write --kind daily|weekly --from <md>；okr deliver notes --from <md>；用户要自动化就 okr job install（会触发备忘录授权，让用户自己跑） |
| 写目标、写 KR | §7「怎么写目标和 KR」 | 目标一句终点状态；KR 一句可验证结果加截止，有精确评估方法才用 metric 否则 milestone；做的事进任务不进 KR；只用读者共享的术语 |
| 改结构：加、改、挪、删、取消、冻结 | §7 | okr add/edit/move/rm … --confirmed |
| 「这个仓库对应哪个 KR」、汇总仓库进度 | §8 | okr repo add <path> --node <id>，读仓库 .okr.yaml |
| 派任务给执行 agent | §9 | okr show <id> --spec，整段贴给执行 agent |
| 自己就是执行 agent（拿到派工包） | §9 | 按契约只写 claim block log submit --link，带 --by --session，不写 done / assess |
回复格式
- 写入成功：一行，说记到了哪个节点、什么事件，附推导变化（写命令的
--json返回里就有progress/stage，写前show --json拿一次基线即可）。例：「记到 kr1：精度 86%（53% → 58%）」。 - 多条更新一句话里：先解析成列表给用户看，确认后按顺序写，逐条一行。
- 看板：
okr status/okr tree/okr week在管道里就是 80 列纯文本，原样贴给用户即可（要 markdown 加--md，写报告时也用--md），再补一两句要关注的。 - 提案：任务名、优先级、截止、所属、一句为什么；不要在用户确认前写入。
派工
用户点名派工时：okr show <id> --spec --json 检查 dispatchable；不可派就先补 spec（问用户 goal / accept / verify / link）。可派就把 okr show <id> --spec 的 markdown 原样交给执行 agent（用户自己开的窗格 / worktree 里的 codex 或 claude），并告诉它 --by 用什么名字、--session 用 worktree 名；并把协议 §9 的执行 agent 契约一起交给它（执行侧暂无单独 skill）。之后用 okr show <id> --json 的 claimed / stage 跟进。