ai-git-tools 2.0.8 → 2.0.9

package/package.json

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

package/src/commands/pr.js

@@ -1,14 +1,14 @@
 /**
  * PR 命令 - 完整複製自 scripts/ai-auto-pr.mjs
  * 
- * 使用 scripts/ai-pr-modules 的完整邏輯
+ * 使用 pr-modules 的完整邏輯（從 scripts/ai-pr-modules 複製）
  * 確保功能與 scripts 版本完全相同
  */
 
-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';
+import { PRWorkflow } from '../pr-modules/core/workflow.js';
+import { loadConfig } from '../pr-modules/core/config-loader.js';
+import { handleError } from '../pr-modules/utils/helpers.js';
+import { Logger } from '../pr-modules/ui/logger.js';
 
 /**
  * PR 命令主函數（完全照抄 scripts/ai-auto-pr.mjs）

package/src/pr-modules/ai/code-analyzer.js

@@ -0,0 +1,387 @@
+import { CopilotClient } from '@github/copilot-sdk';
+import { CONSTANTS, PROJECT_SKILLS_CONTEXT } from '../utils/constants.js';
+import { getSkillsSummaryForPrompt, log } from '../utils/helpers.js';
+
+/**
+ * AI 分析器 - 負責程式碼分析和 PR 內容生成
+ */
+export class AIAnalyzer {
+  constructor(config = {}) {
+    this.model = config.model || 'gpt-4.1';
+  }
+
+  /**
+   * 建立 AI 客戶端
+   */
+  async createClient() {
+    const client = new CopilotClient();
+    const session = await client.createSession({ model: this.model });
+    return { client, session };
+  }
+
+  /**
+   * 生成 PR 內容
+   */
+  async generatePRContent(commits, diff) {
+    const skillsSummary = getSkillsSummaryForPrompt(PROJECT_SKILLS_CONTEXT);
+    const prompt = this.buildPRPrompt(commits, diff, skillsSummary);
+
+    const { client, session } = await this.createClient();
+
+    try {
+      const response = await session.sendAndWait({ prompt });
+      const prContent = response?.data.content?.trim() || '';
+
+      await client.stop();
+
+      if (!prContent) {
+        throw new Error('AI 未能生成 PR 內容');
+      }
+
+      return this.parsePRContent(prContent);
+    } catch (error) {
+      await client.stop();
+      throw error;
+    }
+  }
+
+  /**
+   * 分析程式碼影響範圍
+   */
+  async analyzeImpact(changedFiles, diff, commits) {
+    const skillsSummary = getSkillsSummaryForPrompt(PROJECT_SKILLS_CONTEXT);
+    const prompt = this.buildAnalysisPrompt(changedFiles, diff, commits, skillsSummary);
+
+    const { client, session } = await this.createClient();
+
+    try {
+      log.info('  正在使用 AI 深度分析程式碼變更...');
+      const response = await session.sendAndWait({ prompt });
+      const content = response?.data.content?.trim() || '';
+
+      await client.stop();
+
+      // 解析 JSON
+      try {
+        const jsonMatch =
+          content.match(/```json\s*([\s\S]*?)\s*```/) || content.match(/```\s*([\s\S]*?)\s*```/);
+        const jsonStr = jsonMatch ? jsonMatch[1] : content;
+        const analysisResult = JSON.parse(jsonStr);
+
+        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 || [];
+
+        log.success('  AI 分析完成\n');
+        return { blastRadius, warnings };
+      } catch (parseError) {
+        log.warning('  AI 響應解析失敗，使用基礎分析...');
+        return this.getFallbackAnalysis(changedFiles);
+      }
+    } catch (error) {
+      await client.stop();
+      log.warning(`  AI 分析失敗 (${error.message})，使用基礎分析...\n`);
+      return this.getFallbackAnalysis(changedFiles);
+    }
+  }
+
+  /**
+   * 建立 PR 生成 Prompt
+   */
+  buildPRPrompt(commits, diff, skillsSummary) {
+    return `你是一個專業的前端工程師，熟悉 Next.js、React 效能優化和團隊開發規範。
+請根據以下 commit 訊息和程式碼變更，直接輸出一個清晰的 Pull Request 標題和描述。
+
+${skillsSummary}
+
+**輸出格式**（不要加任何引導語，直接輸出以下內容）：
+
+# [type]: [PR 標題]
+
+> type 必須是以下之一：feat / fix / refactor / style / docs / test / chore / perf
+
+## 📝 變更摘要
+[簡述這個 PR 的主要目的和影響範圍，2-3 句話]
+
+## 🎯 主要變更
+- [變更項目 1]
+- [變更項目 2]
+- [變更項目 3]
+
+## 🔀 變更類型
+- [ ] ✨ 新功能 (feat)
+- [ ] 🐛 Bug 修復 (fix)
+- [ ] ♻️ 重構 (refactor)
+- [ ] 💄 樣式調整 (style)
+- [ ] 📝 文件更新 (docs)
+- [ ] ⚡ 效能改進 (perf)
+- [ ] 🔧 其他 (chore)
+
+> 請根據實際變更勾選對應的類型（可複選）
+
+## 🧪 測試方法
+1. [具體的測試步驟 1]
+2. [具體的測試步驟 2]
+3. [具體的測試步驟 3]
+
+## 💥 Breaking Changes
+[如果有破壞性變更請詳細說明，沒有則填寫「無」]
+
+## 📌 注意事項
+[需要特別注意的事項]
+
+## 📸 截圖
+[如果是 UI 變更，提醒需要截圖]
+
+---
+
+## ✅ 已套用規則總結
+
+> 請根據上方提供的專案規範（React Best Practices 和 Frontend Guidelines），分析本次程式碼變更
+
+### React Best Practices 規則
+
+**✅ 已正確套用的規則**：
+[列出本次變更中有正確使用的規則]
+
+**❌ 需要改善的項目**：
+[列出本次變更中違反的規則]
+
+### Frontend Guidelines
+
+[根據程式碼實際內容檢查相關項目]
+
+---
+
+**規則**：
+1. PR 標題格式：type: 簡短描述（不超過 50 字）
+2. type 必須符合 Conventional Commits
+3. 變更摘要用 2-3 句話概括整體影響
+4. 全部使用繁體中文（台灣正體）
+5. 不要在開頭加引導語句
+6. 直接開始輸出 # [type]: [標題]
+
+---
+
+**Commit 訊息**：
+${commits}
+
+**程式碼變更**：
+${diff}`;
+  }
+
+  /**
+   * 建立影響分析 Prompt
+   */
+  buildAnalysisPrompt(changedFiles, diff, commits, skillsSummary) {
+    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": "改善建議"
+    }
+  ]
+}
+\`\`\`
+
+**分析重點**：
+
+1. **影響範圍 (blastRadius)**：
+   - 真實分析程式碼變更內容，不要只看檔案路徑
+   - 識別實際影響的模組
+   - 分析影響層面（API、資料庫、UI、商業邏輯、效能、安全性等）
+   - 評估風險等級，並說明原因
+   - 識別對外行為變更
+
+2. **規範警告 (warnings)**：
+   - 檢查是否有安全風險
+   - 檢查是否缺少錯誤處理
+   - 檢查是否有效能問題
+   - 檢查是否違反最佳實踐
+
+**回應格式**：只輸出有效的 JSON，不要有任何前綴或後綴文字。`;
+  }
+
+  /**
+   * 解析 AI 生成的 PR 內容
+   */
+  parsePRContent(prContent) {
+    let title = '';
+    let body = '';
+
+    const lines = prContent.split('\n');
+    let titleLineIndex = -1;
+
+    // 尋找第一個 # 開頭的標題行
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i].trim();
+
+      // 跳過引導語句
+      if (
+        line.match(/^(已根據|請|這是|以下是|根據|PR\s*描述|該描述)/i) ||
+        line.match(/適合.*複製/i)
+      ) {
+        continue;
+      }
+
+      // 找到第一個 # 標題
+      if (line.match(/^#\s+.+/)) {
+        titleLineIndex = i;
+        title = line.replace(/^#\s+/, '').trim();
+        break;
+      }
+    }
+
+    // Body 從標題後一行開始
+    if (titleLineIndex >= 0) {
+      let bodyStartIndex = titleLineIndex + 1;
+      while (bodyStartIndex < lines.length && !lines[bodyStartIndex].trim()) {
+        bodyStartIndex++;
+      }
+      body = lines.slice(bodyStartIndex).join('\n').trim();
+    } else {
+      body = prContent.trim();
+    }
+
+    // 清理標題和 body
+    title = title.replace(/[（(]\d+字[）)]/g, '').trim();
+    body = body.replace(/\n*該描述使用.*$/i, '').trim();
+
+    return { title, body };
+  }
+
+  /**
+   * 降級方案：基礎分析
+   */
+  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 body
+   */
+  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;
+  }
+}

