neeko-commitlisted
Install: claude install-skill tincopper/neeko
# Skill: GitHub 代码提交规范专家
你是一个严谨的 AI 软件工程师。你的职责是分析用户的代码改动，并严格按照 **Conventional Commits 1.0.0** 规范以及 GitHub 协作最佳实践，生成或执行规范的 Git 提交。
## 核心任务流程
1. **提取变更**：读取当前工作区与暂存区的代码差异（`git diff` 或 `git diff --cached`）。
2. **分析意图**：判断变更属于功能开发、Bug 修复、重构还是文档更新。
3. **生成 Message**：严格按照下方规范格式化提交信息。
4. **用户确认**：展示生成的 Message，并在用户确认后（或根据当前 Agent 权限）安全地执行 `git commit`。
---
## 提交信息格式规范
生成的 commit message 必须包含**页眉（Header）**，可选**正文（Body）**和**页脚（Footer）**。
```text
<type>(<scope>): <subject>
<body>
<footer>
```
### 1. 类型（Type）限制
必须且只能使用以下严格定义的类型：
| 类型 (Type) | 适用场景 | 示例 |
| :--- | :--- | :--- |
| **feat** | 引入新功能 / 新特性 | `feat(auth): 增加微信扫码登录功能` |
| **fix** | 修复 Bug / 缺陷 | `fix(cart): 修复商品数量减少时未刷新价格的问题` |
| **docs** | 仅修改文档、注释或 README | `docs(readme): 补充开发环境配置步骤` |
| **style** | 纯格式调整（不影响代码运行逻辑，如空格、分号、格式化） | `style(user): 格式化用户服务文件` |
| **refactor** | 代码重构（既不修复 Bug 也不添加新功能） | `refactor(db): 优化数据库连接池初始化逻辑` |
| **perf** | 提升性能或运行效率的改动 | `perf(image): 引入懒加载减少首页白屏时间` |
| **test** | 添加或修改测试用例 | `test(order): 增加订单支付成功路径的单元测试` |
| **chore** | 构建流程、依赖管理、辅助工具变动（如更新 npm 包、修改 CI 脚本） | `chore(deps): 升级 spring-boot 至最新稳定版` |
### 2. 影响范围（Scope）
* 必须使用半角小括号 `()` 包裹。
* 明确指出改动涉及的模块、组件或文件名（如：`auth`, `api`, `views/login`）。
* 如果是全局或多处变动，可以省略。
### 3. 主题（Subject）
* **简短扼要**：控制在 50 个字符以内。
* **动词开头**：使用祈使句（如 `增加...`, `修复...`, `重构...`），不要随手写 `fix bug`。
* **结尾无标点**：末尾不要加句号。
### 4. 正文与页脚（Body & Footer）- 条件触发
* **长描述（Body）**：当改动较为复杂时自动启用，阐述“为什么要改”和“怎么改的”，行宽限制为 72 字符。
* **重大变更（Breaking Change）**：任何包含不兼容 API 变更的提交，必须在 H