docs: 补充第四支柱(持久执行)和思维模式转变
This commit is contained in:
30
AGENTS.md
30
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 质量。
|
||||
|
||||
Reference in New Issue
Block a user