用途:帮助用户快速完成一次 Git 提交。它先读取当前仓库状态(git status)和暂存区差异(git diff --staged),据此判断是否可以提交。
主要能力:若暂存区没有改动,会提示用户先执行 git add 并结束;若用户提供了提交信息($ARGUMENTS),则直接使用;否则根据暂存区 diff 推理生成符合 Conventional Commits 的提交信息,然后执行 git commit -m "<message>",并运行 git show --stat --pretty=format:"✓ Committed: %s (%h)" -1,将真实输出展示给用户。
提交信息格式为 <type>[optional scope]: <description>,常用 type 包括 feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert。规则要求第一行不超过 72 字符,scope 可选(如 feat(auth): add OAuth2 login),破坏性变更可用 type! 或 footer 写 BREAKING CHANGE。
限制:严禁在用户未明确要求时执行任何形式的 git add,包括 git add .、git add -A、git add <file>;提交与展示结果必须通过 Bash 工具真实执行,禁止模拟输出。