commit-messages
从暂存区自动生成 Conventional Commits 提交信息
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:commit-messages。 它的用途是:从暂存区自动生成 Conventional Commits 提交信息 完整的 Skill 内容见:https://321skill.com/skills/commit-messages-x-3/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
对 AI 说:'请为我的暂存区代码生成一条 Conventional Commit 提交信息。' AI 会调用该 Skill 分析暂存区 diff,返回如 'feat(user-auth): add JWT token refresh endpoint' 的提交信息。你可以直接复制使用,或要求修改类型和描述。
介绍
开发者在提交代码时,常常面临写不好提交信息或格式不统一的问题,导致项目历史混乱、Code Review 困难。本 Skill 通过分析 git 暂存区(staged changes)的文件变更内容,自动推断出符合 Conventional Commits 规范的提交信息,包括类型(feat/fix/docs 等)、作用范围和简短描述,让每次提交都规范且一致。
使用非常简单:在 git add 之后,运行该工具(或通过 AI 调用),它会读取暂存区 diff,生成一条或多条建议的提交信息。你可以直接采纳、编辑后再提交,也可以要求它重新生成。整个过程无需手动填写类型或范围,节省大量思考和打字时间。
适合所有使用 Git 的开发者,尤其是参与团队项目、需要严格遵循 Conventional Commits 规范(如 Angular 提交规范)的场景。对于 CI/CD 流程中自动生成 changelog 和语义版本号的项目,本 Skill 更是必备工具。
建议配合 git hooks(如 prepare-commit-msg)使用,实现提交前自动填充信息。但要注意,生成的信息基于代码变更的统计特征,对于涉及多个独立功能点的大提交,建议先拆分提交再分段生成,以保证每条信息的准确性。
核心特点
与 commitizen、gitmoji-cli 等需要手动选择类型和范围的工具不同,本 Skill 直接从代码 diff 内容自动推断提交类型和范围,无需任何交互选择,更适合快速提交和自动化流程。
注意事项
当暂存区包含多个不相关的功能变更时,生成的提交信息可能混在一起,需要人工拆分或调整。
常见问题
如何安装这个 Skill?
执行 npm install -g commit-messages 全局安装,然后在任意 Git 仓库中运行 commit-messages 即可生成提交信息。
支持哪些 Conventional Commits 类型?
默认支持 feat、fix、docs、style、refactor、perf、test、chore、ci 等常见类型,可根据代码变更特征自动匹配。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/commit-messages-x-3/raw/index.md 读取 commit-messages 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/commit-messages-x-3/raw/index.md(查看排版版本)