UI/COMMITTING.md

Git 提交规范（COMMITTING.md）

适用于所有人工提交与自动化迭代提交。ua commit-lint 门禁与 .git/hooks/commit-msg 钩子按本文校验，违规提交被拒绝。

格式

<type>(<scope>): <subject>

[body：动机与要点，每行 ≤ 80 字符]

[footer：Refs: <编号> / BREAKING CHANGE: <说明>]

type 枚举

type	用途
feat	新功能（组件、命令、插件、门禁）
fix	缺陷修复
docs	纯文档变更
style	格式调整（不影响语义：空白、注释格式）
refactor	重构（既非新增也非修复）
test	测试相关
chore	构建、工具、元数据、依赖
iter	迭代流水线产物（自动化专用，scope 必须为 backlog 条目 id）

scope 枚举

• 包名：table-core / frame / ui / tokens / cli（跨包可省略）
• 应用：demo / docs
• 元数据：backlog / repo / protocol
• iter 提交的 scope 固定为条目 id：b02、c01、d29 …
• scope 强制：除 Merge/Revert 自动信息外，所有 type 必须带 scope；ua commit-lint 已机器校验，裸 type（chore: / docs:）一律拒绝

subject 规则

• 中文祈使句，动词开头（「新增…」「修复…」「补充…」）；
• ≤ 50 字符；
• 结尾不加句号；
• 条目 id 不写入 subject（scope 已承载，方便 git log --grep='iter(b02)' 检索）。

示例

iter(b02): 新增 toast 消息提示组件
feat(ui): dataTable 新增 selected 受控信号
fix(cli): 修正 style 检查对 URL 中 // 的误判
chore(backlog): 记录 d29 完成
docs: 重写 README 组件清单

反例（会被门禁拒绝）

iter: b02 新增 toast 消息提示组件   ← iter 缺 scope(id)
iter(b02): 文档站 toast 组件的新增。  ← 句号结尾
feat(ui): 增加 dataTable 的受控选中信号并且支持与内核选择双向同步以及已选计数展示  ← 超 50 字符
update stuff                        ← 非 type 枚举、非中文祈使句

与流水线的关系

• 自动化每轮迭代的首个提交：iter(<id>): <subject>；
• 同轮的元数据变更（backlog 置 done）：chore(backlog): 记录 <id> 完成；
• 合并提交（qa/stable 的 ff-only）不产生 message，无需遵守；
• 门禁来源：ua commit-lint <文件|message>，commit-msg 钩子自动调用；git 自动的 Merge/Revert/fixup 信息跳过校验。