| name | git-commit-message-generator |
| description | 根据本次 diff + 关联 feature 生成符合团队 git-conventions 的 commit message。 |
| allowed-tools | Read, Bash, Grep |
Skill: git-commit-message-generator
原文 §8.3 工程工具类。
输入
{
"diff_target": "staged|HEAD|range",
"feature_id?": "FT-001",
"tapd_id?": "T12345"
}
工作流
- 取 diff 摘要:
git diff --stat
- 判别 type:
- 新增文件 / 新增函数 →
feat
- 修复(含 bug 关键词、修正、fix) →
fix
- 仅重命名 / 提取 / 内部重构 →
refactor
- 仅文档变更 →
docs
- 仅测试 →
test
- 仅 Harness 规范变更 →
harness
- 识别 scope:从 diff 路径推断 service / module(用
.service-matrix/dependencies.yaml 反查)
- subject:≤ 60 字符,祈使句
- 自动追加
(FT-id) 标签(若提供)
输出格式
严格遵循 context/team/git-conventions.md:
[{type}][{scope}] {subject} ({FT-id})
示例:
[feat][couponcenter] 新增按标签发券 API 与任务表 (FT-002)
多 commit 拆分建议
若 diff 跨多个 service / 多个 FT,给出"建议拆成 N 个 commit"提示,每个 commit 一行 message,不直接执行。
反模式
- ❌ 一个 commit 跨多个 FT
- ❌ subject 写"修改一些代码"等无信息内容
- ❌ 忘记 (FT-id) 标签(会被 4.4 维度 7 review 拦下)