用途
该技能用于创建符合 Conventional Commits 规范的 Git 提交,帮助开发者生成格式统一、语义清晰的提交信息。
主要能力
- 支持多种提交类型:feat(新功能)、fix(缺陷修复)、refactor(代码重构)、test(添加测试)、docs(文档)、style(格式化,不改变代码)、perf(性能改进)、chore(维护任务)。
- 按照规范生成提交信息,格式为
type(scope): description。 - 主题行保持在 72 个字符以内。
- 使用祈使语气(如 "add" 而非 "added")。
- 对于复杂变更,可包含正文(body)。
- 可选脚注(footer),用于说明破坏性变更或引用 issue。
使用方式
该技能的执行流程如下:
- 运行
git status查看变更。 - 运行
git diff --staged审查已暂存的变更。 - 如果没有已暂存的变更,则建议需要暂存的文件。
- 根据变更内容生成提交信息。
提交信息格式:
type(scope): short description
[optional body with more details]
[optional footer with breaking changes or issue references]
示例:
# Feature
git commit -m "feat(auth): add OAuth2 login with Google provider"
# Bug fix
git commit -m "fix(api): handle null response from external service"
# Refactor
git commit -m "refactor(hooks): extract useAuth logic into separate hook"
如果提供了参数,则使用 $ARGUMENTS。
适用场景
适用于需要统一提交信息风格、提升提交历史可读性、便于自动化生成变更日志或进行版本管理的开发项目。
限制
资料中未提供关于平台、收费、价格、效果或具体使用步骤的更多信息。