diff --git a/AGENTS.md b/AGENTS.md index 87324b2..0bb7f1f 100644 --- a/AGENTS.md +++ b/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 维护规则