该技能用于在一个逻辑工作单元完成后创建 Git 提交。适用于完成任务、用户要求提交、文档更新或功能修复实现后。
主要流程:先运行 git status、git diff --stat、git diff --cached --stat 收集改动,无改动则停止;随后进行强制分支安全检查,通过 git symbolic-ref 检测当前分支与默认分支,若在默认分支则警告并建议创建特性分支,同时分析现有分支命名惯例后提议分支名(如 type/short-description),必要时运行 git checkout -b <branch-name>。
在默认分支或无工单时进行工单追踪检测:识别 GitHub/GitLab Issues(可用 gh issue list 确认)、Jira、Linear 等迹象;若检测到工单系统且改动未关联工单,会警告并根据改动草拟工单标题与描述,询问用户创建、提供工单 ID 或跳过。仅在特性分支上执行语义关联检查,比较分支名与改动内容,若完全不匹配则警告并等待确认。
之后分析改动类型、范围与破坏性变更,按 Conventional Commits 格式 type(scope): description 草拟消息,类型包括 feat、fix、docs、refactor、style、test、chore,并在页脚关联工单。提交前必须展示 git diff --staged 与消息并等待用户显式批准;批准后优先添加具体文件而非 git add -A,执行提交,最后用 git log -1 --stat 验证。
规则:绝不运行 git push,只做本地提交;始终需用户确认;每个提交代表一个完整改动;使用 Conventional 格式;检查默认分支;对齐工单;语义不符时警告。输出为含分支、类型、范围、文件、消息与差异摘要的提交提案。