docs: 新增 AI 协作系统级约束章节

AGENTS.md

@@ -235,7 +235,7 @@ git push origin main
 
 ### AI 生成 commit message 的硬约束
 
-当 AI 助手（或 IDE agent）被要求生成 commit message 时，**只输出 commit text 本身**，严禁夹带任何元评论、解释或代码块包裹。
+本小节是 `## AI 协作系统级约束` 章节在 commit 场景的具体执行规则。被要求生成 commit message 时，**只输出 commit text 本身**，严禁夹带任何元评论、解释或代码块包裹。
 
 **输出黑名单（出现即视为违规）：**
 
@@ -272,7 +272,40 @@ feat(gitea): bump image to 1.25.2
 这次改动把版本从 1.24 升到 1.25.2，主要修复了…
 ```
 
-> **注意**：thinking 块属于模型内部推理，**无法在 commit 场景关闭**，但它对最终 commit 输出无污染。用户的关注点应放在"最终输出是否干净"。
+> **注意**：thinking 块属于模型内部推理，**无法在 commit 场景关闭**，但它对最终 commit 输出无污染。用户的关注点应放在“最终输出是否干净”。
+
+## AI 协作系统级约束
+
+本章定义 AI 助手在仓库内的系统级行为约束。`## Git 提交规范 > ### AI 生成 commit message 的硬约束` 是本约束在 commit 场景的具体执行规则，本章则覆盖所有 AI 协作场景的通用原则。
+
+### 约束生效机制
+
+AGENTS.md 全文在 **系统提示层级注入** AI 上下文（类似 CLAUDE.md / AGENTS.md 类机制的底层原理）。AI 收到本仓库相关请求时**必须先读取并应用**本约束——这是不可协商的，不是“参考文档”。
+
+### 通用输出原则
+
+任何场景下 AI 输出必须遵守：
+
+- **不夹带元评论**：`我看了你的改动…`、`建议使用：…`、`以下为…`、`分析你的…` 等
+- **不复述 diff**：把 `git diff` 关键行直接复述到回复里
+- **不解释“为什么”**：commit 只描述“改了什么”，不写动机
+- **不多版本候选**：`Option 1 / Option 2`、`---begin--- / ---end---` 等
+- **不擅自 commit / push**：用户未明确要求时不执行 `git commit`、`git push`
+- **不修改敏感文件**：`env.cfg`、Harbor `compose.yaml`、`/data/volumes/` 数据
+- **不修改本文件**：AGENTS.md 由人类维护，AI 不得自行编辑
+
+### thinking 块边界
+
+- **thinking 块是模型内部推理**，在系统提示注入层之上，AI 无法控制是否生成
+- **Zed UI 折叠显示**属于编辑器行为，不在 AGENTS.md 约束范围
+- **判断“是否干净”看最终 commit text 本身**，不是 UI 渲染的折叠块
+- commit 文本里出现元评论 = AI 没遵守本约束，**不是 thinking 泄漏**
+
+### 违规处理
+
+- **轻微违规**（输出含元评论/复述 diff）：让 AI 重做，提示“严格按 AGENTS.md 系统级约束”
+- **严重违规**（擅自 commit/push、修改 env.cfg）：撤销操作 + 立即报告用户
+- **持续违规**：考虑切换非 reasoning 模型或降低 reasoning effort
 
 ## AGENTS.md 维护规则