diff --git a/.claude/skills/git-commit/SKILL.md b/.claude/skills/git-commit/SKILL.md index 4b795ad..d5b3ce4 100644 --- a/.claude/skills/git-commit/SKILL.md +++ b/.claude/skills/git-commit/SKILL.md @@ -33,12 +33,17 @@ message省的是未来翻`git log`时重新读一遍diff的时间。这个技能 ### 第三步:生成 commit message -采用 Conventional Commits 格式(除非第一步发现这个仓库明显用别的风格,这种情况下跟随仓库风格): +**message 正文(subject/body)用中文写**——除非第一步发现这个仓库历史上明显 +是用英文写(且不是本技能自己产生的commit),这种情况下跟随仓库现有语言。 +`type`前缀本身仍用英文标准词(`feat`/`fix`等,这是社区通用约定,不翻译), +`scope`用原始的模块/skill名(通常本身就是英文目录名,不需要翻译)。 + +格式采用 Conventional Commits: ``` -(): +(): <中文subject> - +<中文body — 可选,只在"为什么"不是一眼能看出来的时候写> ``` - `type` 从改动的实际性质里选,不要凭感觉:`feat`(新功能)、`fix`(修bug)、 @@ -48,10 +53,10 @@ message省的是未来翻`git log`时重新读一遍diff的时间。这个技能 考虑拆成多个提交,而不是硬凑一个笼统的type。 - `scope` 可选,涉及单一模块/skill时加上(比如`literature-search-verify`、 `paper-writing-grounded`),改动横跨全仓库时省略。 -- `subject` 祈使语气、不超过~70字符、不以句号结尾,说清楚这次改动做了什么, - 但真正的价值在于讲清楚**为什么**要这么改——如果"为什么"不是从改动本身能 - 一眼看出来的(比如修了一个不明显的bug、调整了一个非默认行为),写进body里, - 不要只重复diff里已经能看到的内容。 +- `subject` 祈使/陈述语气均可、不超过~35个汉字、不以句号结尾,说清楚这次改动 + 做了什么,但真正的价值在于讲清楚**为什么**要这么改——如果"为什么"不是从 + 改动本身能一眼看出来的(比如修了一个不明显的bug、调整了一个非默认行为), + 写进body里,不要只重复diff里已经能看到的内容。 - 不要在message里提及和这次改动无关的历史背景或猜测性动机。 ### 第四步:暂存并提交