git-commit 是一个面向 Git 提交工作流的技能,适用于需要创建规范提交的场景。
用途:当用户提出“提交更改”“创建提交”“暂存并提交”或希望获得提交信息帮助时使用。
主要能力:
- 检查仓库状态与改动:通过 git status、git diff --staged、git diff 了解当前状态,并参考近期提交历史中的信息风格。
- 分析改动:对改动进行分类(新增文件、修改、删除),确定提交类型(feat、fix、docs、style、refactor、test、chore),识别影响范围,并总结改动目的。
- 生成与执行提交:暂存相关文件,生成符合 Conventional Commits 格式的提交信息,执行提交并验证结果。
- 输出结果:报告提交内容、使用的提交信息以及新的提交哈希。
使用方式:技能接受一个对象参数,包含三个可选属性。message(字符串):可选的提交信息覆盖。type(字符串):可选枚举值 feat、fix、docs、style、refactor、test、chore,默认值为 auto。scope(字符串):可选的提交范围。调用时可直接说明提交意图,或指定类型与范围。
适用场景:日常开发中保存代码进展、为改动生成规范提交信息、按类型/范围组织提交、在提交前检查并暂存文件。
限制与注意事项:提交信息遵循 Conventional Commits 格式 type(scope): description;主题行保持在 72 字符以内;使用祈使语气(如 “Add feature” 而非 “Added feature”);不提交敏感文件(如 .env、凭据等);除非明确要求,不使用 --force 或 --amend;提交信息应包含有意义的 WHY,而不仅是 WHAT。
补充信息:关于该技能的安装方式、收费情况、支持平台及实际效果,资料中暂未提供。