用途:speckit-git-commit 是一个在 Spec Kit 命令完成前后自动提交变更的钩子扩展。它以钩子形式被核心命令调用,用于将工作区中的改动自动暂存并提交,减少手动执行 Git 提交的步骤。
主要能力:
- 自动确定事件名:根据触发它的钩子上下文判断事件,例如作为 after_specify 钩子调用时事件为 after_specify,作为 before_plan 调用时事件为 before_plan。
- 读取配置:检查 .specify/extensions/git/git-config.yml 中的 auto_commit 配置段。
- 按事件启用:查找对应事件键判断是否启用自动提交;若没有事件专属键,则回退到 auto_commit.default。
- 自定义提交消息:若配置了按命令的消息则使用该消息,否则使用默认消息。
- 执行提交:在启用且存在未提交变更时,运行 git add . 与 git commit。
使用方式: 先确定触发命令的钩子事件名,然后运行对应脚本: Bash:.specify/extensions/git/scripts/bash/auto-commit.sh <event_name> PowerShell:.specify/extensions/git/scripts/powershell/auto-commit.ps1 <event_name> 将 <event_name> 替换为实际钩子事件,例如 after_specify、before_plan、after_implement。
配置示例(位于 .specify/extensions/git/git-config.yml): auto_commit: default: false # 全局开关——设为 true 以对所有命令启用 after_specify: enabled: true # 按命令覆盖 message: "[Spec Kit] Add specification" after_plan: enabled: false message: "[Spec Kit] Add implementation plan"
优雅降级:
- Git 不可用或当前目录不是仓库:跳过并给出警告。
- 配置文件不存在:跳过(默认禁用)。
- 没有可提交的变更:跳过并给出提示。
适用场景:适合在 Spec Kit 工作流中希望自动记录规格、计划或实现阶段变更的用户,通过配置按事件精细控制是否自动提交及提交消息。
限制:该扩展依赖 Spec Kit 的钩子机制与 .specify/extensions/git 目录结构;自动提交行为完全由 git-config.yml 配置决定,默认禁用;仅在存在未提交变更时执行提交;资料未提供安装命令、支持平台范围、版本要求或额外参数说明,这些暂未提供。