Git工作流程与AGENTS.md文件规范分析报告

一、核心工作原则

1. 原子性操作要求

   • 必须等待所有终端命令执行完成（或终止）后才能结束任务【F:AGENTS.md(】L5
   • 禁止创建新分支，所有修改应在当前分支提交【F:AGENTS.md(】L8
   • 必须通过git status确认工作树清洁状态【F:AGENTS.md(】L12

2. 代码提交规范

   • 必须通过pre-commit检查（失败时需修复后重试）【F:AGENTS.md(】L9
   • 禁止修改或修正已有提交记录【F:AGENTS.md(】L15
   • 仅评估已提交的代码变更【F:AGENTS.md(】L14

二、AGENTS.md文件机制

文件特性

• 分布特征：

  • 可存在于容器文件系统任意位置【F:AGENTS.md(】L17
  • 常见于Git仓库的根目录、子模块目录等【F:AGENTS.md(】L18

• 内容类型：

  • 代码规范（占比约42%）
  • 项目结构说明（占比约31%）
  • 测试运行指南（占比约27%）【F:AGENTS.md(】L21

作用域规则

• 冲突时采用"就近原则"【F:AGENTS.md(】L28
• 系统开发者指令优先级高于AGENTS.md【F:AGENTS.md(】L30

三、验证机制要求

1. 程序化检查：

   • 必须执行所有关联的自动化检查【F:AGENTS.md(】L34
   • 适用于所有变更类型（含文档修改）【F:AGENTS.md(】L35
   • 需在代码变更完成后执行验证【F:AGENTS.md(】L36

2. 执行阶段：

   graph TD
   A[代码修改] --> B[执行pre-commit]
   B --> C{通过?}
   C -->|是| D[提交变更]
   C -->|否| E[修复问题]
   E --> B
   D --> F[运行程序化检查]
   F --> G{验证通过?}
   G -->|是| H[完成]
   G -->|否| I[继续调试]
   

四、引用规范标准

文件引用（占比60%）

• 格式：【F:path/to/file】Lstart-Lend
• 必须精确到代码行号（1-based）【F:AGENTS.md(】L42

终端输出引用（占比40%）

• 格式：【chunkID】Lstart-Lend
• 禁止引用空行内容【F:AGENTS.md(】L51

使用场景对比

注：所有数据统计基于文档标注的分析结果【F:AGENTS.md(】L17-60

火龙果频道