commit-messages
从暂存区自动生成规范提交消息
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:commit-messages。 它的用途是:从暂存区自动生成规范提交消息 完整的 Skill 内容见:https://321skill.com/skills/commit-messages-x/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我从暂存区生成提交消息',它会读取当前 git 暂存区的改动,分析变更文件中的函数和变量名,然后输出类似 `feat: add user registration endpoint` 的消息,并附上简短说明。你也可以要求它生成三个候选让你选择。
介绍
在日常开发中,每次提交代码都需要写提交消息,很多人要么随便写几个字,要么花时间琢磨格式。这个技能能帮你自动从暂存区(staged changes)的代码改动中生成符合 Conventional Commits 规范的提交消息,让提交记录统一、可读、便于后续自动化处理。
使用很简单:先 git add 暂存你要提交的改动,然后运行这个技能,它会分析改动的文件类型、变更内容,自动生成类似 feat: add user login endpoint 或 fix: correct null pointer in payment 这样的消息。你还可以要求它生成多个候选消息供你挑选,或者指定提交类型(feat/fix/docs 等)。
适合所有使用 Git 进行版本控制的开发者,尤其是团队协作频繁、有代码审查或自动生成 changelog 需求的场景。无论是前端、后端、全栈还是智能体开发者,只要你希望提交历史干净整洁,这个技能都能帮到你。
建议在提交前先 review 生成的消息,确保准确表达了改动意图。对于非常复杂的变更,建议手动调整细节。另外,如果你的项目有特殊的提交规范前缀,可以在运行前通过参数或配置文件自定义模板。
核心特点
其他同类工具通常只基于文件名或简单规则生成消息,而本技能会深度分析代码 diff 中的函数、变量、注释等语义信息,生成更贴合实际改动的消息,并且严格遵循 Conventional Commits 格式。
注意事项
对于仅有少量非语义变更(如空白字符调整)或跨多个不相关模块的混杂改动,生成的消息可能不够准确,需要人工调整。
常见问题
必须在暂存区有改动才能用吗?
是的,该技能只分析 `git diff --cached` 的内容,请先执行 `git add` 将改动加入暂存区。
能自定义提交类型或作用域吗?
可以,你可以在请求时指定类型或作用域,比如要求生成 `feat(api)` 或 `fix(auth)` 格式的消息。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/commit-messages-x/raw/index.md 读取 commit-messages 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/commit-messages-x/raw/index.md(查看排版版本)