Caveman Commit

---
name: caveman-commit
description: >
  超精简 commit 消息产生器。砍掉 commit 消息里的噪音，保留意图与理由。
  Conventional Commits 格式。主旨 ≤50 字符，只有“为什么”不明显时才写 body。
  当用户说 "write a commit"、"commit message"、"generate commit"、
  "/commit"，或输入 /caveman-commit 时使用。暂存变更时自动触发。
---

Commit 消息写得精简且精确。Conventional Commits 格式。零废话。“为什么”比“做了什么”重要。

## 规则

**主旨行：**
- `<type>(<scope>): <祈使句摘要>` — `<scope>` 可省略
- 类型：`feat`、`fix`、`refactor`、`perf`、`docs`、`test`、`chore`、`build`、`ci`、`style`、`revert`
- 祈使语气："add"、"fix"、"remove" — 不是 "added"、"adds"、"adding"
- 尽量 ≤50 字符，硬上限 72
- 结尾不加句点
- 冒号后的大小写遵循项目惯例

**Body（有需要才写）：**
- 主旨已经自我说明时，整段省略
- 只在这些情况写 body：不明显的*为什么*、breaking change、迁移注意事项、关联的 issue
- 每行 72 字符换行
- 条列用 `-` 不用 `*`
- Issue／PR 引用放最后：`Closes #42`、`Refs #17`

**绝不写进去的东西：**
- "This commit does X"、"I"、"we"、"now"、"currently" — diff 已经说明做了什么
- "As requested by..." — 改用 Co-authored-by trailer
- "Generated with Claude Code" 或任何 AI 署名 — 除非用户自己的规则要求 `Assisted-by`／AI 署名 trailer，此时以 trailer 形式加上
- Emoji（除非项目惯例要求）
- scope 已经讲了文件名，就别再重复一次

## 范例

Diff：添加用户个人数据 endpoint，body 说明为什么
- ❌ "feat: add a new endpoint to get user profile information from the database"
- ✅
  ```
  feat(api): add GET /users/:id/profile

  Mobile client needs profile data without the full user payload
  to reduce LTE bandwidth on cold-launch screens.

  Closes #128
  ```

Diff：破坏性 API 变更
- ✅
  ```
  feat(api)!: rename /v1/orders to /v1/checkout

  BREAKING CHANGE: clients on /v1/orders must migrate to /v1/checkout
  before 2026-06-01. Old route returns 410 after that date.
  ```

## 自动切回清楚模式

以下情况一律写 body：breaking change、安全性修补、数据迁移、任何 revert 先前 commit 的变更。这些绝不压缩成只有主旨——未来的调试者需要脉络。

## 界线

只产生 commit 消息。不运行 `git commit`、不暂存盘案、不 amend。以代码区块输出消息，可直接粘贴。“stop caveman-commit”或“normal mode”：恢复为详细的 commit 风格。