用途:在用户请求创建 commit 时,按项目已有的 Conventional Commits 规范生成标准化的 git 提交信息,并引导完成提交流程。
主要能力:支持 feat、fix、docs、style、refactor、perf、test、chore、ci、build 等类型;可选 scope 表示受影响模块,如 agentloop、blocklet、arcblock-context 等;主题使用祈使语气、首字母小写、结尾不加句号、尽量不超过 50 字符;正文可选,按 72 字符换行,说明“做什么”和“为什么”;页脚可选,引用 issue(如 Closes #123)或标注破坏性变更(BREAKING CHANGE)。AI 生成提交时会添加 Co-Authored-By 页脚。
使用方式:先运行 git status、git diff --staged、git diff 检查状态;若存在未暂存或未跟踪文件,用 AskUserQuestion 让用户选择 git add . 或中止;确认全部变更已暂存后分析变更并生成提交信息,再让用户选择批准、编辑或取消;用户确认后执行 git commit,最后用 git log -1 --oneline 验证。
适用场景:需要统一提交信息格式的项目,尤其是使用 Conventional Commits 的仓库。
限制:提交信息必须使用英文;类型前缀小写;主题使用祈使语气且不能以句号结尾;未暂存变更未处理前不得继续;执行提交前必须获得用户确认。官方文档未提供收费、价格、支持平台等信息。