name	commit-msg
description	分析 git diff 并生成规范的 Conventional Commit 消息。当用户提到提交代码、写 commit message、git commit、提交信息、代码提交规范时使用。
disable_model_invocation	true

Git Commit Message 规范化

概述

自动分析当前 git 暂存区的变更内容，生成符合 Conventional Commits 规范的 commit message。确保团队提交历史清晰、可追溯、可自动生成 changelog。

工作流程

digraph commit_flow {
    rankdir=TB;
    "用户调用 /commit-msg" [shape=doublecircle];
    "读取 git diff --staged" [shape=box];
    "有暂存变更？" [shape=diamond];
    "提示用户先 git add" [shape=box];
    "分析变更内容" [shape=box];
    "变更是否过大？" [shape=diamond];
    "建议拆分提交" [shape=box];
    "判断变更类型" [shape=box];
    "生成 commit message" [shape=box];
    "展示给用户确认" [shape=doublecircle];

    "用户调用 /commit-msg" -> "读取 git diff --staged";
    "读取 git diff --staged" -> "有暂存变更？";
    "有暂存变更？" -> "提示用户先 git add" [label="否"];
    "有暂存变更？" -> "分析变更内容" [label="是"];
    "分析变更内容" -> "变更是否过大？";
    "变更是否过大？" -> "建议拆分提交" [label="超过5个文件\n或300行"];
    "变更是否过大？" -> "判断变更类型" [label="合理范围"];
    "建议拆分提交" -> "判断变更类型";
    "判断变更类型" -> "生成 commit message";
    "生成 commit message" -> "展示给用户确认";
}

执行步骤

第一步：读取暂存区变更

运行以下命令收集信息：

# 查看暂存的文件列表
git diff --staged --name-status

# 查看暂存的具体变更
git diff --staged

# 查看最近 5 条 commit（参考风格）
git log --oneline -5

如果暂存区为空，提示用户先执行 git add，不要自动执行 git add。

第二步：分析变更内容

分析以下维度：

维度	关注点
变更范围	涉及哪些模块/目录
变更类型	新增功能、修复bug、重构、文档等
变更规模	文件数、行数是否合理
是否有破坏性变更	API 变更、数据库迁移、配置格式变化

过大提交的判断标准：

超过 5 个不相关的文件被修改
变更超过 300 行（不含自动生成文件）
同时包含功能变更和重构

如果提交过大，给出拆分建议，列出建议的拆分方式。

第三步：判断变更类型

按照 Conventional Commits 规范，从以下类型中选择：

类型	含义	示例场景
`feat`	新功能	添加用户注册接口
`fix`	Bug 修复	修复登录页面崩溃
`docs`	文档变更	更新 README
`style`	代码格式（不影响逻辑）	调整缩进、去掉多余空行
`refactor`	重构（不改功能不修 bug）	提取公共方法
`perf`	性能优化	添加数据库索引
`test`	测试相关	补充单元测试
`build`	构建系统或依赖	升级 webpack 版本
`ci`	CI/CD 配置	修改 GitHub Actions
`chore`	其他杂项	更新 .gitignore

第四步：生成 Commit Message

格式规范：

<type>(<scope>): <subject>

<body>

<footer>

各部分规则：

Header（必填）：

type：从上表选择，小写
scope：可选，变更涉及的模块名（如 auth、api、ui）
subject：简短描述，不超过 50 字符
- 使用祈使语气（"add" 而非 "added"）
- 首字母小写
- 末尾不加句号
- 中文项目可以用中文 subject

Body（可选，推荐）：

说明"为什么"做这个变更，而非"做了什么"
每行不超过 72 字符
与 header 空一行

Footer（特殊情况）：

破坏性变更：以 BREAKING CHANGE: 开头
关联 Issue：Closes #123 或 Refs #456

第五步：展示并确认

将生成的 commit message 展示给用户，格式如下：

📋 变更摘要：
- 修改了 3 个文件，新增 45 行，删除 12 行
- 主要变更：用户认证模块

📝 建议的 Commit Message：

feat(auth): add JWT token refresh mechanism

Implement automatic token refresh to prevent session expiration
during active use. Refresh triggers when token has less than
5 minutes remaining.

Closes #234

---
确认使用此消息提交？(Y/n)

不要自动执行 git commit，等待用户确认。

特殊情况处理

中英文混合项目

如果最近的 commit 是中文的，生成中文 message
如果最近的 commit 是英文的，生成英文 message
保持与项目已有风格一致

合并提交 (Merge Commit)

不处理 merge commit，提示用户使用默认的 merge message

空提交

如果暂存区没有变更，提示用户先 git add
列出当前未暂存的修改文件供参考

常见错误示例

# ❌ 类型不对
update: 修改了用户模块        # "update" 不是标准类型

# ❌ subject 太长
feat: 添加了用户注册功能包括邮箱验证手机验证以及第三方登录支持

# ❌ 描述"做了什么"而非"为什么"
fix: changed line 42 in auth.js

# ✅ 正确示例
feat(auth): add email verification for user registration

Enable email verification during signup to reduce fake accounts.
Users receive a 6-digit code valid for 15 minutes.

Closes #189

Más de este repositorio

mismo repositorio

cover-thumbnail

luzhenqian/ai-coding-lab

Use when producing the deliverables for a video episode — the cover thumbnail AND/OR the per-platform marketing copy (Bilibili / YouTube / 小红书 / 视频号 titles, descriptions, tags). Both live as a single "preset" in creative/cover-generator/. Locks the channel's visual + editorial style. Always edit via the React app (cover-generator), never hand-roll HTML or copy-paste-edit per-platform copy from scratch.

