메뉴
掃描 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，必須逐一列出檔案路徑。