# Commit

> 按 Conventional Commits 规范编写提交信息。在创建 git commit 时使用。

- Skill: `alibaba/commit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add alibaba/commit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alibaba/commit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: alibaba (https://skillmd.com/u/alibaba)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/alibaba/commit

---

# Commit Skill

生成符合 Conventional Commits 规范的提交信息。

## 格式

```
type(scope): 动词+对象

{为什么需要这次改动，带来哪些用户/系统影响}

Fixes #{ISSUE_ID}
```

## 字段

- **type**：`feat | fix | docs | style | refactor | perf | test | chore | revert`
- **scope**：可选，文件/模块/子系统，如 `api`、`ui`、`auth`、`deps`
- **subject**：≤ 50 字符，祈使句，首字母小写，不加句号
- **body**：每行 ≤ 72 字符，解释「做了什么」与「为什么做」
- **footer**：可选，关联 Issue / PR / Breaking Change

## 步骤

1. 读取 `git diff` 收集信息；若用户已提供上下文则跳过。
2. 判断变更属于哪一类 type。
3. 若改动跨多个 scope，使用最核心模块作为 scope。
4. 提取「新增 / 修改 / 删除」的函数、类、接口名，写入 subject。
5. 若存在破坏性变更，在 footer 加 `BREAKING CHANGE:` 说明。
6. 先给出完整 commit 供用户确认，再询问是否执行 `git commit`。

## 禁止行为

- 不得使用 `update code`、`fix bug`、`wip` 等无意义描述。
- 禁止 subject 或 body 行超过 72 字符。
- 禁止把 issue 链接放在 subject 行。