用途:将混杂的暂存变更拆成多个聚焦提交,例如把文档、依赖、许可证等分别生成为 docs、chore、license 等类型的 commit,避免出现笼统的大提交。仅处理提交拆分与信息生成,不负责分支、PR、push、merge 和 Issue 关闭等语义,这些以 git-workflow 为准。
主要能力:提供交互式批量提交脚本,可按类别分组文件并生成约定式提交信息;支持关联 GitHub Issue(--issue N,标题追加 (#N),正文写 Refs #N)以及项目本地任务引用(--local-ref "project-task Issue #13")。本工具不生成 Closes #N。
使用方式:先 git add 暂存文件,再运行 python3 skills/git-batch-commit/scripts/interactive_commit.py,可加 --yes 跳过确认、--dry-run 仅查看分组。也可用 categorize_changes.py 单独分析分组。分类支持 docs、feat、fix、refactor、style、chore、license、config、test。SKILL.md 视为功能核心文件而非文档。每个提交应包含正文。
适用场景:暂存文件来自多个类别、希望提交历史清晰标准化、文件较多需按逻辑分组时。
限制:需要 Python 3.10+、Git、PyYAML,并需同级安装 git-workflow 技能;运行前有隐私预检,失败则不创建任何提交;使用原始暂存 tree 的临时 index;要求已有 HEAD;执行期失败不回滚已成功提交;提交后若仓库存在相应同步配置,可能提示发布到 ClawHub/SkillHub 或推送 subtree,但均须用户确认。