lispking/git-skills

🌿 Git 技能

一个强大的 Claude Code Git 助手技能，提供智能分支管理、提交信息规范、工作流协助和代码审查指导。

功能特性

| 功能 | 描述 |
|---------|-------------|
| 🌱 智能分支管理 | 自动建议分支命名规范，快速创建/切换/清理分支 |
| ✍️ 专家级提交助手 | 遵循 Conventional Commits 生成详细、专业的提交信息 |
| 🔄 PR 工作流助手 | PR 创建检查清单，自动同步主分支，冲突解决指导 |
| 🔍 代码审查助手 | 检查变更范围、敏感数据、提交信息质量 |
| 📊 Git 统计 | 贡献统计、提交历史、行变更指标 |

安装

在 Claude Code 中运行：

/plugin marketplace add lispking/git-skills
/plugin install git-skills

使用方法

自动触发

当检测到以下操作时，Git 技能会自动激活：
- git commit - 智能提交建议
- git push - 推送前检查
- git checkout -b - 分支命名建议
- git merge / git rebase - 冲突解决指导

命令调用

告诉 Claude 你想做什么：

帮我提交这些更改
为用户认证创建一个功能分支
将我的分支与主分支同步
显示最近的提交统计

提交规范

提交类型

| 类型 | 描述 | 示例 |
|------|-------------|---------|
| feat | 新功能 | feat: implement JWT-based user authentication |
| fix | Bug 修复 | fix: resolve race condition in concurrent database writes |
| docs | 文档 | docs: add comprehensive API usage examples |
| style | 代码风格 | style: enforce consistent import ordering across modules |
| refactor | 重构 | refactor: decouple business logic from presentation layer |
| test | 测试 | test: add integration tests for payment gateway |
| chore | 构建/工具 | chore: migrate build pipeline from CircleCI to GitHub Actions |
| perf | 性能 | perf: implement connection pooling for database queries |
| ci | CI/CD | ci: add automated security scanning to pipeline |

提交格式

():

专家级要求：
- 主题：具体、祈使语气、最多 50 个字符、无句号
- 正文：对于所有非琐碎的更改，必须使用多段落
- 第 1 段：解释更改了什么（WHAT）以及为什么（WHY）（动机）
- 第 2 段：关键实现细节、权衡取舍、破坏性变更
- 使用空行分隔段落
- 包含：问题背景、方案理由、副作用、破坏性变更
- 页脚：问题引用、破坏性变更通知
- 禁止 Co-Authored-By: 签名
- 禁止 AI 生成的签名
- 禁止 单句提交信息

分支命名规范

feature/123-user-auth      # 新功能
bugfix/456-fix-login       # Bug 修复
hotfix/urgent-patch        # 紧急修复
refactor/api-cleanup       # 代码重构
docs/readme-update         # 文档
test/auth-tests            # 测试相关

配置

在项目根目录创建 .gitskills.json：

{
"commit": {
"types": ["feat", "fix", "docs", "style", "refactor", "test", "chore"],
"scopes": ["api", "ui", "auth", "db"],
"requireScope": false,
"requireBody": true
},
"branch": {
"mainBranch": "main",
"namingPattern": "{type}/{ticket-id}-{description}"
}
}

项目结构

git-skills/
├── .claude-plugin/
│   ├── plugin.json       # 插件配置（支持 /plugin install）
│   └── marketplace.json  # 市场展示配置
├── skills/
│   └── git/
│       └── SKILL.md      # 技能核心文档（官方规范）
├── .gitskills.json       # 配置示例
└── README.md             # 用户文档

许可证

MIT 许可证

贡献

欢迎提交 Issue 和 PR！