jeo

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

JEO — Integrated Agent Orchestration

JEO — 集成Agent编排

Keyword:
jeo
| Platforms: Claude Code · Codex CLI · Gemini CLI · OpenCode
계획(ralph+plannotator) → 실행(team/bmad) → 정리(worktree cleanup) 의 완전 자동화 오케스트레이션 플로우를 제공하는 통합 스킬.

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

1. Quick Start

1. 快速开始

bash

undefined

bash

undefined

전체 설치 (모든 AI 툴 + 모든 컴포넌트)

完整安装（所有AI工具+所有组件）

bash scripts/install.sh --all

상태 확인

状态检查

bash scripts/check-status.sh

각 AI 툴 개별 설정

各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 플러그인 등록

---

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. 설치 컴포넌트

2. 安装组件

JEO가 설치하고 설정하는 도구 목록:

도구	설명	설치 명령
omc (oh-my-claudecode)	Claude Code 멀티에이전트 오케스트레이션	`/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode`
omx	OpenCode용 멀티에이전트 오케스트레이션	`bunx oh-my-opencode setup`
ohmg	Gemini CLI용 멀티에이전트 프레임워크	`bunx oh-my-ag`
bmad	BMAD 워크플로우 오케스트레이션	skills에 포함됨
ralph	자기참조 완료 루프	omc에 포함 또는 별도 설치
plannotator	계획/diff 시각적 리뷰	`bash scripts/install.sh --with-plannotator`
agent-browser	AI 에이전트용 헤드리스 브라우저 — 브라우저 동작 검증 기본 도구	`npm install -g agent-browser`
playwriter	Playwright 기반 브라우저 자동화 (선택)	`npm install -g playwriter`

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 워크플로우

3. JEO工作流

전체 플로우

完整流程

jeo "<task>"
    │
    ▼
[1] PLAN (ralph + plannotator)
    ralph으로 계획 수립 → plannotator로 시각적 검토 → Approve/Feedback
    │
    ▼
[2] EXECUTE
    ├─ team 사용 가능? → /omc:team N:executor "<task>"
    │                    staged pipeline: plan→prd→exec→verify→fix
    └─ team 없음?     → /bmad /workflow-init → BMAD 단계 실행
    │
    ▼
[3] VERIFY (agent-browser — 기본 동작)
    agent-browser로 브라우저 동작 검증
    → 스냅샷 캡처 → UI/기능 정상 여부 확인
    │
    ▼
[4] CLEANUP
    모든 작업 완료 후 → bash scripts/worktree-cleanup.sh
    git worktree prune

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 PLAN 단계 (ralph + plannotator)

3.1 计划阶段 (ralph + plannotator)

플랫폼 노트:
/ralph
슬래시 커맨드는 Claude Code (omc)에서만 사용 가능합니다. Codex/Gemini/OpenCode에서는 아래 "대체 방법"을 사용하세요.

Claude Code (omc):

bash

/ralph "jeo-plan: <task>" --completion-promise="PLAN_APPROVED" --max-iterations=5

Codex / Gemini / OpenCode (대체):

bash

undefined

平台说明：
/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

undefined

1. plan.md 직접 작성 후 plannotator로 검토

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 훅 또는 수동)
- 브라우저에서 계획 검토 → Approve 또는 Send Feedback
- Approve → [2] EXECUTE 단계 진입
- Feedback → 재계획 (루프)

**Claude Code 수동 실행:**

Shift+Tab×2 → plan mode 진입 → 계획 완료 시 plannotator 자동 실행

undefined


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

**Claude Code手动执行：**

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

undefined

3.2 EXECUTE 단계

3.2 执行阶段

team 사용 가능한 경우 (Claude Code + omc):

bash

/omc:team 3:executor "jeo-exec: <task based on approved plan>"

staged pipeline: team-plan → team-prd → team-exec → team-verify → team-fix
병렬 에이전트 실행으로 속도 최대화

team 없는 경우 (BMAD fallback):

bash

/workflow-init   # BMAD 워크플로우 초기화
/workflow-status # 현재 단계 확인

Analysis → Planning → Solutioning → Implementation 순서로 진행
각 단계 완료 시 plannotator로 문서 검토

可用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 VERIFY 단계 (agent-browser — 기본 동작)

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

브라우저 기반 기능이 있을 경우

agent-browser

로 동작을 검증합니다.

bash

undefined

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

agent-browser

验证操作。

bash

undefined

앱 실행 중인 URL에서 스냅샷 캡처

对运行中应用的URL捕获快照

agent-browser snapshot http://localhost:3000

특정 요소 확인 (accessibility tree ref 방식)

检查特定元素（accessibility tree引用方式）

agent-browser snapshot http://localhost:3000 -i

→ @eN ref 번호로 요소 상태 확인

→ 通过@eN引用编号查看元素状态

스크린샷 저장

保存截图

agent-browser screenshot http://localhost:3000 -o verify.png


