用途:按 Conventional Commits v1.0.0 规范创建 git 提交。带参数调用时,为已暂存改动生成对应提交信息。该技能仅适用于 git 提交信息,不适用于 PR 标题、分支名、变更日志或发布说明,除非明确要求。
主要能力:先运行 git diff --cached 检查已暂存改动;若无暂存内容则报告并停止;分析 diff 确定 type、scope 与 description;按规则撰写信息;用 git commit -m "<message>" 提交,多行信息使用 HEREDOC。不暂存文件,只提交已暂存内容。
信息结构:<type>[optional scope]: <description>,可选 body 与 footer。类型包括 feat、fix、docs、style、refactor、perf、test、build、ci、chore。scope 可选,取模块、组件或代码区域,来自项目结构中的目录名或模块名而非文件名,如 feat(auth):、fix(api):;跨领域或影响项目根时省略。description 用祈使语气,类型前缀后首字母小写,不加句号,限 50 字符。body 每行 72 字符换行,说明改了什么与为什么,与 description 之间空一行。
禁止内容:AI 署名、类型前缀或描述中的 emoji、时间估计或日期、TODO 或未来工作引用、文件列表、道歉或含糊措辞。
限制:仅处理提交信息,不负责暂存文件;不适用于 PR 标题、分支名、变更日志与发布说明。示例:docs: correct spelling of CHANGELOG;feat(lang): add Polish language;feat!: send email to customer when product ships,并附 BREAKING CHANGE 说明。