Eo Workflow

eo-workflow — 多 Agent 编排工作流

在 tmux 多窗格中编排新工作流的 skill 流水线。通过 tmux-bridge 跨 pane 通信，配合 CronCreate 做定时轮询，实现 module-init / change / implement / archive 的自动派发、状态监控和结果流转。

前置

必须能找到 .eo-project.json。找不到 → 报错退出，提示运行 /eo-project-init。子 pane 中执行的每个 eo-* skill 自己也会检查，但本 skill 启动时先校验以快速失败。

新工作流速览

模块不存在 → /eo-module-init（含 spec + spec-review 一次性审查）
模块已存在 + 业务变更 → /eo-change → /eo-implement → /eo-test → /eo-review → /eo-archive
实施期 bug fix → /eo-implement（不开新 change，不走 archive）

参数

/eo-workflow   [change-id] [loop-interval] [--with-review]

| 参数 | 必填 | 说明 | 示例 | |------|------|------|------| | phase | 是 | module-init / change / implement / archive / full | implement | | module-name | 是 | eo-doc/dev/ 下的模块名（kebab-case） | transport | | change-id | implement/archive 必填 | 模块内 change 目录名（如 001-add-queue） | 001-add-queue | | loop-interval | 否 | 监控轮询间隔，默认 3m | 5m | | --with-review | 否 | 在 change / full phase 启用 change-review 子阶段（change draft 完成后自动派发 /eo-change-review） | --with-review |

派生变量：

• MODULE_ROOT = eo-doc/dev//
• CHANGE_ROOT = eo-doc/dev//changes//
• LOOP_CRON = interval 转 cron（如 3m → */3 * * * *）

执行流程

1. 前置校验

| Phase | 校验 | |-------|------| | module-init | MODULE_ROOT 不存在 | | change | MODULE_ROOT/spec.md 存在且 status: confirmed | | implement | CHANGE_ROOT/change.md 存在且 status: approved 或 implementing | | archive | CHANGE_ROOT/change.md 存在且 status: done；review.md 存在且通过 | | full | module-name 有效 |

2. 启动 Pane

bash ~/.claude/skills/eo-workflow/start-panes.sh 

各阶段所需 pane（除 main/orchestrator）：

| Phase | Pane | |-------|------| | module-init | spec, review | | change | change | | implement | implement, test, review | | archive | （无，主 orchestrator 直接执行） | | full | spec, change, implement, test, review |

3. 识别 Agent 类型

从 tmux-bridge list 的 PROCESS 列判断：

• 含 codex → Codex → 前缀 $
• 含 claude 或其他 → Claude → 前缀 /

4. 设置 Loop 并首次触发

1. CronCreate 监控 job（LOOP_CRON, recurring: true）
2. 立即执行首轮操作

---

指令发送标准流程

对所有 pane 统一用 tmux-bridge type（不用 message）：

tmux-bridge read  20
tmux-bridge type  ""
tmux-bridge read  5
tmux-bridge keys  Enter

Review Pane 上下文清理

full 模式下 review pane 被 spec-review / code-review 两个阶段复用。切换阶段前发 /clear：

tmux-bridge read review 5
tmux-bridge type review "/clear"
tmux-bridge read review 5
tmux-bridge keys review Enter

---

Phase: module-init（交互式）

由用户在 spec pane 中直接操作，orchestrator 负责派发 spec-review。

首次操作

通知用户： > spec pane 已就绪，请在 spec pane 中使用 /eo-module-init 初始化模块。 > 完成后将 spec.md 的 status 改为 confirmed，我会自动派发 spec-review。

Cron 监控逻辑

1. 读 MODULE_ROOT/spec.md frontmatter → status 非 confirmed → 不操作
2. status confirmed + review pane 空闲 + spec-review.md 不存在 → 派发 eo-spec-review MODULE_ROOT/spec.md 到 review pane
3. review 完成 + spec-review.md 存在 → 读审查结论：

• 无 P0/P1 → CronDelete + 通知 "✅ 模块基线建立完成"
• 有 P0/P1 → 暂停 loop（CronDelete），通知用户去 spec pane 修复，等 continue

恢复机制

用户输入 continue 后：删除旧 spec-review.md → 重新 CronCreate 同一监控 prompt

---

Phase: change（交互式）

由用户在 change pane 中直接和 eo-change 协作澄清。默认不做自动审查（change 自澄清）；启用 --with-review 时，draft 完成后会自动派发 /eo-change-review 到 review pane。

启动 Pane

• 默认：只需 change pane
• --with-review：需要 change + review pane

首次操作

默认： > change pane 已就绪，请在 change pane 中使用 /eo-change，目标模块 `。 > 完成后将 change.md 的 status 改为 approved，然后启动 /eo-workflow implement `。

带 --with-review： > change pane 已就绪，请在 change pane 中使用 /eo-change，目标模块 `。 > change.md 写完后保持 status: draft，我会自动派发 /eo-change-review 到 review pane 做方案审查。 > change-review 通过后，你再将 status 改为 approved` 进入 implement。

Cron 监控逻辑

默认模式：

1. 扫描 MODULE_ROOT/changes/ 下所有 change 的 frontmatter
2. 发现 status: approved 的 change → 通知用户可进入 implement 阶段
3. 不自动派发任何审查

