可用 git notes 为生产提交附加工单状态而不改原始 commit，通过环境变量注入结构化字段、JSON 格式存储、配置 notes 显示与推送，并绑定发布流程校验与追加更新。
可以直接用 git notes 为已发布的生产提交附加工单状态，比如“已上线”“待回滚”“审计通过”，全程不碰原始 commit，哈希值完全不变。
明确目标提交与工单上下文
生产发布通常对应一个附注标签（如 v2.3.0），先确认其指向的 commit SHA：
-
git rev-parse v2.3.0获取真实提交 ID - 从工单系统（Jira/GitLab Issue）提取结构化字段：工单号、当前状态、负责人、审批时间、变更影响等级
- 避免硬编码，建议将这些字段注入 CI 环境变量，例如
JIRA_ID=PROJ-123、STATUS=deployed-to-prod
构造带语义的 notes 内容
不要只写一行文字。用轻量 JSON 或键值对格式，便于后续脚本解析和展示：
MergeIQ: Automatically Score & Prioritise PR Complexity for GitLab and GitHub
下载
使用四维度框架评估任意 GitLab MR 或 GitHub PR 的复杂度：规模（20%），认知负荷（30%），审查工作量（30%），风险/影响（20%）...
- 单行注入：
git notes add -m "JIRA: $JIRA_ID | Status: $STATUS | By: $DEPLOYER | At: $(date -Iseconds)" $COMMIT_SHA - 结构化文件注入（推荐）：
创建release-note.json：
{"jira_id":"PROJ-123","status":"deployed-to-prod","env":"prod-us-east","approved_by":"sec-team","timestamp":"2026-05-26T22:15:42+00:00"}
再执行：git notes add -F release-note.json $COMMIT_SHA
确保 notes 可见且可同步
默认 notes 不显示也不推送，必须显式配置：
- 让
git log自动带出：git config --global notes.displayRef refs/notes/commits - CI 流水线末尾强制推送：
git push origin refs/notes/commits - 团队成员首次拉取时启用自动获取：
git config --add remote.origin.fetch "refs/notes/*:refs/notes/*"，之后git fetch即同步全部 notes
与发布流程绑定，防遗漏
把 notes 注入作为发布流水线的必经步骤，而不是人工补救操作：
- 在部署成功后、打 tag 前或后均可，但建议放在
post-deploy阶段 - 加校验：若
$JIRA_ID为空或$STATUS不在预设白名单（如deployed-to-prod,rollback-initiated,audit-approved），则构建失败 - 支持追加更新：用
git notes append补充新状态，例如上线后追加安全扫描结果：git notes append -m "[Security] SCA passed: 0 critical, 2 low" $COMMIT_SHA
