ai-git-tools 2.0.78 → 2.0.80

package/README.md

@@ -14,6 +14,8 @@
 - **⚙️ 配置檔支援** - 靈活的配置選項，適應不同專案需求
 - **🌐 跨專案通用** - 可在任何 Git 專案中使用
 
+> 📊 想瞭解各命令的完整流程？請參考 [docs/flowchart.md](docs/flowchart.md)。
+
 ## 📦 安裝
 
 ### NPX 使用（推薦）

package/bin/cli.js

@@ -2,9 +2,8 @@
 
 /**
  * AI Git Tools CLI
- * 
+ *
  * AI-powered Git automation for commit messages and PR generation
- * 完全重寫版本基於 scripts/ 原始實現
  */
 
 import { Command } from 'commander';
@@ -15,6 +14,8 @@ import { commitCommand } from '../src/commands/commit.js';
 import { commitAllCommand } from '../src/commands/commit-all.js';
 import { prCommand } from '../src/commands/pr.js';
 import { initCommand } from '../src/commands/init.js';
+import { usageCommand } from '../src/commands/usage.js';
+import { registerCommand } from '../src/utils/cli-helpers.js';
 
 // 讀取 package.json 獲取版本號
 const __filename = fileURLToPath(import.meta.url);
@@ -31,70 +32,47 @@ program
   .version(packageJson.version);
 
 // Init 命令
-program
-  .command('init')
-  .description('初始化配置檔案 (.ai-git-config.mjs)')
-  .action(async (options) => {
-    try {
-      await initCommand(options);
-      process.exit(0);
-    } catch (error) {
-      process.exit(1);
-    }
-  });
+registerCommand(program, 'init', '初始化配置檔案 (.ai-git-config.mjs)', [], initCommand);
 
 // Commit 命令
-program
-  .command('commit')
-  .description('AI 自動生成 commit message 並提交')
-  .option('--model <model>', '指定 AI 模型')
-  .option('-v, --verbose', '顯示詳細輸出')
-  .option('--max-diff <number>', '最大 diff 長度')
-  .option('--max-retries <number>', '最大重試次數')
-  .action(async (options) => {
-    try {
-      await commitCommand(options);
-      process.exit(0);
-    } catch (error) {
-      process.exit(1);
-    }
-  });
+registerCommand(program, 'commit', 'AI 自動生成 commit message 並提交', [
+  { flags: '--model <model>', description: '指定 AI 模型' },
+  { flags: '-v, --verbose', description: '顯示詳細輸出' },
+  { flags: '--max-diff <number>', description: '最大 diff 長度' },
+  { flags: '--max-retries <number>', description: '最大重試次數' },
+], commitCommand);
 
 // Commit All 命令
-program
-  .command('commit-all')
-  .description('智慧分析所有變更並自動分組提交')
-  .option('--model <model>', '指定 AI 模型')
-  .option('-v, --verbose', '顯示詳細輸出')
-  .option('--max-diff <number>', '最大 diff 長度')
-  .option('--max-retries <number>', '最大重試次數')
-  .action(async (options) => {
-    try {
-      await commitAllCommand(options);
-      process.exit(0);
-    } catch (error) {
-      process.exit(1);
-    }
-  });
+registerCommand(program, 'commit-all', '智慧分析所有變更並自動分組提交', [
+  { flags: '--model <model>', description: '指定 AI 模型' },
+  { flags: '-v, --verbose', description: '顯示詳細輸出' },
+  { flags: '--max-diff <number>', description: '最大 diff 長度' },
+  { flags: '--max-retries <number>', description: '最大重試次數' },
+], commitAllCommand);
 
 // PR 命令
