diff --git a/AGENTS.md b/AGENTS.md index 3499bad64..b07476981 100755 --- a/AGENTS.md +++ b/AGENTS.md @@ -480,3 +480,50 @@ Harness Engineering 建立在前人范式之上,将"编码实现"层交给 AI | 第4阶段 | 试点 Harness | ✅ **当前阶段** — 在 OPENHIS 项目落地 | | 第5阶段 | 规模化推广 | ⏳ 未来 — Harness 模板复用 | | 第6阶段 | 持续优化 | 🔄 持续 — 每次失败优化 AGENTS.md | + +## 环境设计原则 + +> Agent 的行为不是由 Agent 本身决定的,而是由它所处的环境决定的。 + +### 本项目的执行环境架构 + +``` +你(人类工程师)设计 Harness + │ + ▼ +AGENTS.md(约束规则层 + 工作流程 + 反馈机制) + │ + ▼ +Git 仓库 + 编译工具(基础设施层:代码、编译器、测试) + │ + ▼ +AI Agent(我)在约束内执行编码 +``` + +### 环境设计目标 + +| 目标 | 在本项目的含义 | 衡量方式 | +|---|---|---| +| **可靠性** | Agent 能稳定完成编码任务 | 编译通过率 | +| **效率性** | 少迭代次数完成任务 | 每次失败的修复次数 | +| **安全性** | 不删文件、不改架构 | git diff 变更范围 | +| **可观测性** | 所有修改可追溯 | git log + diff | +| **可扩展性** | 规则可复用到新任务 | AGENTS.md 通用性 | + +### 监控指标体系 + +| 指标类型 | 指标 | 本项目的采集方式 | +|---|---|---| +| **业务指标** | 任务成功率 | 编译是否通过 | +| | 人工介入率 | 你审查发现的问题数 | +| **质量指标** | 代码变更范围 | git diff --stat | +| | 数据流完整性 | 全链路检查是否遗漏环节 | +| **效率指标** | 修复迭代次数 | 从失败到通过的重试次数 | +| | 规则复用率 | AGENTS.md 规则的适用广度 | + +### 环境设计原则(本项目的解读) +- **分层设计**:AGENTS.md 定义上层约束 → 编译器捕获下层语法错误 +- **配置即代码**:AGENTS.md 本身就是代码,Git 管理、可回滚 +- **渐进增强**:先跑通编译 → 再加数据流验证 → 再沉淀规则 +- **可观测性优先**:每次修改必须 git diff 可见 +- **安全内建**:铁律(不可删文件、不可改架构)是底线