consulting-agent-pipeline（咨询 Agent 管道）

Multi-Agent Pipeline — 多Agent协作研究管线

首钢吉泰安项目（2026-04-09 ~ 04-14）的实战协作经验抽象为可复制工作流。

技能定位

不是什么：本技能不是通用任务管理工具（task-management），不是单Agent TODO列表，不是LangGraph/CrewAI框架替代品，不是项目管理软件（Gantt/Jira）的替代品。

是什么：一套跨平台、多Agent协作的文件系统协议——定义如何通过共享文件夹 + 结构化文档实现协作，而不依赖任何特定Agent平台或聊天通道。

适用项目类型：

• ✅ 咨询类交付物（PPT/报告/方案文档）
• ✅ 多专题并行调研 → 单一线性产出的项目
• ✅ 需要多轮审核迭代（≥2轮）的对外交付
• ✅ 跨平台Agent协作（Agent不同属一个公司/平台）

不适用：

• ❌ 纯软件开发迭代（代码频繁merge/branch，适合用Git工作流而非本技能）
• ❌ 实时通信/客服类项目（需要毫秒级响应，不适合文件交接协议）
• ❌ 单Agent独立完成任务（不需要多Agent协作协议）
• ❌ 高度机密项目（不建议在共享文件系统存储任何项目信息）

核心设计原则

1. Agent-Agnostic：基于文件系统协议，任何能读/写本地文件的Agent都能参与
2. Shared State：PROJECT_STATE.yaml 是唯一的项目状态数据源，消除分散在多个文档中的状态不一致
3. Structured Handoff：交接文档使用 YAML frontmatter（机器可解析）+ Markdown 正文八节（人类可读）
4. Calibrated Autonomy：Human 决策矩阵决定干预层级，P0/P1/P2 优先级决定自动化程度
5. Every Handoff Auditable：每次交接都有文档记录，替代聊天传递，审计可追溯

工作流五阶段

┌─────────────────────────────────────────────────────────────┐
│ Phase 0: INIT                                               │
│ → Orion: 初始化项目结构 + 填写 PROJECT_STATE               │
│ → 人类审批: 框架方向 + Agent分配 + 禁用词清单               │
└──────────────────────────────┬──────────────────────────────┘
                               │ 人类Gate ✅
┌──────────────────────────────▼──────────────────────────────┐
│ Phase 1: RESEARCH（可并行 Fan-Out）                         │
│ → N个 Research Agent 并行执行专题调研                       │
│ → Orion: 汇总 → research-synthesis.md                       │
│ → 人类审批: 调研质量 + 数据可用性                           │
└──────────────────────────────┬──────────────────────────────┘
                               │ 人类Gate ✅
┌──────────────────────────────▼──────────────────────────────┐
│ Phase 2: FRAMEWORK                                         │
│ → Reviewer Agent: 构建交付物内容框架                        │
│ → 输出: framework-to-execution.handoff.md                  │
│ → 人类审批: 框架方向（如"冒总定调：先出框架去谈"）          │
└──────────────────────────────┬──────────────────────────────┘
                               │ 人类Gate ✅
┌──────────────────────────────▼──────────────────────────────┐
│ Phase 3: EXECUTION                                          │
│ → Execution Agent: 生成 v1 交付物                           │
│ → forbidden-terms-scan.sh: 自动扫描                         │
│ ⚡ Auto Gate: 扫描通过 → 进入审核；不通过 → 退回修复        │
└──────────────────────────────┬──────────────────────────────┘
                               │ Auto Gate ✅
┌──────────────────────────────▼──────────────────────────────┐
│ Phase 4: AUDIT（Generator / Critic 循环，3轮上限）          │
│ Round 1: 方向 + 语气 + 视觉层级                             │
│ Round 2: 完整度 + 合规性 + 数据一致性                        │
│ Round 3: 风险边界 + 禁用词清除                               │
│                                                            │
│ 📊 Calibrated Gate:                                        │
│   全部P2 → Agent自动迭代进入下一轮                          │
│   有P1无P0 → Agent迭代后人类复核                            │
│   有P0 → 人类必须审批修复方案                               │
│   审核通过 → 进入 Phase 5                                  │
└──────────────────────────────┬──────────────────────────────┘
                               │ Human Gate ✅
┌──────────────────────────────▼──────────────────────────────┐
│ Phase 5: DELIVERY                                          │
│ → validate-deliverable.sh: 结构验证                        │
│ → forbidden-terms-scan.sh: 最终扫描                         │
│ → snapshot-dir.sh: 版本快照归档                            │
│ → 人类审批: 最终交付物确认                                  │
└─────────────────────────────────────────────────────────────┘

Human Gate 与 Calibrated Autonomy 速查

核心文件速查

模板选择指南

关键协议速览

脚本工具

局限性（必须了解）

首钢吉泰安项目教训

复盘机制

本技能内置两层复盘：

1. 阶段级复盘（每Phase结束时）

• Orion 对照 PROJECT_STATE 的 decisions 节，审查本阶段是否有未记录决策
• 检查 milestone 是否全部 completed
• 更新 PHASE_README.md 的阶段总结节

2. 项目级复盘（Phase 5 完成后）

• Orion 填写 DECISION_LOG.md 最终汇总
• 对照首钢吉泰安教训清单，检查本项目是否有新教训
• 将新教训追加到 MEMORY.md 的"协作反思"节

复盘结果不修改本技能的 SKILL.md，而是追加到 ~/.openclaw/workspace/memory/YYYY-MM-DD.md。

敏感信息处理

警告：所有模板中的示例数据（如 YYYY-MM-DD / PROJECT_NAME / 项目ID）均为占位符，不得包含真实项目数据。