-program
-  .command('pr')
-  .description('AI 自動生成 PR 並創建 Pull Request')
-  .option('--base <branch>', '指定目標分支')
-  .option('--model <model>', '指定 AI 模型')
-  .option('--preview', '僅預覽 PR 內容，不實際創建')
-  .option('--no-confirm', '跳過確認直接創建')
-  .option('--auto-labels', '自動添加 Labels (預設啟用)')
-  .option('--include-impact', '在 PR 中包含影響範圍分析和注意事項 (預設關閉)')
-  .option('--force-new', '強制創建新 PR，不更新現有 PR')
-  .action(async (options) => {
-    try {
-      await prCommand(options);
-      process.exit(0);
-    } catch (error) {
-      process.exit(1);
-    }
-  });
+registerCommand(program, 'pr', 'AI 自動生成 PR 並創建 Pull Request', [
+  { flags: '--base <branch>', description: '指定目標分支' },
+  { flags: '--model <model>', description: '指定 AI 模型' },
+  { flags: '--preview', description: '僅預覽 PR 內容，不實際創建' },
+  { flags: '--no-confirm', description: '跳過確認直接創建' },
+  { flags: '--auto-labels', description: '自動添加 Labels (預設啟用)' },
+  { flags: '--include-impact', description: '在 PR 中包含影響範圍分析和注意事項 (預設關閉)' },
+  { flags: '--force-new', description: '強制創建新 PR，不更新現有 PR' },
+], prCommand);
+
+// Usage 命令
+registerCommand(program, 'usage', '查看組織 GitHub Copilot 使用狀態與用量', [
+  { flags: '--org <org>', description: '指定組織名稱（預設自動從 git remote 偵測）' },
+  { flags: '--from <date>', description: '開始日期，格式 YYYY-MM-DD（預設：本月第一天）' },
+  { flags: '--to <date>', description: '結束日期，格式 YYYY-MM-DD（預設：今天）' },
+  { flags: '--top <n>', description: '只顯示前 N 名用戶' },
+  { flags: '--sort <by>', description: '排序方式：credits（預設）| amount | name | activity' },
+  { flags: '--team <slug>', description: '只顯示指定團隊的成員' },
+  { flags: '--inactive', description: '同時顯示非活躍用戶' },
+  { flags: '--breakdown', description: '顯示每日使用量明細' },
+  { flags: '--export <file>', description: '匯出為 CSV 檔案（例如 usage.csv）' },
+  { flags: '--json', description: '以 JSON 格式輸出完整資料' },
+], usageCommand);
 
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-git-tools",
-  "version": "2.0.78",
+  "version": "2.0.80",
   "description": "AI-powered Git automation tools for commit messages and PR generation",
   "main": "src/index.js",
   "type": "module",

package/src/ai/prompts/commit-message.js

@@ -0,0 +1,42 @@
+/**
+ * Commit Message Prompt 生成
+ * 集中管理 commit message 的 AI prompt 與後處理
+ */
+
+import { getProjectTypePrompt } from '../../utils/helpers.js';
+
+/**
+ * 生成 commit message prompt
+ * @param {string} diff - git diff 內容
+ * @param {Object} config - 配置物件
+ * @returns {string}
+ */
+export function generateCommitMessagePrompt(diff, config = {}) {
+  const projectPrompt = getProjectTypePrompt();
+
+  return `${projectPrompt}
+
+請根據以下 git diff 產生一則 commit message。
+
+**Commit Message 規則**：
+1. 使用 Conventional Commits 格式：type(scope): subject
+2. type 必須是：feat/fix/docs/style/refactor/test/chore/perf 其中之一
+3. scope: 影響範圍（如 member、report、auth、api、ui、config）
+4. subject 限制在 50 字內，使用繁體中文
+5. 如果變更複雜，加上 body 說明（使用 bullet points）
+
+**重要**：
+- 直接輸出 commit message 純文字，不要使用 markdown 程式碼區塊（\`\`\`）
+- 不要加上任何前綴說明或後綴文字
+- 第一行是標題，如有需要可加上空行後的詳細說明
+
+**範例格式**：
+feat(member): 新增會員管理頁面
+
+- 實作會員列表查詢功能
+- 新增會員資料編輯表單
+- 整合 Zustand 狀態管理
+
+git diff:
+${diff}`;
+}

package/src/ai/prompts/pr-content.js

