docs: 补充第四支柱(持久执行)和思维模式转变

This commit is contained in:
2026-05-28 14:35:14 +08:00
parent 37ea3b1b45
commit bda4b398c6

View File

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