docs: 补充环境设计原则和监控指标体系

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 可见
+- **安全内建**：铁律（不可删文件、不可改架构）是底线