Harness Design Patterns#

Agent harness 架构设计决策参考。蒸馏自 Claude Code 内部架构、OMC、Anthropic/OpenAI harness engineering 博客。

When to Use#

• 设计多阶段任务的上下文传递方案 → Handoff 文档 / Compaction 提取
• 选择多 agent 的协调模式 → Coordinator / Fork / Swarm 选型
• 设计 hook 系统架构 → Hook Pair Bracket / Component-Scoped / Profiles
• 评估任务复杂度以选择执行强度 → Adaptive Complexity

When NOT to Use#

• 需要可执行的 hook 脚本 → 用 agent-hooks
• 需要运维工具（限速恢复、session 监控） → 用 agent-ops
• 需要 prompt 硬化 → 用 prompt-hardening

---

10 个设计模式#

#模式解决什么详情1Handoff 文档跨阶段/跨压缩的上下文传递详情2原子文件写入并发状态文件安全详情3Compaction 记忆提取压缩前被动抢救知识（PreCompact hook）详情4权限否决追踪防止 agent 绕过拒绝详情5三门控记忆合并跨 session 记忆碎片化详情6Hook Pair Bracket每轮 context/时间测量详情7Component-Scoped Hooks任务级别的 hook 控制详情8三种委托模式多 agent 协调方式选型详情9Adaptive Complexity任务复杂度自适应详情10Hook Runtime Profiles环境级 hook 强度控制详情

注：reference 文件名保留原始编号（02/06/08/...）以兼容 monorepo 中的交叉引用。

常见场景选型#

场景推荐模式多阶段任务（plan → implement → verify）Handoff 文档 + Compaction 提取选择 Coordinator / Fork / Swarm三种委托模式选型指南Hook 太多互相干扰Component-Scoped Hooks + Hook Profiles不同环境需要不同保障级别Hook Runtime Profiles (minimal/standard/strict)简单任务 overhead 太高Adaptive Complexity (triage → 自动选执行模式)

工作流程#

Step 1: 识别问题#

当遇到 agent 可靠性问题时，判断属于哪一类：上下文丢失、协调混乱、hook 冲突、或执行强度不匹配。

Step 2: 选型#

根据「常见场景选型」表找到对应模式，MUST 先读 reference 详情再做决策，otherwise 可能误用模式。

Step 3: 应用#

如果需要可执行脚本 → 切换到 agent-hooks skill。如果需要运维工具 → 切换到 agent-ops skill。如果不确定 → 先从最简单的模式开始试验。

Output#

当被询问 harness 设计建议时，returns:

• 推荐的模式名称及原因
• 该模式的 tradeoff 说明
• 具体的实施步骤指引（指向 agent-hooks 或 agent-ops 中的脚本）

延伸阅读#

• 蒸馏方法论 — PCA 降维类比、Review-Execution 分离
• 质量测评体系集成 — 与 improvement-* skill family 的接入点