用途:在代码改动完成后,按 conventional-commits 格式生成规范的 git 提交信息,并在提交前请求用户确认。
主要能力:支持 type(scope): description 格式,标题不超过 72 字符;提供类型表(feat、fix、docs、chore、refactor、test、perf、style)与作用域表(api、ui、sdk、mcp、skills、ci、docs,多作用域或根级可省略);正文用 2-5 条要点概括高层变更,避免过度具体和实现细节。
使用方式:先分析改动,运行 git status、git diff --stat HEAD、git log -3 --oneline 查看状态与近期风格;再起草信息并展示待提交文件与消息,等待用户明确确认后执行 git add <files> 与 git commit。多行提交可用 heredoc 形式。
限制:必须等待用户明确要求才提交,不得主动提议;提交前必须确认;除非用户明确要求,不使用 -n;禁止 git push --force 或 -f;标题不写实现细节和数量统计。
适用场景:需要统一提交规范、减少提交信息噪音的仓库与团队协作流程。