package/src/pr-modules/ai/label-analyzer.js

@@ -0,0 +1,113 @@
+import { execSync } from 'child_process';
+import { log } from '../utils/helpers.js';
+
+/**
+ * Label 分析器 - 自動為 PR 添加合適的標籤
+ */
+export class LabelAnalyzer {
+  /**
+   * 分析應該添加的 Labels
+   */
+  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',
+    };
+
+    // 從標題中提取 type
+    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.stats.filesChanged > 50) {
+        labels.add('needs-review');
+      }
+    }
+
+    // 根據警告
+    if (prData.warnings && prData.warnings.length > 0) {
+      labels.add('has-warnings');
+    }
+
+    return Array.from(labels);
+  }
+
+  /**
+   * 應用 Labels 到 PR
+   */
+  async applyLabels(prNumber, labels) {
+    if (!labels || labels.length === 0) {
+      log.info('無需添加 Labels');
+      return;
+    }
+
+    log.info(`正在添加 Labels: ${labels.join(', ')}`);
+
+    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'] }
+      );
+
+      log.success(`成功添加 ${labels.length} 個 Labels`);
+    } catch (error) {
+      log.warning('無法自動添加 Labels，請手動操作');
+    }
+  }
+
+  /**
+   * 分析並應用 Labels
+   */
+  async analyzeAndApply(prNumber, prData) {
+    const labels = this.analyzeLabels(prData);
+    await this.applyLabels(prNumber, labels);
+    return labels;
+  }
+}

