用途:把改动整理成原子化的 Git 提交。先做预检查(确认在 git worktree、非 detached、不在 rebase/merge/cherry-pick 状态),再收集分支、状态与已暂存差异,处理暂存,分析 diff 推断提交类型,最后执行提交,可选推送或使用 Graphite。
主要能力:按 conventional-commit 类型(feat、fix、docs、style、refactor、test、chore、build、ci、perf、revert、ai)推断类型与 scope;主题行不超过 50 字符,采用祈使句、小写、无句号;默认模式主题行必需,正文用短横线列出不同改动,琐碎改动可省略正文;--deep 做语义分析、检测破坏性变更并保持简洁正文,可用 BREAKING CHANGE 与 Closes #123;--all 提交全部改动;--push 在提交后推送;--stack 改用 Graphite 的 gt create。
使用方式:参数支持 --all、--deep、--push、--stack,类型关键字覆盖推断类型,引号文本覆盖推断描述。暂存时若 --all 则 git add -A;否则先 git reset,只暂存本会话修改且有实际变动的文件,随后重新读取 git diff --cached。提交时用 git commit -m "subject",有正文时再加 -m "body";--stack 用 gt create。推送在 --stack 下用 gt stack submit,否则有上游用 git push,无上游用 git push -u origin HEAD。
适用场景:需要规范化、可读、原子化提交历史的日常开发;使用 Graphite 管理堆栈的团队;希望按改动语义自动选择提交类型的工作流。
限制:预检查任一失败即报错停止;--all 无改动时报错,非 --all 且无会话内改动时报错;--stack 需安装 Graphite CLI,缺失时提示 https://graphite.dev/docs/installing-the-cli;暂存后差异可能过期需重新读取;推送失败需自行处理拉取/变基、上游或认证问题。其他细节资料未提供。