@@ -0,0 +1,151 @@
+/**
+ * PR Content Prompt 生成
+ * 集中管理 PR 標題、描述與影響分析的 AI prompt
+ */
+
+import { CONSTANTS } from '../../utils/constants.js';
+import { getSkillsSummaryForPrompt, PROJECT_SKILLS_CONTEXT } from '../../utils/project-skills.js';
+
+/**
+ * 生成 PR 內容 prompt
+ * @param {string} commits - commit 訊息
+ * @param {string} diff - 程式碼變更 diff
+ * @returns {string}
+ */
+export function generatePRContentPrompt(commits, diff) {
+  return `你是一個專業的前端工程師，熟悉 Next.js、React 效能優化和團隊開發規範。
+請根據以下 commit 訊息和程式碼變更，直接輸出一個清晰的 Pull Request 標題和描述。
+
+**重要原則**：
+- 只根據實際的 commit 訊息和 diff 內容描述變更，不要臆測或誇大
+- 如果 commit 中沒有提到「新增指令 / 新增 API / 新增組件」，請不要用這些詞
+- 文件（如 .github/copilot-instructions.md、prompt 檔案、README）應描述為「新增/更新文件」而非「新增指令」
+- 如果 OpenSpec prompt 被刪除並改為 OpsX prompt，請描述為「以 OpsX 取代 OpenSpec」，不要說「新增 OpenSpec prompt」
+- package.json 若只有版本號變更，請描述為「更新版本號」，不要說「更新相依」
+- 重構相關的改動請優先使用 refactor 類型
+
+**輸出格式**（不要加任何引導語，直接輸出以下內容）：
+
+# [type]: [PR 標題]
+
+> type 必須是以下之一：feat / fix / refactor / style / docs / test / chore / perf
+> **重要**：如果有新增任何功能、新增檔案、新增 API、新增組件，優先使用 **feat**
+
+## 📝 變更摘要
+[簡述這個 PR 的主要目的和影響範圍，2-3 句話]
+
+## 🎯 主要變更
+- [變更項目 1]
+- [變更項目 2]
+- [變更項目 3]
+
+## 🔀 變更類型
+- [ ] ✨ 新功能 (feat)
+- [ ] 🐛 Bug 修復 (fix)
+- [ ] ♻️ 重構 (refactor)
+- [ ] 💄 樣式調整 (style)
+- [ ] 📝 文件更新 (docs)
+- [ ] ⚡ 效能改進 (perf)
+- [ ] 🔧 其他 (chore)
+
+> 根據 diff 和 commit 自動勾選（可複選），[ ] 改為 [x]；有新增檔案或功能必勾 ✨ feat
+
+## 🧪 測試方法
+1. [具體的測試步驟 1]
+2. [具體的測試步驟 2]
+3. [具體的測試步驟 3]
+
+## 💥 Breaking Changes
+[如果有破壞性變更請詳細說明，沒有則填寫「無」]
+
+## 📌 注意事項
+[需要特別注意的事項]
+
+## 📸 截圖
+[如果是 UI 變更，提醒需要截圖]
+
+---
+
+## ⚠️ 風險與注意事項
+**Risk Level**: \`LOW\` / \`MEDIUM\` / \`HIGH\`
+
+[說明潛在風險、破壞性變更（breaking changes）、需要特別小心的地方；沒有則填「無」]
+
+## 👀 Reviewer 重點
+- [請 reviewer 特別關注的邏輯或設計決策 1]
+- [請 reviewer 特別關注的邏輯或設計決策 2]
+
+---
+
+**規則**：
+- 直接輸出 # [type]: [標題]，繁體中文（台灣正體）
+- type 必須符合 Conventional Commits；以 commit 內容為準，新增檔案/功能優先 feat，重構優先 refactor
+- 變更類型只勾選實際出現的類型，沒有 fix 類 commit 就不要勾 Bug 修復
+- Risk Level：HIGH=核心流程，MEDIUM=影響現有功能，LOW=新增或純重構
+- Reviewer 重點列 1-3 個值得仔細看的地方
+- 描述必須和 commit 訊息一致，禁止虛構功能或誇大影響範圍
+
+---
+
+**Commit 訊息**：
+${commits}
+
+**程式碼變更**：
+${diff}`;
+}
+
+/**
+ * 生成影響分析 prompt
+ * @param {string[]} changedFiles - 變更檔案列表
+ * @param {string} diff - 程式碼變更 diff
+ * @param {string} commits - commit 訊息
+ * @returns {string}
+ */
+export function generateImpactAnalysisPrompt(changedFiles, diff, commits) {
+  const skillsSummary = getSkillsSummaryForPrompt(PROJECT_SKILLS_CONTEXT);
+
+  return `你是一個資深的程式碼審查專家，精通 React/Next.js 效能優化與前端架構設計。
+請分析以下程式碼變更，提供專業的影響範圍分析與規範合規檢查。
+
+${skillsSummary}
+
+**變更檔案列表**：
+${changedFiles.slice(0, CONSTANTS.MAX_FILES_IN_PROMPT).join('\n')}
+${
+  changedFiles.length > CONSTANTS.MAX_FILES_IN_PROMPT
+    ? `... 還有 ${changedFiles.length - CONSTANTS.MAX_FILES_IN_PROMPT} 個檔案`
+    : ''
+}
+
+**Commit 訊息**：
+${commits.split('\n').slice(0, CONSTANTS.MAX_COMMITS_IN_PROMPT).join('\n')}
+
+**程式碼變更內容**：
+\`\`\`diff
+${diff.substring(0, CONSTANTS.MAX_DIFF_LENGTH)}
+${diff.length > CONSTANTS.MAX_DIFF_LENGTH ? '\n... (內容過長已截斷)' : ''}
+\`\`\`
+
+---
+
+請以 JSON 格式輸出分析結果（不要加任何其他文字，只輸出 JSON）：
+
+\`\`\`json
+{
+  "blastRadius": {
+    "modules": ["影響的模組1", "影響的模組2"],
+    "impacts": ["影響層面1", "影響層面2"],
+    "riskLevel": "低|中|高",
+    "riskReasons": ["風險原因1", "風險原因2"],
+    "externalBehaviors": ["對外行為變更說明"]
+  },
+  "warnings": [
+    {
+      "level": "⚠️|ℹ️",
+      "message": "問題描述",
+      "suggestion": "改善建議"
+    }
+  ]
+}
+\`\`\``;
+}

