用途:当用户要求写提交信息、创建提交或格式化提交时,分析已暂存的 git diff,生成规范的 Conventional Commits 提交信息。
主要能力:先读取项目上下文(如 .chalk/docs/engineering/ 下的提交规范、commitlint.config.js 等),若存在自定义约定则优先遵循;再获取暂存差异并分类变更类型(feat、fix、refactor、docs、test、chore、perf、ci、build、style、revert),从改动文件推断 scope,撰写 72 字符以内、小写祈使句、无句号的主题行,必要时补充解释“为什么”的正文和 BREAKING CHANGE、Fixes #123 等页脚,最后输出完整提交信息及可直接复制的 git 命令。
使用方式:运行 git diff --cached --stat、git diff --cached 和 git status 查看暂存与未暂存内容;若没有暂存内容则提示用户并建议暂存命令;可用 git log --oneline -50 匹配既有 scope 约定。
适用场景:需要统一提交信息风格、生成规范提交、处理破坏性变更或关联 issue 的仓库。
限制:仅基于已暂存变更工作;类型不确定时应询问用户而非猜测;正文应解释动机而非复述 diff;不相关的多项改动应拆分为多个提交;破坏向后兼容时必须写 BREAKING CHANGE 页脚。具体安装与调用方式资料未提供。