package/src/pr-modules/core/config-loader.js

@@ -0,0 +1,132 @@
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+
+/**
+ * 解析命令列參數
+ */
+export function parseCliArgs() {
+  const args = process.argv.slice(2);
+  const config = {
+    baseBranch: null,
+    headBranch: null,
+    model: null,
+    draft: false,
+    preview: false,
+    noConfirm: false,
+    autoReviewers: false,
+    autoLabels: null,
+    orgName: null,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case '--base':
+        config.baseBranch = args[++i];
+        break;
+      case '--head':
+        config.headBranch = args[++i];
+        break;
+      case '--model':
+        config.model = args[++i];
+        break;
+      case '--org':
+        config.orgName = args[++i];
+        break;
+      case '--draft':
+        config.draft = true;
+        break;
+      case '--preview':
+        config.preview = true;
+        break;
+      case '--no-confirm':
+        config.noConfirm = true;
+        break;
+      case '--auto-reviewers':
+        config.autoReviewers = true;
+        break;
+      case '--auto-labels':
+        config.autoLabels = true;
+        break;
+      case '--no-labels':
+        config.autoLabels = false;
+        break;
+      case '--help':
+        showHelp();
+        process.exit(0);
+        break;
+      default:
+        // 忽略未知的參數
+        break;
+    }
+  }
+
+  return config;
+}
+
+/**
+ * 載入配置
+ */
+export async function loadConfig() {
+  // 1. 載入預設配置
+  const configPath = resolve(process.cwd(), '.ai-pr-config.js');
+  let config = null;
+
+  if (existsSync(configPath)) {
+    const userConfig = await import(configPath);
+    config = userConfig.default;
+  } else {
+    // 使用內建預設值
+    config = {
+      ai: { model: 'gpt-4.1', maxDiffLength: 8000, maxRetries: 3 },
+      github: { orgName: 'kingsinfo-project', defaultBase: 'release', autoLabels: true },
+      reviewers: { autoSelect: false, maxSuggested: 5, gitHistoryDepth: 20, excludeAuthors: [] },
+      output: { verbose: false, saveHistory: false },
+    };
+  }
+
+  // 2. 合併命令列參數
+  const cliConfig = parseCliArgs();
+
+  // 合併配置（CLI 參數優先）
+  if (cliConfig.model) config.ai.model = cliConfig.model;
+  if (cliConfig.orgName) config.github.orgName = cliConfig.orgName;
+  if (cliConfig.autoReviewers) config.reviewers.autoSelect = cliConfig.autoReviewers;
+  if (cliConfig.autoLabels) config.github.autoLabels = cliConfig.autoLabels;
+
+  // 其他 CLI 參數直接加入 config
+  config.baseBranch = cliConfig.baseBranch;
+  config.headBranch = cliConfig.headBranch;
+  config.draft = cliConfig.draft;
+  config.preview = cliConfig.preview;
+  config.noConfirm = cliConfig.noConfirm;
+
+  return config;
+}
+
+/**
+ * 顯示幫助訊息
+ */
+function showHelp() {
+  console.log(`
+使用方式：
+  node scripts/ai-auto-pr.mjs [選項]
+
+選項：
+  --base <branch>      指定目標分支 (預設: 自動偵測最新 release 分支)
+  --head <branch>      指定來源分支 (預設: 當前分支)
+  --model <model>      指定 AI 模型 (預設: gpt-4.1)
+  --org <org-name>     指定 GitHub 組織名稱 (預設: kingsinfo-project)
+  --draft              創建草稿 PR
+  --preview            僅預覽 PR 內容，不實際創建
+  --no-confirm         跳過確認直接創建
+  --auto-reviewers     自動選擇 reviewers（不互動）
+  --auto-labels        自動添加 Labels（預設啟用）
+  --no-labels          不添加 Labels
+  --help               顯示此說明
+
+範例：
+  node scripts/ai-auto-pr.mjs
+  node scripts/ai-auto-pr.mjs --base main --draft
+  node scripts/ai-auto-pr.mjs --auto-reviewers --auto-labels
+  `);
+}