@jira-deploy/core 1.0.11 → 1.0.12

package/constants/system-codes.js

@@ -1,79 +1,20 @@
-/**
- * 系統代碼及其映射
- */
+import {getDeployConfig} from './config.js';
 
-export const SYSTEM_CODES = {
-  IBK: 'IBK',
-  CWA: 'CWA',
-  EIB: 'EIB',
-  EVT: 'EVT',
-  NPM: 'NPM',
-  BOF: 'BOF',
-};
+const config = getDeployConfig();
+
+export const SYSTEM_CODES = config.systemCodes;
 
 /** 系統 → 部門代碼映射 */
-export const SYSTEM_TO_DEPT_MAP = {
-  IBK: 'CH014',
-  CWA: 'CH014',
-  NPM: 'CH014',
-  EVT: 'CH015',
-  EIB: 'CH015',
-  BOF: 'CH015',
-};
+export const SYSTEM_TO_DEPT_MAP = config.systemToDept;
 
 /** 系統代碼的 Jira ID */
-export const SYSTEM_CODE_JIRA_IDS = {
-  // Library 中的系統代碼 ID
-  library: {
-    IBK: '15600',
-    EVT: '15509',
-    CWA: '15513',
-    BOF: '15800',
-    EIB: '15803',
-    NPM: '15807',
-  },
-  // CI 中的系統代碼 ID
-  ci: {
-    EVT: '15508',
-    BOF: '15802',
-    EIB: '15806',
-    IBK: '14800',
-    CWA: '15516',
-  },
-};
+export const SYSTEM_CODE_JIRA_IDS = config.systemCodeJiraIds;
 
 /** 各系統支援的模組 */
-export const SYSTEM_MODULES = {
-  IBK: ['ibk', 'wealth', 'ssr', 'a11y'],
-  CWA: ['cwa'],
-  BOF: ['web'],
-  EIB: ['web_cust', 'web_agnt'],
-  EVT: ['evt007', 'evt009', 'evt005', 'nextjs_web'],
-  NPM: ['utils'],
-};
+export const SYSTEM_MODULES = config.systemModules;
 
 /** 模組名稱 → Git Repo 映射 */
-export const MODULE_TO_REPO_MAP = {
-  ibk: 'tw-bank-web',
-  ssr: 'tw-bank-web-ssr',
-  wealth: 'tw-bank-web-wealth',
-  a11y: 'tw-bank-web-a11y',
-  cwa: 'tw-bank-webapp',
-  web: 'tw-bank-admin-web',
-  web_cust: 'tw-bank-enterprise-cust',
-  web_agnt: 'tw-bank-enterprise-agent',
-  evt007: 'tw-bank-evt',
-  evt009: 'tw-bank-evt',
-  evt005: 'tw-bank-evt',
-  nextjs_web: 'tw-bank-web-evt',
-  utils: 'tw-bank-npm',
-};
+export const MODULE_TO_REPO_MAP = config.moduleToRepo;
 
 /** 系統代碼 → CI 倉庫映射 */
-export const SYSTEM_TO_CI_REPO_MAP = {
-  IBK: 'ch014.ibk.assembly',
-  CWA: 'ch014.cwa.assembly',
-  BOF: 'ch015.bof.assembly',
-  EIB: 'ch015.eib.assembly',
-  EVT: 'ch015.evt.assembly',
-};
+export const SYSTEM_TO_CI_REPO_MAP = config.systemToCiRepo;

package/constants/users.js