package/src/commands/commit-all.js

@@ -9,7 +9,7 @@ import { readFileSync, writeFileSync, unlinkSync } from 'fs';
 import { loadCommitConfig } from '../core/config-loader.js';
 import { AIClient } from '../core/ai-client.js';
 import { Logger } from '../utils/logger.js';
-import { handleError } from '../utils/helpers.js';
+import { handleError, isCopilotSubscriptionError } from '../utils/helpers.js';
 
 /**
  * 獲取檔案的變更內容
@@ -54,7 +54,7 @@ function getAllChanges() {
     }
 
     const changes = [];
-    const lines = status.split('\n').filter((line) => line.trim());
+    const lines = status.split('\n').filter(line => line.trim());
 
     for (const line of lines) {
       const statusCode = line.substring(0, 2);
@@ -184,8 +184,19 @@ ${changeSummary}
   try {
     return AIClient.parseJSON(response);
   } catch (error) {
-    console.error('❌ 無法解析 AI 回應:', error.message);
-    console.log('原始回應:', response);
+    // 區分不同類型的錯誤
+    if (isCopilotSubscriptionError(error)) {
+      console.error('\n🔑 看起來是 GitHub Copilot 授權問題');
+      console.error('\n解決方案:');
+      console.error('  1. 確認你的 GitHub 帳號已訂閱 GitHub Copilot');
+      console.error('  2. 驗證 VS Code 中使用的 GitHub 帳號是否有 Copilot 存取權限');
+      console.error('  3. 嘗試重新登入:');
+      console.error('     gh auth logout');
+      console.error('     gh auth login');
+    } else {
+      console.error('❌ 無法解析 AI 回應:', error.message);
+      console.log('原始回應:', response);
+    }
     return null;
   }
 }
@@ -197,7 +208,7 @@ async function generateCommitMessage(group, files, config) {
   // 每個檔案最多 2000 字元，避免單一群組內大量 diff 超出限制
   const MAX_DIFF_PER_FILE = 2000;
   const filesList = files
-    .map((file) => {
+    .map(file => {
       const diff = getFileDiff(file.filePath, file.isNew, file.isDeleted);
       const truncatedDiff =
         diff.length > MAX_DIFF_PER_FILE
@@ -295,7 +306,7 @@ async function commitGroup(group, files, config) {
 
       console.log(`\n   📝 Commit Message:`);
       console.log(`   ${'─'.repeat(50)}`);
-      commitMessage.split('\n').forEach((line) => {
+      commitMessage.split('\n').forEach(line => {
         console.log(`   ${line}`);
       });
       console.log(`   ${'─'.repeat(50)}`);
@@ -386,8 +397,8 @@ export async function commitAllCommand() {
 
     // 驗證所有檔案都被包含在分組中
     const groupedIndices = new Set();
-    groups.forEach((group) => {
-      group.file_indices.forEach((index) => {
+    groups.forEach(group => {
+      group.file_indices.forEach(index => {
         groupedIndices.add(index);
       });
     });
@@ -402,7 +413,7 @@ export async function commitAllCommand() {
     // 如果有檔案未被分組，創建一個 "其他變更" 群組
     if (ungroupedIndices.length > 0) {
       console.log(`\n⚠️  發現 ${ungroupedIndices.length} 個未分組的檔案，將自動歸類：`);
-      ungroupedIndices.forEach((index) => {
+      ungroupedIndices.forEach(index => {
         console.log(`   - ${changes[index].filePath}`);
       });
 
@@ -420,7 +431,7 @@ export async function commitAllCommand() {
       console.log(`   群組 ${index + 1}: ${group.group_name} (${group.commit_type})`);
       console.log(`   └─ 包含 ${group.file_indices.length} 個檔案`);
       if (config.output.verbose) {
-        group.file_indices.forEach((fileIndex) => {
+        group.file_indices.forEach(fileIndex => {
           console.log(`      - [${fileIndex}] ${changes[fileIndex].filePath}`);
         });
       }
@@ -434,10 +445,10 @@ export async function commitAllCommand() {
     let successCount = 0;
     for (let i = 0; i < groups.length; i++) {
       const group = groups[i];
-      const groupFiles = group.file_indices.map((index) => changes[index]);
+      const groupFiles = group.file_indices.map(index => changes[index]);
 
       // 驗證檔案索引是否有效
-      const invalidIndices = group.file_indices.filter((idx) => idx >= changes.length);
+      const invalidIndices = group.file_indices.filter(idx => idx >= changes.length);
       if (invalidIndices.length > 0) {
         console.error(`\n❌ 群組 ${i + 1} 包含無效的檔案索引:`, invalidIndices);
         console.log(`   跳過此群組: ${group.group_name}`);

package/src/commands/commit.js

@@ -1,6 +1,5 @@
 /**
  * Commit 命令
- * 基於 scripts/ai-auto-commit.mjs
  * 自動產生 commit message 並執行 commit
  */
 
