From b02c10de152c64673e5fa31b72bb9bb467659b94 Mon Sep 17 00:00:00 2001
From: zhaoyun <zhaoyun@gentronhealth.com>
Date: Thu, 28 May 2026 14:39:19 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E7=8E=AF=E5=A2=83?=
 =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E5=8E=9F=E5=88=99=E5=92=8C=E7=9B=91=E6=8E=A7?=
 =?UTF-8?q?=E6=8C=87=E6=A0=87=E4=BD=93=E7=B3=BB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

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