用途:为已暂存的 Git 改动生成 Conventional Commit 格式的提交信息,并完成提交。
主要能力:查看暂存区差异;在改动未暂存时提示用户先暂存或使用 git add . 暂存全部;生成单行或多行提交信息;支持在信息中引用 issue、用户故事、任务或缺陷编号。
使用方式:查看暂存改动使用 git --no-pager diff --staged。提交时通过标准输入读取信息,避免 !、引号、反引号、反斜杠和换行带来的 shell 问题:
git commit -F - <<'EOF' <type(scope): subject>
<body (optional)> EOF
当信息可能包含 !、引号、反引号、反斜杠或换行时,避免使用 -m 传参。
规则:改动较小时(如少于 100 行、小幅编辑)生成单行提交;改动较大时允许简洁的多行提交;始终遵循 Conventional Commits 格式;主题行最多 100 字符。
风格:主题不以 emoji 开头,可在主题末尾加一个 emoji;正文 emoji 保持克制(一般不超过 2 个);可加入少量与上下文相关、专业且不失幽默的表达。若必须在 shell 命令中内联信息,避免使用 shell 敏感字符(尤其是 !),否则优先使用上述标准输入方式。
限制:资料未提供该技能的安装方式、依赖环境、支持的平台及收费信息。