Git Commit Writer Skill Skill 技能

技能简介

Git Commit Writer Skill（Git 提交写作技能）由 JustHandledLabs 开发，是一款专为 AI 编程助手设计的 Git 提交信息生成工具。该技能通过检查暂存区的文件状态和变更内容，自动推荐符合 Conventional Commits 规范的提交信息，包括类型（feat、fix、refactor 等）、作用范围（scope）和简洁的主题行，并能够识别潜在的破坏性变更（breaking changes），是团队规范 Git 提交信息的实用辅助工具。

核心能力

1. 暂存区检查：通过 git status --short 检查当前文件暂存状态
2. 变更统计：通过 git diff --cached --stat 获取暂存区文件的影响范围
3. 差异分析：通过 git diff --cached 读取暂存区的完整变更内容
4. 规范推荐：根据变更意图推荐符合 Conventional Commits 的类型和作用范围
5. 破坏性变更检测：分析 diff 内容识别公共 API 或 schema 变更，自动建议 breaking commit 标记
6. 多格式输出：支持推荐一条主消息和一条备选消息

安装配置

1. 安装命令：执行 npx skillstore add justhandledlabs/git-commit-writer-free 完成技能安装
2. 环境要求：需要 AI 编程助手能访问本地 Git 仓库，并具有执行 git 命令的能力
3. 依赖条件：需有已暂存的变更（git add 之后使用），技能不支持未暂存的变更

使用步骤

1. 暂存变更：使用 git add 命令将要提交的文件加入暂存区
2. 调用技能：向 AI 编程助手发送「Write a conventional commit message for my staged changes」
3. 审阅推荐：AI 分析暂存区的 diff 内容，推荐类型、作用范围和主题行
4. 应用提交：审阅通过后使用 git commit 命令完成提交

适用场景

1. 规范团队提交历史：确保团队所有成员的提交信息符合统一格式，方便 Code Review 和版本管理
2. AI 辅助编程流程：AI 编程助手生成代码后，自动生成规范的提交信息，减少人工操作
3. 破坏性变更标注：识别公共 API 的破坏性变更，在提交信息中自动添加 BREAKING CHANGE 标记
4. 多人协作审查：在 Pull Request 审查时，快速了解提交内容是否符合规范
5. 提交信息审计：定期检查历史提交是否符合团队规范

适用人群

• 重视提交信息规范、希望 AI 辅助生成规范 commit message 的开发团队
• 使用 Conventional Commits 规范并需要自动校验的个人开发者
• 需要在 AI 编程流程中保持 Git 提交规范性的 AI Code Assistant 用户

工作原理

技能通过以下步骤生成规范提交信息：

1. 暂存区状态检查：运行 git status --short 确认已暂存的文件列表
2. 影响范围统计：运行 git diff --cached --stat 获取各文件增减行数
3. 变更内容分析：读取 git diff --cached 的完整内容，理解具体改动了什么
4. 类型推荐决策：根据变更内容匹配 feat（新增功能）、fix（修复 bug）、refactor（重构）等类型
5. 范围和主题生成：识别变更所属模块，生成简洁的主题行描述
6. 破坏性变更评估：检查是否存在公共接口、配置文件或 schema 的破坏性修改

官方链接

技能页面：https://skillstore.io/skills/justhandledlabs-git-commit-writer-free GitHub 仓库：https://github.com/justhandledlabs/skills