一周
193 次提交

规范不是拿来背的，是拿来对照自己的。所以先把你这一周的数字摆出来——后面每一条规则，都会回到这些数字上找你自己的例子。

每天提交几次

// 07-27 那根灰柱矮是统计窗口的切边（GitHub 按 UTC 零点切），不是你那天没干活。
// 周六周日各 20+ 次——这份文档不劝你少提交，只想让每一条更值钱。

提交都落在哪个仓库

团队用的是业界通用的 Conventional Commits（约定式提交）。它不神秘，就是把提交信息切成固定的五块，让人和机器都能一眼读懂。下面这条是你自己写的（Akke 8a785e3），我把它拆开标了颜色。

同一件事，两种写法

下面这个演示会自己循环播放。左边是随手写的，右边是按规范写的——改动的代码完全一样。

团队规定只用这七个（全局 CLAUDE.md「Git 提交」条）。不要自创。判断法很简单：问自己"这次改动，对使用者意味着什么"。

你这一周的 type 分布

// 94.8% 合规——这个数字放在团队里是好的。剩下 10 条不合规全部集中在两处，第 09 节会具体点出来。

scope 就是"我动了哪一块"。它不是必填的，但写了之后，队友刷 git log 时能直接跳过跟自己无关的行。你这周写得相当好——135 条带了 scope，而且用词稳定。

feat: 门店素材上传服务
feat: 迁到团队账号，改用 R2 binding
fix: 登录框默认填门店码
fix: 移除工作台冗余说明文案

feat(upload): 门店素材上传服务
feat(storage): 迁到团队账号，改用 R2 binding
fix(auth): 登录框默认填门店码
fix(workbench): 移除工作台冗余说明文案

代码本身已经完整记录了怎么做的——diff 摆在那儿。代码唯一说不出口的是为什么这么做、为什么不那么做。这就是正文存在的全部理由。

范本：你自己写的那条

这是 3723a96（Akke，fix middleware）。它只有 4 行正文，但把一次修改该交代的东西全交代完了——照着这个模板写就够了。

fix(middleware): /api/material-feed 加入免登白名单

跟 /api/internal/* 同款：没有 Supabase 登录态，
route 自校验 MATERIAL_FEED_KEY。

漏了这条时 middleware 直接 401，返回的
{"error":"Unauthorized"} 跟 route 自己的鉴权
失败几乎一样，排查时会误以为 key 配错了。

fix(middleware): /api/material-feed 加入免登白名单

正文写什么 · 三段式

// 三段都是你自己写过的原句。你已经会了——问题只是这一周里有 128 条提交没这么写。

写完 commit 不算完——它得进 main 才算数。团队里有四条路，每条路的"审查强度"不一样。选错路的代价是：要么白排队，要么没人看就上线了。

你横跨的三个仓库，纪律强度完全不同。同一个动作（比如直推 main）在一个仓是常规操作，在另一个仓会被 CI 标红 + 推飞书告警。换仓库先换脑子。

Akke 仓里有一份"高危路径"清单。判断标准不是"重要"，而是——改错了不会报错，而是安静地在线上出事。这类改动谁都不许直推。

两道闸怎么拦你

// 闸① 拦不住 git push --no-verify，闸② 也只标红不回滚——它们的作用是"必留痕、必有第二双眼睛知道"，不是物理阻断。
// 为什么不用 GitHub 原生分支保护？免费计划的私有仓开不了，这两道自建闸就是全部防线。

下面三条不是泛泛而谈，是逐条跑命令核出来的，都附了原始证据。第一条最要紧，而且不是你的错——但它让你这周 34 个 PR 的审查全部白做了。

上面挑了三个毛病，但这一周的整体质量是高的。把做对的地方明确写出来，是因为下面这几条最容易在赶工时第一个丢掉。

前面十节都可以忘掉，这一张记住就行。六个问题，正常情况下 60 秒能过完。

全页只用五个信号色，每个色固定对应一种语义——看到颜色就知道该用什么态度读。括号内为最接近的 Pantone 参考色号。