conventional-commit 是根据 Git 变更生成规范提交说明的 Skill,并包含暂存和提交的操作流程。适合团队希望从提交历史里看懂改了什么,却经常只看到 update、fix 等模糊记录的情况。
它先检查变更文件和具体差异,再组织成“类型、可选范围、简短描述”。修复、功能、文档、测试等改动使用不同类型,必要时补正文、问题引用或破坏性变更说明。
比如按钮对齐修复,可以让提交说明指出界面范围和修正内容;更新安装说明,则应表达文档变化。标题里的动词要说明发生的改变,不必把代码里每一个文件名都塞进去。
这份 Skill 使用 XML 片段组织提示要求,最终写进 Git 的仍是普通提交说明,不是把整段 XML 当成提交消息。
要注意它的工作范围:生成文案之后还会尝试执行提交,并不只是给你一行候选文本。调用时应说明本次要包含哪些变更,尤其工作区里同时存在多个任务时,先检查差异和暂存范围。
如果团队已经有提交约定,把它一起提供给 AI,生成结果才容易和现有历史保持一致。