> For the complete documentation index, see [llms.txt](https://yeasy.gitbook.io/harness_engineering_guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yeasy.gitbook.io/harness_engineering_guide/di-yi-bu-fen-harness-gong-cheng-ji-chu/03_principles.md).

# 第三章：设计原则与方法论

本章从哲学和方法论的高度，总结了在构建生产级Harness系统时应该遵循的五大设计原则。

这些原则不是从零开始发明的，而是从Claude Code、OpenClaw以及业界其他成功的智能体系统中提炼出来的最佳实践。它们在看似不同的架构中都能找到体现，这证明了它们的普遍性和重要性。

**约束优先(Constraint-first)** 强调的是，对智能体能力的合理限制，往往比无限制地赋予能力更为关键。通过明确的约束边界，我们既保证了安全性，也提高了系统的可预测性。

**可验证性(Verifiability)** 要求系统的每一个操作都应该是可审计的、可重放的、可验证的。这不仅是安全合规的要求，更是快速定位问题的基础。

**渐进信任(Progressive Trust)** 描述了如何从人工密集的管理模式逐步演进到自主执行模式。这个过程应该是可观测的、可回退的、循序渐进的。

**故障假设(Design for Failure)** 要求我们在设计时，主动假设每一步都可能失败，并提前设计失败的处理机制。这样做的收益是，即使出现意外，系统也能够优雅地降级而非彻底崩溃。

**智能体工学(Agent Ergonomics)** 要求我们为Agent（而非人类）设计更好用的软件系统和开发工具：清晰指令、快速反馈、标准化接口。这一原则由黄东旭在QCon 2026提出，提醒我们Harness的“使用者”是自主智能体，而非有判断力的人类。

这五大原则相互补充、相互强化，共同构建了一个安全、可靠、可管理且对Agent友好的智能体系统。

## 本章结构

* 3.1：约束优先原则
* 3.2：可验证性原则
* 3.3：渐进信任原则
* 3.4：故障假设原则
* 3.5：智能体工学原则