ai-git-tools 2.1.9 → 2.1.11

package/README.md

@@ -372,6 +372,35 @@ Issue 的基本責任分工如下：`description` 保存原始需求與未來其
 
 同一個 Issue 若已經有先前的 notes，後續再次執行更新仍會新增一筆新的 Redmine journal，不會因為已有 notes 而略過；只有 Issue 的需求內容或狀態在產生草稿後被其他人修改時，才會停下來要求重新確認。
 
+AI 產出的 notes 會固定整理成以下架構：
+
+```markdown
+## 開發內容
+
+### 需求說明
+一句話說明這次為什麼修改。
+
+### 實作內容
+- 實際完成事項
+- 實際完成事項
+- 實際完成事項
+
+### 行為規則
+| 情境 | 行為 |
+|---|---|
+| ... | ... |
+
+### 影響範圍
+受影響的功能、API、頁面或模組。
+
+### 待確認
+- [ ] AI 無法確認的項目
+```
+
+實作內容最多顯示 6 個項目；沒有待確認事項時不會建立空的 `待確認` 區塊。Git 與流程圖區塊會維持既有格式。
+
+所有 Copilot AI 回應會在程式內統一轉換為台灣繁體中文，包含 Redmine notes、需求說明、實作內容、行為規則、影響範圍與 Mermaid 文字；不依賴模型自行遵守語言設定。
+
 ## ⚙️ 配置
 
 配置檔案範例（\`.ai-git-config.js\`）：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-git-tools",
-  "version": "2.1.9",
+  "version": "2.1.11",
   "description": "AI-powered Git automation tools for commit messages and PR generation",
   "main": "src/index.js",
   "type": "module",
@@ -44,6 +44,7 @@
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "inquirer": "^9.2.0",
+    "opencc-js": "^1.4.2",
     "ora": "^8.0.1"
   },
   "devDependencies": {

package/src/commands/redmine-update.js

@@ -12,6 +12,7 @@ import {
 import { buildRedmineConfig } from '../redmine/config.js';
 import { RedmineClient } from '../redmine/redmine-client.js';
 import { Logger } from '../utils/logger.js';
+import { toTraditionalChinese } from '../utils/traditional-chinese.js';
 import {
   applyRedmineDraft,
   generateRedmineDraft,
@@ -32,7 +33,7 @@ function printProgress(progress) {
       logger.step(`[${progress.index}/${progress.total}] 讀取 Redmine Issue #${progress.issueId}...`);
       break;
     case 'issue-read':
-      logger.success(`Issue #${progress.issueId} 已取得：${progress.subject || '無標題'}`);
+      logger.success(`Issue #${progress.issueId} 已取得：${toTraditionalChinese(progress.subject || '無標題')}`);
       break;
     case 'analyze-issue':
       logger.step(`[${progress.index}/${progress.total}] 使用 Copilot 分析 Issue #${progress.issueId}...`);