> **기본 동작**: 브라우저 관련 작업 완료 시 자동으로 agent-browser 검증 단계를 실행합니다.
> 브라우저 UI가 없는 백엔드/CLI 작업은 이 단계를 건너뜁니다.

agent-browser screenshot http://localhost:3000 -o verify.png


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

3.4 CLEANUP 단계 (worktree 자동 정리)

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

bash

undefined

bash

undefined

모든 작업 완료 후 자동 실행

所有任务完成后自动执行

bash scripts/worktree-cleanup.sh

개별 명령

单独执行命令

git worktree list # 현재 worktree 목록 확인 git worktree prune # 삭제된 브랜치 worktree 정리 bash scripts/worktree-cleanup.sh --force # 강제 정리

---

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

---

4. 플랫폼별 플러그인 설정

4. 各平台插件配置

4.1 Claude Code

bash

undefined

bash

undefined

자동 설정

自动配置

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 훅 추가

添加plannotator钩子

bash .agent-skills/plannotator/scripts/setup-hook.sh


**설정 파일**: `~/.claude/settings.json`
```json
{
  "hooks": {
    "ExitPlanMode": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "plannotator plan -"
      }]
    }]
  }
}

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

undefined

bash

undefined

자동 설정

自动配置

bash scripts/setup-codex.sh

developer_instructions 추가됨: ~/.codex/config.toml

已添加developer_instructions: ~/.codex/config.toml

prompt 파일 생성됨: ~/.codex/prompts/jeo.md

已生成prompt文件: ~/.codex/prompts/jeo.md


Codex에서 사용:
```bash
/prompts:jeo    # JEO 워크플로우 활성화


Codex中使用：
```bash
/prompts:jeo    # 激活JEO工作流

4.3 Gemini CLI

bash

undefined

bash

undefined

자동 설정

自动配置

bash scripts/setup-gemini.sh

ExitPlanMode 훅 추가됨: ~/.gemini/settings.json

已添加ExitPlanMode钩子: ~/.gemini/settings.json

지시사항 추가됨: ~/.gemini/GEMINI.md

已添加说明文档: ~/.gemini/GEMINI.md


Gemini에서 사용:
```bash
gemini --approval-mode plan    # plan 모드로 진입 → plannotator 자동 실행


Gemini中使用：
```bash
gemini --approval-mode plan    # 进入plan模式 → 自动启动plannotator

4.4 OpenCode

bash

undefined

bash

undefined

자동 설정

自动配置

bash scripts/setup-opencode.sh

opencode.json에 추가됨:

已添加至opencode.json:

"@jeo/opencode@latest" 플러그인

"@jeo/opencode@latest" 插件


OpenCode 슬래시 커맨드:
- `/jeo-plan` — ralph + plannotator로 계획 수립
- `/jeo-exec` — team/bmad로 실행
- `/jeo-status` — vibe-kanban 상태 확인
- `/jeo-cleanup` — worktree 정리

---


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

---

5. 기억/상태 유지 (Memory & State)

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

undefined

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

undefined

상태 확인 및 재개

检查状态并恢复

bash scripts/check-status.sh --resume

---

bash scripts/check-status.sh --resume

---

6. 권장 워크플로우

6. 推荐工作流

undefined

undefined

1단계: 설치 (최초 1회)

步骤1：安装（首次执行）

bash scripts/install.sh --all bash scripts/check-status.sh

2단계: 작업 시작

步骤2：启动任务

jeo "<작업 설명>" # 키워드로 활성화

jeo "<任务描述>" # 通过关键词激活

또는 Claude에서: Shift+Tab×2 → plan mode

或在Claude中：Shift+Tab×2 → 进入plan模式

3단계: plannotator로 계획 검토

步骤3：用plannotator评审计划

브라우저 UI에서 Approve 또는 Send Feedback

在浏览器UI中点击批准或发送反馈

4단계: 자동 실행

步骤4：自动执行

team 또는 bmad가 작업 처리

team或bmad会处理任务

5단계: 완료 후 정리

步骤5：完成后清理

bash scripts/worktree-cleanup.sh

---

bash scripts/worktree-cleanup.sh

---

7. Best Practices

7. 最佳实践

계획 먼저: ralph+plannotator로 항상 계획 검토 후 실행 (잘못된 접근 조기 차단)
team 우선: Claude Code에서는 omc team 모드 사용이 가장 효율적
bmad fallback: team 없는 환경(Codex, Gemini)에서 BMAD 사용
worktree 정리: 작업 완료 즉시
```
worktree-cleanup.sh
```
실행 (브랜치 오염 방지)
상태 저장:
```
.omc/state/jeo-state.json
```
으로 세션 간 상태 유지

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

8. Troubleshooting

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` 확인

问题	解决方法
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. References

9. 参考链接

oh-my-claudecode — Claude Code 멀티에이전트
plannotator — 계획/diff 시각적 리뷰
BMAD Method — 구조화된 AI 개발 워크플로우
Agent Skills Spec — 스킬 포맷 명세

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