okr-run
Skill3 starsChanged 7 months agoMITView on GitHub
Run the full DoWithOKR workflow from client need to GM OKR, role tree, role OKR, delivery acts, status board, scoring, and final result.
In this repository11 other files it gives its agents.
- okr-alignment-checkSkill
- okr-archiveSkill
- okr-execution-planSkill
- okr-gmSkill
- okr-next-cycleSkill
- okr-plannerSkill
- okr-review-scoreSkill
- okr-role-runSkill
- okr-role-splitterSkill
- okr-run-webSkill
- okr-status-trackerSkill
The file
Files
OKR Run
前置条件
- 需要:用户自然语言需求描述(全新执行时)。
- 缺失处理:
- 全新执行但无需求 → 提示用户输入需求。
- 断点续跑 → 无需额外输入,从上次进度继续。
前置读取
- 检查
.okr/active.md是否存在。- 存在且包含
current_act→ 断点续跑模式:- 读取
current_act确定当前交付幕。 - 扫描
.okr/status.md统计各 KR 的实际状态(未开始 / 进行中 / 阻塞 / 已完成 / 放弃)。 - 综合两者生成进度摘要,供用户决策。
- 读取
- 存在但用户要求重新开始 → 归档到
.okr/archive/<YYYY-MM-DD>-active.md,重新初始化。 - 不存在 → 全新执行,从 M0 开始。
- 存在且包含
- 读取用户输入的自然语言需求(全新执行时必须)。
- 状态文件结构(含归档目录):
.okr/ active.md status.md evidence/ reviews/ archive/ # 历史快照归档 <YYYY-MM-DD>-active.md <YYYY-MM-DD>-status.md
执行规则
- 用于全自动闭环执行。
- 固定主链路:甲方需求 → GM OKR → 角色树 → 角色 OKR → 交付幕计划 → 角色执行 → 状态看板 → 上级评分 → 最终 R。
- 写入状态文件、高风险操作、范围变化、证据不足标记完成前必须请求用户确认。
- 每个阶段必须更新状态:未开始、进行中、阻塞、已完成、放弃。
- 每个完成项必须有证据。
状态机
转换表
| 当前幕 | 退出门禁 | 验证方式 | 通过 → 下一幕 | 未通过处理 |
| M0 | 用户确认 GM OKR | active.md 含 ## GM OKR 且用户确认 | → M1 | 停留 M0,修改后重新确认 |
| M1 | 所有 GM KR 有负责人 | active.md 含 ## 角色树 + ## 层级 OKR;status.md 已创建 | → M2 | 停留 M1,提示补充角色或 KR 映射 |
| M2 | 产品方案和技术方案明确 | PD 和 ArchD KR 状态 ≠ 未开始;active.md 含 ## 交付验证计划;用户确认方案 | → M3 | 停留 M2,继续执行方案角色 |
| M3 | 关键 KR 有证据且自检达标 | status.md 中 M3 阶段 KR 均有证据或标记为放弃;角色自检结果达标 | → M4 | 停留 M3,列出缺失证据和未达标的 KR |
| M4 | 评分和复盘完整 | reviews/ 下存在评分文件;用户确认最终 R | → 完成 | 停留 M4,补充评分 |
子技能调用序列
| 幕 | 调用序列 | 用户确认点 |
| M0 | okr-gm | GM OKR 确认 |
| M1 | okr-role-splitter → okr-planner | 无(自动流转) |
| M2 | okr-execution-plan → okr-role-run(PD) → okr-role-run(PM) → okr-role-run(UI) → okr-role-run(ArchD) → okr-status-tracker | 方案确认 |
| M3 | okr-role-run(BE) → okr-role-run(FE) → okr-role-run(QA) → okr-role-run(DevOps) → okr-role-run(SEC) → okr-role-run(TW) → okr-alignment-check → okr-status-tracker | 无(门禁自动检查:证据 + 自检达标) |
| M4 | okr-review-score → okr-next-cycle | 最终 R 确认 |
执行步骤
启动判断
- 检查
.okr/active.md是否存在。 - 如果存在,读取
current_act并扫描status.md获取实际 KR 状态:- 统计各状态 KR 数量(未开始 / 进行中 / 阻塞 / 已完成 / 放弃)。
- 展示进度摘要:
- 当前交付幕:
current_act值(如 M2 方案成型幕)。 - 已完成 KR:X / 总 KR 数。
- 进行中 KR:列出 KR 编号和对应角色。
- 阻塞项:列出阻塞的 KR 编号、阻塞原因和影响范围。
- 当前交付幕:
- 给用户 3 个选项:
- 从断点继续:从
current_act对应的幕继续执行,跳过已完成的步骤。 - 重新开始:将当前
.okr/active.md归档到.okr/archive/<YYYY-MM-DD>-active.md,同时归档status.md到.okr/archive/<YYYY-MM-DD>-status.md,然后重新初始化,从 M0 开始。 - 取消:不执行任何操作,退出。
- 从断点继续:从
- 如果不存在,进入 M0 全新执行。
- 如果用户选择"重新开始":
- 创建
.okr/archive/目录(如不存在)。 - 归档当前状态文件。
- 清空
.okr/active.md和.okr/status.md,从 M0 开始。
- 创建
M0 需求转译幕
- 调用
okr-gm:将甲方需求转成 GM OKR。 - 验证:
.okr/active.md包含## GM OKR区块。 - 用户确认点:展示 GM OKR,等待用户确认后继续。
M1 组织拆解幕
- 调用
okr-role-splitter:生成角色树。 - 验证:
.okr/active.md包含## 角色树区块。 - 调用
okr-planner:生成层级 OKR 和交付幕计划。 - 验证:
.okr/active.md包含## 层级 OKR和## 交付幕计划;.okr/status.md已创建。
M2 方案成型幕
- 调用
okr-execution-plan:生成交付验证计划(验收标准 + 验证方法 + 证据类型)。 - 调用
okr-role-run:执行 PD 产品总监角色 OKR。 - 调用
okr-role-run:执行 PM 产品经理和 UI 设计师角色 OKR。 - 调用
okr-role-run:执行 ArchD 技术总监角色 OKR。 - 调用
okr-status-tracker:展示当前看板。 - 用户确认点:展示方案摘要,等待用户确认后进入构建阶段。
M3 构建验证幕
- 按推荐顺序调用
okr-role-run:BE → FE → QA → DevOps → SEC → TW(按角色树裁剪结果跳过不参与的角色)。 - 每个角色执行后调用
okr-alignment-check:检查交付结果是否满足 KR 标准。 - 调用
okr-status-tracker:展示当前看板。 - 门禁检查:关键 KR 是否有证据且自检结果达标。未通过 → 停留 M3,提示缺失项和未达标项。
M4 收敛复盘幕
- 调用
okr-review-score:上级评分并汇总最终 R。okr-review-score完成评分后会执行周期归档与清理(归档 active.md、status.md、evidence/、reviews/ 到.okr/archive/<date>-cycle/,清空工作区,保留 wisdom/ 和 archive/)。- 归档前需用户确认。
- 调用
okr-next-cycle:生成下一轮建议。- 如果用户确认本轮结束且
okr-review-score已完成归档,则okr-next-cycle跳过归档。 - 如果用户在
okr-review-score阶段拒绝了归档,okr-next-cycle在用户确认结束时再次触发归档。
- 如果用户确认本轮结束且
- 用户确认点:展示最终 R 和下一轮建议,等待用户决定。
失败回退
- 任一步骤的前置读取失败 → 停止并报告缺失的前置条件和建议操作。
- 门禁未通过 → 停留当前幕,列出未满足的退出条件。
- 用户拒绝确认 → 回退到当前幕起点,允许用户修改后重新执行。
输出格式
先输出全局摘要,再按交付幕展示 GM OKR、角色树、执行计划、OKR 状态看板、上级评分、最终 R。
必须包含:
- 当前交付幕
- 上级映射
- 证据
- 下一步
异常处理
- 用户中途要求跳过某个幕:允许跳过但提示风险(如跳过 M2 直接进入 M3 可能导致方案不明确)。
- 某个角色执行失败或阻塞:记录阻塞状态,继续执行其他角色,最后汇总阻塞项。
- 用户中途修改需求:暂停执行,回到 M0 重新生成 GM OKR,保留已有角色树和执行记录供参考。
产出写入
- 本技能通过调用子技能间接写入所有
.okr/文件。 - 每个子技能调用后验证其产出文件已正确写入。
- 更新
.okr/active.mdfrontmatter 的current_act为当前执行到的交付幕。 - Web 事件发射:每个子技能调用完成后,追加一行 JSON 到
.okr/web/events.jsonl(目录不存在时自动创建)。事件格式:{ "time": "2026-05-01T10:00:00+08:00", "skill": "okr-role-run", "act": "M3", "role": "BE", "status": "completed", "changed": [".okr/status.md", ".okr/evidence/BE-KR1.md"], "summary": "BE-KR1 已完成接口实现" }status取值:completed、failed、skipped。.okr/文件仍是唯一状态源,事件仅用于通知 Web 控制台刷新。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

