🔄 工作流可视化指南¶
📅 最后更新: 2026-03-24 | 📦 版本: v2.44.15
本文档帮助你快速理解工作流的执行细节、可选参数和条件分支。
🎯 核心工作流总览¶
┌──────────────────────────────────────────────────────────────────────┐
│ │
│ 💡 Brainstorm ──→ 📋 Plan ──→ ⚡ Work ──→ 🔍 Review │
│ │ │ │ │
│ ┌───┴───┐ ┌────┴────┐ ┌───┴────────┐ │
│ │ [P] │ │ 自动 │ │ 裁决链 │ │
│ │ Party │ │ 检测 │ │ 事实核查 │ │
│ │ Mode │ └────┬────┘ │ ⚖️ 过滤 │ │
│ └───────┘ │ │ [C] Codex │ │
│ ┌──────┴──────┐└────────────┘ │
│ │ │ │
│ 1任务 ≥2任务 │
│ 标准模式 Subagent │
│ │
└──────────────────────────────────────────────────────────────────────┘
独立工具（手动调用）：
• 📚 /ce:compound - 记录已解决的问题
• 🔄 /ce:sync-upstream - 检测上游更新
• 🔀 /ce:pr - 创建 PR
📌 图例说明¶
| 符号 | 含义 |
|---|---|
→ |
正常流程方向 |
[X] |
⭐ 可选参数 |
┌─┐ |
条件分支 |
📖 详细步骤分解¶
🔄 独立工具: /ce:sync-upstream¶
💬 作用: 检测上游仓库更新，生成智能分析报告
╭─────────────────────────────────────────────────────────────╮
│ 🔄 /ce:sync-upstream [F] │
│ │
│ ⭐ 可选参数: [F] - 强制全量扫描（v1 无实际差异） │
╰─────────────────────────────────────────────────────────────╯
🔹 Phase 0: 参数解析 + 前置条件
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 检测 [F] 标志 │
│ 检查 gh auth status │
│ 检查 upstream remote │
└─────────────────────────────────────────────┘
🔹 Phase 1: 配置加载 + 数据获取
─────────────────────────────────────────────
┌──────────────────────────┐
│ 📁 读取 upstream-repos.json │
└────────────┬─────────────┘
│
┌───────┴───────┐
│ │
📄 有 📭 无
│ │
↓ ↓
使用配置 创建默认配置
（4 个仓库）
┌─────────────────────────────────────────────┐
│ 🚀 按角色并行获取 │
│ │
│ parent: git fetch + git log │
│ reference: gh api commits + releases │
│ runtime: gh api releases │
└─────────────────────────────────────────────┘
🔹 Phase 2: 噪音过滤 + 分析
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 🔇 排除: chore/bump/dependabot/merge │
│ │
│ 📊 两步分析: │
│ Step 1: Releases（信噪比最高） │
│ Step 2: 过滤后 Commits（补充） │
│ │
│ 🎯 相关性判断（附理由） │
│ 高: 修复本仓库也有的功能 │
│ 中: 新增可选功能或改进 │
│ 低: 与本仓库无关 │
└─────────────────────────────────────────────┘
🔹 Phase 3: 报告生成
─────────────────────────────────────────────
📄 输出: docs/sync-reports/YYYY-MM-DD-upstream-sync.md
（含 YAML frontmatter，支持 /ce:plan 自动发现）
🔹 Phase 4: 讨论
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 🎯 选择下一步 │
│ │
│ 1️⃣ 逐项讨论 — 逐个评估高相关变更 │
│ 2️⃣ 创建整合计划 — 运行 /ce:plan │
│ 3️⃣ 执行上游合并 — git merge upstream │
│ 4️⃣ 稍后处理 — 报告已保存 │
└─────────────────────────────────────────────┘
✨ 适用场景: 定期检查上游更新 | 同步前评估 | 跨仓库变更追踪
💡 Step 1: /ce:brainstorm¶
💬 作用: 探索需求和方案，协作对话
╭─────────────────────────────────────────────────────────────╮
│ 💡 /ce:brainstorm [功能描述] │
│ │
│ ⭐ 可选参数: [P] - 激活 Party Mode 多代理讨论 │
╰─────────────────────────────────────────────────────────────╯
🔹 Phase 0: 评估需求清晰度
─────────────────────────────────────────────
┌────────────────────────┐
│ 🤔 需求是否已足够清晰？ │
└───────────┬────────────┘
│
┌───────┴───────┐
│ │
✅ 是 ❌ 否
│ │
↓ ↓
建议跳转 继续 brainstorm
→ /plan
🔹 Phase 1: 理解想法
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 1️⃣ 轻量级仓库研究 │
│ └→ 🤖 Task: repo-research-analyst │
│ │
│ 2️⃣ 协作对话（逐个提问） │
│ • 多选题优先 │
│ • 从广（目的）到窄（约束） │
│ • 直到清晰 OR 用户说 "proceed" │
└─────────────────────────────────────────────┘
🔹 Phase 2: 探索方案
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 📋 提出 2-3 个具体方案 │
│ │
│ 方案 A: xxxxxx │
│ ✅ 优点: ... │
│ ⚠️ 缺点: ... │
│ │
│ 方案 B: xxxxxx │
│ ✅ 优点: ... │
│ ⚠️ 缺点: ... │
└─────────────────────────────────────────────┘
│
↓
┌─────────────────────────────────────────────┐
│ 🎯 用户选择 │
│ │
│ • 选择方案 A / B / C │
│ • [P] Party Mode 多专家讨论 ←── ⭐ 可选 │
└─────────────────────────────────────────────┘
🎉 Party Mode (可选增强)
═════════════════════════════════════════════
╭─────────────────────────────────────────────╮
│ 🎊 激活: 输入 [P] / [P+] 或 "开启派对模式" │
│ 🚪 退出: 输入 [E] 或 "结束派对" │
╰─────────────────────────────────────────────╯
执行流程:
┌─────────────────────────────────────────────┐
│ 1️⃣ 显式启动 party-mode │
│ [P] 3 核心视角 / [P+] 12-14 全量视角 │
│ 🏗️ 架构师 | 📊 分析师 | 💻 开发者 │
│ │
│ 2️⃣ 多视角碰撞 │
│ 代理带 emoji + 角色名发言 │
│ 代理可相互引用、质疑、补充 │
│ │
│ 3️⃣ 胶水编程检查 │
│ 复用机会 / 胶水代码 / 必须自研边界 │
│ │
│ 4️⃣ 结构化收敛 │
│ ✅ 共识点 ⚠️ 分歧/风险 🎯 P1-P4 │
└─────────────────────────────────────────────┘
🔹 Phase 3 & 4: 记录 & 交接
─────────────────────────────────────────────
📄 输出: docs/brainstorms/YYYY-MM-DD-<topic>.md
🎯 下一步选项:
1️⃣ 进入 /plan
2️⃣ 继续探索
3️⃣ 稍后再来
🎉 Party Mode 适用场景¶
| ✅ 适合 | ❌ 不适合 |
|---|---|
| 重大技术选型 | 需求已明确 |
| 多方利益权衡 | 简单 bug 修复 |
| 复杂需求探索 | 已有明确方案 |
| 事后复盘分析 | 纯技术实现问题 |
📋 Step 2: /ce:plan¶
💬 作用: 将功能描述转化为结构清晰的项目计划
╭─────────────────────────────────────────────────────────────╮
│ 📋 /ce:plan [功能描述] │
╰─────────────────────────────────────────────────────────────╯
🔹 Step 0: 想法细化
─────────────────────────────────────────────
┌──────────────────────────┐
│ 🔍 检查 docs/brainstorms/ │
│ 是否有相关文档？ │
└────────────┬─────────────┘
│
┌───────┴───────┐
│ │
📄 有 📭 无
│ │
↓ ↓
读取并使用 运行想法细化对话
brainstorm 决策
🔹 Step 1: 本地研究（并行）
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 🚀 并行执行 │
│ │
│ 🤖 repo-research-analyst ──→ 仓库模式研究 │
│ 🤖 learnings-researcher ───→ 历史经验搜索 │
└─────────────────────────────────────────────┘
🔹 Step 1.5: 研究决策
─────────────────────────────────────────────
┌────────────────────────────────────┐
│ 🔐 高风险主题？ │
│ (安全 / 支付 / 外部API) │
└─────────────────┬──────────────────┘
│
┌────────┴────────┐
│ │
⚠️ 是 ✅ 否
│ │
↓ ↓
必须外部研究 ┌────────────────┐
│ 本地上下文足够？ │
└───────┬────────┘
│
┌────────┴────────┐
│ │
✅ 是 ❌ 否
│ │
↓ ↓
跳过外部研究 进行外部研究
🔹 Step 1.5b: 外部研究（条件执行，并行）
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 🌐 并行执行 │
│ │
│ 🤖 best-practices-researcher │
│ 🤖 framework-docs-researcher │
└─────────────────────────────────────────────┘
🔹 Step 2: 任务拆解
─────────────────────────────────────────────
╭─────────────────────────────────────────────╮
│ ⚠️ 铁律: 每个任务 2-5 分钟可完成 │
╰─────────────────────────────────────────────╯
每个任务必须包含:
┌─────────────────────────────────────────────┐
│ 📁 文件路径（确切，含行号） │
│ 📝 具体操作步骤 │
│ 💻 完整代码（非伪代码） │
│ ✅ 验证命令 │
└─────────────────────────────────────────────┘
🔹 Step 3-6: 结构规划 → SpecFlow → 详细级别 → 格式化
─────────────────────────────────────────────
📄 输出: docs/plans/YYYY-MM-DD-<type>-<name>-plan.md
🔹 后续选项
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 🎯 选择下一步 │
│ │
│ 1️⃣ 打开计划文件 │
│ 2️⃣ /deepen-plan - 并行研究增强 │
│ 3️⃣ /plan_review - 多代理评审 │
│ 4️⃣ /ce:work - 开始执行 ← 常用 │
│ 5️⃣ 创建 GitHub Issue │
│ 6️⃣ 简化计划 │
└─────────────────────────────────────────────┘
📊 计划详细级别¶
| 级别 | 适用场景 | 内容量 |
|---|---|---|
| 📄 MINIMAL | 简单 bug、小改进 | 少 |
| 📋 MORE | 大多数功能 | 中 |
| 📚 A LOT | 重大功能、架构变更 | 多 |
⚡ Step 3: /ce:work¶
💬 作用: 高效执行工作计划
╭─────────────────────────────────────────────────────────────╮
│ ⚡ /ce:work [计划文件路径] │
╰─────────────────────────────────────────────────────────────╯
🔹 Phase 1: 快速启动
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 1️⃣ 读取计划并澄清 │
│ 2️⃣ 检测 UI/前端任务 → 自动加载设计技能 │
│ 3️⃣ 设置环境（分支 / worktree） │
│ 4️⃣ TodoWrite 创建任务列表 │
└─────────────────────────────────────────────┘
⭐ 自动执行模式检测
═════════════════════════════════════════════
╭─────────────────────────────────────────────╮
│ 📊 统计 TodoWrite 任务数量 │
╰─────────────────────────────────────────────╯
│
┌────────┴────────┐
│ │
任务数 = 1 任务数 ≥ 2
│ │
↓ ↓
╭─────────────────╮ ╭──────────────────────╮
│ 🔹 标准模式 │ │ 🔸 Subagent 模式 │
│ │ │ │
│ • 单代理执行 │ │ • 每任务新子代理 │
│ • 无额外开销 │ │ • 两阶段审查 │
│ │ │ • 每3任务检查点 │
╰─────────────────╯ ╰──────────────────────╯
🔹 Phase 2: 执行
─────────────────────────────────────────────
┌──────────────────────┐ ┌──────────────────────────────┐
│ 🔹 标准模式 │ │ 🔸 Subagent 模式 │
├──────────────────────┤ ├──────────────────────────────┤
│ │ │ │
│ while(tasks): │ │ batch_size = 3 │
│ ├─ 标记进行中 │ │ │
│ ├─ 读取引用 │ │ for task in batch: │
│ ├─ 匹配模式 │ │ │
│ ├─ 实现代码 │ │ ┌────────────────────┐ │
│ ├─ 写测试 │ │ │ 🤖 子代理执行任务 │ │
│ ├─ 运行测试 │ │ └──────────┬─────────┘ │
│ ├─ 标记完成 │ │ ↓ │
│ └─ 增量提交 │ │ ┌────────────────────┐ │
│ │ │ │ 🔍 Stage 1: │ │
└──────────────────────┘ │ │ 规范合规审查 │ │
│ └──────────┬─────────┘ │
│ ↓ │
│ ┌────────────────────┐ │
│ │ 🔍 Stage 2: (可选) │ │
│ │ 代码质量审查 │ │
│ └──────────┬─────────┘ │
│ ↓ │
│ ┌────────────────────┐ │
│ │ 🛑 人工检查点 │ │
│ │ (每 3 任务) │ │
│ │ │ │
│ │ → 继续 │ │
│ │ → 审查变更 │ │
│ │ → 停止 │ │
│ └────────────────────┘ │
│ │
└──────────────────────────────┘
🔹 Phase 3: 质量检查
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ ✅ 运行测试套件 │
│ ✅ 运行 linting │
│ ✅ UI 检查（如适用） │
│ 🔹 可选: 调用 reviewer agents │
└─────────────────────────────────────────────┘
🔹 Phase 4: Ship It 🚀
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 📝 创建提交 │
│ 📸 截图上传（UI 变更必须） │
│ 🔗 创建 PR │
│ 📢 通知用户 │
└─────────────────────────────────────────────┘
📊 Subagent vs 标准模式对比¶
| 维度 | 🔹 标准模式 | 🔸 Subagent 模式 |
|---|---|---|
| 上下文污染 | 任务越多质量越差 | ✅ 每任务新鲜上下文 |
| Token 成本 | 累积增长 | ✅ 精确控制 |
| 首次成功率 | ~40%（后期） | ✅ ~95%（恒定） |
| 适用场景 | 简单/连续任务 | 复杂/独立任务 |
🔍 Step 4: /ce:review¶
💬 作用: 使用多代理分析进行全面代码审查
╭─────────────────────────────────────────────────────────────╮
│ 🔍 /ce:review [PR号/URL/分支名] [C] │
│ │
│ ⭐ 可选参数: [C] - 自动调用 Codex 额外审核 │
╰─────────────────────────────────────────────────────────────╯
🔹 Step 0: 解析参数
─────────────────────────────────────────────
┌────────────────────────────┐
│ 🔍 检查是否包含 [C] 标志 │
└─────────────┬──────────────┘
│
┌────────┴────────┐
│ │
✅ 是 ❌ 否
│ │
↓ ↓
CODEX_ENABLED CODEX_ENABLED
= true = false
🔹 Step 1: 确定审查目标
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 输入 处理 │
│ ───────────────────────────────────── │
│ PR 号 → gh pr view │
│ URL → 解析并获取 │
│ 分支名 → checkout │
│ 空 → 当前分支 │
└─────────────────────────────────────────────┘
🔹 并行 Agents（同时运行）
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 🤖 并行执行审查代理 │
│ │
│ 1. kieran-rails-reviewer │
│ 2. dhh-rails-reviewer │
│ 3. git-history-analyzer │
│ 4. pattern-recognition-specialist │
│ 5. architecture-strategist │
│ 6. security-sentinel │
│ 7. performance-oracle │
│ 8. data-integrity-guardian │
│ 9. agent-native-reviewer │
└─────────────────────────────────────────────┘
🔹 条件性 Agents（按需运行）
─────────────────────────────────────────────
┌──────────────────────────────────┐
│ 📁 PR 包含 db/migrate/*.rb ？ │
└────────────────┬─────────────────┘
│
┌────────┴────────┐
│ │
✅ 是 ❌ 否
│ │
↓ ↓
┌────────────────────────┐ 跳过
│ 🤖 追加运行: │
│ • data-migration-expert│
│ • deployment- │
│ verification-agent │
└────────────────────────┘
🔹 Step 2-4: Ultra-Thinking 深度分析
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 🧠 多角度分析 │
│ │
│ 👨💻 开发者视角: 可读性、可测试性 │
│ 🔧 运维视角: 部署、监控、排错 │
│ 👤 用户视角: 功能、错误提示、性能 │
│ 🔐 安全视角: 攻击面、合规、数据保护 │
│ 💼 业务视角: ROI、风险、TCO │
└─────────────────────────────────────────────┘
🔹 Step 4.5: 事实核查（v2.44.14 新增）
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 🔍 Fact-Check Phase │
│ │
│ 提取所有代理的 Structured Findings │
│ ├─ opinion 类 → 跳过验证 │
│ ├─ exists/missing/dead_work → L1 轻验证 │
│ └─ 涉及删除代码的高风险 → L2 强验证 │
│ │
│ 效率控制: finding > 20 时只验证高风险类型 │
└─────────────────────────────────────────────┘
│
↓
┌─────────────────────────────────────────────┐
│ ⚖️ Adjudicator Phase │
│ │
│ 规则 1: ❌ refuted → 自动移除 │
│ 规则 2: 🔗 同一前提多 finding → 合并为 1 票 │
│ 规则 3: ⚠️ ambiguous 高风险 → 降级为 P3 │
│ 规则 4: ✅ verified → 正常展示 │
│ 规则 5: 建议删除 docs/plans/ → 自动移除 │
└─────────────────────────────────────────────┘
🔹 Step 5: 发现综合 & Todo 创建
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 📊 分类优先级（经过事实核查过滤） │
│ │
│ 🔴 P1 (阻止合并): 安全、数据损坏、破坏性变更 │
│ 🟡 P2 (应修复): 性能、架构、可靠性 │
│ 🔵 P3 (可选): 清理、优化、文档 │
│ │
│ 🔽 裁决过滤统计（可选展开） │
│ ❌ refuted / ⚠️ ambiguous / 🔗 合并 │
│ │
│ 📄 输出: todos/ 目录下的 todo 文件 │
└─────────────────────────────────────────────┘
🔹 Step 6: 端到端测试（可选）
─────────────────────────────────────────────
┌─────────────────────────────────────────────┐
│ 🌐 Web 项目 → /test-browser │
│ 📱 iOS 项目 → /xcode-test │
│ 🔀 混合项目 → 选择测试范围 │
└─────────────────────────────────────────────┘
⭐ Step 7: Codex 额外审核（[C] 参数触发）
═════════════════════════════════════════════
┌───────────────────────┐
│ CODEX_ENABLED = true? │
└───────────┬───────────┘
│
┌───────┴───────┐
│ │
✅ 是 ❌ 否
│ │
↓ ↓
╭────────────────────────────╮ 直接显示
│ 🤖 Codex 审核流程 │ Claude 结果
│ │
│ 7.1 检查 CLI 可用性 │
│ codex --version │
│ │
│ 7.2 同步调用审核（非后台） │
│ codex review │
│ --uncommitted │
│ │
│ 7.3 整合结果 │
│ • Claude vs Codex 对比 │
│ • 双方一致 → 优先级最高│
│ • 综合建议 │
╰────────────────────────────╯
🔹 输出
─────────────────────────────────────────────
📊 审查报告 + 📄 Todo 文件列表
📝 使用示例¶
/ce:review # 仅 Claude 审核
/ce:review 123 # 审核 PR #123
/ce:review [C] # Claude + Codex 审核 ← ⭐
/ce:review 123 [C] # PR #123 + Codex 审核 ← ⭐
⚙️ Codex 前提条件¶
⭐ 可选参数速查表¶
| 命令 | 可选参数 | 说明 | 示例 |
|---|---|---|---|
/ce:brainstorm |
[P] |
🎉 激活 Party Mode 多代理讨论 | /ce:brainstorm [P] 用户认证方案 |
/ce:review |
[C] |
🤖 额外调用 Codex 审核 | /ce:review 123 [C] |
🔀 条件分支快速参考¶
⚡ /ce:work 自动模式选择¶
┌──────────────────────────────────────────────────────┐
│ │
│ TodoWrite 任务数 = 1 → 🔹 标准模式 │
│ • 单代理直接执行 │
│ │
│ TodoWrite 任务数 ≥ 2 → 🔸 Subagent 模式 │
│ • 每任务新子代理 │
│ • 两阶段审查 │
│ • 每 3 任务人工检查点 │
│ │
└──────────────────────────────────────────────────────┘
📋 /ce:plan 外部研究决策¶
┌──────────────────────────────────────────────────────┐
│ │
│ 🔐 高风险主题（安全/支付/外部API） → 必须研究 │
│ │
│ ✅ 本地上下文充足 → 跳过研究 │
│ │
│ ❓ 不确定/陌生领域 → 进行研究 │
│ │
└──────────────────────────────────────────────────────┘
🔍 /ce:review 条件代理¶
┌──────────────────────────────────────────────────────┐
│ │
│ PR 包含 db/migrate/*.rb ？ │
│ │
│ ✅ 是 → 追加运行: │
│ • data-migration-expert │
│ • deployment-verification-agent │
│ │
│ ❌ 否 → 跳过 │
│ │
└──────────────────────────────────────────────────────┘
📘 典型工作流示例¶
🚀 示例 1：完整功能开发¶
💡 /ce:brainstorm [P] 用户登录功能 ← Party Mode 讨论
│
↓
📋 /ce:plan 用户登录功能 ← 创建计划
│
↓
⚡ /ce:work docs/plans/xxx-plan.md ← 自动选择执行模式
│
↓
🔍 /ce:review [C] ← Claude + Codex 审核
🐛 示例 2：快速 Bug 修复¶
🏗️ 示例 3：大型重构¶
💡 /ce:brainstorm 重构认证模块
│
↓
📋 /ce:plan 认证模块重构
│
↓
⚡ /ce:work ← 多任务 → Subagent 模式
│
↓
🔍 /ce:review [C] ← Claude + Codex 双重审核
💡 示例 4：记录解决方案（可选）¶
📝 更新日志¶
| 日期 | 版本 | 变更 |
|---|---|---|
| 2026-03-24 | v2.44.15 | Review 报告增加裁决过滤可选展开；流程图补充 Step 4.5/4.6 裁决链 |
| 2026-02-04 | v2.40.0 | 添加 /ce:sync-upstream 上游同步检测 |
| 2026-02-02 | v2.35.0 | ✨ 初始文档创建；添加 [C] Codex 参数说明 |
📚 相关文档¶
| 文档 | 说明 |
|---|---|
| INSTALL.md | 安装与使用指南 |
| CONCEPTS.md | 核心概念 |
| VERSION-STRATEGY.md | 版本管理策略 |