ai-git-tools 2.0.19 → 2.0.21

package/README.md

@@ -163,6 +163,7 @@ npx ai-git-tools pr [選項]
   --no-confirm                 跳過確認直接創建
   --interactive-reviewers      啟用互動式 reviewer 選擇 (預設啟用)
   --auto-labels                自動添加 Labels (預設啟用)
+  --include-impact             在 PR 中包含影響範圍分析和注意事項 (預設關閉)
 \`\`\`
 
 **範例：**
@@ -211,8 +212,9 @@ export default {
 
   // GitHub 設定
   github: {
-    defaultBase: 'release', // 預設目標分支
+    defaultBase: 'release', // 預設目標分支：'release'=自動查找最新，或指定具體分支名
     autoLabels: true, // 自動添加 Labels
+    includeImpactAnalysis: false, // 是否在 PR 中包含影響範圍分析和注意事項 (使用 --include-impact 啟用)
   },
 
   // Reviewer 設定
@@ -231,6 +233,44 @@ export default {
 };
 \`\`\`
 
+### defaultBase 配置說明
+
+\`defaultBase\` 支援兩種模式：
+
+#### 1. 自動模式（推薦）
+```javascript
+github: {
+  defaultBase: 'release',  // 自動查找最新的 release 分支
+}
+```
+- 工具會自動偵測所有 \`release-*\` 或 \`release/*\` 格式的分支
+- 自動選擇最新版本（優先選擇月度分支，如 release-2025-m12.1）
+- 適合經常更新 release 版本的專案
+
+#### 2. 具體分支模式
+```javascript
+github: {
+  defaultBase: 'release-2025-m12.1',  // 固定使用此分支
+}
+```
+- 直接使用指定的分支名稱
+- 適合需要固定某個版本的情況
+- 或使用 \`main\`、\`develop\` 等標準分支
+
+**範例輸出**：
+```bash
+# 使用 defaultBase: 'release'
+配置檔指定使用 release 分支，正在偵測最新版本...
+📋 偵測到的 release 分支:
+  月度分支 (優先):
+    1. release-2025-m12.1 ← 最新
+    2. release-2025-m11.1
+✅ 自動選擇最新 release 分支: release-2025-m12.1
+
+# 使用 defaultBase: 'release-2025-m12.1'
+✅ 使用配置檔指定的分支: release-2025-m12.1
+```
+
 ## 🔧 環境需求
 
 - **Node.js** >= 18.0.0

package/bin/cli.js

@@ -52,11 +52,10 @@ program
   .description('AI 自動生成 PR 並創建 Pull Request')
   .option('--base <branch>', '指定目標分支')
   .option('--model <model>', '指定 AI 模型')
-  .option('--org <org-name>', '指定 GitHub 組織名稱')
   .option('--preview', '僅預覽 PR 內容，不實際創建')
   .option('--no-confirm', '跳過確認直接創建')
-  .option('--auto-labels', '自動添加 Labels')
-  .option('--no-labels', '不添加 Labels')
+  .option('--auto-labels', '自動添加 Labels (預設啟用)')
+  .option('--include-impact', '在 PR 中包含影響範圍分析和注意事項 (預設關閉)')
   .action(prCommand);
 
 program.parse();

package/package.json

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

package/src/commands/init.js

@@ -23,9 +23,9 @@ export default {
 
   // GitHub 相關配置
   github: {
-    orgName: '', // GitHub 組織名稱（留空則自動從 git remote 取得）
-    defaultBase: 'release', // PR分支（使用 'release' 自動偵測最新 release 分支，如 release-2025-m11.1）
+    defaultBase: 'release', // PR 預設目標分支（使用 'release' 自動偵測最新 release 分支，如 release-2025-m11.1）
     autoLabels: true, // 自動新增 Labels
+    includeImpactAnalysis: false, // 是否在 PR 中包含影響範圍分析和注意事項（使用 --include-impact 啟用）
   },
 
   // Reviewers 相關配置

package/src/core/config-loader.js

@@ -4,7 +4,6 @@
  * 支援從任何目錄下的 .ai-git-config.mjs 載入配置
  */
 
-import { execSync } from 'child_process';
 import { existsSync } from 'fs';
 import { resolve } from 'path';
 
@@ -111,7 +110,6 @@ export function parsePRCliArgs() {
     noConfirm: false,
     autoReviewers: false,
     autoLabels: null,
-    orgName: null,
   };
 
   for (let i = 0; i < args.length; i++) {
@@ -122,9 +120,6 @@ export function parsePRCliArgs() {
       case '--model':
         config.model = args[++i];
         break;
-      case '--org':
-        config.orgName = args[++i];
-        break;
       case '--preview':
         config.preview = true;
         break;
@@ -134,9 +129,6 @@ export function parsePRCliArgs() {
       case '--auto-labels':
         config.autoLabels = true;
         break;
-      case '--no-labels':
-        config.autoLabels = false;
-        break;
       default:
         break;
     }
@@ -166,31 +158,20 @@ export async function loadPRConfig() {
   if (!config) {
     config = {
       ai: { model: 'gpt-4.1', maxDiffLength: 8000, maxRetries: 3 },
-      github: { orgName: '', defaultBase: 'release', autoLabels: true },
+      github: { defaultBase: 'release', autoLabels: true },
       reviewers: { autoSelect: true, maxSuggested: 5, gitHistoryDepth: 20, excludeAuthors: [] },
       output: { verbose: false, saveHistory: false },
     };
   }
 
-  // 如果 orgName 為空，嘗試從 git remote 取得，否則使用 'kingsinfo-project'
-  if (!config.github.orgName) {
-    try {
-      const remoteUrl = execSync('git config --get remote.origin.url', { encoding: 'utf-8' }).trim();
-      const match = remoteUrl.match(/github\.com[:/]([^/]+)\//);
-      config.github.orgName = match ? match[1] : 'kingsinfo-project';
-    } catch (error) {
-      config.github.orgName = 'kingsinfo-project';
-    }
+  // 確保 github 物件存在
+  if (!config.github) {
+    config.github = {};
   }
 
   // 合併命令行參數
   const cliConfig = parsePRCliArgs();
   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 !== null) config.github.autoLabels = cliConfig.autoLabels;
-
-  config.baseBranch = cliConfig.baseBranch;
   config.headBranch = cliConfig.headBranch;
   config.draft = cliConfig.draft;
   config.preview = cliConfig.preview;

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

@@ -123,7 +123,7 @@ ${skillsSummary}
 - [ ] ⚡ 效能改進 (perf)
 - [ ] 🔧 其他 (chore)
 
-> 請根據實際變更勾選對應的類型（可複選）
+> **重要**: 請根據實際變更**自動勾選**對應的類型（可複選），將 [ ] 改為 [x]
 
 ## 🧪 測試方法
 1. [具體的測試步驟 1]

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

@@ -14,6 +14,7 @@ export function parseCliArgs() {
     noConfirm: false,
     interactiveReviewers: undefined,
     autoLabels: null,
+    includeImpactAnalysis: null,
   };
 
   for (let i = 0; i < args.length; i++) {
@@ -39,6 +40,9 @@ export function parseCliArgs() {
       case '--auto-labels':
         config.autoLabels = true;
         break;
+      case '--include-impact':
+        config.includeImpactAnalysis = true;
+        break;
       case '--help':
         showHelp();
         process.exit(0);
@@ -67,7 +71,7 @@ export async function loadConfig() {
     // 使用內建預設值
     config = {
       ai: { model: 'gpt-4.1', maxDiffLength: 8000, maxRetries: 3 },
-      github: { defaultBase: 'release', autoLabels: true },
+      github: { defaultBase: 'release', autoLabels: true, includeImpactAnalysis: false },
       reviewers: { interactiveReviewers: true, maxSuggested: 5, gitHistoryDepth: 20, excludeAuthors: [] },
       output: { verbose: false, saveHistory: false },
     };
@@ -80,6 +84,7 @@ export async function loadConfig() {
   if (cliConfig.model) config.ai.model = cliConfig.model;
   if (cliConfig.interactiveReviewers !== undefined) config.reviewers.interactiveReviewers = cliConfig.interactiveReviewers;
   if (cliConfig.autoLabels !== null) config.github.autoLabels = cliConfig.autoLabels;
+  if (cliConfig.includeImpactAnalysis !== null) config.github.includeImpactAnalysis = cliConfig.includeImpactAnalysis;
 
   // 其他 CLI 參數直接加入 config
   config.baseBranch = cliConfig.baseBranch;

package/src/pr-modules/core/github-api.js

@@ -113,13 +113,6 @@ export class GitHubAPI {
    * 從 GitHub 抓取組織的團隊列表
    */
   async fetchTeams(orgName = this.orgName) {
-    // 如果沒有 orgName，直接返回空結果
-    if (!orgName || orgName.trim() === '') {
-      log.warning('未設置 GitHub 組織名稱，且無法自動偵測');
-      log.info('請在 .ai-pr-config.js 中設置 github.orgName 或使用 --org 參數\n');
-      return { teams: {}, members: [] };
-    }
-
     try {
       // 先檢查認證狀態
       const authStatus = this.checkAuth();
@@ -198,8 +191,7 @@ export class GitHubAPI {
       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');
+      console.log(`  4. 有權限存取 ${orgName} 組織\n`);
 
       log.info('提示: 你仍可以手動輸入 reviewer 的 GitHub username\n');
 

package/src/pr-modules/core/workflow.js

@@ -101,8 +101,31 @@ export class PRWorkflow {
     if (!baseBranch) {
       // 優先使用配置檔中的 defaultBase
       if (this.config.github?.defaultBase) {
-        baseBranch = this.config.github.defaultBase;
-        log.success(`使用配置檔指定的分支: ${baseBranch}\n`);
+        const defaultBase = this.config.github.defaultBase;
+        
+        // 如果 defaultBase 是 'release'，則自動查找最新的 release 分支
+        if (defaultBase === 'release' || defaultBase.match(/^release$/i)) {
+          log.step('配置檔指定使用 release 分支，正在偵測最新版本...\n');
+          const allBranches = this.git.detectReleaseBranches();
+          const latestRelease = this.git.findLatestReleaseBranch();
+
+          if (latestRelease) {
+            baseBranch = latestRelease;
+            this.displayDetectedBranches(allBranches, latestRelease);
+            log.success(`自動選擇最新 release 分支: ${baseBranch}`);
+            log.info(`提示: 使用 --base <分支名> 指定其他分支\n`);
+          } else {
+            throw new PRError('未偵測到任何 release 分支', 'NO_RELEASE_BRANCH', [
+              '使用 --base 參數指定目標分支',
+              '或在 .ai-git-config.js 中設置具體的分支名（如 release-2025-m12.1）',
+              '確認遠端分支存在: git branch -r | grep release',
+            ]);
+          }
+        } else {
+          // 使用配置檔中指定的具體分支名
+          baseBranch = defaultBase;
+          log.success(`使用配置檔指定的分支: ${baseBranch}\n`);
+        }
       } else {
         // 如果沒有配置，則自動偵測最新的 release 分支
         log.step('正在偵測 release 分支...\n');
@@ -263,19 +286,27 @@ export class PRWorkflow {
     // 生成 PR 標題和描述
     const { title, body } = await this.ai.generatePRContent(changeData.commits, changeData.diff);
 
-    // 分析影響範圍
-    log.step('正在使用 AI 深度分析影響範圍和潛在問題...\n');
-    const { blastRadius, warnings } = await this.ai.analyzeImpact(
-      changeData.changedFiles,
-      changeData.diff,
-      changeData.commits
-    );
+    let enhancedBody = body;
+    let blastRadius = null;
+    let warnings = [];
+
+    // 根據配置決定是否進行影響範圍分析
+    if (this.config.github.includeImpactAnalysis === true) {
+      log.step('正在使用 AI 深度分析影響範圍和潛在問題...\n');
+      const analysis = await this.ai.analyzeImpact(
+        changeData.changedFiles,
+        changeData.diff,
+        changeData.commits
+      );
+      blastRadius = analysis.blastRadius;
+      warnings = analysis.warnings;
 
-    // 顯示分析結果摘要
-    this.displayAnalysisSummary(blastRadius, warnings);
+      // 顯示分析結果摘要
+      this.displayAnalysisSummary(blastRadius, warnings);
 
-    // 將分析結果附加到 body
-    const enhancedBody = this.ai.appendAnalysisToBody(body, blastRadius, warnings);
+      // 將分析結果附加到 body
+      enhancedBody = this.ai.appendAnalysisToBody(body, blastRadius, warnings);
+    }
 
     return { title, body: enhancedBody, blastRadius, warnings };
   }