🚀 OMX + Superpowers + Gstack 完整使用指南

版本：v1.0 | 更新日期：2026-04-30

Claude Code 三层架构完整使用指南，让你的 AI 助手更强大！

📐 一、三层架构总览

┌──────────────────────────────────────────────────────────────┐
│                    🎯 OMX 编排调度层                          │
│           统一入口 · 任务分发 · 状态持久化                     │
└──────────────────────────────────────────────────────────────┘
                              ↓
    ┌─────────────────┬─────────────────┬─────────────────┐
    │                 │                 │                 │
    ▼                 ▼                 ▼                 ▼
┌─────────┐     ┌─────────┐     ┌─────────┐     ┌─────────┐
│🧠 流程层 │     │⚡ 执行层 │     │🌐 交互层 │     │🛡️ 护栏层 │
│Super-   │     │OMX Team │     │Gstack   │     │Guard    │
│powers   │     │         │     │         │     │         │
└─────────┘     └─────────┘     └─────────┘     └─────────┘

🎯 三层分工

💡 分工原则：Superpowers 思考 → OMX 调度 → Gstack 执行

🎯 二、任务分流决策流程

                    用户任务输入
                         ↓
                ┌────────────────┐
                │  🤔 判断任务规模  │
                └────────────────┘
                         ↓
    ┌────────────────────┼────────────────────┐
    │                    │                    │
    ▼                    ▼                    ▼
┌────────┐         ┌────────┐         ┌────────┐
│🟢 轻量  │         │🟡 中等  │         │🔴 大型  │
│ 任务    │         │ 任务    │         │ 任务    │
└────────┘         └────────┘         └────────┘
    │                    │                    │
    │                    │                    │
    ▼                    ▼                    ▼
直接实现           brainstorm + plan      完整闭环
    │                    │                    │
    ▼                    ▼                    ▼
 /browse            /qa 验证            omx team

📊 任务类型速查表

🔄 三、完整闭环流程

┌──────────────────────────────────────────────────────────────┐
│                                                              │
│  ┌─────┐   ┌─────┐   ┌─────┐   ┌─────┐   ┌─────┐   ┌─────┐  │
│  │🎨设计│→ │📋审查│→ │🔒隔离│→ │⚡并行│→ │✅验证│→ │🚀部署│  │
│  └─────┘   └─────┘   └─────┘   └─────┘   └─────┘   └─────┘  │
│                                                              │
│  brainstorm  plan-ceo   worktrees  omx team    qa      ship  │
│  writing-    plan-eng     TDD                  verify  deploy│
│  plans       plan-design                                  canary│
│                                                              │
└──────────────────────────────────────────────────────────────┘

🎬 各阶段详解

🤖 四、OMX Team 模式详解

4.1 🎭 Team 工作流程

omx team N:agent "task"

┌─────────────────────────────────────────────┐
│         🎯 Leader (tmux 主 pane)            │
│      任务分发 · 结果整合 · 最终验证          │
└─────────────────────────────────────────────┘
                    ↓ 分发任务
    ┌───────────┬───────────┬───────────┐
    │           │           │           │
    ▼           ▼           ▼           ▼
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│Worker 1│ │Worker 2│ │Worker 3│ │Worker N│
│executor│ │debugger│ │designer│ │  ...   │
│独立tree│ │独立tree│ │独立tree│ │独立tree│
└────────┘ └────────┘ └────────┘ └────────┘
    ↓           ↓           ↓           ↓
    └───────────┴───────────┴───────────┘
                    ↓ 各自完成
┌─────────────────────────────────────────────┐
│       ✅ Leader 整合 + 验证                  │
│    omx team await / omx team shutdown       │
└─────────────────────────────────────────────┘

4.2 🧠 Agent 选择指南

4.3 ⌨️ Team 命令速查

# 🚀 启动团队
omx team 3:executor "task"           # 启动 3 个 executor worker

# 📊 状态管理
omx team status my-team              # 查看团队运行状态
omx team await my-team               # 等待所有 worker 完成

# 🔄 恢复机制
omx team resume my-team              # 恢复中断的团队

# 🛑 关闭团队
omx team shutdown my-team            # 关闭团队

🧠 五、Superpowers 核心 Skills

5.1 🎯 核心流程 Skills

5.2 👁️ Plan Review 三视角

┌─────────────────┬─────────────────┬─────────────────┐
│   👔 CEO 视角    │   🔧 Eng 视角    │  🎨 Design 视角  │
│                 │                 │                 │
│ /plan-ceo-      │ /plan-eng-      │ /plan-design-   │
│   review        │   review        │   review        │
│                 │                 │                 │
│ 重新审视问题    │ 锁定执行细节    │ 用户体验审查    │
│ 寻找更优解      │ 检查可行性      │ 交互合理性      │
└─────────────────┴─────────────────┴─────────────────┘

🌐 六、Gstack 执行层详解

6.1 🌍 浏览器唯一入口

⚠️ 唯一入口：/browse

禁止使用 mcp__claude-in-chrome__* 和 mcp__computer-use__* 等其他浏览器 MCP 工具

6.2 ✅ QA 验证流程

6.3 🚀 部署流程

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│    /ship    │ ──→ │ /land-and-  │ ──→ │   /canary   │
│             │     │   deploy    │     │             │
└─────────────┘     └─────────────┘     └─────────────┘
      ↓                    ↓                    ↓
  检测变更            合并 PR              部署后监控
  合并 base           等待 CI              观察线上
  运行测试            触发部署             异常告警

6.4 🛡️ 安全护栏

🚨 危险命令必须先过护栏

以下命令执行前必须使用 /careful 或 /guard 或 /freeze：

• rm -rf / DROP TABLE / git push --force
• git reset --hard / kubectl delete
• 任何破坏性操作

💾 七、不中断运行保障

7.1 🗄️ 状态持久化

7.2 🔄 恢复机制

# 恢复上次会话
omx resume

# 恢复中断的团队
omx team resume my-team

# 查看历史会话
omx session

7.3 📢 通知配置

✅ 八、配置检查清单

❓ 九、常见问题

A:

• Team 模式：持久并行执行（tmux 分屏、独立 worktree），适合大型任务
• 普通 Subagent：会话内小规模并行，适合轻量任务

A:

• OMX：负责调度（怎么分配任务）
• Superpowers：负责思考（怎么正确做事）
• 大任务两者配合使用

A:

omx resume              # 恢复上次会话
omx team resume my-team # 恢复团队

A: OMX Team 默认使用独立 worktree，每个 worker 有独立分支，自动避免冲突。

🎯 快速开始

# 1️⃣ 启动一个简单的任务
omx task "实现用户登录功能"

# 2️⃣ 启动团队并行开发
omx team 3:executor "重构 API 模块"

# 3️⃣ 完整流程：设计 → 实现 → 验证 → 部署
/brainstorming    # 设计
/writing-plans    # 计划
/plan-ceo-review  # 审查
omx team 2:executor "实现"  # 并行
/qa               # 验证
/ship             # 部署

💡 提示：本文档持续更新中，如有问题请查阅最新版本或联系维护者。