@@ -1,45 +1,25 @@
-/**
- * 使用者名稱 → Jira accountId 對應表
- * 支援中英文名稱、暱稱等多種別名
- * 使用方式：resolveAccountId('Solar') → 'BK00129'
- */
-export const USER_MAP = {
-  // 格式：'名稱/暱稱（不分大小寫）': 'accountId'
-  'Solar Chen': 'BK00325',
-  'Rex Li': 'BK00325',
-  'James Yu': 'BK00325',
-  'Alvin Wang': 'BK00325',
-  'Chester Kuo': 'BK00325',
-  'Riemann Tseng': 'BK00325',
-  // 'Solar Chen': 'BK00129',
-  // 'Rex Li': 'BK00136',
-  // 'James Yu': 'BK00178',
-  // 'Alvin Wang': 'BK00236',
-  // 'Chester Kuo': 'BK00172',
-  // 'Riemann Tseng': 'BK00003',
-};
+import {getDeployConfig} from './config.js';
+
+export const USER_MAP = getDeployConfig().users.aliases;
 
 /**
  * 依名稱模糊查找 accountId（不分大小寫）
  * 優先順序：完全相符 → key 包含輸入 → 輸入包含 key
- * @param {string} name - 顯示名稱或暱稱（例如 "Solar"、"Solar Chen"）
+ * @param {string} name - 顯示名稱或暱稱
  * @returns {string|null} accountId 或 null（查無此人）
  */
 export function resolveAccountId(name) {
   if (!name) return null;
   const query = name.toLowerCase();
 
-  // 1. 完全相符
   const exact = USER_MAP[query];
   if (exact) return exact;
 
   const entries = Object.entries(USER_MAP);
 
-  // 2. key 包含輸入（例如 "solar chen" 包含 "solar"）
   const keyContains = entries.find(([k]) => k.toLowerCase().includes(query));
   if (keyContains) return keyContains[1];
 
-  // 3. 輸入包含 key（例如 "solar chen" 被輸入，key 是 "solar"）
   const inputContains = entries.find(([k]) => query.includes(k.toLowerCase()));
   if (inputContains) return inputContains[1];
 

package/jira-client.js

@@ -255,7 +255,8 @@ export class JiraClient {
 
   // 取得 Bitbucket repo 的原始檔案內容（Bitbucket REST API 1.0）
   async getBitbucketFileContent(project, repo, filePath, branch) {
-    const BB_BASE = process.env.BITBUCKET_URL ?? 'https://bitbucket.linebank.com.tw';
+    const BB_BASE = process.env.BITBUCKET_URL ?? process.env.BITBUCKET_BASE_URL;
+    if (!BB_BASE) throw new Error('Missing required Bitbucket env var: BITBUCKET_URL');
     const url = `${BB_BASE}/rest/api/1.0/projects/${project}/repos/${repo}/raw/${filePath}`;
     const res = await axios
       .get(url, {
@@ -280,7 +281,8 @@ export class JiraClient {
     repo,
     {filterValue = '', orderBy = 'MODIFICATION', limit = 1} = {},
   ) {
-    const BB_BASE = process.env.BITBUCKET_URL ?? 'https://bitbucket.linebank.com.tw';
+    const BB_BASE = process.env.BITBUCKET_URL ?? process.env.BITBUCKET_BASE_URL;
+    if (!BB_BASE) throw new Error('Missing required Bitbucket env var: BITBUCKET_URL');
     const url = `${BB_BASE}/rest/api/1.0/projects/${project}/repos/${repo}/tags`;
     const res = await axios
       .get(url, {
@@ -305,7 +307,8 @@ export class JiraClient {
     repo,
     {filterValue = '', orderBy = 'MODIFICATION', limit = 1} = {},
   ) {
-    const BB_BASE = process.env.BITBUCKET_URL ?? 'https://bitbucket.linebank.com.tw';
+    const BB_BASE = process.env.BITBUCKET_URL ?? process.env.BITBUCKET_BASE_URL;
+    if (!BB_BASE) throw new Error('Missing required Bitbucket env var: BITBUCKET_URL');
     const url = `${BB_BASE}/rest/api/1.0/projects/${project}/repos/${repo}/branches`;
     const res = await axios
       .get(url, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jira-deploy/core",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "type": "module",
   "main": "./index.js",
   "repository": {
@@ -21,15 +21,27 @@
   },
   "files": [
     "constants/**/*.js",
-    "scripts/**/*.py",
-    "tools/**/*.js",
-    "*.js"
+    "scripts/jabber_notify.py",
+    "tools/cd.js",
+    "tools/ci.js",
+    "tools/grayrelease.js",
+    "tools/helpers.js",
+    "tools/index.js",
+    "tools/jabber.js",
+    "tools/library.js",
+    "tools/release.js",
+    "tools/workflows.js",
+    "index.js",
+    "jira-client.js",
+    "notifier.js",
+    "platform-config.js",
+    "poller.js"
   ],
   "dependencies": {
     "axios": "^1.6.0",
     "dotenv": "^16.3.0"
   },
   "scripts": {
-    "test": "node --test tools.test.js tools/jabber.test.js"
+    "test": "node --import ./test-env.js --test tools.test.js tools/jabber.test.js"
   }
 }

package/platform-config.js

@@ -12,17 +12,12 @@ import {getServerList} from './tools/helpers.js';
  * 平台映射 - 將使用者友善的平台名稱對應到系統代碼
  */
 export const PLATFORM_TO_SYSTEM_CODE = {
-  cwa: SYSTEM_CODES.CWA,
-  ibk: SYSTEM_CODES.IBK,
-  eib: SYSTEM_CODES.EIB,
-  evt: SYSTEM_CODES.EVT,
-  bof: SYSTEM_CODES.BOF,
-  npm: SYSTEM_CODES.NPM,
+  ...Object.fromEntries(Object.values(SYSTEM_CODES).map((code) => [code.toLowerCase(), code])),
 };
 
 /**
  * 取得平台設定 - 根據平台名稱回傳相關設定
- * @param {string} platformName - 平台名稱 (例如 'cwa', 'ibk')
+ * @param {string} platformName - 平台名稱
  * @param {string} environment - 環境 (例如 'stg', 'prd')
  * @returns {object} 平台設定
  */

package/scripts/jabber_notify.py

@@ -13,8 +13,8 @@ Required environment variables:
     JABBER_KEYCHAIN_ACCOUNT
 
 One of the following must be set:
-    JABBER_ROOM   — MUC room JID (e.g. webqa@conference.linebank.com.tw)
-    JABBER_TO     — Direct message recipient JID (e.g. BK00178@linebank.com.tw)
+    JABBER_ROOM   — MUC room JID (e.g. room@conference.example.internal)
+    JABBER_TO     — Direct message recipient JID (e.g. user@example.internal)
 
 Optional environment variables:
     JABBER_PORT (defaults to 5222)

package/tools/grayrelease.js

@@ -9,6 +9,7 @@
  */
 import {
   SYSTEM_CODES,
+  getDeployConfig,
   ENV_CODES,
   SUPPORTED_ENVS,
   DEPT_CODES,
@@ -45,7 +46,7 @@ import { handleSendJabberMessage } from './jabber.js';
  * 簽核規則：
  *   - DEV：直接 Approve
  *   - STG：指派給當日 Release Manager，等待簽核
- *   - UAT：指派 James Yu 等待留言，再轉給 Solar Chen 等待簽核
+ *   - UAT：依 env/config 指派第一階段與最終簽核人
  *
  * Rebuild 規則：
  *   VERIFY 狀態只有在使用者明確要求 build/rebuild 時，才可透過 build_ticket({rebuild: true})
@@ -113,6 +114,21 @@ function progress(ctx, event) {
   }
 }
 
+function getJabberJid(accountId) {
+  const domain = process.env.JABBER_DOMAIN ?? getDeployConfig().jabber?.domain;
+  return domain ? `${accountId}@${domain}` : accountId;
+}
+
+function getGrayReleaseUatApprovers() {
+  const config = getDeployConfig().release.grayReleaseUatApprovers ?? {};
+  return {
+    commentReviewerAlias:
+      process.env.GRAYRELEASE_UAT_COMMENT_REVIEWER_ALIAS ?? config.commentReviewerAlias,
+    finalApproverAlias:
+      process.env.GRAYRELEASE_UAT_FINAL_APPROVER_ALIAS ?? config.finalApproverAlias,
+  };
+}
+
 function isPassingResult(value) {
   return ['pass', 'passed', 'success', 'succeeded', 'done'].includes(
     String(value ?? '').trim().toLowerCase(),
@@ -1110,7 +1126,7 @@ async function handleGrayReleaseApproval(issueKey, environment, systemCode, ctx)
     await notifier.notify(issueKey, `已指派給 STG 值班組長 ${managerName}`);
 
     // 發送 jabber 通知
-    const jabberTo = `${accountId}@linebank.com.tw`;
+    const jabberTo = getJabberJid(accountId);
     progress(ctx, {
       phase: 'waiting',
       title: '發送 GrayRelease 簽核通知',
@@ -1136,45 +1152,43 @@ async function handleGrayReleaseApproval(issueKey, environment, systemCode, ctx)
     return { approved: true, by: managerName };
   }
 
-  // UAT: assign James Yu → 等待留言 → 轉 Solar Chen → 等待 approve
+  // UAT: assign first reviewer → 等待留言 → 轉 final approver → 等待 approve
   if (env === 'uat') {
-    const jamesAccountId = resolveAccountId('James Yu');
-    if (!jamesAccountId) {
-      throw new Error('找不到 James Yu 的 accountId');
+    const {commentReviewerAlias, finalApproverAlias} = getGrayReleaseUatApprovers();
+    const commentReviewerAccountId = resolveAccountId(commentReviewerAlias);
+    if (!commentReviewerAccountId) {
+      throw new Error(`找不到 UAT 第一階段簽核人 accountId，請設定 GRAYRELEASE_UAT_COMMENT_REVIEWER_ALIAS 或 release.grayReleaseUatApprovers.commentReviewerAlias`);
     }
 
-    // Assign 給 James Yu
     progress(ctx, {
       phase: 'action',
       title: '指派 GrayRelease 簽核人',
-      detail: '部長 James Yu',
+      detail: commentReviewerAlias,
       issueKey,
     });
-    await jira.updateAssignee(issueKey, jamesAccountId);
-    await notifier.notify(issueKey, '已指派給部長 James Yu，等待留言確認');
+    await jira.updateAssignee(issueKey, commentReviewerAccountId);
+    await notifier.notify(issueKey, `已指派給 ${commentReviewerAlias}，等待留言確認`);
 
-    // 發送 jabber 通知給 James Yu
-    const jamesJabber = `${jamesAccountId}@linebank.com.tw`;
+    const commentReviewerJabber = getJabberJid(commentReviewerAccountId);
     progress(ctx, {
       phase: 'waiting',
       title: '發送 GrayRelease 簽核通知',
-      detail: `to James Yu (${jamesJabber})`,
+      detail: `to ${commentReviewerAlias} (${commentReviewerJabber})`,
       issueKey,
     });
     await handleSendJabberMessage(
       {
-        to: jamesJabber,
+        to: commentReviewerJabber,
         message: `[GrayRelease 簽核通知] ${issueKey} 需要您的簽核並留言確認。環境: UAT，系統: ${systemCode}\n${process.env.JIRA_BASE_URL}/browse/${issueKey}`,
       },
       {},
     );
 
-    // 等待 James Yu 留言 "Approved"
     const commentResult = await handleWaitForComment(
       {
         issueKey,
         keyword: 'approved',
-        authorAccountId: jamesAccountId,
+        authorAccountId: commentReviewerAccountId,
         timeoutMs: parseInt(process.env.POLL_TIMEOUT_MS ?? '3600000'),
         intervalMs: parseInt(process.env.POLL_INTERVAL_MS ?? '30000'),
       },
@@ -1183,43 +1197,40 @@ async function handleGrayReleaseApproval(issueKey, environment, systemCode, ctx)
     const commentData = parseToolResult(commentResult);
 
     if (!commentData?.found) {
-      throw new Error('等待 James Yu 留言超時');
+      throw new Error(`等待 ${commentReviewerAlias} 留言超時`);
     }
 
-    await notifier.notify(issueKey, `James Yu 已留言確認: ${commentData.comment}`);
+    await notifier.notify(issueKey, `${commentReviewerAlias} 已留言確認: ${commentData.comment}`);
 
-    // 轉給 Solar Chen
-    const solarAccountId = resolveAccountId('Solar Chen');
-    if (!solarAccountId) {
-      throw new Error('找不到 Solar Chen 的 accountId');
+    const finalApproverAccountId = resolveAccountId(finalApproverAlias);
+    if (!finalApproverAccountId) {
+      throw new Error(`找不到 UAT 最終簽核人 accountId，請設定 GRAYRELEASE_UAT_FINAL_APPROVER_ALIAS 或 release.grayReleaseUatApprovers.finalApproverAlias`);
     }
 
     progress(ctx, {
       phase: 'action',
       title: '指派 GrayRelease 簽核人',
-      detail: 'Solar Chen',
+      detail: finalApproverAlias,
       issueKey,
     });
-    await jira.updateAssignee(issueKey, solarAccountId);
-    await notifier.notify(issueKey, '已轉單給 Solar Chen，等待最終簽核');
+    await jira.updateAssignee(issueKey, finalApproverAccountId);
+    await notifier.notify(issueKey, `已轉單給 ${finalApproverAlias}，等待最終簽核`);
 
-    // 發送 jabber 通知給 Solar Chen
-    const solarJabber = `${solarAccountId}@linebank.com.tw`;
+    const finalApproverJabber = getJabberJid(finalApproverAccountId);
     progress(ctx, {
       phase: 'waiting',
       title: '發送 GrayRelease 簽核通知',
-      detail: `to Solar Chen (${solarJabber})`,
+      detail: `to ${finalApproverAlias} (${finalApproverJabber})`,
       issueKey,
     });
     await handleSendJabberMessage(
       {
-        to: solarJabber,
-        message: `[GrayRelease 簽核通知] ${issueKey} 已由 James Yu 確認，需要您的最終簽核。環境: UAT，系統: ${systemCode}\n${process.env.JIRA_BASE_URL}/browse/${issueKey}`,
+        to: finalApproverJabber,
+        message: `[GrayRelease 簽核通知] ${issueKey} 已由 ${commentReviewerAlias} 確認，需要您的最終簽核。環境: UAT，系統: ${systemCode}\n${process.env.JIRA_BASE_URL}/browse/${issueKey}`,
       },
       {},
     );
 
-    // 輪詢等待 Solar Approve（狀態變為 WAIT DEPLOY）
     const poller = new Poller(jira);
     await poller.waitForStatus(issueKey, 'WAIT DEPLOY', {
       intervalMs: parseInt(process.env.POLL_INTERVAL_MS ?? '30000'),
@@ -1227,7 +1238,7 @@ async function handleGrayReleaseApproval(issueKey, environment, systemCode, ctx)
       onProgress: ctx.progress,
     });
 
-    return { approved: true, by: 'James Yu → Solar Chen' };
+    return { approved: true, by: `${commentReviewerAlias} → ${finalApproverAlias}` };
   }
 
   throw new Error(`不支援的環境: ${environment}`);

package/tools/helpers.js

@@ -1,4 +1,4 @@
-import {SERVERS, SERVER_MODULE_MAP} from '../constants/index.js';
+import {getDeployConfig, META_TEST_NODES, SERVERS, SERVER_MODULE_MAP} from '../constants/index.js';
 
 export function ok(data) {
   return {content: [{type: 'text', text: JSON.stringify(data, null, 2)}]};
@@ -31,8 +31,7 @@ export function getServerList(systemCode, env, metaTest, module) {
 
   // metaTest 模式：ibk / cwa 只保留單一節點
   if (metaTest) {
-    const META_TEST_NODE = {IBK: 'tvprd-ibk-web05', CWA: 'tvprd-cwa-web05'};
-    if (META_TEST_NODE[systemCode]) return [META_TEST_NODE[systemCode]];
+    if (META_TEST_NODES[systemCode]) return [META_TEST_NODES[systemCode]];
   }
 
   // 如果是嵌套結構 (EIB, EVT)，依 SERVER_MODULE_MAP 選擇 was 或 web
@@ -51,27 +50,12 @@ export function getClusterList(systemCode, env, module) {
 }
 
 /**
- * 依 systemCode + module + versionName 組出 LBPRJ 版本名稱
- * 例：getModuleName('IBK', 'ssr', '1.3.1.0') → 'IBK_ssr_1.3.1.0'
- *     getModuleName('IBK', 'ibk', '1.5.2.0') → 'IBK_1.5.2.0'
- *     getModuleName('BOF', 'web', '1.0.0.0') → 'COP_WEB_1.0.0.0'
+ * 依 systemCode + module + versionName 組出 release 版本名稱。
  */
 export function getModuleName(systemCode, module, versionName) {
-  const systemMap = {BOF: 'COP'};
-  const moduleMap = {
-    cwa: '',
-    ibk: '',
-    ssr: 'ssr',
-    wealth: 'wealth',
-    a11y: 'accessibility',
-    web: 'WEB',
-    web_cust: 'CUST',
-    web_agnt: 'AGENT',
-    evt007: '',
-    evt009: '',
-    evt005: '',
-    nextjs_web: 'WEB',
-  };
+  const moduleNameConfig = getDeployConfig().moduleName;
+  const systemMap = moduleNameConfig.systemAliases ?? {};
+  const moduleMap = moduleNameConfig.moduleAliases ?? {};
   return (
     (systemMap[systemCode] || systemCode) +
     '_' +

package/tools/index.js

@@ -89,7 +89,7 @@ export function getToolDefinitions() {
         type: 'object',
         required: ['issueKey', 'transitionName'],
         properties: {
-          issueKey: { type: 'string', description: '例如 OPS-123' },
+          issueKey: { type: 'string', description: 'Jira issue key' },
           transitionName: {
             type: 'string',
             description: '狀態名稱，例如 "Pending Approval"、"Approved"、"In Progress"、"Done"',
@@ -164,8 +164,8 @@ export function getToolDefinitions() {
         type: 'object',
         required: ['inwardKey', 'outwardKey'],
         properties: {
-          inwardKey: { type: 'string', description: '被包含方 issue key，例如 CD 單 CID-1669' },
-          outwardKey: { type: 'string', description: '包含方 issue key，例如 CI 單 CID-1668' },
+          inwardKey: { type: 'string', description: '被包含方 issue key' },
+          outwardKey: { type: 'string', description: '包含方 issue key' },
           linkType: {
             type: 'string',
             description:
@@ -185,7 +185,7 @@ export function getToolDefinitions() {
         properties: {
           issueKey: {
             type: 'string',
-            description: '要 build 的 issue key，例如 CI/Library 單 CID-1668，或可重複 rebuild 的 GrayRelease 單 CID-822',
+            description: '要 build 的 issue key，例如 CI、Library 或 GrayRelease 單',
           },
           rebuild: {
             type: 'boolean',
@@ -204,7 +204,7 @@ export function getToolDefinitions() {
         properties: {
           issueKey: {
             type: 'string',
-            description: 'CI issue key，例如 CID-1668',
+            description: 'CI issue key',
           },
         },
       },
@@ -219,7 +219,7 @@ export function getToolDefinitions() {
         properties: {
           issueKey: {
             type: 'string',
-            description: 'CI issue key，例如 CID-1668',
+            description: 'CI issue key',
           },
         },
       },
@@ -234,7 +234,7 @@ export function getToolDefinitions() {
         properties: {
           cdIssueKey: {
             type: 'string',
-            description: 'CD 單 issue key，例如 CID-1710',
+            description: 'CD 單 issue key',
           },
           environment: {
             type: 'string',
@@ -258,7 +258,7 @@ export function getToolDefinitions() {
         properties: {
           issueKey: {
             type: 'string',
-            description: 'CD 單 issue key，例如 CID-1697',
+            description: 'CD 單 issue key',
           },
           environment: {
             type: 'string',
@@ -271,14 +271,14 @@ export function getToolDefinitions() {
     {
       name: 'cancel_release',
       description:
-        '取消目前進行中的 CI 單，並回傳關聯的 Library 模組清單（含 gitBranch）與其他關聯 CI 單，供後續 reroll 流程使用。當使用者說「cancel IBK release」、「取消 IBK release」、「can 掉 IBK」時使用。',
+        '取消目前進行中的 CI 單，並回傳關聯的 Library 模組清單（含 gitBranch）與其他關聯 CI 單，供後續 reroll 流程使用。',
       inputSchema: {
         type: 'object',
         required: ['systemCode'],
         properties: {
           systemCode: {
             type: 'string',
-            description: '系統代碼，例如 IBK、EIB、EVT',
+            description: '系統代碼',
           },
           ciIssueKey: {
             type: 'string',
@@ -290,14 +290,14 @@ export function getToolDefinitions() {
     {
       name: 'get_release_status',
       description:
-        '查詢指定系統代號的 Release 現況。以最新 CI 單為錨點，列出關聯的 Library 單、CD 單狀態與建議下一步。當使用者說「IBK 目前 release 到哪了」、「現在 CI 狀態怎樣」、「幫我看一下進度」時使用。',
+        '查詢指定系統代號的 Release 現況。以最新 CI 單為錨點，列出關聯的 Library 單、CD 單狀態與建議下一步。',
       inputSchema: {
         type: 'object',
         required: ['systemCode'],
         properties: {
           systemCode: {
             type: 'string',
-            description: '系統代碼，例如 IBK、EIB、EVT、CWA、BOF',
+            description: '系統代碼',
           },
         },
       },
@@ -305,22 +305,22 @@ export function getToolDefinitions() {
     {
       name: 'update_assignee',
       description:
-        '更新 Jira issue 的 Assignee。當使用者說「切單給 Solar」或「切單給 xxx(BK00129)」時使用。支援直接輸入名稱（會自動查找 accountId）或直接指定 accountId。',
+        '更新 Jira issue 的 Assignee。支援直接輸入 displayName（會從 env/config 查找 accountId）或直接指定 accountId。',
       inputSchema: {
         type: 'object',
         required: ['issueKey'],
         properties: {
           issueKey: {
             type: 'string',
-            description: '要更新的 issue key，例如 CID-1718',
+            description: '要更新的 issue key',
           },
           accountId: {
             type: 'string',
-            description: 'Jira 用戶 accountId，例如 BK00129（與 displayName 擇一填寫即可）',
+            description: 'Jira 用戶 accountId（與 displayName 擇一填寫即可）',
           },
           displayName: {
             type: 'string',
-            description: '用戶顯示名稱或暱稱，例如 Solar（系統會自動查找對應的 accountId）',
+            description: '用戶顯示名稱或暱稱（系統會自動查找對應的 accountId）',
           },
         },
       },

package/tools/jabber.js

@@ -55,7 +55,7 @@ export function getJabberToolDefinitions() {
     {
       name: 'send_jabber_message',
       description:
-        '發送訊息到 Jabber。可傳給個人（to 參數，格式 BK00xxx@linebank.com.tw）或 MUC 群組（room 參數）。' +
+        '發送訊息到 Jabber。可傳給個人（to 參數使用完整 JID）或 MUC 群組（room 參數）。' +
         '若 to/room 都未提供，則使用環境變數 JABBER_TO 或 JABBER_ROOM。' +
         '用於上版通知、請主管簽單、上版完成公告等。',
       inputSchema: {
@@ -68,11 +68,11 @@ export function getJabberToolDefinitions() {
           },
           to: {
             type: 'string',
-            description: '直接傳給個人的 JID，例如 BK00178@linebank.com.tw',
+            description: '直接傳給個人的完整 JID，例如 user@example.internal',
           },
           room: {
             type: 'string',
-            description: 'MUC 群組 JID，例如 webqa@conference.linebank.com.tw',
+            description: 'MUC 群組 JID，例如 room@conference.example.internal',
           },
         },
       },