git-step-commit

Git Step Commit

把当前 Git 更改整理成清晰、可审查、可回滚的提交。

管理持久偏好

当用户要求设置、查看或删除提交偏好时，只处理配置并返回结果，不检查工作树、不规划提交，也不提交文件。使用 Git 原生配置，不依赖 Skill 携带的脚本或额外运行时。

使用两个配置项：

• git-step-commit.mode：只允许 default、review 或 direct。
• git-step-commit.language：允许 auto 或规范化的语言标识。把常见自然语言名称转换为稳定标识，例如中文为 zh-CN、英文为 en、日文为 ja、韩文为 ko；其他值使用合法的 BCP 47 形式，不确定时先询问，不写入猜测值。

使用两个作用域：

• 全局：使用 git config --global，对该用户的所有项目生效。
• 当前项目：使用 git config --local，只写入当前仓库的 Git 配置，不写入或提交项目文件。执行前确认位于 Git 仓库中。

写入或删除时必须知道作用域。用户未说明且无法从上下文确定时先询问，不要擅自选择全局或当前项目。读取未指定作用域时默认显示当前有效值及来源。

读取

使用当前终端直接执行以下 Git 命令；不要要求 Bash、Python 或 Go。分别读取各层，按字段解析：

git config --local --get git-step-commit.mode
git config --local --get git-step-commit.language
git config --global --get git-step-commit.mode
git config --global --get git-step-commit.language

不在 Git 仓库中时跳过 --local。读取不存在的 key 所产生的非零退出码表示“未设置”，不是工作流失败。显示每个字段的有效值和来源：本次指令、当前项目、全局或内置。

写入

先校验并规范化所有值，再使用对应作用域执行一个或两个精确命令：

git config --global --replace-all git-step-commit.mode review
git config --global --replace-all git-step-commit.language zh-CN
git config --local --replace-all git-step-commit.mode direct
git config --local --replace-all git-step-commit.language auto

只修改用户明确给出的字段。写入后从同一作用域读回并核对；命令失败或读回不一致时说明真实结果，不要声称配置成功。

删除

删除单个字段时执行对应的 --unset-all：

git config --global --unset-all git-step-commit.mode
git config --local --unset-all git-step-commit.language

删除指定作用域的全部提交偏好时执行：

git config --global --remove-section git-step-commit
git config --local --remove-section git-step-commit

只删除用户指定的字段和作用域。目标不存在所产生的非零退出码表示原本已无配置，按幂等成功处理。删除后读取有效值并说明回退到了哪一层。

选择模式

• 每次实际提交请求开始时静默读取项目和全局的两个配置项，即使用户本轮没有提到偏好；把读取放进下方的一次性分析调用，避免增加往返。
• 对 mode 按“本次明确指令 → 当前项目配置 → 全局配置 → 内置默认”逐层取值。只要当前项目存在该 key，就停止向全局回退；因此项目级 default 可以明确恢复内置行为。
• default：使用内置行为。对“帮我提交”“git commit”“分步提交”等普通请求先输出计划并等待确认；本次明确说“按推荐提交”“你决定并直接提交”“无需确认”等授权时直接提交。
• review：默认输出计划并等待确认。
• direct：默认内部完成分析并直接提交全部推荐批次。
• 本次明确说“本次直接提交”或“本次先审查”时，临时覆盖持久模式但不修改配置。
• 如果用户只询问“推荐怎么提交”“给我建议”或只要求审查，无论持久模式为何都只输出计划。