| name | okr-run-web |
| description | Launch a local bilingual Web console for DoWithOKR, accepting raw requirements or user-authored GM OKR, visualizing .okr/ state, and refreshing after each skill step. |
OKR Run Web
核心定位
okr-run-web 是 okr-run 的可视化入口，不替代命令行流程。用户在浏览器中输入需求或 GM OKR，查看角色树、层级 OKR、KR 关联、状态看板、执行日志、证据和评分。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|
| --project | string | 否 | 项目根目录，默认当前工作目录 |
| --no-runner | flag | 否 | 禁用自动 Runner，仅展示状态 |
| --no-browser | flag | 否 | 不自动打开浏览器 |
前置条件
- Node.js 运行时可用（v18+）。
- 运行时脚本存在于以下位置之一：
.claude/dowithokr/scripts/okr-run-web.mjs（Claude Code 安装）.agents/plugins/plugins/dowithokr/scripts/okr-run-web.mjs（Codex 安装）.codex-plugin/scripts/okr-run-web.mjs（旧版 Codex 安装）- 插件源目录
scripts/okr-run-web.mjs（开发模式）
- 缺失处理：提示用户运行
install.sh 安装运行时资源。
前置读取
- 检查
.okr/ 目录是否存在。
- 存在 → 读取
.okr/active.md、.okr/status.md、.okr/evidence/、.okr/reviews/，在页面展示断点续跑选项。
- 不存在 → 页面展示启动表单，等待用户输入。
- 读取
.okr/web/events.jsonl（如存在），展示历史执行日志。
执行规则
- 本技能启动本地 Web 服务，不直接修改
.okr/ 状态文件（状态修改由 okr-run 及其子技能完成）。
- Web 服务只监听
127.0.0.1，不暴露局域网地址。
- 启动时生成随机 session token，所有 API 请求必须携带 token。
- 不向外部网络发送需求、OKR、代码路径或证据内容。
- 页面支持中文 / English 切换，语言偏好保存在浏览器 localStorage。
- 子技能完成后通过 SSE 事件流和文件监听双机制刷新页面。
执行步骤
- 定位运行时脚本：按优先级检查
.claude/dowithokr/scripts/okr-run-web.mjs、.agents/plugins/plugins/dowithokr/scripts/okr-run-web.mjs、.codex-plugin/scripts/okr-run-web.mjs、插件源 scripts/okr-run-web.mjs。
- 启动本地服务：
node <script> --project <cwd>。
- 服务自动探测可用端口（从 3767 开始），生成 token，打开浏览器。
- 终端输出访问 URL：
http://127.0.0.1:<port>/?token=<token>。
- 用户在页面选择输入模式：
- 原始需求模式：输入自然语言需求，点击"开始运行"触发
okr-run 从 M0 开始。
- GM OKR 模式：输入 Objective、KR、边界，点击"开始运行"写入
.okr/active.md 并从 M1 继续。
- Runner Adapter 检测可用执行器（Codex > Claude > 手动降级），触发
okr-run。
- 页面通过 SSE
/events 和文件监听持续刷新 OKR 状态。
- 用户可在页面查看角色树、层级 OKR、KR 关联、状态看板、执行日志、证据和评分。
- 服务退出时保留
.okr/ 正常状态，不删除用户数据。
输出格式
本技能的输出是浏览器页面，不产生终端文本输出。终端仅显示：
DoWithOKR Web: http://127.0.0.1:<port>/?token=<token>
页面展示内容包括：
- 当前交付幕
- GM OKR（含边界和确认状态）
- 角色树（树形结构）
- 层级 OKR（按角色分组）
- KR 状态看板（表格，支持点击查看关联链路）
- 执行日志（时间倒序）
- 证据文件列表
- 评分复盘记录
- 最终 R
异常处理
- Node.js 不可用：提示用户安装 Node.js v18+。
- 运行时脚本不存在：提示用户运行
install.sh 安装。
- 端口被占用：自动尝试下一个端口。
- Runner 不可用（无 Codex 或 Claude CLI）：页面展示降级提示，生成可复制的
okr-run 指令。
.okr/ 文件解析失败：页面展示原始内容并标注"结构化解析失败"。- SSE 连接断开：页面显示连接状态，自动重连。
产出写入
- 本技能通过 Runner Adapter 间接触发
okr-run，由子技能写入 .okr/ 文件。
- GM OKR 模式下，直接写入
.okr/active.md（标记 source: user_gm_input）。
- 执行事件追加到
.okr/web/events.jsonl。
