用途:当用户明确要求生成 commit message、整理提交说明,或提到 commit-msg 时使用本技能。不用于自动执行 git add 或 git commit,不代替正式 code review,也不生成 release notes 或 changelog。
主要能力:默认先查看已暂存变更;用户明确说 all、全部变更或包含未暂存时,再看整个工作区 diff。先判断改动是否适合一个提交,过于混杂时提醒拆分。按改动意图归类为 feat、fix、refactor、style、docs、test 或 chore。先给一条可直接使用的 subject,再给 2-5 条 body 要点,并列出主要变更文件,帮助判断 message 是否过宽。
输出要求:使用 Conventional Commit 风格 <type>: <subject>;type 关键字保留英文,subject 与 body 使用简体中文;subject 简洁聚焦,不堆砌文件名,最长不超过 80 字符;body 使用 flat bullets;不加 emoji、AI 声明或 Co-Authored-By;不替用户执行提交命令。
落盘命令:输出 message 后,必须额外给出可直接复制执行的 heredoc 命令,让 git 正确保留 subject 单行 + 空行 + body 多行 bullet 的结构:
git add <文件列表> && git commit -m "$(cat <<'EOF' <type>: <subject>
- 变更点1
- 变更点2
- 变更点3 EOF )"
<<'EOF' 用单引号围栏,避免 $、反引号被 shell 展开。禁止的反例包括:用 \n 字面字符串拼接、把 body 压成单行、把多个 bullet 用空格拼接进 subject。
自验:落盘后用 git log -1 --pretty=format:'%s%n---%n%b' 检查,subject 必须单行,body 必须保留每行独立的 - bullet。
按需展开:类型选择见 references/commit-types.md,格式约束见 references/message-format.md。