用途:在用户要求“commit this”“commit”“save changes”或调用 /commit 命令时,按 Conventional Commits 规范创建 git 提交,可用于提交信息生成、变更日志等场景。
主要能力:支持多种提交类型,并对应分支前缀,包括 feat→feature/、fix→fix/、refactor→refactor/、docs→docs/、test→test/、chore→chore/、style→style/、perf→perf/。提交格式为 <type>(<scope>): <description>,可选正文,并附带固定的 Co-Authored-By: First Fluke our.first.fluke@gmail.com。
使用方式:先分析变更,运行 git status、git diff --staged、git log --oneline -5。若变更文件跨多个功能或领域,按 scope、类型或逻辑独立性拆分提交;单一功能、文件较少(5 个或以下)或用户要求单次提交时不拆分。随后判断类型与 scope,描述控制在 72 字符内、使用祈使语气、首字母小写、结尾无句号,展示提交信息后直接执行 git add <specific-files> 与 git commit -m "<message>",多行信息使用 HEREDOC。
适用场景:需要规范化提交信息、自动判断提交类型和范围、在提交前组织变更拆分的开发流程。限制与注意:绝不使用 git add -A 或 git add .(除非明确授权);绝不提交可能含机密的文件(如 .env、credentials);暂存时始终使用具体文件名。项目特定配置位于 .agents/skills/commit/config/commit-config.yaml,参考资源为 resources/conventional-commits.md。