--with-review 模式：

1. 扫描 MODULE_ROOT/changes/ 下 status: draft 的 change
2. 发现 change.md 写完且 change-review.md 不存在 + review pane 空闲 → 派发 eo-change-review CHANGE_ROOT/change.md 到 review pane
3. change-review 完成 + change-review.md 存在 → 读结论：

• 无 P0/P1 → 通知用户可将 status 改为 approved 进入 implement
• 有 P0/P1 → 暂停 loop 通知用户去 change pane 修订，修订后等 continue

1. status: approved → 通知用户可进入 implement
2. 恢复机制：用户输入 continue 后删除旧 change-review.md 并重新 CronCreate 同一监控 prompt

---

Phase: implement（全自动）

implement 阶段完全自动化，在 implement / test / review 三 pane 间流转。

首次操作

派发 eo-implement CHANGE_ROOT/change.md 到 implement pane。将 change.md status 从 approved 改为 implementing。

Cron 监控逻辑（状态机）

规则 1：implement 完成 + test 未开始本轮 → 派发 eo-test CHANGE_ROOT/change.md 到 test pane

规则 2：test 完成 → 读 CHANGE_ROOT/test.md

• 有失败 → 派发 implement 修复：eo-implement CHANGE_ROOT/change.md 根据 CHANGE_ROOT/test.md 的测试结果修复所有失败
• 全通过 → 派发 eo-review CHANGE_ROOT/change.md 到 review pane

规则 3：review 完成 → 读 CHANGE_ROOT/review.md

• 有 P1+ 问题 → 派发 implement 修复：eo-implement CHANGE_ROOT/change.md 根据 CHANGE_ROOT/review.md 的审查意见修复所有问题
• 通过（"LGTM"/"可合入"/"通过" 且无 P0/P1）→ 将 change.md status 改为 done → CronDelete + 通知 "✅ 实施、测试、审查全部通过，可进入 /eo-workflow archive"

规则 4：任一 pane 运行中 → 不操作

安全阀：超过 3 轮 implement-fix 循环无进展 → 暂停通知用户人工介入

implement fix 完成后的流转

• 上一轮 test 失败修复 → 重新派发 test
• 上一轮 review 问题修复 → 重新派发 review
• fix 不创建新 change：所有 fix 都在当前 change.md 内迭代

---

Phase: archive（一次性）

orchestrator 主 pane 直接执行 /eo-archive ，无需额外 pane。

执行逻辑

1. 校验 change.md status: done + review.md 通过
2. 调用 eo-archive（或由 main pane 的 agent 执行）
3. 读 change.md 的 Spec Delta → 合并到 MODULE_ROOT/spec.md
4. 更新 changes/INDEX.md 和 eo-doc/dev/INDEX.md
5. 将 change.md status 改为 archived
6. 通知 "✅ 归档完成，Delta 已合并回模块 spec"

若遇到 Delta 冲突 → 停止并要求用户裁决

---

Phase: full（全流程）

依次执行 module-init（若需要）→ change → implement → archive。

阶段转换

module-init → change：

1. spec-review 通过
2. Edit 工具将 spec.md status 改为 confirmed
3. 向 review pane 发 /clear
4. CronDelete module-init cron → CronCreate change cron
5. 通知用户去 change pane 触发 /eo-change

change → implement：

1. change.md status 从 draft 改为 approved（由用户确认后触发）
2. CronDelete change cron → CronCreate implement cron
3. 向 implement pane 发送 eo-implement CHANGE_ROOT/change.md

implement → archive：

1. review 通过
2. change.md status 改为 done
3. CronDelete implement cron
4. 主 orchestrator 执行 /eo-archive
5. 归档成功 → 流程结束

---

Pane 状态检测

通过 tmux-bridge read 30 判断：

| 信号 | 含义 | |------|------| | Codex › / Claude ❯ 提示符无活跃输出 | 空闲 | | Working (Nm Ns • esc to interrupt) | 运行中 | | "已完成"/"done"/"completed"/"applied" | 任务完成 |

Review/Test 结果判断

Review 类（spec-review.md / change-review.md / review.md）：

• 有 P0/P1 issue → 未通过
• 结论含 "通过"/"LGTM"/"可合入" 且无 P0/P1 → 通过

Test（test.md）：

• 有 "❌"/"FAIL"/"失败" → 有失败
• 全部 "✅"/"pass" → 全通过

---

文档路径速查

| 阶段 | skill | 产出文档 | |------|-------|---------| | module-init | eo-module-init | eo-doc/dev//spec.md | | spec-review | eo-spec-review | eo-doc/dev//spec-review.md | | change | eo-change | eo-doc/dev//changes//change.md | | change-review（可选） | eo-change-review | changes//change-review.md | | implement | eo-implement | 代码 + 可选 changes//implement.md（偏差） | | test | eo-test | changes//test.md | | review（代码） | eo-review | changes//review.md | | archive | eo-archive | 合并回 /spec.md + 状态变更 |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: SimpleEve
• Source: SimpleEve/eo-skills
• License: MIT

Install and usage instructions live in the source repository linked above.