Git使用标准（Agent）

说明：本标准专门用于 Agent 执行与自动化协作场景，不作为人类开发者日常操作手册。

人类开发者请查阅 Git使用标准（人类）。

目标

为 Agent 在执行仓库改动时提供统一约束，降低不可追溯提交、漏审、误改和回滚困难。

分支与命名

• 默认不在 master 直接开发，统一基于分支提单。
• 分支命名建议：
  • feature/<issue-id>-<desc>
  • fix/<issue-id>-<desc>
  • chore/<issue-id>-<desc>
  • hotfix/<issue-id>-<desc>
• 避免直接在受保护分支上 force push、--delete。

提交规范

• 使用约定式提交：类型(范围): 说明
  • 示例：feat(auth): add login retry validation
  • 示例：fix(ui): resolve ranking stale issue
  • 示例：docs(planning): add human git standard
• 禁止空提交（--allow-empty）用于替代实际修改。
• 每条提交尽量只解决一类问题，便于回滚和定位。

MR 与审计

• 所有变更需关联 issue 或任务号。
• MR 说明至少包含：
  • 变更动机
  • 修改范围
  • 验证命令或结果
  • 回滚方案
• 未通过审阅不得合并到主线。

内容边界

提交前确认以下内容不在变更里：

• 密钥、token、账号密码、证书
• 生产环境配置路径明文
• 与本任务无关的临时文件（日志、临时数据库、构建产物）

回退与风险

• 提供清晰回退方案并标注：
  • 回退条件（如功能回归、指标异常）
  • 回退步骤（关键命令）
  • 回退验证方式
• 发现重大风险时，先中止合并流程并同步负责人确认。

适用边界

• 本标准覆盖 Agent 自动化生成、文档补充、分支提交、MR 补充动作。
• 不替代服务端上线、凭据管理、运行时变更的单独审批流程。