hashgraph-online/awesome-codex-plugins / plugins/Colin4k1024/tsp/skills/agent-patterns-catalog
agent-patterns-catalog
VerifiedAI Agent 架构模式目录。提供 ReAct、Multi-Agent Conversation、Multi-Agent Workflow、 RAG Agent、Tool-Use Agent、Autonomous Agent 六种核心模式的参考架构、组件拓扑、 数据流、设计决策和框架无关的最佳实践。供 agent-dev-workshop Phase 2 调用。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| references/autonomous-agent.md | markdown | 4.7 KB |
| references/multi-agent-conversation.md | markdown | 3.4 KB |
| references/multi-agent-workflow.md | markdown | 3.8 KB |
| references/rag-agent.md | markdown | 4.4 KB |
| references/react-agent.md | markdown | 2.4 KB |
| references/tool-use-agent.md | markdown | 4.3 KB |
references/multi-agent-workflow.md
View on GitHub# Multi-Agent 工作流模式
## 核心思想
将复杂任务拆解为**有向无环图(DAG)**中的阶段,每个阶段由专门的 Agent 负责,
通过显式的输入/输出契约和质量门禁串联。适合流程确定、需要阶段质量保证的场景。
## 参考架构
```mermaid
graph LR
Input[任务输入] --> S1[Stage 1: 数据采集]
S1 -->|Gate 1| S2[Stage 2: 分析处理]
S1 -->|Gate 1| S3[Stage 3: 知识检索]
S2 --> S4[Stage 4: 报告生成]
S3 --> S4
S4 -->|Gate 2| S5[Stage 5: 质量审查]
S5 -->|Pass| Output[最终输出]
S5 -->|Fail| S4
```
## 工作流定义
```yaml
workflow:
name: "research-report-pipeline"
stages:
- id: "collect"
agent: "data-collector"
inputs: ["user_query"]
outputs: ["raw_data"]
timeout: 60s
- id: "analyze"
agent: "analyst"
inputs: ["raw_data"]
outputs: ["analysis_result"]
depends_on: ["collect"]
- id: "retrieve"
agent: "knowledge-retriever"
inputs: ["user_query"]
outputs: ["relevant_docs"]
depends_on: ["collect"]
parallel_with: ["analyze"]
- id: "generate"
agent: "report-writer"
inputs: ["analysis_result", "relevant_docs"]
outputs: ["draft_report"]
depends_on: ["analyze", "retrieve"]
- id: "review"
agent: "quality-reviewer"
inputs: ["draft_report"]
outputs: ["final_report"]
depends_on: ["generate"]
gate:
condition: "score >= 0.8"
on_fail: "retry:generate"
max_retries: 2
```
## 组件职责
| 组件 | 职责 | 关键配置 |
|------|------|---------|
| Workflow Engine | DAG 调度、状态跟踪 | `max_retries`, `timeout` |
| Stage Agent | 执行单一阶段任务 | `inputs`, `outputs`, `tools` |
| Quality Gate | 阶段间验证 | `condition`, `on_fail` |
| State Store | 中间产物持久化 | `backend`, `ttl` |
## 调度策略
| 策略 | 描述 | 实现方式 |
|------|------|---------|
| Sequential | 严格顺序执行 | `depends_on` 链式依赖 |
| Parallel | 无依赖阶段并行 | `parallel_with` 或自动检测 |
| Conditional | 根据条件分支 | `gate.condition` + `on_fail` |
| Fan-out / Fan-in | 一对多分发 + 汇聚 | 多阶段同一 `depends_on` |
| Iterative | 循环直到条件满足 | `gate.on_fail: retry` |
## 适用场景
- 数据处理流水线(采集 → 清洗 → 分析 → 可视化)
- 内容生产流水线(研究 → 撰写 → 审核 → 发布)
- 软件发布流水线(编码 → 测试 → 审查 → 部署)
- 多步骤任务自动化(表单提交 → 验证 → 处理 → 通知)
## 设计要点
1. **阶段粒度**:一个阶段 = 一个清晰的输入/输出变换,不要太粗也不要太细
2. **契约优先**:先定义每个阶段的输入/输出 schema,再实现
3. **幂等性**:每个阶段应支持重试而不产生副作用
4. **超时控制**:每个阶段和整体工作流都设置超时
5. **可观测性**:记录每个阶段的输入、输出、耗时、token 消耗
## 质量门禁模板
```yaml
gate:
name: "report-quality-gate"
checks:
- type: "completeness"
condition: "all required sections present"
- type: "accuracy"
condition: "no factual contradictions"
- type: "format"
condition: "follows output schema"
on_pass: "continue"
on_fail:
action: "retry_previous"
max_retries: 2
feedback: "将检查失败原因反馈给上游 Agent"
```
## 常见陷阱
| 陷阱 | 表现 | 解决方案 |
|------|------|---------|
| 阶段耦合 | 修改一个阶段影响其他阶段 | 严格的输入/输出 schema |
| 重试风暴 | 质量门禁反复失败 | 设置 max_retries + 降级策略 |
| 状态丢失 | 中间产物未持久化 | 每个阶段输出写入 state store |
| 并行竞争 | 并行阶段写同一资源 | 输出隔离,在汇聚点合并 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |