GUIDE PATTERN
模式组合指南
- Maturity
- L1
- Complexity
- low
- Reliability
- medium
- Hermes
- docs
- Version
- v1.0.0
Skill Contract（本模式的模块声明）
版本 v1.0.0 ｜ 分类 conventions ｜ 相关 maker-checker · state-file-pattern · control-flow-separation · error-compact-pattern · skill-evolution · checkpoint-pattern
场景→模式映射决策树
你的 Cron 任务是什么类型？
│
├─ 只读监控（检查磁盘、API 健康、证书过期）
│ ├─ 只需要 state-file-pattern（防重复 + 进度追踪）
│ └─ 错误多？→ + error-compact-pattern
│
├─ 内容生成（写摘要、日报、周报）
│ ├─ state-file-pattern（基础）
│ ├─ + maker-checker（质量控制）
│ ├─ + error-compact-pattern（异常处理）
│ └─ + budget-guardrail（防止 token 失控）
│
├─ 数据流水线（抓取→清洗→转换→入库）
│ ├─ control-flow-separation（决定哪些步用代码）
│ ├─ state-file-pattern（进度追踪 + 断点续跑）
│ ├─ + error-compact-pattern（各步骤错处理）
│ ├─ + data-retention-privacy（敏感数据脱敏）
│ └─ + skill-evolution（长周期优化）
│
├─ 复杂多 Agent 协作
│ ├─ maker-checker（角色分离）
│ ├─ multi-agent-isolation（资源隔离 + 文件锁 + 命名空间）
│ ├─ control-flow-separation（协调者用代码控制流）
│ ├─ state-file-pattern（全局状态）
│ ├─ + error-compact-pattern（错误隔离）
│ └─ + skill-evolution（持续优化）
│
├─ 🧩 Graph 工作流（节点编排）
│ ├─ control-flow-separation（决定节点内 Code vs LLM）
│ ├─ state-file-pattern（跨节点状态传递）
│ ├─ maker-checker（关键节点双重验证）
│ └─ + checkpoint-pattern（断点续跑）
│
└─ 全自主 7x24 Agent
├─ budget-guardrail（三级预算防护）
├─ human-escalation（高风险人工兜底）
├─ observability-trace（决策链路追溯）
├─ state-file-pattern + checkpoint-pattern
├─ + maker-checker + error-compact
└─ + evolution-gate + memory-os-pattern
你的系统处于什么阶段？
│
├─ 刚起步：核心四条（maker-checker / state-file / control-flow / error-compact）
├─ 已有 cron 在跑：+ cron-job-pattern + self-update-pattern（升级安全）
├─ 知识在积累：+ memory-os-pattern（五层记忆 + 检索 + 写侧纪律）
└─ 开始做优化：+ data-driven-optimization + evolution-gate（评估→回归闭环）
快速速查表
| 场景 |
必须 |
强烈推荐 |
可选 |
| 🟢 健康检查监控 |
state-file |
error-compact |
— |
| 📊 数据采集 |
state-file |
error-compact, control-flow |
— |
| 📝 自动摘要/日报 |
state-file, maker-checker |
error-compact |
skill-evolution |
| 🧪 CI 自动修复 |
control-flow, state-file |
maker-checker, error-compact |
skill-evolution |
| 🤖 多 Agent 流水线 |
maker-checker, state-file |
control-flow, error-compact |
skill-evolution |
| 🔧 系统运维自动化 |
control-flow, error-compact |
state-file |
— |
| 🧩 Graph 工作流 |
control-flow, state-file, checkpoint |
maker-checker |
graph-executor, error-compact |
| 📝 内容创作流水线 |
maker-checker, data-driven-optimization |
state-file, error-compact |
skill-evolution |
| 🔄 系统升级/更新 |
self-update-pattern |
state-file（基线） |
error-compact |
| 🧠 知识沉淀与检索 |
memory-os-pattern |
state-file |
evolution-gate |
| 📈 技能/流程持续优化 |
evolution-gate, data-driven-optimization |
maker-checker, state-file |
skill-evolution |
| 💰 全自主 Agent 成本控制 |
budget-guardrail, state-file |
cron-job-pattern |
error-compact |
| 🆙 高风险操作人工兜底 |
human-escalation, maker-checker |
state-file |
secret-management |
| 🔒 多 Agent 并行协作 |
multi-agent-isolation, state-file |
maker-checker |
control-flow |
| 👁️ 决策链路追溯 |
observability-trace |
state-file |
error-compact |
| 🛡️ 敏感数据管理 |
data-retention-privacy, secret-management |
state-file |
error-compact |
模式间的关系图
┌───────────────────┐
│ control-flow-sep │← 决定每一步用 Code 还是 LLM
└────────┬──────────┘
│
┌──────────────┼──────────────┐
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ maker-check │ │ state-file │ │error-compact│
│ (LLM 输出) │ │ (全局状态) │ │ (异常处理) │
└──────┬──────┘ └──────┬──────┘ └──────┬──────┘
│ │ │
└────────────────┼────────────────┘
│
┌─────────▼──────────┐
│ checkpoint-pattern │← Graph 节点断点续跑
└────────────────────┘
│
┌─────────▼──────────┐
│ graph-executor │← 多节点编排框架
└────────────────────┘
│
▼
┌────────────────┐
│ skill-evolution│← 长期迭代优化
│ (收敛后停止) │
└────────────────┘
按成熟度分级（L1→L3）的推荐组合
| 级别 |
必须装的 convention |
行为 |
| L1 🟢 |
state-file-pattern |
只读、仅报告、人类决策 |
| L2 🟡 |
+ maker-checker + error-compact |
草稿 + 人工批准、有错误处理 |
| L3 🔴 |
+ control-flow-separation + skill-evolution |
自动执行、自愈、持续优化 |
| 🧩 Graph |
+ checkpoint-pattern + graph-executor |
多节点编排、断点续跑、R1→R5 流水线 |
反组合（不要这样用）
| ❌ 错误组合 |
为什么不行 |
| maker-checker 但无 state-file |
Checker FAIL 后无法记录状态，下次不知道哪些重试过 |
| skill-evolution 但无 maker-checker |
没有评分数据，无法判断技能变好还是变差 |
| control-flow-separation 但无 error-compact |
代码路径出错后堆栈炸上下文 |
| state-file 但无 error-compact |
错误发生后写入 STATE.md 失败，状态不完整 |