@@ -161,7 +162,7 @@ export async function redmineUpdateCommand(options = {}) {
     }
   }
   if (pullRequest) {
-    logger.success(`已找到 PR #${pullRequest.number}：${pullRequest.title || '無標題'}`);
+    logger.success(`已找到 PR #${pullRequest.number}：${toTraditionalChinese(pullRequest.title || '無標題')}`);
     console.log(`🔗 ${pullRequest.url}`);
   } else {
     logger.info('目前 branch 沒有找到對應的 GitHub PR，略過 PR 資訊');

package/src/core/ai-client.js

@@ -4,6 +4,7 @@
  */
 
 import { CopilotClient, approveAll } from '@github/copilot-sdk';
+import { toTraditionalChinese } from '../utils/traditional-chinese.js';
 
 export class AIClient {
   /**
@@ -75,7 +76,7 @@ export class AIClient {
         const response = await Promise.race([responsePromise, timeoutPromise]);
 
         const content = response?.data?.content || '';
-        return content.trim();
+        return toTraditionalChinese(content.trim());
       } catch (error) {
         lastError = error;
         if (attempt < maxRetries) {

package/src/redmine/issue-analyzer.js

@@ -1,8 +1,11 @@
 import { AIClient } from '../core/ai-client.js';
+import { normalizeAnalysisLanguage } from '../utils/traditional-chinese.js';
 
 const ANALYSIS_FIELDS = [
   'developmentSummary',
   'requirementDescription',
+  'implementationDetails',
+  'impactScope',
   'codeChanges',
   'apiChanges',
   'technicalDetails',
@@ -15,9 +18,11 @@ const ANALYSIS_FIELDS = [
 function normalizeFlowcharts(value) {
   const flowcharts = Array.isArray(value)
     ? value
-    : value
+    : typeof value === 'string'
       ? [{ source: value }]
-      : [];
+      : value
+        ? [value]
+        : [];
 
   const usedIds = new Set();
   return flowcharts
@@ -37,7 +42,9 @@ function normalizeFlowcharts(value) {
       return {
         id: uniqueId,
         title,
-        source: typeof flowchart.source === 'string' ? flowchart.source.trim() : '',
+        source: typeof (flowchart.source || flowchart.mermaid) === 'string'
+          ? (flowchart.source || flowchart.mermaid).trim()
+          : '',
         evidence: asStringArray(flowchart.evidence),
       };
     })
@@ -80,13 +87,15 @@ export function buildIssueAnalysisPrompt({ issue, evidence }) {
 
 重要規則：
 - 這次只分析指定的 Issue #${issue.id}，不得把結果指派給其他 Issue。
+- 所有自然語言欄位必須使用台灣繁體中文，禁止輸出簡體中文。
 - 只能描述下方 Issue、Git commits、changed files、diff 或 PR evidence 中有明確證據的內容。
 - 不得捏造 API endpoint、參數、檔案、function、class、測試或部署結果。
+- requirementDescription 必須是一句話，說明這次為什麼修改。
+- implementationDetails 必須整理 3～6 個實際完成事項。
+- behaviorRules 必須使用 scenario/behavior 物件描述不同情境的行為。
+- impactScope 必須描述受到影響的功能、API、頁面或模組。
+- 若能從實際流程推導出可靠的流程，才產生 flowcharts；每張流程圖必須有穩定 id、title、source 與 evidence。
 - 沒有明確測試或驗證證據時，verification 必須是空陣列。
-- 沒有可靠 API 變更證據時，apiChanges 必須是空陣列。
-- requirementDescription 應整理指定 Issue 的需求重點；behaviorRules 使用 scenario/behavior 物件陣列。
-- 若能從實際流程推導出可靠的複製流程，才產生 flowcharts；否則為空陣列。每張流程圖必須有穩定、描述用途的 id，source 必須以 graph TD 開始，不要加入 Mermaid wrapper 或 code fence。
-- developmentSummary、codeChanges、apiChanges、technicalDetails 中的程式路徑、API path、function 與 class 使用雙反引號標示；需要多行程式片段時使用 code block。
 - 不要產生 suggestedStatus、coverage 或 confidence，也不要決定 Redmine status。
 
 ## 指定 Redmine Issue
@@ -100,6 +109,8 @@ ${JSON.stringify(evidence, null, 2)}
   "issueId": ${issue.id},
   "developmentSummary": [],
   "requirementDescription": "",
+  "implementationDetails": [],
+  "impactScope": "",
   "behaviorRules": [],
   "codeChanges": [],
   "apiChanges": [],
@@ -110,8 +121,7 @@ ${JSON.stringify(evidence, null, 2)}
   "unresolvedItems": [],
   "evidence": []
 }
-
-developmentSummary、codeChanges、apiChanges、technicalDetails、modifiedFiles、verification、unresolvedItems 與 evidence 必須是字串陣列；requirementDescription 必須是字串；behaviorRules 必須是包含 scenario 與 behavior 字串的物件陣列；flowcharts 必須是包含 id、title、source 與 evidence 的物件陣列。`;
+requirementDescription 與 impactScope 必須是字串；implementationDetails 必須是 3～6 個字串的陣列；behaviorRules 必須是包含 scenario 與 behavior 字串的物件陣列；flowcharts 必須是包含 id、title、source 與 evidence 的物件陣列；其它清單欄位必須是字串陣列。`;
 }
 
 /**
@@ -121,11 +131,11 @@ developmentSummary、codeChanges、apiChanges、technicalDetails、modifiedFiles
  * @returns {object}
  */
 export function parseIssueAnalysis(content, issueId) {
-  const parsed = AIClient.parseJSON(content);
+  const parsed = normalizeAnalysisLanguage(AIClient.parseJSON(content));
   const result = { issueId };
 
   for (const field of ANALYSIS_FIELDS) {
-    result[field] = field === 'requirementDescription'
+    result[field] = field === 'requirementDescription' || field === 'impactScope'
       ? (typeof parsed[field] === 'string' ? parsed[field].trim() : '')
       : asStringArray(parsed[field]);
   }

package/src/redmine/redmine-formatters.js

@@ -1,5 +1,6 @@
 import inquirer from 'inquirer';
 import chalk from 'chalk';
+import { normalizeAnalysisLanguage, toTraditionalChinese } from '../utils/traditional-chinese.js';
 
 function bulletSection(title, items) {
   if (!Array.isArray(items) || items.length === 0) return '';
@@ -11,6 +12,23 @@ function paragraphSection(title, content) {
   return `### ${title}\n\n${content}\n`;
 }
 
+function formatRequirement(content) {
+  if (!content) return '';
+  return content.replace(/\s+/g, ' ').trim();
+}
+
+function getImplementationDetails(analysis = {}) {
+  if (analysis.implementationDetails?.length) {
+    return analysis.implementationDetails.slice(0, 6);
+  }
+
+  return [
+    ...(analysis.codeChanges || []),
+    ...(analysis.apiChanges || []),
+    ...(analysis.technicalDetails || []),
+  ].slice(0, 6);
+}
+
 function formatBehaviorRules(rules = []) {
   if (!Array.isArray(rules) || rules.length === 0) return '';
   const rows = rules
@@ -152,39 +170,29 @@ export function formatRedmineDescription(description = '', source = null) {
  * @returns {string}
  */
 export function formatRedmineNote({ issue = {}, analysis = {}, evidence = {}, pullRequest = null }) {
+  const localizedIssue = normalizeAnalysisLanguage(issue);
+  const localizedAnalysis = normalizeAnalysisLanguage(analysis);
   const sections = ['## 開發內容', ''];
-  const development = Array.isArray(analysis.developmentSummary)
-    ? analysis.developmentSummary.join('\n\n')
-    : analysis.developmentSummary || '';
-  const requirementDescription = analysis.requirementDescription || issue.description || '';
-  const behaviorRules = formatBehaviorRules(analysis.behaviorRules);
-  const codeChanges = bulletSection('程式修改重點', analysis.codeChanges);
-  const apiChanges = bulletSection('API 變更', analysis.apiChanges);
-  const technicalDetails = bulletSection('重要技術細節', analysis.technicalDetails);
-  const modifiedFiles = bulletSection(
-    '修改檔案',
-    analysis.modifiedFiles?.length
-      ? analysis.modifiedFiles.map(file => `\`\`${file}\`\``)
-      : evidence.changedFiles?.map(file => `\`\`${file}\`\``)
+  const requirementDescription = formatRequirement(
+    localizedAnalysis.requirementDescription || localizedAnalysis.developmentSummary?.[0] || localizedIssue.description || ''
   );
-  const verification = bulletSection('驗證結果', analysis.verification);
-  const unresolved = analysis.unresolvedItems?.length
-    ? `### 待確認\n${analysis.unresolvedItems.map(item => `- [ ] ${item}`).join('\n')}\n`
+  const implementationDetails = getImplementationDetails(localizedAnalysis);
+  const behaviorRules = formatBehaviorRules(localizedAnalysis.behaviorRules);
+  const implementation = bulletSection('實作內容', implementationDetails);
+  const impactScope = paragraphSection('影響範圍', localizedAnalysis.impactScope);
+  const unresolved = localizedAnalysis.unresolvedItems?.length
+    ? `### 待確認\n${localizedAnalysis.unresolvedItems.map(item => `- [ ] ${item}`).join('\n')}\n`
     : '';
-  const flowcharts = formatFlowcharts(analysis.flowcharts);
+  const flowcharts = formatFlowcharts(localizedAnalysis.flowcharts);
 
   sections.push(
-    development,
     paragraphSection('需求說明', requirementDescription),
+    implementation,
     behaviorRules,
-    modifiedFiles,
-    codeChanges,
-    apiChanges,
-    technicalDetails,
-    flowcharts,
-    verification
+    impactScope,
+    unresolved,
+    flowcharts
   );
-  sections.push(unresolved);
 
   if (evidence.currentBranch || evidence.baseBranch || pullRequest) {
     const branch = evidence.currentBranch || '—';
@@ -212,8 +220,8 @@ export function formatRedmineNote({ issue = {}, analysis = {}, evidence = {}, pu
     );
   }
 
-  if (analysis.evidence?.length) {
-    sections.push(`分析依據：${analysis.evidence.join('、')}`, '');
+  if (localizedAnalysis.evidence?.length) {
+    sections.push(`分析依據：${localizedAnalysis.evidence.join('、')}`, '');
   }
 
   return sections.filter((section, index) => section || index === 1).join('\n').trim();
@@ -290,8 +298,8 @@ export function formatRedminePreview(drafts = []) {
   for (const draft of drafts) {
     lines.push(
       chalk.bold.cyan(`Issue #${draft.issueId}`),
-      `${chalk.dim('目前狀態：')} ${draft.currentStatusName || draft.originalStatusName || '—'}`,
-      `${chalk.green('更新狀態：')} ${draft.statusName || '未選擇'}`,
+      `${chalk.dim('目前狀態：')} ${toTraditionalChinese(draft.currentStatusName || draft.originalStatusName || '—')}`,
+      `${chalk.green('更新狀態：')} ${toTraditionalChinese(draft.statusName || '未選擇')}`,
       draft.doneRatio !== undefined ? `${chalk.green('完成百分比：')} ${draft.doneRatio}%` : '',
       draft.dueDate ? `${chalk.green('完成日期：')} ${draft.dueDate}` : '',
       draft.customFields?.length

package/src/utils/traditional-chinese.js

@@ -0,0 +1,28 @@
+import OpenCC from 'opencc-js';
+
+const convertToTraditional = OpenCC.Converter({ from: 'cn', to: 'tw' });
+
+/**
+ * 將文字轉換為台灣繁體中文
+ * @param {string} value
+ * @returns {string}
+ */
+export function toTraditionalChinese(value) {
+  return typeof value === 'string' ? convertToTraditional(value) : value;
+}
+
+/**
+ * 遞迴將資料中的所有字串轉換為台灣繁體中文
+ * @param {unknown} value
+ * @returns {unknown}
+ */
+export function normalizeAnalysisLanguage(value) {
+  if (typeof value === 'string') return toTraditionalChinese(value);
+  if (Array.isArray(value)) return value.map(normalizeAnalysisLanguage);
+  if (value && typeof value === 'object') {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, item]) => [key, normalizeAnalysisLanguage(item)])
+    );
+  }
+  return value;
+}