2026-05-02147

chinese-blog-writer

luzhenqian/ai-coding-lab

生成中文技术博客文章。当用户提到写博客、写文章、技术分享、写教程、写总结、博客草稿、内容创作、技术写作时使用此技能。

2026-03-26147

invoice-generator

luzhenqian/ai-coding-lab

从 Excel 时间表或手动输入生成专业发票。当用户提到生成发票、创建账单、invoice、billing、开发票、时间表转发票、账单生成时使用此技能。

2026-03-26147

name	commit-msg
description	分析 git diff 并生成规范的 Conventional Commit 消息。当用户提到提交代码、写 commit message、git commit、提交信息、代码提交规范时使用。
disable_model_invocation	true

Git Commit Message 规范化

概述

自动分析当前 git 暂存区的变更内容，生成符合 Conventional Commits 规范的 commit message。确保团队提交历史清晰、可追溯、可自动生成 changelog。

工作流程

digraph commit_flow {
    rankdir=TB;
    "用户调用 /commit-msg" [shape=doublecircle];
    "读取 git diff --staged" [shape=box];
    "有暂存变更？" [shape=diamond];
    "提示用户先 git add" [shape=box];
    "分析变更内容" [shape=box];
    "变更是否过大？" [shape=diamond];
    "建议拆分提交" [shape=box];
    "判断变更类型" [shape=box];
    "生成 commit message" [shape=box];
    "展示给用户确认" [shape=doublecircle];

    "用户调用 /commit-msg" -> "读取 git diff --staged";
    "读取 git diff --staged" -> "有暂存变更？";
    "有暂存变更？" -> "提示用户先 git add" [label="否"];
    "有暂存变更？" -> "分析变更内容" [label="是"];
    "分析变更内容" -> "变更是否过大？";
    "变更是否过大？" -> "建议拆分提交" [label="超过5个文件\n或300行"];
    "变更是否过大？" -> "判断变更类型" [label="合理范围"];
    "建议拆分提交" -> "判断变更类型";
    "判断变更类型" -> "生成 commit message";
    "生成 commit message" -> "展示给用户确认";
}

执行步骤

第一步：读取暂存区变更

运行以下命令收集信息：

# 查看暂存的文件列表
git diff --staged --name-status

# 查看暂存的具体变更
git diff --staged

# 查看最近 5 条 commit（参考风格）
git log --oneline -5

如果暂存区为空，提示用户先执行 git add，不要自动执行 git add。

第二步：分析变更内容

分析以下维度：

维度	关注点
变更范围	涉及哪些模块/目录
变更类型	新增功能、修复bug、重构、文档等
变更规模	文件数、行数是否合理
是否有破坏性变更	API 变更、数据库迁移、配置格式变化

过大提交的判断标准：

超过 5 个不相关的文件被修改
变更超过 300 行（不含自动生成文件）
同时包含功能变更和重构

如果提交过大，给出拆分建议，列出建议的拆分方式。

第三步：判断变更类型

按照 Conventional Commits 规范，从以下类型中选择：

类型	含义	示例场景
`feat`	新功能	添加用户注册接口
`fix`	Bug 修复	修复登录页面崩溃
`docs`	文档变更	更新 README
`style`	代码格式（不影响逻辑）	调整缩进、去掉多余空行
`refactor`	重构（不改功能不修 bug）	提取公共方法
`perf`	性能优化	添加数据库索引
`test`	测试相关	补充单元测试
`build`	构建系统或依赖	升级 webpack 版本
`ci`	CI/CD 配置	修改 GitHub Actions
`chore`	其他杂项	更新 .gitignore

第四步：生成 Commit Message

格式规范：

<type>(<scope>): <subject>

<body>

<footer>

各部分规则：

Header（必填）：

type：从上表选择，小写
scope：可选，变更涉及的模块名（如 auth、api、ui）
subject：简短描述，不超过 50 字符
- 使用祈使语气（"add" 而非 "added"）
- 首字母小写
- 末尾不加句号
- 中文项目可以用中文 subject

Body（可选，推荐）：

说明"为什么"做这个变更，而非"做了什么"
每行不超过 72 字符
与 header 空一行

Footer（特殊情况）：

破坏性变更：以 BREAKING CHANGE: 开头
关联 Issue：Closes #123 或 Refs #456

第五步：展示并确认

将生成的 commit message 展示给用户，格式如下：

📋 变更摘要：
- 修改了 3 个文件，新增 45 行，删除 12 行
- 主要变更：用户认证模块

📝 建议的 Commit Message：

feat(auth): add JWT token refresh mechanism

Implement automatic token refresh to prevent session expiration
during active use. Refresh triggers when token has less than
5 minutes remaining.

Closes #234

---
确认使用此消息提交？(Y/n)

不要自动执行 git commit，等待用户确认。

特殊情况处理

中英文混合项目

如果最近的 commit 是中文的，生成中文 message
如果最近的 commit 是英文的，生成英文 message
保持与项目已有风格一致

合并提交 (Merge Commit)

不处理 merge commit，提示用户使用默认的 merge message

空提交

如果暂存区没有变更，提示用户先 git add
列出当前未暂存的修改文件供参考

常见错误示例

# ❌ 类型不对
update: 修改了用户模块        # "update" 不是标准类型

# ❌ subject 太长
feat: 添加了用户注册功能包括邮箱验证手机验证以及第三方登录支持

# ❌ 描述"做了什么"而非"为什么"
fix: changed line 42 in auth.js

# ✅ 正确示例
feat(auth): add email verification for user registration

Enable email verification during signup to reduce fake accounts.
Users receive a 6-digit code valid for 15 minutes.

Closes #189