القائمة
掃描 repo 中所有已變動的檔案，依照功能/類別自動分組，為每個分組產生詳細的 commit message（支援語言參數，預設英文）。產出後強制暫停等待使用者確認，使用者確認指定批次後才依序執行 git add + commit，絕對嚴格禁止自動 push。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
針對由其他 AI 完結的任務，進行至少三次以上的重複檢查。嚴格驗證所有內容是否符合原始需求、測試檔與文件是否已完整更新，並確保所有測試檔已通過執行測試。適用於任務交接或交付前的品質把關。
接收使用者指定要歸檔的文件或資料夾，優先依 templates/8-Archived 規範完成搬移與 summary 建立。適用於使用者要求指定來源後直接歸檔，完成 summary 就停下等待下一步指令的情境。
不經 Spec，直接建立 Plan 文件到 2-Plans。預設不自動跨階段，並支援可用數字回答的固定問答流程。
先建立 Plan 文件並等待使用者確認；確認後自動從 Plan 推進到 Progressing、Testing、Done、Archived。適用於需要先看 plan 再連續執行後續階段的情境。
不經 Plan 拆解，直接建立 Spec 文件到 1-Specs。預設不自動跨階段，並支援可用數字回答的固定問答流程。
依 templates 規範建立 Spec，確認後拆解成 Plans。完成拆解後立即停止等待後續指令。支援可用數字回答的固定問答流程。
| name | git-smart-batch-commit |
| description | 掃描 repo 中所有已變動的檔案，依照功能/類別自動分組，為每個分組產生詳細的 commit message（支援語言參數，預設英文）。產出後強制暫停等待使用者確認，使用者確認指定批次後才依序執行 git add + commit，絕對嚴格禁止自動 push。 |
| version | 1.1.0 |
| last_updated | "2026-05-01T00:00:00.000Z" |
| effective_date | "2026-05-01T00:00:00.000Z" |
本文件中提到的 templates/、scripts/、skills/，皆以目前語系內容根目錄為相對基準（例如 zh-TW/），不綁定 repo 根目錄固定路徑。
當同一個 repo 一次混入了多個不同功能的修改，自動將變動檔案依類別分組，為每組產生獨立、詳細的 commit message（語言由參數決定，預設英文），並在使用者明確確認後才逐批執行 git add + commit。
觸發（無參數）：$git-smart-batch-commit
觸發（含路徑）：$git-smart-batch-commit /path/to/repo
觸發（含路徑 + 語言）：$git-smart-batch-commit /path/to/repo zh
觸發（全域，僅語言）：$git-smart-batch-commit . 中文
語言切換（關鍵字方式）：若需求中包含 中文commit、zh、tw commit，亦可觸發語言切換（優先級低於明確參數）。
AI 產出分組與 commit message 後：強制暫停，等待使用者確認。
使用者確認後輸入例如：
現在我同意你，依序依照批次，git add and git commit，先完成 1 and 2
AI 才依序執行指定的批次。
zh、en、日文），若未指定且無關鍵字則預設英文。明確語言參數優先級高於關鍵字偵測，支援以下輸入形式：
| 輸入值（不分大小寫） | 對應語言 | 說明 |
|---|---|---|
zh、zh-tw、tw、中文、繁體中文、chinese | 繁體中文（台灣用語） | |
zh-cn、cn、简体中文、簡體中文 | 簡體中文 | |
en、english、英文、英語 | 英文 | 預設值 |
jp、ja、japanese、日文、日語、日本語 | 日文 | |
ko、korean、韓文、韓語 | 韓文 | |
| 其他未知值 | 視為英文（預設） | 並輸出警告提示 |
語言優先級順序（由高到低）：
中文commit、zh、tw commit 等）執行 git status --porcelain（限定於指定路徑範圍，若無指定則為 repo 根目錄），取得所有已變動的檔案清單。
對每一個變動檔案，執行 git diff HEAD -- <file> 或 git diff --cached -- <file>（視檔案狀態而定），讀取實際修改內容（diff）。
依照修改內容與路徑語意，將所有檔案分組，分組原則如下：
src/auth/、src/ui/、.github/）[需確認]。輸出分組結果，格式如下：
=== 變動檔案分組結果 ===
【批次 1】<功能簡述>
- path/to/file1.ts
- path/to/file2.ts
【批次 2】<功能簡述>
- path/to/file3.ts
...（依此類推）
針對每個批次，依照批次內檔案的實際 diff 內容，產生一段詳細且完整的 commit message（語言依上述語言參數與優先級決定）。
commit message 格式必須遵循 Conventional Commits：
<type>(<scope>): <subject>
<body>
<footer>
type：feat、fix、refactor、chore、docs、test、style、ci 等body：至少包含主要修改目的、重要行為變更、涉及檔案與影響面footer：若已知對應 task 文件，必須標註 task 檔名；若未知則省略輸出所有批次的 commit message，格式如下：
=== Commit Message 草稿 ===
【批次 1】
feat(auth): implement token refresh logic
- Add automatic token refresh in AuthService
- Handle 401 responses globally in HTTP interceptor
- Affected files: src/auth/auth.service.ts, src/interceptors/http.interceptor.ts
Task: [plan-XXXXX]-auth-token-refresh.md
---
【批次 2】
...
輸出完所有分組與 commit message 後，必須立即停止，絕對不可自動執行任何 git 操作。
輸出以下等待確認提示：
✅ 已完成分組與 commit message 草稿。
請確認以上內容是否正確：
- 如需調整分組或 commit message，請告知。
- 若確認無誤，請告訴我要執行哪些批次，例如：
「現在我同意你，依序依照批次，git add and git commit，先完成 1 and 2」
⚠️ 在收到你的明確確認前，我不會執行任何 git 操作。
收到使用者確認訊息後，只執行使用者明確指定的批次編號，其餘批次繼續等待。
對每個指定批次，依序執行：
git add <file1> <file2> ...（僅限該批次的檔案，絕對禁止使用 git add .、git add -A、git add --all）git diff --staged --name-only，確認 staged 檔案與該批次完全一致，無多餘檔案。-m 參數分段傳入，例如：
git commit -m "<type>(<scope>): <subject>" -m "<body>" -m "<footer>"
每個批次 commit 完成後，立即回報結果，格式如下：
✅ 批次 1 已完成 commit。
Commit hash: <hash>
Files committed: file1.ts, file2.ts
全部指定批次完成後，若仍有未執行的批次，提示使用者：
⏸ 批次 3、4 尚未執行，請告訴我是否繼續。
⛔ 以下規則為最高優先級，任何情況下均不得違反。
git push，無論使用者是否要求，無論任何理由，絕無例外。git add 或 git commit。git add .、git add -A、git add --all，必須逐一列出檔案路徑。