JEO — 集成Agent编排

关键词：
jeo
| 支持平台：Claude Code · Codex CLI · Gemini CLI · OpenCode
提供「计划(ralph+plannotator) → 执行(team/bmad) → 清理(worktree cleanup)」全流程自动化编排的集成技能。

1. 快速开始

bash

# 完整安装（所有AI工具+所有组件）
bash scripts/install.sh --all

# 状态检查
bash scripts/check-status.sh

# 各AI工具单独配置
bash scripts/setup-claude.sh      # Claude Code插件+钩子
bash scripts/setup-codex.sh       # Codex CLI developer_instructions配置
bash scripts/setup-gemini.sh      # Gemini CLI钩子+GEMINI.md配置
bash scripts/setup-opencode.sh    # OpenCode插件注册

2. 安装组件

JEO会安装并配置的工具列表：

工具	说明	安装命令
omc (oh-my-claudecode)	Claude Code多Agent编排	`/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode`
omx	OpenCode多Agent编排	`bunx oh-my-opencode setup`
ohmg	Gemini CLI多Agent框架	`bunx oh-my-ag`
bmad	BMAD工作流编排	包含在技能组件中
ralph	自引用完成循环	包含在omc中或可单独安装
plannotator	计划/差异可视化评审	`bash scripts/install.sh --with-plannotator`
agent-browser	AI Agent用无头浏览器 — 浏览器操作验证核心工具	`npm install -g agent-browser`
playwriter	基于Playwright的浏览器自动化（可选）	`npm install -g playwriter`

3. JEO工作流

完整流程

jeo "<任务描述>"
    │
    ▼
[1] 计划阶段 (ralph + plannotator)
    通过ralph制定计划 → 用plannotator可视化评审 → 批准/反馈
    │
    ▼
[2] 执行阶段
    ├─ 可用team？ → /omc:team N:executor "<任务描述>"
    │                    分阶段流水线：plan→prd→exec→verify→fix
    └─ 无team？     → /bmad /workflow-init → 执行BMAD步骤
    │
    ▼
[3] 验证阶段 (agent-browser — 默认执行)
    用agent-browser验证浏览器操作
    → 捕获快照 → 检查UI/功能是否正常
    │
    ▼
[4] 清理阶段
    所有任务完成后 → 执行bash scripts/worktree-cleanup.sh
    git worktree prune

3.1 计划阶段 (ralph + plannotator)

平台说明：
/ralph
斜杠命令仅支持Claude Code (omc)。 Codex/Gemini/OpenCode请使用下方“替代方案”。

Claude Code (omc):

bash

/ralph "jeo-plan: <任务描述>" --completion-promise="PLAN_APPROVED" --max-iterations=5

Codex / Gemini / OpenCode (替代方案):

bash

# 1. 手动编写plan.md后用plannotator评审
cat plan.md | python3 -c "
import json, sys
plan = sys.stdin.read()
print(json.dumps({'tool_input': {'plan': plan, 'permission_mode': 'acceptEdits'}}))
" | plannotator > /tmp/plannotator_feedback.txt 2>&1 &

通用流程：

生成计划文档 (
```
plan.md
```
)
启动plannotator UI（ExitPlanMode钩子或手动启动）
在浏览器中评审计划 → 批准或发送反馈
批准 → 进入[2]执行阶段
反馈 → 重新计划（循环）

Claude Code手动执行：

Shift+Tab×2 → 进入plan模式 → 计划完成后自动启动plannotator

3.2 执行阶段

可用team的情况 (Claude Code + omc):

bash

/omc:team 3:executor "jeo-exec: <基于批准计划的任务描述>"

分阶段流水线：team-plan → team-prd → team-exec → team-verify → team-fix
多Agent并行执行，最大化效率

无team的情况 (BMAD降级方案):

bash

/workflow-init   # 初始化BMAD工作流
/workflow-status # 查看当前阶段

按Analysis → Planning → Solutioning → Implementation顺序执行
每个阶段完成后用plannotator评审文档

3.3 验证阶段 (agent-browser — 默认执行)

若涉及浏览器相关功能，使用

agent-browser

验证操作。

bash

# 对运行中应用的URL捕获快照
agent-browser snapshot http://localhost:3000

# 检查特定元素（accessibility tree引用方式）
agent-browser snapshot http://localhost:3000 -i
# → 通过@eN引用编号查看元素状态

# 保存截图
agent-browser screenshot http://localhost:3000 -o verify.png

默认行为：浏览器相关任务完成后自动执行agent-browser验证步骤。无浏览器UI的后端/CLI任务将跳过此阶段。

3.4 清理阶段 (自动清理Worktree)

bash

# 所有任务完成后自动执行
bash scripts/worktree-cleanup.sh

