GitX：将AI批量改动整理为规范提交

AI 编程 agent 很擅长修改代码。

但在使用 Codex、Claude Code、Cursor 或其他编程 agent 完成一轮长会话之后，我往往得到的是这样的结果：

17 changed files

有些文件属于某个功能。 有些文件属于某个 bug 修复。 有些是文档。

把所有改动放进一次提交也能工作，但通常会造出混乱的 Git 历史。

GitX 是一个面向 AI 编程 agent 的便携式 Git 工作流工具。它检查你的工作树、理解代码变动，并帮助将它们组织成清晰、合乎逻辑的提交。

从提交计划开始

我最常用的命令之一是：

gitx plan

它分析当前的改动，在不创建任何提交的前提下提议如何对它们进行分组。

3 logical commits

feat(auth): add token refresh support

fix(api): handle expired authentication sessions

test(auth): cover refresh token behavior

这让我可以在 GitX 实际做任何修改之前先审视计划。

如果计划看起来没问题：

gitx

GitX 会根据实际改动创建符合 Conventional Commit 规范的提交信息。

如果工作树中包含多个逻辑分组，GitX 可以将它们分开，而不是自动地把不相关的改动放入一次大提交。

GitX 不只是生成提交信息

我不想让 GitX 只是另一个提交信息生成器。

它还能辅助 Git 工作流的其余环节：

gitx status
gitx tree
gitx plan
gitx check

gitx branch
gitx pull
gitx push

gitx pr

gitx issue <description>
gitx issue <number>

gitx resolve
gitx amend

提交前运行检查

gitx check

GitX 会检测项目中相关的检查项（如测试或 lint），并在创建提交之前运行它们。

gitx branch

GitX 可以推断出合适的分支名，并加上 feat/、fix/、docs/ 或 refactor/ 等前缀。

创建 GitHub Pull Request

gitx pr

它检查提交和改动，必要时推送分支，并创建一个包含生成标题和摘要的 Pull Request。

处理 GitHub Issues

gitx issue Login fails after token expiry

或者让你的编程 agent 去处理一个已有的 issue：

gitx issue 123

gitx resolve

GitX 可以检查正在进行的合并或 rebase 冲突，理解改动的双方，解决冲突，并运行相关检查。

Git 自动化很容易变得危险，因此 GitX 有意采用了保守的设计。

它避免 force-push，不在普通提交工作流中执行 push，保护已有分支和工作树的改动，并在包含凭据、密钥、日志或构建产物等可能敏感的文件时发出警告。

GitX 遵循便携式 Agent Skills SKILL.md 格式，设计用于与 Codex、Claude Code、Cursor 等兼容 Agent Skills 规范的编程 agent 协同工作。

npx skills add musoyangrigor/gitx-skill --skill gitx

gitx plan

https://github.com/musoyangrigor/gitx-skill

我特别希望听到在实际项目中使用了 AI 编程 agent 的开发者的反馈。

如果你试用了 GitX，我很好奇一件事：

gitx plan 对你代码改动的分组方式，和你自己会采用的分组方式一致吗？

如果不一致，我很想了解具体情况，以便改进它。