Commit Standards

---
source: ../../../../skills/commit-standards/SKILL.md
source_version: 1.0.0
translation_version: 1.0.0
last_synced: 2026-02-10
status: current
description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 commit message"
name: commit
allowed-tools: Read, Grep, Bash(git status:*), Bash(git diff:*), Bash(git log:*), Bash(git add:*), Bash(git commit:*)
scope: universal
argument-hint: "[description of changes | 變更描述]"
disable-model-invocation: true
---

# Commit Message 助手

> **語言**: [English](../../../../skills/commit-standards/SKILL.md) | 繁體中文

根據 staged 的變更，產生符合 Conventional Commits 格式的 commit message。

## 工作流程

1. **檢查狀態** - 執行 `git status` 和 `git diff --staged` 了解變更內容
2. **分析變更** - 判斷類型（feat、fix、refactor 等）和範圍
3. **產生訊息** - 根據以下格式建立 commit message
4. **確認並提交** - 在執行 `git commit` 前詢問使用者確認

### 訊息格式

```
<type>(<scope>): <subject>
<body>
<footer>
```

## 提交類型

| 類型 | 使用時機 | When to Use |
|------|---------|-------------|
| `feat` | 新功能 | New feature |
| `fix` | 修復錯誤 | Bug fix |
| `refactor` | 重構（無功能變更） | Code refactoring |
| `docs` | 文件更新 | Documentation |
| `style` | 格式調整（無邏輯變更） | Formatting |
| `test` | 測試相關 | Tests |
| `perf` | 效能優化 | Performance |
| `chore` | 維護任務 | Maintenance |

## 規則

- **Subject**：祈使語氣、不加句號、首字母大寫、不超過 72 字元
- **Body**：說明**為什麼**進行變更，而非僅描述變更了什麼
- **Footer**：使用 `BREAKING CHANGE:` 標記破壞性變更，使用 `Fixes #123` 關聯 issue

## 使用方式

- `/commit` - 自動分析 staged 的變更並建議 commit message
- `/commit fix login bug` - 根據提供的描述產生訊息

## 下一步引導

`/commit` 完成後，AI 助手應建議：

> **提交完成。建議下一步：**
> - 執行 `git push` 推送到遠端
> - 準備發布時 → 執行 `/changelog` + `/release`
> - 發現重複模式或規範摩擦 → 執行 `/audit --report` 回報

## 參考

- 詳細指南：[guide.md](./guide.md)
- 核心規範：[commit-message-guide.md](../../../../core/commit-message-guide.md)