# 单独执行命令
git worktree list                         # 查看当前Worktree列表
git worktree prune                        # 清理已删除分支的Worktree
bash scripts/worktree-cleanup.sh --force  # 强制清理

4. 各平台插件配置

4.1 Claude Code

bash

# 自动配置
bash scripts/setup-claude.sh

# 或手动配置:
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
/omc:omc-setup

# 添加plannotator钩子
bash .agent-skills/plannotator/scripts/setup-hook.sh

配置文件：

~/.claude/settings.json

json

{
  "hooks": {
    "ExitPlanMode": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "plannotator plan -"
      }]
    }]
  }
}

4.2 Codex CLI

bash

# 自动配置
bash scripts/setup-codex.sh

# 已添加developer_instructions: ~/.codex/config.toml
# 已生成prompt文件: ~/.codex/prompts/jeo.md

Codex中使用：

bash

/prompts:jeo    # 激活JEO工作流

4.3 Gemini CLI

bash

# 自动配置
bash scripts/setup-gemini.sh

# 已添加ExitPlanMode钩子: ~/.gemini/settings.json
# 已添加说明文档: ~/.gemini/GEMINI.md

Gemini中使用：

bash

gemini --approval-mode plan    # 进入plan模式 → 自动启动plannotator

4.4 OpenCode

bash

# 自动配置
bash scripts/setup-opencode.sh

# 已添加至opencode.json:
# "@jeo/opencode@latest" 插件

OpenCode斜杠命令:

```
/jeo-plan
```
— 通过ralph+plannotator制定计划
```
/jeo-exec
```
— 通过team/bmad执行任务
```
/jeo-status
```
— 查看vibe-kanban状态
```
/jeo-cleanup
```
— 清理Worktree

5. 记忆/状态保持 (Memory & State)

JEO在以下路径保存状态：

{worktree}/.omc/state/jeo-state.json   # JEO执行状态
{worktree}/.omc/plans/jeo-plan.md      # 已批准的计划
{worktree}/.omc/logs/jeo-*.log         # 执行日志

状态文件结构:

json

{
  "phase": "plan|execute|verify|cleanup",
  "task": "当前任务描述",
  "plan_approved": true,
  "team_available": true,
  "worktrees": ["path/to/worktree1", "path/to/worktree2"],
  "created_at": "2026-02-24T00:00:00Z",
  "updated_at": "2026-02-24T00:00:00Z"
}

重启后恢复状态:

bash

# 检查状态并恢复
bash scripts/check-status.sh --resume

6. 推荐工作流

# 步骤1：安装（首次执行）
bash scripts/install.sh --all
bash scripts/check-status.sh

# 步骤2：启动任务
jeo "<任务描述>"           # 通过关键词激活
# 或在Claude中：Shift+Tab×2 → 进入plan模式

# 步骤3：用plannotator评审计划
# 在浏览器UI中点击批准或发送反馈

# 步骤4：自动执行
# team或bmad会处理任务

# 步骤5：完成后清理
bash scripts/worktree-cleanup.sh

7. 最佳实践

先计划后执行：始终通过ralph+plannotator评审计划后再执行（提前规避错误方向）
优先使用team：在Claude Code中使用omc team模式效率最高
BMAD降级方案：在无team的环境(Codex, Gemini)中使用BMAD
及时清理Worktree：任务完成后立即执行
```
worktree-cleanup.sh
```
（避免分支混乱）
状态持久化：通过
```
.omc/state/jeo-state.json
```
在会话间保持状态

8. 故障排查

问题	解决方法
plannotator无法启动	执行 `bash .agent-skills/plannotator/scripts/check-status.sh`
Worktree冲突	执行 `git worktree prune && git worktree list`
team模式无法运行	设置环境变量 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`
omc安装失败	执行 `/omc:omc-doctor`
agent-browser报错	检查 `agent-browser --version`

9. 参考链接

oh-my-claudecode — Claude Code多Agent框架
plannotator — 计划/差异可视化评审工具
BMAD Method — 结构化AI开发工作流
Agent Skills Spec — 技能格式规范

jeo

NPX安装

标签

SKILL.md 内容（中文）

JEO — 集成Agent编排

1. 快速开始

2. 安装组件

3. JEO工作流

完整流程

3.1 计划阶段 (ralph + plannotator)

3.2 执行阶段

3.3 验证阶段 (agent-browser — 默认执行)

3.4 清理阶段 (自动清理Worktree)

4. 各平台插件配置

4.1 Claude Code

4.2 Codex CLI

4.3 Gemini CLI

4.4 OpenCode

5. 记忆/状态保持 (Memory & State)

6. 推荐工作流

7. 最佳实践

8. 故障排查

9. 参考链接