ai-git-tools 2.0.6 → 2.0.8

package/package.json

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

package/src/commands/pr.js

@@ -1,684 +1,30 @@
 /**
- * PR 命令
- * 基於 scripts/ai-auto-pr.mjs 簡化版
- * 產生 PR 標題、描述並建立 Pull Request
+ * PR 命令 - 完整複製自 scripts/ai-auto-pr.mjs
+ * 
+ * 使用 scripts/ai-pr-modules 的完整邏輯
+ * 確保功能與 scripts 版本完全相同
  */
 
-import { execSync } from 'child_process';
-import * as readline from 'readline/promises';
-import { stdin as input, stdout as output } from 'process';
-import { loadPRConfig } 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 { handleError, getProjectTypePrompt } from '../utils/helpers.js';
+import { PRWorkflow } from '../../scripts/ai-pr-modules/core/workflow.mjs';
+import { loadConfig } from '../../scripts/ai-pr-modules/core/config-loader.mjs';
+import { handleError } from '../../scripts/ai-pr-modules/utils/helpers.mjs';
+import { Logger } from '../../scripts/ai-pr-modules/ui/logger.mjs';
 
 /**
- * 根據 Git History 找出最常修改這些檔案的人
- */
-function getReviewersByGitHistory(changedFiles, config) {
-  const contributors = {};
-  const maxFiles = Math.min(changedFiles.length, 10); // 最多分析 10 個檔案
-
-  changedFiles.slice(0, maxFiles).forEach((file) => {
-    try {
-      const logOutput = execSync(
-        `git log -${config.reviewers.gitHistoryDepth} --format="%ae|%an" -- "${file}"`,
-        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
-      );
-
-      logOutput
-        .split('\n')
-        .filter(Boolean)
-        .forEach((line) => {
-          const [email, name] = line.split('|');
-          if (email && email.includes('@')) {
-            // 檢查是否在排除列表中
-            const shouldExclude = config.reviewers.excludeAuthors.some((excluded) => {
-              const normalizedExcluded = excluded.toLowerCase();
-              return (
-                email.toLowerCase().includes(normalizedExcluded) ||
-                (name && name.toLowerCase().includes(normalizedExcluded))
-              );
-            });
-
-            if (!shouldExclude) {
-              const key = email.toLowerCase();
-              contributors[key] = {
-                email,
-                name: name || email.split('@')[0],
-                username: email.split('@')[0],
-                commits: (contributors[key]?.commits || 0) + 1,
-              };
-            }
-          }
-        });
-    } catch (error) {
-      // 忽略單個檔案的錯誤
-    }
-  });
-
-  // 排序並取前 N 名
-  return Object.values(contributors)
-    .sort((a, b) => b.commits - a.commits)
-    .slice(0, config.reviewers.maxSuggested);
-}
-
-/**
- * 獲取當前 Git 使用者
- */
-function getCurrentUser() {
-  try {
-    const email = execSync('git config user.email', { encoding: 'utf-8' }).trim();
-    const name = execSync('git config user.name', { encoding: 'utf-8' }).trim();
-    return { email, name, username: email.split('@')[0] };
-  } catch (error) {
-    return null;
-  }
-}
-
-/**
- * 互動式選擇 Reviewers
- */
-async function selectReviewers(suggestedReviewers, currentUser) {
-  const logger = new Logger();
-  
-  console.log('\n' + '═'.repeat(80));
-  console.log('🎯 選擇 Reviewers');
-  console.log('═'.repeat(80) + '\n');
-
-  // 過濾掉當前使用者
-  const validReviewers = suggestedReviewers.filter(
-    (r) => !currentUser || r.email.toLowerCase() !== currentUser.email.toLowerCase()
-  );
-
-  if (validReviewers.length === 0) {
-    logger.warning('沒有找到建議的 reviewers');
-    console.log('💡 您可以在創建 PR 後手動添加 reviewers\n');
-    return [];
-  }
-
-  // 顯示建議的 Reviewers
-  console.log('💡 建議的 Reviewers（基於 Git 歷史）:\n');
-  validReviewers.forEach((reviewer, idx) => {
-    console.log(
-      `   ${idx + 1}. ${reviewer.name} (@${reviewer.username}) - ${reviewer.commits} commits`
-    );
-  });
-  console.log('');
-
-  const rl = readline.createInterface({ input, output });
-
-  try {
-    const answer = await rl.question(
-      '請輸入要選擇的 reviewer 編號（用逗號分隔，例如: 1,2,3），或直接按 Enter 跳過: '
-    );
-    rl.close();
-
-    if (!answer.trim()) {
-      logger.info('已跳過 reviewer 選擇\n');
-      return [];
-    }
-
-    const selectedIndices = answer
-      .split(',')
-      .map((s) => parseInt(s.trim()) - 1)
-      .filter((i) => i >= 0 && i < validReviewers.length);
-
-    const selectedReviewers = selectedIndices.map((i) => validReviewers[i].username);
-
-    if (selectedReviewers.length > 0) {
-      logger.success(`已選擇: ${selectedReviewers.map((u) => `@${u}`).join(', ')}\n`);
-    }
-
-    return selectedReviewers;
-  } catch (error) {
-    rl.close();
-    logger.warning('選擇過程發生錯誤，將跳過 reviewer 選擇\n');
-    return [];
-  }
-}
-
-/**
- * 分析影響範圍
- */
-async function analyzeImpact(changedFiles, diff, commits, config) {
-  const logger = new Logger();
-  logger.step('正在分析影響範圍和風險...');
-
-  const truncatedDiff = GitOperations.truncateDiff(diff, config.ai.maxDiffLength);
-  const fileList = changedFiles.slice(0, 30).join('\n');
-
-  const prompt = `你是一個資深的程式碼審查專家，精通 React/Next.js 效能優化與前端架構設計。
-請分析以下程式碼變更，提供專業的影響範圍分析。
-
-${getProjectTypePrompt()}
-
-**變更檔案列表**：
-${fileList}
-${changedFiles.length > 30 ? `\n... 還有 ${changedFiles.length - 30} 個檔案` : ''}
-
-**Commit 訊息**：
-${commits.split('\n').slice(0, 10).join('\n')}
-
-**程式碼變更**：
-\`\`\`diff
-${truncatedDiff}
-\`\`\`
-
-請以 JSON 格式輸出分析結果：
-
-\`\`\`json
-{
-  "blastRadius": {
-    "modules": ["影響的模組1", "影響的模組2"],
-    "impacts": ["影響層面1", "影響層面2"],
-    "riskLevel": "低|中|高",
-    "riskReasons": ["風險原因1"],
-    "externalBehaviors": ["對外行為變更說明"]
-  },
-  "warnings": [
-    {
-      "level": "⚠️|ℹ️",
-      "message": "問題描述",
-      "suggestion": "改善建議"
-    }
-  ]
-}
-\`\`\`
-
-**分析重點**：
-1. 影響範圍：識別實際影響的模組和層面（API、資料庫、UI、效能等）
-2. 風險評估：評估風險等級並說明原因
-3. 規範檢查：檢查安全風險、效能問題、最佳實踐
-
-請只輸出有效的 JSON。`;
-
-  try {
-    const response = await AIClient.sendAndWait(prompt, config.ai.model);
-    const analysisResult = AIClient.parseJSON(response);
-
-    const blastRadius = {
-      modules: analysisResult.blastRadius?.modules || [],
-      impacts: analysisResult.blastRadius?.impacts || [],
-      riskLevel: analysisResult.blastRadius?.riskLevel || '低',
-      riskReasons: analysisResult.blastRadius?.riskReasons || [],
-      externalBehaviors: analysisResult.blastRadius?.externalBehaviors || [],
-    };
-
-    const warnings = analysisResult.warnings || [];
-
-    logger.success('影響範圍分析完成\n');
-    return { blastRadius, warnings };
-  } catch (error) {
-    logger.warning('使用基礎分析...\n');
-    return getFallbackAnalysis(changedFiles);
-  }
-}
-
-/**
- * 降級方案：基礎分析
- */
-function getFallbackAnalysis(changedFiles) {
-  const modules = [];
-  const impacts = [];
-  let riskLevel = '低';
-  const riskReasons = [];
-
-  changedFiles.forEach((file) => {
-    const lower = file.toLowerCase();
-    if (lower.includes('/api/')) {
-      if (!impacts.includes('API 層')) impacts.push('API 層');
-      if (!modules.includes('API 服務')) modules.push('API 服務');
-    }
-    if (lower.includes('/components/') || lower.includes('/pages/')) {
-      if (!impacts.includes('使用者介面')) impacts.push('使用者介面');
-      if (!modules.includes('前端元件')) modules.push('前端元件');
-    }
-    if (lower.includes('db') || lower.includes('migration') || lower.includes('schema')) {
-      if (!impacts.includes('資料庫')) impacts.push('資料庫');
-      riskLevel = '高';
-      riskReasons.push('涉及資料庫結構變更');
-    }
-  });
-
-  const warnings = [];
-  const hasTestFiles = changedFiles.some((f) => f.includes('test') || f.includes('spec'));
-  if (!hasTestFiles && changedFiles.length > 3) {
-    warnings.push({
-      level: '⚠️',
-      message: '未包含測試檔案',
-      suggestion: '建議新增測試確保程式碼品質',
-    });
-  }
-
-  return {
-    blastRadius: { modules, impacts, riskLevel, riskReasons, externalBehaviors: [] },
-    warnings,
-  };
-}
-
-/**
- * 生成 PR 內容
- */
-async function generatePRContent(baseBranch, headBranch, config) {
-  const logger = new Logger();
-  logger.step('AI 正在生成 PR 內容...');
-
-  // 獲取 diff 和 commits
-  const diff = GitOperations.getDiff(baseBranch, headBranch);
-  const commits = GitOperations.getCommits(baseBranch, headBranch);
-  const truncatedDiff = GitOperations.truncateDiff(diff, config.ai.maxDiffLength);
-
-  const prompt = `${getProjectTypePrompt()}
-
-請根據以下 commit 訊息和程式碼變更，生成清晰的 Pull Request 標題和描述。
-
-**Commits 列表**：
-${commits}
-
-**Git Diff**：
-${truncatedDiff}
-
-**輸出格式**（JSON）：
-{
-  "title": "[type]: PR 標題（type 為 feat/fix/refactor/perf/docs/style/test/chore 之一，繁體中文，50 字內）",
-  "description": "PR 描述（Markdown 格式，繁體中文）"
-}
-
-**PR 描述必須包含**：
-
-## 📝 變更摘要
-[簡述這個 PR 的主要目的和影響範圍，2-3 句話]
-
-## 🎯 主要變更
-- [變更項目 1]
-- [變更項目 2]
-- [變更項目 3]
-
-## 🔀 變更類型
-- [ ] ✨ 新功能 (feat)
-- [ ] 🐛 Bug 修復 (fix)
-- [ ] ♻️ 重構 (refactor)
-- [ ] 💄 樣式調整 (style)
-- [ ] 📝 文件更新 (docs)
-- [ ] ⚡ 效能改進 (perf)
-- [ ] 🔧 其他 (chore)
-
-## 🧪 測試方法
-1. [具體的測試步驟 1]
-2. [具體的測試步驟 2]
-
-## 💥 Breaking Changes
-[如果有破壞性變更請詳細說明，沒有則填寫「無」]
-
-## 📌 注意事項
-[需要特別注意的事項，沒有則填寫「無」]
-
-**規則**：
-1. 標題格式：type: 簡短描述（不超過 50 字）
-2. 全部使用繁體中文
-3. 只輸出 JSON，不要其他文字
-`;
-
-  const response = await AIClient.sendAndWait(prompt, config.ai.model);
-
-  try {
-    const prContent = AIClient.parseJSON(response);
-    logger.success('PR 內容生成完成\n');
-    return prContent;
-  } catch (error) {
-    throw new Error(`無法解析 AI 回應: ${error.message}`);
-  }
-}
-
-/**
- * 分析 Labels
- */
-function analyzeLabels(prData) {
-  const labels = new Set();
-
-  // 根據 commit type
-  const typeLabels = {
-    feat: 'feature',
-    fix: 'bug',
-    refactor: 'refactor',
-    perf: 'performance',
-    docs: 'documentation',
-    test: 'testing',
-    style: 'style',
-    chore: 'chore',
-  };
-
-  const titleMatch = prData.title.match(/^(\w+):/);
-  if (titleMatch) {
-    const type = titleMatch[1];
-    if (typeLabels[type]) {
-      labels.add(typeLabels[type]);
-    }
-  }
-
-  // 根據影響範圍
-  if (prData.blastRadius) {
-    if (prData.blastRadius.impacts.includes('API 層')) {
-      labels.add('api-change');
-    }
-    if (prData.blastRadius.impacts.includes('資料庫')) {
-      labels.add('database');
-    }
-    if (prData.blastRadius.impacts.includes('使用者介面')) {
-      labels.add('ui');
-    }
-
-    // 根據風險等級
-    if (prData.blastRadius.riskLevel === '高') {
-      labels.add('high-risk');
-      labels.add('needs-careful-review');
-    } else if (prData.blastRadius.riskLevel === '中') {
-      labels.add('medium-risk');
-    }
-  }
-
-  // 根據變更規模
-  if (prData.stats) {
-    if (prData.stats.filesChanged > 20) {
-      labels.add('large-change');
-    }
-  }
-
-  // 根據警告
-  if (prData.warnings && prData.warnings.length > 0) {
-    labels.add('has-warnings');
-  }
-
-  return Array.from(labels);
-}
-
-/**
- * 應用 Labels
- */
-function applyLabels(prUrl, labels) {
-  if (!labels || labels.length === 0) return;
-
-  const logger = new Logger();
-  logger.info(`正在添加 ${labels.length} 個 Labels...`);
-
-  // 從 PR URL 提取 PR 號碼
-  const prNumberMatch = prUrl.match(/\/pull\/(\d+)/);
-  if (!prNumberMatch) return;
-
-  const prNumber = prNumberMatch[1];
-  const requestBody = JSON.stringify({ labels });
-
-  try {
-    execSync(
-      `printf '%s' '${requestBody.replace(
-        /'/g,
-        "'\\''"
-      )}' | gh api repos/:owner/:repo/issues/${prNumber}/labels --input - -X POST`,
-      { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
-    );
-    logger.success(`成功添加 Labels: ${labels.join(', ')}\n`);
-  } catch (error) {
-    logger.warning('無法自動添加 Labels，請手動操作\n');
-  }
-}
-
-/**
- * 附加影響分析到 PR body
- */
-function appendAnalysisToBody(body, blastRadius, warnings) {
-  let enhancedBody = body;
-
-  // 添加影響範圍
-  enhancedBody += '\n\n---\n\n## 💥 影響範圍分析\n\n';
-
-  if (blastRadius.modules.length > 0) {
-    enhancedBody += `**影響模組**：${blastRadius.modules.join('、')}\n\n`;
-  }
-
-  if (blastRadius.impacts.length > 0) {
-    enhancedBody += `**影響層面**：${blastRadius.impacts.join('、')}\n\n`;
-  }
-
-  const riskEmojiMap = { 高: '🔴', 中: '🟡', 低: '🟢' };
-  const riskEmoji = riskEmojiMap[blastRadius.riskLevel] || '🟢';
-  enhancedBody += `**風險等級**：${riskEmoji} ${blastRadius.riskLevel}\n\n`;
-
-  if (blastRadius.riskReasons && blastRadius.riskReasons.length > 0) {
-    enhancedBody += `**風險因素**：\n`;
-    blastRadius.riskReasons.forEach((reason) => {
-      enhancedBody += `- ${reason}\n`;
-    });
-    enhancedBody += '\n';
-  }
-
-  if (blastRadius.externalBehaviors && blastRadius.externalBehaviors.length > 0) {
-    enhancedBody += `**對外行為變更**：\n`;
-    blastRadius.externalBehaviors.forEach((behavior) => {
-      enhancedBody += `- ${behavior}\n`;
-    });
-    enhancedBody += '\n';
-  }
-
-  // 添加規範警告
-  if (warnings.length > 0) {
-    enhancedBody += '\n## ⚠️ 注意事項\n\n';
-    warnings.forEach((warning) => {
-      enhancedBody += `${warning.level} **${warning.message}**\n`;
-      if (warning.suggestion) {
-        enhancedBody += `  - 💡 ${warning.suggestion}\n`;
-      }
-      enhancedBody += '\n';
-    });
-  }
-
-  return enhancedBody;
-}
-
-/**
- * 顯示 PR 預覽
- */
-function displayPreview(prData, stats) {
-  console.log('\n' + '═'.repeat(80));
-  console.log('📋 PR 預覽');
-  console.log('═'.repeat(80));
-  console.log(`\n標題: ${prData.title}\n`);
-  console.log(`統計: ${stats.stats}`);
-  console.log(`檔案數: ${stats.filesChanged} 個檔案\n`);
-
-  // 顯示影響範圍
-  if (prData.blastRadius) {
-    const { blastRadius } = prData;
-    console.log('─'.repeat(80));
-    console.log('💥 影響範圍:\n');
-    if (blastRadius.modules.length > 0) {
-      console.log(`   模組: ${blastRadius.modules.join('、')}`);
-    }
-    if (blastRadius.impacts.length > 0) {
-      console.log(`   層面: ${blastRadius.impacts.join('、')}`);
-    }
-    const riskEmojiMap = { 高: '🔴', 中: '🟡', 低: '🟢' };
-    const riskEmoji = riskEmojiMap[blastRadius.riskLevel] || '🟢';
-    console.log(`   風險: ${riskEmoji} ${blastRadius.riskLevel}`);
-  }
-
-  // 顯示 Labels
-  if (prData.labels && prData.labels.length > 0) {
-    console.log(`\n🏷️  Labels: ${prData.labels.join(', ')}`);
-  }
-
-  console.log('\n' + '─'.repeat(80));
-  console.log('描述:\n');
-  console.log(prData.description);
-  console.log('\n' + '═'.repeat(80) + '\n');
-}
-
-/**
- * PR 命令主函數
+ * PR 命令主函數（完全照抄 scripts/ai-auto-pr.mjs）
  */
 export async function prCommand() {
   const logger = new Logger();
 
   try {
-    logger.header('AI Auto PR Generator');
-
-    // 載入配置
-    const config = await loadPRConfig();
-
-    if (config.output.verbose) {
-      console.log('📋 使用配置：');
-      console.log(`   AI Model: ${config.ai.model}`);
-      console.log(`   Max Diff Length: ${config.ai.maxDiffLength}`);
-      console.log('');
-    }
-
-    // 獲取當前分支
-    const currentBranch = GitOperations.getCurrentBranch();
-    let headBranch = config.headBranch || currentBranch;
-    let baseBranch = config.baseBranch;
-
-    // 自動偵測 base branch
-    if (!baseBranch) {
-      logger.step('正在偵測 release 分支...\n');
-      const latestRelease = GitOperations.findLatestReleaseBranch();
-
-      if (latestRelease) {
-        baseBranch = latestRelease;
-        logger.success(`自動選擇目標分支: ${baseBranch}\n`);
-      } else {
-        logger.error('未偵測到任何 release 分支');
-        console.log('💡 使用 --base 參數指定目標分支');
-        process.exit(1);
-      }
-    }
-
-    // 檢查是否在 base branch
-    if (currentBranch === baseBranch) {
-      logger.error(`你目前在 ${baseBranch} 分支，請切換到 feature 分支`);
-      console.log('💡 切換到 feature 分支: git checkout <feature-branch>');
-      process.exit(1);
-    }
-
-    console.log('\n📌 分支資訊:');
-    console.log(`   Base: ${baseBranch}`);
-    console.log(`   Head: ${headBranch}\n`);
-
-    // 推送到遠端（預覽模式跳過）
-    if (!config.preview) {
-      logger.step(`推送到遠端分支: origin/${headBranch}`);
-      GitOperations.push(headBranch);
-      logger.success('推送成功\n');
-
-      // 等待 GitHub 同步
-      logger.info('等待 GitHub 同步...');
-      await new Promise(resolve => setTimeout(resolve, 2000));
-      GitOperations.fetch();
-      logger.success('同步完成\n');
-    }
-
-    // 獲取變更統計和檔案列表
-    const stats = GitOperations.getChangeStats(baseBranch, headBranch);
-    const changedFiles = GitOperations.getChangedFiles(baseBranch, headBranch);
-    console.log(`📈 變更統計: ${stats.stats}`);
-    console.log(`📁 影響檔案: ${stats.filesChanged} 個\n`);
-
-    // 1. 分析影響範圍
-    const diff = GitOperations.getDiff(baseBranch, headBranch);
-    const commits = GitOperations.getCommits(baseBranch, headBranch);
-    const { blastRadius, warnings } = await analyzeImpact(changedFiles, diff, commits, config);
-
-    // 2. 生成 PR 內容
-    const prContent = await generatePRContent(baseBranch, headBranch, config);
-
-    // 3. 附加影響分析到 PR body
-    const enhancedDescription = appendAnalysisToBody(
-      prContent.description,
-      blastRadius,
-      warnings
-    );
-
-    // 4. 分析 Labels
-    const labels = analyzeLabels({
-      title: prContent.title,
-      blastRadius,
-      warnings,
-      stats,
-    });
-
-    const prData = {
-      title: prContent.title,
-      description: enhancedDescription,
-      blastRadius,
-      warnings,
-      labels,
-    };
-
-    // 顯示預覽
-    displayPreview(prData, stats);
-
-    // 預覽模式：僅顯示不創建
-    if (config.preview) {
-      logger.info('預覽模式：未創建 PR');
-      return;
-    }
-
-    // 5. Reviewer 選擇（如果啟用）
-    let selectedReviewers = [];
-    if (config.reviewers.autoSelect) {
-      const currentUser = getCurrentUser();
-      const suggestedReviewers = getReviewersByGitHistory(changedFiles, config);
-      
-      if (suggestedReviewers.length > 0) {
-        selectedReviewers = await selectReviewers(suggestedReviewers, currentUser);
-      } else {
-        logger.info('未找到建議的 reviewers（可能是新專案或檔案無歷史記錄）\n');
-      }
-    }
-
-    // 創建 PR（使用 GitHub CLI）
-    logger.step('創建 Pull Request...');
-
-    // 準備 PR body
-    const prBody = prData.description;
-
-    // 構建 gh pr create 命令
-    let ghCommand = `gh pr create --base ${baseBranch} --head ${headBranch} --title "${prData.title.replace(/"/g, '\\"')}"`;
-
-    // 將 body 寫入臨時檔案
-    const { writeFileSync, unlinkSync } = await import('fs');
-    const tmpFile = '/tmp/pr-body-temp.md';
-    writeFileSync(tmpFile, prBody, 'utf-8');
-    ghCommand += ` --body-file ${tmpFile}`;
-
-    if (config.draft) {
-      ghCommand += ' --draft';
-    }
-
-    // 添加 reviewers
-    if (selectedReviewers.length > 0) {
-      ghCommand += ` --reviewer ${selectedReviewers.join(',')}`;
-    }
-
-    try {
-      const result = execSync(ghCommand, { encoding: 'utf-8' });
-      unlinkSync(tmpFile);
+    logger.header('AI Auto PR Generator (v2.0 Enhanced)');
 
-      logger.success('PR 創建成功！\n');
-      console.log(result);
+    // 載入配置（使用 scripts/ 的配置載入邏輯）
+    const config = await loadConfig();
 
-      // 應用 Labels（如果啟用）
-      if (config.github.autoLabels && labels.length > 0) {
-        applyLabels(result, labels);
-      }
-    } catch (error) {
-      try {
-        unlinkSync(tmpFile);
-      } catch (e) {
-        // 忽略
-      }
-      throw new Error(`創建 PR 失敗: ${error.message}`);
-    }
+    // 執行工作流程（使用 scripts/ 的完整工作流）
+    const workflow = new PRWorkflow(config);
+    await workflow.execute();
   } catch (error) {
     handleError(error);
     process.exit(1);

package/src/core/github-api.js

@@ -0,0 +1,161 @@
+/**
+ * GitHub API 操作封裝
+ * 基於 scripts/ai-pr-modules/core/github-api.mjs
+ */
+
+import { execSync } from 'child_process';
+import { Logger } from '../utils/logger.js';
+
+/**
+ * GitHub API 操作類
+ */
+export class GitHubAPI {
+  constructor(config = {}) {
+    this.orgName = config.orgName || 'kingsinfo-project';
+  }
+
+  /**
+   * 檢查 GitHub CLI 認證狀態
+   */
+  checkAuth() {
+    try {
+      const authStatus = execSync('gh auth status 2>&1', {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+
+      return {
+        authenticated: authStatus.includes('Logged in'),
+        details: authStatus,
+      };
+    } catch (error) {
+      return {
+        authenticated: false,
+        details: error.message,
+      };
+    }
+  }
+
+  /**
+   * 從 GitHub 抓取組織的成員列表
+   */
+  async fetchOrgMembers(orgName = this.orgName) {
+    const logger = new Logger();
+    
+    try {
+      logger.step(`正在嘗試抓取 ${orgName} 組織的成員列表...`);
+
+      const membersJson = execSync(`gh api orgs/${orgName}/members --jq '.'`, {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+
+      const membersData = JSON.parse(membersJson);
+      const members = membersData.map((member) => ({
+        login: member.login,
+        name: member.name || member.login,
+      }));
+
+      if (members.length > 0) {
+        logger.success(`成功抓取 ${members.length} 位組織成員\n`);
+        return members;
+      }
+
+      return [];
+    } catch (error) {
+      return [];
+    }
+  }
+
+  /**
+   * 從 GitHub 抓取組織的團隊列表
+   */
+  async fetchTeams(orgName = this.orgName) {
+    const logger = new Logger();
+    
+    try {
+      // 先檢查認證狀態
+      const authStatus = this.checkAuth();
+      if (!authStatus.authenticated) {
+        logger.warning('GitHub CLI 未認證');
+        logger.info('請執行: gh auth login\n');
+        return { teams: {}, members: [] };
+      }
+
+      logger.step(`正在從 GitHub 抓取 ${orgName} 的團隊資訊...`);
+
+      let teamsJson;
+      try {
+        teamsJson = execSync(`gh api orgs/${orgName}/teams --jq '.'`, {
+          encoding: 'utf-8',
+          stdio: ['pipe', 'pipe', 'pipe'],
+        });
+      } catch (error) {
+        // 無法存取團隊 API，使用替代方案
+        logger.warning('未找到任何團隊，嘗試直接抓取組織成員...');
+
+        const members = await this.fetchOrgMembers(orgName);
+        if (members.length > 0) {
+          return { teams: {}, members };
+        }
+
+        throw error;
+      }
+
+      const teams = JSON.parse(teamsJson);
+
+      if (!teams || teams.length === 0) {
+        logger.warning('未找到任何團隊，嘗試直接抓取組織成員...');
+        const members = await this.fetchOrgMembers(orgName);
+        return { teams: {}, members };
+      }
+
+      const teamData = {};
+
+      for (const team of teams) {
+        try {
+          const membersJson = execSync(
+            `gh api orgs/${orgName}/teams/${team.slug}/members --jq '.'`,
+            {
+              encoding: 'utf-8',
+              stdio: ['pipe', 'pipe', 'pipe'],
+            }
+          );
+
+          const members = JSON.parse(membersJson);
+          teamData[team.slug] = {
+            name: team.name,
+            slug: team.slug,
+            description: team.description || '',
+            members: members.map((m) => ({
+              login: m.login,
+              name: m.name || m.login,
+            })),
+          };
+        } catch (error) {
+          logger.warning(`無法抓取團隊 ${team.slug} 的成員: ${error.message}`);
+        }
+      }
+
+      // 同時取得所有成員作為備選
+      const allMembers = await this.fetchOrgMembers(orgName);
+
+      logger.success(
+        `成功抓取 ${Object.keys(teamData).length} 個團隊和 ${allMembers.length} 位成員\n`
+      );
+      return { teams: teamData, members: allMembers };
+    } catch (error) {
+      logger.warning('無法從 GitHub 抓取資訊');
+      logger.info('請確認：');
+      console.log('  1. 已安裝 GitHub CLI: brew install gh');
+      console.log('  2. 已執行認證: gh auth login');
+      console.log('  3. 選擇正確的認證範圍（需要 read:org 權限）');
+      console.log(`  4. 有權限存取 ${orgName} 組織`);
+      console.log('  5. 組織名稱正確（可用 --org 參數指定）\n');
+
+      logger.info('提示: 你仍可以在創建 PR 後手動添加 reviewers\n');
+
+      return { teams: {}, members: [] };
+    }
+  }
+}

package/src/utils/interactive-select.js

@@ -0,0 +1,154 @@
+/**
+ * 互動式選擇工具（使用方向鍵和空白鍵）
+ * 基於 scripts/ai-pr-modules/ui/interactive-select.mjs
+ */
+
+import { emitKeypressEvents } from 'readline';
+
+// ANSI 顏色碼
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  magenta: '\x1b[35m',
+  blue: '\x1b[34m',
+};
+
+// 游標控制
+const cursor = {
+  hide: '\x1b[?25l',
+  show: '\x1b[?25h',
+  up: (n = 1) => `\x1b[${n}A`,
+  clearLine: '\x1b[2K',
+};
+
+/**
+ * 互動式選擇器
+ */
+export class InteractiveSelect {
+  /**
+   * @param {Array} options - 選項陣列
+   * @param {string} title - 標題
+   * @returns {Promise<{cancelled: boolean, selected: Array}>}
+   */
+  async select(options, title = '選擇項目') {
+    return new Promise((resolve) => {
+      let currentIndex = 0;
+      const selected = new Set();
+
+      // 準備選項列表
+      const items = options.map((opt, idx) => ({
+        ...opt,
+        index: idx,
+      }));
+
+      const render = () => {
+        // 清除整個選擇區域
+        if (items.length > 0) {
+          // 向上移動到開始位置
+          for (let i = 0; i < items.length + 3; i++) {
+            process.stdout.write(cursor.up(1));
+          }
+        }
+
+        // 清除並重新繪製每一行
+        process.stdout.write(cursor.clearLine);
+        console.log(`${colors.bright}${title}${colors.reset}`);
+
+        process.stdout.write(cursor.clearLine);
+        console.log(
+          `${colors.yellow}↑/↓: 移動  Space: 選擇/取消  Enter: 確認  q: 跳過${colors.reset}`
+        );
+
+        process.stdout.write(cursor.clearLine);
+        console.log('');
+
+        items.forEach((item, idx) => {
+          const isSelected = selected.has(idx);
+          const isCurrent = idx === currentIndex;
+
+          const checkbox = isSelected ? `${colors.green}[✓]${colors.reset}` : '[ ]';
+          const cursorMarker = isCurrent ? `${colors.cyan}▶${colors.reset}` : ' ';
+          const label = item.label || item.name || item.login;
+          const extra = item.extra || '';
+
+          process.stdout.write(cursor.clearLine);
+          console.log(`${cursorMarker} ${checkbox} ${label}${extra}`);
+        });
+      };
+
+      const cleanup = () => {
+        process.stdin.setRawMode(false);
+        process.stdin.removeAllListeners('keypress');
+        process.stdout.write(cursor.show);
+        console.log('');
+      };
+
+      const handleKeypress = (str, key) => {
+        if (!key) return;
+
+        // q or Ctrl+C to quit
+        if (key.name === 'q' || (key.ctrl && key.name === 'c')) {
+          cleanup();
+          resolve({ cancelled: true, selected: [] });
+          return;
+        }
+
+        // Arrow up
+        if (key.name === 'up') {
+          currentIndex = Math.max(0, currentIndex - 1);
+          render();
+        }
+
+        // Arrow down
+        else if (key.name === 'down') {
+          currentIndex = Math.min(items.length - 1, currentIndex + 1);
+          render();
+        }
+
+        // Space to toggle selection
+        else if (key.name === 'space') {
+          if (selected.has(currentIndex)) {
+            selected.delete(currentIndex);
+          } else {
+            selected.add(currentIndex);
+          }
+          render();
+        }
+
+        // Enter to confirm
+        else if (key.name === 'return') {
+          cleanup();
+          const selectedItems = Array.from(selected).map((idx) => items[idx]);
+          resolve({ cancelled: false, selected: selectedItems });
+        }
+      };
+
+      // 初始化
+      process.stdout.write(cursor.hide);
+
+      // 先印出佔位用的空行
+      for (let i = 0; i < items.length + 3; i++) {
+        console.log('');
+      }
+
+      render();
+
+      // 啟用 raw mode 和 keypress
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+
+        // 需要監聽 keypress 事件
+        emitKeypressEvents(process.stdin);
+
+        process.stdin.on('keypress', handleKeypress);
+      } else {
+        cleanup();
+        resolve({ cancelled: true, selected: [] });
+      }
+    });
+  }
+}