Gitkkal Commit 是一个 Git 提交辅助技能,用于分析代码改动、按语义意图组织提交,并生成符合仓库配置风格的提交信息。
用途:当用户希望创建结构清晰、信息规范的 Git 提交时使用。它可以接受一个可选的自由文本提示,该提示作为参考信息,而非硬性约束;如果没有提供此类提示,则从 diff 和提交历史中推断意图。
主要能力:
- 读取仓库根目录下的 .gitkkal/config.json;如果该文件缺失,就使用默认值:language=en、commitPattern=conventional、splitCommits=true、askOnAmbiguity=true。
- 收集变更上下文:运行 git status --short、git diff --cached、git diff、git log --oneline -5。
- 从候选暂存文件中排除敏感文件,如 .env、凭据文件、私钥、令牌。
- 推断改动的语义意图;当意图不明确且 askOnAmbiguity=true 时先询问用户。
- 当 splitCommits=true 时,按内聚的逻辑单元拆分提交,保证每个提交可独立理解。
- 在执行前展示提交计划,包括提交分组和建议的提交标题,并用编号选项请用户确认(如 1) 继续、2) 修改计划、3) 取消)。
- 支持三种提交信息风格:conventional(<type>[(scope)]: <description>)、gitmoji(<emoji> <description>)、simple(<description>)。提交信息使用祈使语气,标题不超过 50 字符。
- 逐个文件显式执行 git add <path>,在单次顺序流程中完成暂存,不并行调用。
- 使用 heredoc 构造提交信息;每次提交后运行 git log -1 --oneline 验证并报告实际生成的提交标题。
使用方式:通过斜杠命令 /gitkkal:commit 触发,普通自然语言请求也可等效触发。需要用户输入时,优先使用宿主提供的交互式提问或选择工具;否则回退到纯聊天,并在每条问题中重新从 1) 开始编号。
索引安全:所有会修改 Git 索引的命令(git add、git restore --staged、git reset、git rm --cached、git commit)必须串行执行,不得并行或放入后台作业;只读命令可以并行。遇到 index.lock 错误时立即停止,确认没有活动的 Git 进程占用仓库后再删除锁文件,恢复后重试一次暂存命令;若再次失败则报告并询问用户。
限制与约束:仅暂存显式路径,避免 git add . 或 git add -A 误纳入敏感或生成文件;创建新提交而非 amend;不添加 Co-Authored-By 行;无变更时以 No changes to commit 停止;存在合并冲突时请用户先解决再提交;当提示与代码证据冲突时,先做一次澄清再提交。