用途:在需要保存代码改动时,帮助生成并创建符合 Conventional Commits 规范的提交信息。触发词包括“commit”“create a commit”或任何保存改动的请求。
工作流程:先运行 git status,若不是 Git 仓库或没有已暂存内容则停止;再运行 git diff --staged,并结合对话上下文理解改动原因;随后提出一条提交信息;必须获得用户明确批准后才提交。
格式:使用 type(scope): description 或 type: description。描述用祈使语气、小写、结尾不加句号。破坏性变更在类型后加 !,例如 feat(api)!: rename foo to bar。可选正文与标题之间空一行,正文解释“为什么”而非“做了什么”。
类型:feat(面向用户的新能力)、fix(修复缺陷)、perf(行为不变但更快更轻)、refactor(无行为变化的代码重构)、style(空白、格式或缺失分号)、test(仅测试改动)、docs(文档或注释)、build(依赖或打包等构建输入)、ci(仅 CI 配置)、chore(仓库杂务,如 lint 配置、.gitignore、脚本)、revert(回滚先前提交)。
避免:使用 I、we、now、currently 等措辞;添加 Co-authored-by 或 Generated with 等 AI 署名(该技能会抑制此类署名);使用 emoji(除非项目约定要求);在 scope 已覆盖时重复文件名。
限制:资料未提供安装方式、平台支持、收费情况或更多配置细节。