Commit Message Assistant | Commit Message 助手

Generate well-formatted commit messages following the Conventional Commits standard.

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

Workflow | 工作流程

Detect language - Read .standards/manifest.json → check options.commit_language. If not found, default to english.
Check status - Run git status and git diff --staged to understand changes
Analyze changes - Determine the type (feat, fix, refactor, etc.) and scope
Generate message - Create a commit message following the format for the detected language (see below)
Confirm and commit - Ask user to confirm before executing git commit

Message Format | 訊息格式

<type>(<scope>): <subject>

<body>

<footer>

Commit Types | 提交類型

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

Rules | 規則

Subject: imperative mood, no period, first letter capitalized, ≤ 72 characters
Body: explain WHY the change was made, not just what changed
Footer: use BREAKING CHANGE: for breaking changes, Fixes #123 for issue refs

Bilingual Format | 雙語格式

When commit_language is bilingual, you MUST use this format:

<type>(<scope>): <English subject>. <中文主旨>.

<English body — explain what and why in English>

<中文本文 — 用中文說明做了什麼及為什麼>

<footer>

MUST Rules | 必須遵守的規則

English body comes FIRST, Chinese body comes SECOND
Separate English and Chinese body with a blank line
NEVER mix languages within the same paragraph
NEVER omit the Chinese body — both languages are required
Footer (BREAKING CHANGE, Fixes #, Co-authored-by) goes LAST after both bodies

Bilingual Example | 雙語範例

feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援.

Implement Google OAuth2 authentication flow for user login.

- Add Google OAuth2 SDK integration
- Create callback endpoint for OAuth flow
- Store refresh tokens securely

實作 Google OAuth2 認證流程供使用者登入。

- 整合 Google OAuth2 SDK
- 建立 OAuth 流程回呼端點
- 安全儲存更新權杖

Closes #123

Traditional Chinese Format | 繁體中文格式

When commit_language is traditional-chinese, use Chinese types and body:

功能(認證): 新增 OAuth2 Google 登入支援

實作 Google OAuth2 認證流程供使用者登入。

關閉 #123

Usage | 使用方式

/commit - Auto-analyze staged changes and suggest commit message
/commit fix login bug - Generate message based on provided description

Next Steps Guidance | 下一步引導

After /commit completes, the AI assistant should suggest:

提交完成。建議下一步 / Commit complete. Suggested next steps:

執行 /changelog 更新變更日誌 — Update the changelog

執行 git push 推送到遠端 — Push to remote

執行 /release（若準備發布）— Start release process (if ready)

發現重複模式或規範摩擦 → 執行 /audit --report 回報 — Patterns or friction detected → Run /audit --report to submit feedback

Reference | 參考

Detailed guide: guide.md
Core standard: commit-message-guide.md