用途:把当前工作区的 staged、unstaged 和 untracked 变更归纳为一个主题,生成符合 Conventional Commit 前缀(feat、fix、refactor、docs、chore、test、build 等)的 commit message 并直接执行提交。
主要能力:先判断变更能否被诚实概括为一个 commit;优先使用用户已提供的 git status、git diff HEAD、当前分支和最近提交记录,缺失时自行运行 git status、git diff HEAD、git branch --show-current、git log --oneline -10 补充上下文;提炼单一主题,识别 2 到 5 个最重要改动点写入 commit body,优先描述结果和行为变化而非罗列文件名。
使用方式:默认提交全部相关变更,使用 git add -A;支持非交互式写入多行 message,例如 git add -A && git commit -F - <<'EOF' 后接标题与中文要点。若用户明确限制范围(只提交已暂存内容或指定文件),按用户范围执行。
限制:不修改代码、不运行测试、不清理无关文件、不做额外格式化;不 amend、不拆分多个 commit、不 push,除非用户明确要求;无可提交变更时不创建空提交;若变更包含两个以上互不相关主题,应指出无法安全合并为单个 commit,而不是编造含糊的 message。执行原则以用户提供的 git 信息优先,且不输出额外解释文字。缺少官方文档等细节暂未提供。