用途:oma-commit 用于在用户请求“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。
使用方式:项目配置位于 .agents/skills/commit/config/commit-config.yaml。工作流先执行 git status、git diff --staged、git log --oneline -5 分析变更;若变更涉及多个功能或领域,可按 scope、type 或逻辑独立性拆分提交,不同 scope、不同类型或逻辑独立的改动适合拆分,单一功能、少量文件(5 个及以内)或用户要求单次提交时则不拆分。随后确定类型与 scope,编写 72 字符以内、祈使语气、首字母小写、无句末句点的描述,然后执行 git add <specific-files> 与 git commit -m "<message>",多行提交信息应使用 HEREDOC。工具会展示提交信息并直接继续,不再请求确认。
限制与注意:绝不使用 git add -A 或 git add .(除非获得明确许可);绝不提交可能含密钥的文件(如 .env、credentials 等);暂存时必须使用具体文件名。其余配置与指南参见 config/commit-config.yaml 与 resources/conventional-commits.md。