commit

commit — 一个关注点，一条能审的记录，三道落地前的闸

产物是一个 git commit：消息按 Conventional Commits 的形状（产物序），暂存集只含这个关注点的 文件。本文件写：commit 在这条流水线里是什么、什么算对、原语与出口、不可豁免的边界。分几次 提、先提哪个是你的份额。

缺口（Judgment + Capability）

deletion 测试：撤掉本 skill，引擎 git add -A && git commit -m "fix stuff"——把三张卡的改动、 一个误留的 .env、一处 console.log 和一条改了 done_when.yaml 的行一起提进去。review 无法 按关注点读，锁形同虚设，白名单从未在落地前被检查。缺的是判据（原子 / 消息 / 不该进的东西） 和把机械半边编译掉的原语。

世界（Σ：git 的性质，不是流程规定）

• 暂存是按 hunk 的：git add -p 可以只提一个文件里属于本关注点的块。一个 diff 含两个 关注点 → 两次提交，不是一条长消息。
• 本地 commit 可逆、push 不可逆、amend 改写历史：未推送的 commit 可 --amend / reset --soft； 已推送的永不 amend / rebase（毁 review 锚点、毁协作者基线）。
• HEAD 不一定是你的提交：同一 checkout 被多个并行 session 共用时，你上一条提交之后对方可能已经 提了几条，--amend 落在对方的 HEAD 上，把他们的消息改成你的（dogfood 2026-09-06，I-53： 一次 amend 覆盖了另一个 session 的报告提交，靠 reflog 找回）。同一工作区还共用一个 git 索引， 你 git add 的东西会进对方的提交。世界的性质是"工作区与索引是进程间共享的可变状态"，不是流程规定。
• 门与落地必须是同一个动作：verify → 读退出码 → commit 三步分开写时，中间任何一层管道 （| jq、| tail）都会把退出码换成最后一段的——被拒的提交照样落地（I-50）。
• 消息是给六个月后的人读的：subject 说做了什么（祈使、≤ 72 字符、不加句号），body 说 为什么与取舍，footer 说关联（Refs #N / Closes #N）与 breaking change。
• 卡与锁（在 /ai-dlc 里跑时）：卡的 allowed_files 是白名单执行器的输入；.done_when.lock 列出的文件是 G2 冻结物，同一 diff 改它们必须带 change-proposal-*.md。
• 红-绿证据（TDD 模式下）：新增测试的 commit 先于实现的 commit，且前者在基线上必须失败—— 这是堵"driver 写成空断言"的主防线。本 skill 不做红-绿脚本；references/conventions.md 写了手工做法与记录格式（登记为空白）。
• 关于用户的 Σ："提一下""存个档"= 用户要的是安全点，不是发布；WIP 允许但消息也要能读 （wip(scope): …），且不进 main。

判据（φ）

• 原子：暂存文件属于一个关注点；跨 > 3 个顶层目录且无 scope → 可疑（flag，非拒）。
• 消息：type(scope)?: subject，type ∈ feat/fix/docs/style/refactor/perf/test/chore/ci/build/revert（+ wip 仅限非 main）； subject ≤ 72、无句号；body 行 ≤ 100（flag）；有 issue 时 footer 含 Refs #N 或 Closes #N（flag）； ! 或 BREAKING CHANGE: 时 body 必须解释。
• 不该进的东西（拒）：secret 形态的字符串（AWS / GitHub / Slack / OpenAI token、私钥块）； debugger; / pdb.set_trace() / binding.pry；.env、*.pem、id_rsa；node_modules/、 构建产物（除非仓库约定提交）。console.log / print( 新增行 → flag。
• 白名单（--card）：每个暂存文件匹配 allowed_files 且不匹配 forbidden_files；溢出即拒。
• 锁（--lock）：锁内文件被改 → 无变更提案同 diff → 拒；有 → 放行并提示登记 task 回流。 放行时输出集合级 lock_detail：locked_changed（暂存集 ∩ 锁内路径）、proposal_files、 proposal_missing_path（变更提案没提到的被改锁内路径 → flag）。复核提案的人不该手算这个交集。
• 不在 main / master / develop 上提交（拒，除 --allow-main）。
• 插件版本同步（本仓库的 CLAUDE.md 规则，编译在预门里）：diff 触及 plugins/<p>/skills/** 而 plugins/<p>/.claude-plugin/plugin.json 的 version 未变 → --range / PR 闸门拒；暂存模式只 flag （CLAUDE.md 明写版本 bump 单独提交，暂存模式看不到那一条，拒了就等于拒绝它自己规定的流程）。 marketplace.json 的 version 与 plugin.json 不一致同样拒；skill 自身 SKILL.md 的 frontmatter version 未动 → flag。理由是插件缓存按版本号取目录：不 bump 的修复，装着旧版本的用户永远收不到。
• amend（拒）：--amend 必须声明你以为 HEAD 是哪条（--expect-subject）， git log -1 --format=%s 对不上就停——共享 checkout 里那可能是别人的提交。
• 体量：新增 > 800 行 → flag "考虑拆"。
• 残差（人 / judge）：消息说的"为什么"是不是真的；两个文件到底算不算一个关注点。