@@ -9,129 +8,119 @@ import { loadCommitConfig } from '../core/config-loader.js';
 import { GitOperations } from '../core/git-operations.js';
 import { AIClient } from '../core/ai-client.js';
 import { Logger } from '../utils/logger.js';
-import { cleanCommitMessage, validateCommitMessage, handleError, getProjectTypePrompt } from '../utils/helpers.js';
+import {
+  cleanCommitMessage,
+  validateCommitMessage,
+  isCopilotSubscriptionError,
+} from '../utils/helpers.js';
+import { generateCommitMessagePrompt } from '../ai/prompts/commit-message.js';
 
 export async function commitCommand() {
   const logger = new Logger();
 
-  try {
-    // 載入配置
-    const config = await loadCommitConfig();
+  // 載入配置
+  const config = await loadCommitConfig();
 
-    if (config.output.verbose) {
-      console.log('📋 使用配置：');
-      console.log(`   AI Model: ${config.ai.model}`);
-      console.log(`   Max Diff Length: ${config.ai.maxDiffLength}`);
-      console.log('');
-    }
+  if (config.output.verbose) {
+    console.log('📋 使用配置：');
+    console.log(`   AI Model: ${config.ai.model}`);
+    console.log(`   Max Diff Length: ${config.ai.maxDiffLength}`);
+    console.log('');
+  }
 
-    // 檢查是否有 staged 變更
-    const diff = GitOperations.getStagedDiff();
+  // 檢查是否有 staged 變更
+  const diff = GitOperations.getStagedDiff();
 
-    if (!diff.trim()) {
-      logger.error('沒有 staged 的變更');
-      console.log('💡 請先使用 git add 來 stage 你的變更');
-      throw new Error('沒有 staged 的變更');
-    }
+  if (!diff.trim()) {
+    logger.error('沒有 staged 的變更');
+    console.log('💡 請先使用 git add 來 stage 你的變更');
+    throw new Error('沒有 staged 的變更');
+  }
 
-    logger.step('正在分析變更內容...\n');
+  logger.step('正在分析變更內容...\n');
 
-    // 截斷過長的 diff
-    const truncatedDiff =
-      diff.length > config.ai.maxDiffLength
-        ? diff.substring(0, config.ai.maxDiffLength) + '\n\n... [diff 過長已截斷]'
-        : diff;
+  // 截斷過長的 diff
+  const truncatedDiff =
+    diff.length > config.ai.maxDiffLength
+      ? diff.substring(0, config.ai.maxDiffLength) + '\n\n... [diff 過長已截斷]'
+      : diff;
 
-    if (config.output.verbose && diff.length > config.ai.maxDiffLength) {
-      logger.warning(`Diff 已從 ${diff.length} 字元截斷至 ${config.ai.maxDiffLength} 字元\n`);
-    }
+  if (config.output.verbose && diff.length > config.ai.maxDiffLength) {
+    logger.warning(`Diff 已從 ${diff.length} 字元截斷至 ${config.ai.maxDiffLength} 字元\n`);
+  }
+
+  // 使用 AI 產生 commit message
+  let commitMessage = '';
+  let lastError = null;
 
-    // 使用 AI 產生 commit message
-    let commitMessage = '';
-    let lastError = null;
-
-    for (let attempt = 1; attempt <= config.ai.maxRetries; attempt++) {
-      try {
-        if (config.output.verbose && attempt > 1) {
-          console.log(`🔄 重試第 ${attempt}/${config.ai.maxRetries} 次...\n`);
-        }
-
-        const prompt = `${getProjectTypePrompt()}
-
-請根據以下 git diff 產生一則 commit message。
-
-**Commit Message 規則**：
-1. 使用 Conventional Commits 格式：type(scope): subject
-2. type 必須是：feat/fix/docs/style/refactor/test/chore/perf 其中之一
-3. scope: 影響範圍（如 member、report、auth、api、ui、config）
-4. subject 限制在 50 字內，使用繁體中文
-5. 如果變更複雜，加上 body 說明（使用 bullet points）
-
-**重要**：
-- 直接輸出 commit message 純文字，不要使用 markdown 程式碼區塊（\`\`\`）
-- 不要加上任何前綴說明或後綴文字
-- 第一行是標題，如有需要可加上空行後的詳細說明
-
-**範例格式**：
-feat(member): 新增會員管理頁面
-
-- 實作會員列表查詢功能
-- 新增會員資料編輯表單
-- 整合 Zustand 狀態管理
-
-git diff:
-${truncatedDiff}`;
-
-        const response = await AIClient.sendAndWait(prompt, config.ai.model);
-        commitMessage = cleanCommitMessage(response);
-
-        // 驗證 commit message
-        const validation = validateCommitMessage(commitMessage);
-        if (!validation.valid) {
-          throw new Error(`無效的 commit message: ${validation.reason}`);
-        }
-
-        // 成功產生，跳出重試迴圈
-        break;
-      } catch (error) {
-        lastError = error;
-        if (config.output.verbose) {
-          logger.warning(`嘗試 ${attempt} 失敗: ${error.message}\n`);
-        }
-
-        if (attempt < config.ai.maxRetries) {
-          continue;
-        }
+  for (let attempt = 1; attempt <= config.ai.maxRetries; attempt++) {
+    try {
+      if (config.output.verbose && attempt > 1) {
+        console.log(`🔄 重試第 ${attempt}/${config.ai.maxRetries} 次...\n`);
+      }
+
+      const prompt = generateCommitMessagePrompt(truncatedDiff, config);
+
+      const response = await AIClient.sendAndWait(prompt, config.ai.model);
+      commitMessage = cleanCommitMessage(response);
+
+      // 驗證 commit message
+      const validation = validateCommitMessage(commitMessage);
+      if (!validation.valid) {
+        throw new Error(`無效的 commit message: ${validation.reason}`);
+      }
+
+      // 成功產生，跳出重試迴圈
+      break;
+    } catch (error) {
+      lastError = error;
+      if (config.output.verbose) {
+        logger.warning(`嘗試 ${attempt} 失敗: ${error.message}\n`);
+      }
+
+      if (attempt < config.ai.maxRetries) {
+        continue;
       }
     }
+  }
 
-    // 所有重試都失敗
-    if (!commitMessage) {
-      logger.error('無法產生有效的 commit message');
-      if (lastError && config.output.verbose) {
+  // 所有重試都失敗
+  if (!commitMessage) {
+    logger.error('無法產生有效的 commit message');
+
+    // 區分不同類型的錯誤
+    if (isCopilotSubscriptionError(lastError)) {
+      console.log('\n🔑 看起來是 GitHub Copilot 授權問題\n');
+      console.log('解決方案:');
+      console.log('  1. 確認你的 GitHub 帳號已訂閱 GitHub Copilot');
+      console.log('  2. 驗證 VS Code 中使用的 GitHub 帳號是否有 Copilot 訪問權限');
+      console.log('  3. 嘗試重新登入:');
+      console.log('     gh auth logout');
+      console.log('     gh auth login');
+      console.log('  4. 若是公司帳號，確保使用公司的 GitHub 帳號登入');
+    } else {
+      if (config.output.verbose && lastError) {
         console.log(`   最後錯誤: ${lastError.message}`);
       }
       console.log('\n💡 建議：');
       console.log('   1. 檢查網路連線');
       console.log('   2. 嘗試更換 AI 模型（使用 --model 參數）');
       console.log('   3. 確認變更內容不會太複雜或太大');
-      throw new Error('無法產生有效的 commit message');
     }
 
-    logger.success('產生的 Commit Message:');
-    logger.separator('─', 60);
-    console.log(commitMessage);
-    logger.separator('─', 60);
-
-    // 執行 commit
-    logger.step('\n正在執行 commit...');
-    execSync(`git commit -m "${commitMessage.replace(/"/g, '\\"')}"`, {
-      stdio: 'inherit',
-    });
-
-    logger.success('Commit 完成！\n');
-  } catch (error) {
-    handleError(error);
-    throw error;
+    throw new Error('無法產生有效的 commit message');
   }
+
+  logger.success('產生的 Commit Message:');
+  logger.separator('─', 60);
+  console.log(commitMessage);
+  logger.separator('─', 60);
+
+  // 執行 commit
+  logger.step('\n正在執行 commit...');
+  execSync(`git commit -m "${commitMessage.replace(/"/g, '\\"')}"`, {
+    stdio: 'inherit',
+  });
+
+  logger.success('Commit 完成！\n');
 }