From bda4b398c69b3ce48b07a0826e93de09367832fe Mon Sep 17 00:00:00 2001
From: zhaoyun <zhaoyun@gentronhealth.com>
Date: Thu, 28 May 2026 14:35:14 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E7=AC=AC=E5=9B=9B?=
 =?UTF-8?q?=E6=94=AF=E6=9F=B1=EF=BC=88=E6=8C=81=E4=B9=85=E6=89=A7=E8=A1=8C?=
 =?UTF-8?q?=EF=BC=89=E5=92=8C=E6=80=9D=E7=BB=B4=E6=A8=A1=E5=BC=8F=E8=BD=AC?=
 =?UTF-8?q?=E5=8F=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index d690e3fc0..2188ccef6 100755
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -281,7 +281,7 @@ Agent 提交代码
 
 人类工程师（用户）设计 Harness，Agent（你）在 Harness 中执行。
 
-## 三大支柱
+## 四大核心组件
 
 ### 1. 约束机制（Constraints）
 让 Agent 在正确边界内工作：
@@ -318,6 +318,17 @@ Agent 生成代码
 | **可观测性** | 记录完整执行链路 | git diff 审查变更范围；编译结果作为门禁 |
 | **人机协作** | 人类介入触发点 | 你做最终审查批准，Agent 自主执行 |
 
+
+### 4. 持久执行（Durable Execution）
+保障 Agent 长时间可靠运行：
+
+| 组件 | 功能 | 本项目的实现方式 |
+|---|---|---|
+| **状态持久化** | 定期保存执行状态 | 每个任务用 update_plan 记录进度和当前状态 |
+| **断点续传** | 中断后自动恢复继续执行 | 编译失败后不从头重来，从失败点继续修复 |
+| **超时处理** | 长时间任务的优雅处理 | 超过单次 token 预算时做 checkpoint，下次继续 |
+| **资源清理** | 任务完成后释放资源 | git commit 后清理中间文件，保持工作区干净 |
+
 ## Harness 设计原则
 
 ### 渐进式构建
@@ -382,3 +393,20 @@ Agent 生成代码
 
 > 这是 Harness Engineering 的终局：Agent 不仅能写代码，还能自我优化执行的框架。
 > 但**底线不可放弃** — 删除文件、架构变更等红线始终由你控制。
+
+## 思维模式转变
+
+当 Agent 出现问题时，不要问"怎么修这个 Bug"，该问：
+
+| 旧思维 | → Harness 思维 |
+|---|---|
+| "这段代码有 Bug" | "约束机制哪里不够完善？" |
+| "我来修复这个问题" | "反馈回路为什么没有捕获？" |
+| "Code Review 通过" | "自动化验证全部通过了？" |
+| "这个功能怎么实现？" | "如何让 Agent 理解这个需求？" |
+| "项目进度如何？" | "Harness 效率指标如何？" |
+| 关注具体实现 | 关注系统设计 |
+| 关注个人产出 | 关注环境效率 |
+| 关注代码质量 | 关注约束完善 |
+
+> 你的成功不再取决于你写的代码行数，而是取决于你设计的 Harness 质量。