@cloudglab/zentao-cli 0.1.4 → 0.1.6

package/dist/install.js

@@ -0,0 +1,206 @@
+import { spawn } from 'node:child_process';
+import { mkdtemp, rm } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import readline from 'node:readline';
+import { ZentaoApi } from './api/index.js';
+import { loadConfig, maskConfig, normalizeConfig, saveConfig } from './core/config.js';
+const PACKAGE_NAME = '@cloudglab/zentao-cli';
+const GIT_SKILL_SOURCE = 'cloudglab/zentao-cli';
+export async function runInstallCommand(args = []) {
+    await installPackageAndSkill('安装', parseInstallOptions(args));
+    await ensureValidZentaoConfig();
+    process.stdout.write('安装完成，禅道配置校验通过。\n');
+}
+export async function runUpdateCommand(args = []) {
+    await installPackageAndSkill('更新', parseInstallOptions(args));
+    await ensureValidZentaoConfig();
+    process.stdout.write('更新完成，禅道配置校验通过。\n');
+}
+function parseInstallOptions(args) {
+    let skillSource = 'git';
+    let skillLocalPath;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--skill-source') {
+            const value = args[index + 1];
+            if (value !== 'git' && value !== 'npm') {
+                throw new Error('--skill-source 只支持 git 或 npm');
+            }
+            skillSource = value;
+            index += 1;
+            continue;
+        }
+        if (arg === '--skill-local-path') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error('--skill-local-path 需要传入本地目录路径');
+            }
+            skillLocalPath = value;
+            index += 1;
+            continue;
+        }
+        throw new Error(`未知安装参数: ${arg}`);
+    }
+    return { skillSource, skillLocalPath };
+}
+async function installPackageAndSkill(action, options) {
+    await runStep(`${action} zentao CLI`, 'npm', ['install', '-g', `${PACKAGE_NAME}@latest`]);
+    await installSkill(action, options);
+}
+async function installSkill(action, options) {
+    if (options.skillLocalPath) {
+        await runStep(`${action} zentao skill`, 'npx', ['-y', 'skills', 'add', '-g', path.resolve(options.skillLocalPath)]);
+        return;
+    }
+    if (options.skillSource === 'git') {
+        await runStep(`${action} zentao skill`, 'npx', ['-y', 'skills', 'add', '-g', GIT_SKILL_SOURCE]);
+        return;
+    }
+    await installSkillFromNpmPackage(action);
+}
+async function installSkillFromNpmPackage(action) {
+    const tempDir = await mkdtemp(path.join(os.tmpdir(), 'zentao-cli-skill-'));
+    try {
+        const stdout = await runCommandOutput('npm', ['pack', `${PACKAGE_NAME}@latest`, '--pack-destination', tempDir, '--silent']);
+        const tarballName = stdout.trim().split('\n').filter(Boolean).at(-1);
+        if (!tarballName) {
+            throw new Error('npm pack 没有返回包文件名');
+        }
+        const tarballPath = path.join(tempDir, tarballName);
+        await runStep('解压 zentao npm 包', 'tar', ['-xzf', tarballPath, '-C', tempDir]);
+        await runStep(`${action} zentao skill`, 'npx', ['-y', 'skills', 'add', '-g', path.join(tempDir, 'package')]);
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+async function runStep(title, command, args) {
+    process.stdout.write(`\n${title}...\n`);
+    await runCommand(command, args);
+}
+function runCommand(command, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: 'inherit', shell: process.platform === 'win32' });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`${command} ${args.join(' ')} 执行失败，退出码 ${String(code)}`));
+        });
+    });
+}
+function runCommandOutput(command, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { shell: process.platform === 'win32' });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk.toString('utf8');
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString('utf8');
+        });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve(stdout);
+                return;
+            }
+            reject(new Error(`${command} ${args.join(' ')} 执行失败，退出码 ${String(code)}${stderr ? `：${stderr.trim()}` : ''}`));
+        });
+    });
+}
+async function ensureValidZentaoConfig() {
+    const existing = tryLoadConfig();
+    if (existing && await validateConfig(existing)) {
+        process.stdout.write(`\n检测到已有禅道配置，校验通过：${JSON.stringify(maskConfig(existing))}\n`);
+        return;
+    }
+    if (existing) {
+        process.stdout.write('\n检测到已有禅道配置，但登录校验失败，请重新输入。\n');
+    }
+    else {
+        process.stdout.write('\n未检测到可用禅道配置，请输入配置。\n');
+    }
+    const config = await promptForConfig(existing ?? undefined);
+    await validateConfigOrThrow(config);
+    saveConfig(config);
+    process.stdout.write(`已保存禅道配置：${JSON.stringify(maskConfig(config))}\n`);
+    if (hasZentaoEnvConfig()) {
+        process.stdout.write('提示：当前 shell 存在 ZENTAO_* 环境变量，后续命令会优先使用环境变量；如果仍登录失败，请同步更新或清除这些环境变量。\n');
+    }
+}
+function tryLoadConfig() {
+    try {
+        return loadConfig();
+    }
+    catch {
+        return null;
+    }
+}
+function hasZentaoEnvConfig() {
+    return Boolean(process.env.ZENTAO_URL || process.env.ZENTAO_USERNAME || process.env.ZENTAO_ACCOUNT || process.env.ZENTAO_PASSWORD || process.env.ZENTAO_API_BASE_URL);
+}
+async function validateConfig(config) {
+    try {
+        await validateConfigOrThrow(config);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function validateConfigOrThrow(config) {
+    const api = new ZentaoApi(config);
+    await api.getToken();
+}
+async function promptForConfig(defaults) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        throw new Error('当前不是交互式终端，无法输入配置。请先设置 ZENTAO_URL、ZENTAO_USERNAME、ZENTAO_PASSWORD 后重试。');
+    }
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const url = await ask(rl, '禅道地址', defaults?.url);
+        const username = await ask(rl, '禅道用户名', defaults?.username);
+        const password = await askPassword(rl, defaults?.password ? '禅道密码（直接回车保留原密码）' : '禅道密码');
+        const apiVersion = await ask(rl, 'API 版本', defaults?.apiVersion ?? 'v1');
+        const apiBaseUrl = await ask(rl, 'API 基础地址（可选，直接回车跳过）', defaults?.apiBaseUrl ?? '');
+        return normalizeConfig({
+            url,
+            username,
+            password: password || defaults?.password,
+            apiVersion,
+            apiBaseUrl: apiBaseUrl || undefined,
+        });
+    }
+    finally {
+        rl.close();
+    }
+}
+function ask(rl, label, defaultValue = '') {
+    const suffix = defaultValue ? ` [${defaultValue}]` : '';
+    return new Promise((resolve) => {
+        rl.question(`${label}${suffix}: `, (answer) => resolve(answer.trim() || defaultValue));
+    });
+}
+function askPassword(rl, label) {
+    const mutableRl = rl;
+    return new Promise((resolve) => {
+        mutableRl.stdoutMuted = true;
+        mutableRl.question(`${label}: `, (answer) => {
+            mutableRl.stdoutMuted = false;
+            process.stdout.write('\n');
+            resolve(answer.trim());
+        });
+        if (!mutableRl._writeToOutput)
+            return;
+        const originalWrite = mutableRl._writeToOutput.bind(rl);
+        mutableRl._writeToOutput = (value) => {
+            originalWrite(mutableRl.stdoutMuted ? '*' : value);
+        };
+    });
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}

package/dist/tools/execution.js

@@ -5,6 +5,9 @@ export function registerExecutionTools(server) {
     server.tool('getExecutionDetail', {
         executionId: z.number().int().positive(),
     }, async ({ executionId }) => jsonResult(await getApi().execution.getExecutionDetail(executionId)));
+    server.tool('getExecutionDynamic', {
+        executionId: z.number().int().positive(),
+    }, async ({ executionId }) => jsonResult(await getApi().execution.getExecutionDynamic(executionId)));
     server.tool('getProjectExecutions', {
         projectId: z.number().int().positive(),
     }, async ({ projectId }) => jsonResult(await getApi().execution.getProjectExecutions(projectId)));
@@ -17,5 +20,10 @@ export function registerExecutionTools(server) {
         limit: z.number().int().positive().max(100).optional(),
         status: z.string().optional().describe('可选，按禅道接口支持的状态过滤'),
     }, async ({ executionId, page, limit, status }) => jsonResult(await getApi().execution.getExecutionBugs(executionId, { page, limit, status })));
+    server.tool('getExecutionDailyBugStats', {
+        executionId: z.number().int().positive(),
+        iterationName: z.string().optional().describe('输出报告里的迭代名称，例如 1.2.3迭代。'),
+        date: z.string().optional().describe('统计日期，默认今天。支持 today/今天/yesterday/昨天/YYYY-MM-DD。'),
+    }, async ({ executionId, iterationName, date }) => jsonResult(await getApi().execution.getExecutionDailyBugStats(executionId, { iterationName, date })));
 }
 //# sourceMappingURL=execution.js.map

package/dist/tools/execution.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/tools/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KACzC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAChG,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KACvC,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,SAAS,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAC9F,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KACzC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAChG,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QACtD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KAC1D,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAC5I,CAAC;AACJ,CAAC"}
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/tools/execution.ts"],"names":[],"mappings":"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"}

package/dist/tools/statistics.js

@@ -6,5 +6,13 @@ export function registerStatisticsTools(server) {
     server.tool('getMyBugStatistics', {
         productId: z.number().int().positive().optional().describe('可选。禅道产品 ID。不传时统计跨所有产品指派给我的 Bug；传入时收窄到指定产品。'),
     }, async ({ productId }) => jsonResult(await getApi().statistics.getMyBugStatistics(productId)));
+    server.tool('getMyWeeklyActivity', {
+        account: z.string().min(1).describe('禅道账号，例如 lixm1。'),
+        week: z.enum(['last', 'this']).optional().default('last').describe('统计哪一周：last=上周，this=本周。'),
+        dateRange: z.string().optional().describe('自然语言日期范围，例如：上周、本周、今天、昨天、最近3天、3天前、2026-05-28、2026-05-25到2026-05-29。传入后优先于 week。'),
+        startDate: z.string().optional().describe('开始日期，例如 2026-05-25。和 endDate 搭配时优先于 week。'),
+        endDate: z.string().optional().describe('结束日期，例如 2026-05-29。和 startDate 搭配时优先于 week。'),
+        days: z.number().int().positive().optional().describe('最近 N 天，例如 3 表示最近3天。优先于 week，低于 startDate/endDate。'),
+    }, async ({ account, week, dateRange, startDate, endDate, days }) => jsonResult(await getApi().statistics.getMyWeeklyActivity({ account, week, dateRange, startDate, endDate, days })));
 }
 //# sourceMappingURL=statistics.js.map

package/dist/tools/statistics.js.map

@@ -1 +1 @@
-{"version":3,"file":"statistics.js","sourceRoot":"","sources":["../../src/tools/statistics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,uBAAuB,CAAC,MAAmB;IACzD,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;IAEhH,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KACzG,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAC7F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"statistics.js","sourceRoot":"","sources":["../../src/tools/statistics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,uBAAuB,CAAC,MAAmB;IACzD,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;IAEhH,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KACzG,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAC7F,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACrD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAC5F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;QAC3H,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QACtF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACtF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;KAC3G,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CACpL,CAAC;AACJ,CAAC"}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const CLI_VERSION = "0.1.4";
+export declare const CLI_VERSION = "0.1.6";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const CLI_VERSION = '0.1.4';
+export const CLI_VERSION = '0.1.6';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudglab/zentao-cli",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "ZenTao CLI rebuilt for ZenTao 18.5 REST v1 API",
   "repository": {
     "type": "git",
@@ -18,6 +18,7 @@
   },
   "files": [
     "dist",
+    "skills",
     "README.md",
     "CHANGELOG.md",
     "MCP_ZENTAO_REBUILD_PLAN.md"
@@ -26,7 +27,10 @@
     "build": "rm -rf dist && tsc -p tsconfig.json",
     "dev": "tsx src/bin/zentao.ts",
     "lint": "oxlint src",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "check": "pnpm lint && pnpm typecheck && pnpm test && pnpm build",
+    "prepare": "lefthook install"
   },
   "dependencies": {
     "axios": "^1.13.2",
@@ -34,9 +38,12 @@
   },
   "devDependencies": {
     "@types/node": "^20.19.25",
+    "@vitest/coverage-v8": "^4.1.8",
+    "lefthook": "^2.1.9",
     "oxlint": "^1.31.0",
     "tsx": "^4.20.6",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=16.0.0"

package/skills/zentao-cli/SKILL.md

@@ -0,0 +1,185 @@
+---
+name: zentao-cli
+description: 禅道 CLI 技能包
+triggers:
+  - zentao
+  - 禅道
+  - bug
+  - task
+  - testcase
+  - testtask
+argument-hint: "[command]"
+---
+
+# @cloudglab/zentao-cli
+
+## 概览
+
+把禅道能力暴露给命令行 / 智能体使用，默认带写保护。
+
+建议把它当成一个“命令行技能包”：先安装，再按 `reference/` 文档执行。
+
+## 入口优先级
+
+1. 本机已安装 `zentao`：直接执行
+2. 未安装时：先 `npm i -g @cloudglab/zentao-cli@latest`
+3. 如果当前环境不方便安装，再临时用 `npx -y @cloudglab/zentao-cli@latest`
+4. 需要固定版本：全局安装后再运行
+5. 默认只 preview；写操作必须显式确认
+
+## Bug 查询强制判断
+
+在调用任何 Bug 查询工具或产品查询工具前，先判断用户问的是：
+
+1. 普通禅道产品 Bug
+2. 真实业务产品的线上 Bug / 生产问题 / 客户反馈问题
+
+如果用户表达了以下任一意图，必须走“线上 Bug 查询口径”：
+
+- `<产品名> 最近一周有哪些线上 bug`
+- `<产品名> 有哪些线上问题`
+- `<产品名> 生产环境问题`
+- `<产品名> 客户反馈问题`
+- `<产品名> 售后反馈 Bug`
+- `<产品名> 线上报错`
+
+这类场景里，用户说的 `<产品名>` 是真实业务产品 / 模块名，不是禅道产品名。
+
+禁止：
+
+- 直接用这个 `<产品名>` 去匹配禅道产品
+- 先解释“找到了 `<产品名>` 对应的禅道产品”
+
+只有当用户明确说“查某个禅道产品下的 Bug”，或上下文明显不是线上 / 生产 / 客户反馈问题时，才按普通产品 Bug 查询。
+
+### 线上 Bug 固定查询口径
+
+公司线上 Bug 统一挂在禅道产品 **`市场和售后问题跟踪`** 下，再通过 Bug 模块区分真实业务产品。
+
+固定流程：
+
+1. 先 `getProducts`
+2. 找到名称为 `市场和售后问题跟踪` 的产品
+3. 用该产品 ID 调 `getProductBugs`
+4. 必要时继续分页
+5. 用 `module` / `moduleName` / `modulePath` / `path`，以及标题、关键词等字段匹配真实业务产品
+
+输出必须说明：
+
+- 查询的是固定禅道产品：`市场和售后问题跟踪`
+- 真实业务产品是通过模块匹配出来的
+- 匹配到的模块名 / 模块路径
+- 查询页数和候选 Bug 数
+- 未关闭线上 Bug、近期已解决线上 Bug、无法确认归属的疑似 Bug
+
+## 安装 / 更新
+
+一键安装 CLI + skill，并校验禅道配置：
+
+```bash
+npx -y @cloudglab/zentao-cli@latest install
+```
+
+不能访问远程 `.git` 仓库但可以访问 npm 时：
+
+```bash
+npx -y @cloudglab/zentao-cli@latest install --skill-source npm
+```
+
+已经提前下载并解压 npm 静态包时：
+
+```bash
+zentao install --skill-local-path ./package
+```
+
+更新 CLI + skill：
+
+```bash
+zentao update
+```
+
+```bash
+npm i -g @cloudglab/zentao-cli@latest
+zentao --version
+npx -y @cloudglab/zentao-cli@latest --help
+```
+
+安装 skill：
+
+```bash
+npx -y skills add -g cloudglab/zentao-cli
+```
+
+只能访问 npm 时：
+
+```bash
+npm pack @cloudglab/zentao-cli@latest
+tar -xzf cloudglab-zentao-cli-*.tgz
+npx -y skills add -g ./package
+```
+
+检查是否已安装：
+
+```bash
+command -v zentao
+zentao --version
+zentao version
+```
+
+## 启动方式
+
+```bash
+zentao help
+zentao list
+zentao version
+zentao --role qa getMyBugs --limit 50
+```
+
+或直接：
+
+```bash
+npx -y @cloudglab/zentao-cli@latest
+npx -y @cloudglab/zentao-cli@latest --role qa
+```
+
+## 文档入口
+
+- `reference/overview.md`
+- `reference/install.md`
+- `reference/cli.md`
+- `reference/task.md`
+- `reference/bug.md`
+- `reference/story.md`
+- `reference/execution.md`
+- `reference/build.md`
+- `reference/testcase.md`
+- `reference/testtask.md`
+- `reference/plan.md`
+- `reference/product.md`
+- `reference/project.md`
+- `reference/statistics.md`
+
+## 典型能力
+
+- 查任务、Bug、需求、项目、执行、构建
+- 创建 / 更新任务、构建、测试用例、测试单
+- 从 Bug 派生任务
+- 生成统计和开发上下文
+
+## 写保护
+
+默认不写入线上。
+真实写操作需要同时满足：
+
+- `ZENTAO_ENABLE_WRITE=true`
+- `confirm=true`
+
+## 运行时要求
+
+- 发布产物：`Node.js >= 16`
+- 开发 / 构建环境可以高于 16
+
+## 适用场景
+
+- 命令行手工操作禅道
+- 智能体自动化调用

package/skills/zentao-cli/reference/bug.md

@@ -0,0 +1,93 @@
+# Bug
+
+## 强制判断
+
+在调用任何 Bug 查询工具或产品查询工具前，先判断用户问的是普通禅道产品 Bug，还是线上 Bug。
+
+如果用户表达了以下任一意图，就必须走“线上 Bug 查询口径”：
+
+- `<产品名> 最近一周有哪些线上 bug`
+- `<产品名> 有哪些线上问题`
+- `<产品名> 生产环境问题`
+- `<产品名> 客户反馈问题`
+- `<产品名> 售后反馈 Bug`
+- `<产品名> 线上报错`
+
+线上 Bug 场景中，用户说的 `<产品名>` 是真实业务产品 / 模块名，不是禅道产品名。禁止直接用这个 `<产品名>` 去匹配禅道产品，也不要先解释“找到了 `<产品名>` 对应的禅道产品”。
+
+只有当用户明确说“查某个禅道产品下的 Bug”或上下文不是线上 / 生产 / 客户反馈问题时，才按普通产品 Bug 查询。
+
+## 线上 Bug 查询口径
+
+公司线上 Bug 不按真实业务产品分别挂在各自产品下管理。所有产品的线上 Bug 统一放在禅道产品 **`市场和售后问题跟踪`** 下，再通过 Bug 的模块区分真实业务产品。
+
+正确流程：
+
+1. 调用 `getProducts`，找到名称为 **`市场和售后问题跟踪`** 的产品，确认它的 `productId`
+2. 调用 `getProductBugs` 查询这个固定产品下的 Bug：
+
+```bash
+zentao getProductBugs --productId <市场和售后问题跟踪产品ID> --status all --limit 100 --order id_desc
+```
+
+3. 如果结果不足，继续分页：
+
+```bash
+zentao getProductBugs --productId <市场和售后问题跟踪产品ID> --status all --page 2 --limit 100 --order id_desc
+```
+
+4. 在返回结果中，用用户提到的真实产品名匹配 Bug 的模块字段，例如 `module`、`moduleName`、`modulePath`、`path`，以及标题、关键词等补充字段。
+5. 如果用户没有指定状态，默认同时看未关闭和近期已解决的 Bug；输出时优先展示未关闭 / 激活 / 待处理问题。
+6. 如果用户问“最近”，优先用 `openedDate`、`editedDate`、`assignedDate`、`resolvedDate`、`closedDate` 等时间字段判断；缺少时间字段时，说明只能按 `id_desc` 近似代表最近。
+
+输出必须说明：
+
+- 查询的是固定禅道产品：`市场和售后问题跟踪`
+- 真实业务产品是通过模块匹配出来的
+- 匹配到的模块名 / 模块路径
+- 查询页数和候选 Bug 数
+- 未关闭线上 Bug、近期已解决线上 Bug、无法确认是否属于该产品的疑似 Bug
+
+如果没有结果，不要直接说“产品没有 Bug”。应说明“在 `市场和售后问题跟踪` 产品下，未通过模块匹配到该真实业务产品的线上 Bug”，并建议扩大模块关键词或确认模块命名。
+
+## 查询
+
+```bash
+zentao getBugDetail --bugId <id>
+zentao getMyBugs
+zentao getMyBugs --productId <productId>
+zentao getProductBugs --productId <productId>
+```
+
+## 写入
+
+```bash
+zentao resolveBug --bugId <id> --resolution fixed --confirm true
+```
+
+## 场景
+
+- 看我的 Bug
+- 解决 Bug
+- 查看产品 Bug 列表
+- 查看某个真实业务产品的线上 Bug
+
+说明：
+
+- `getMyBugs` 不传 `productId` 时，默认查跨所有产品“指派给我的 Bug”
+- 传 `productId` 时，只查指定产品内我的 Bug
+
+## 线上 Bug 固定场景
+
+- `<产品名> 最近一周有哪些线上 bug`
+- `<产品名> 有哪些线上问题`
+- `<产品名> 生产环境问题`
+- `<产品名> 客户反馈问题`
+- `<产品名> 售后反馈 Bug`
+- `<产品名> 线上报错`
+
+## 普通产品 Bug 场景
+
+- 查某个禅道产品下的 Bug
+- 查看禅道产品 `<产品名>` 的 Bug
+- 看产品ID `<id>` 下的 Bug

package/skills/zentao-cli/reference/build.md

@@ -0,0 +1,21 @@
+# Build
+
+## 查询
+
+```bash
+zentao getProjectBuilds --projectId <projectId>
+zentao getBuildDetail --buildId <id>
+```
+
+## 写入
+
+```bash
+zentao createBuild --project <projectId> --execution <executionId> --product <productId> --name <name> --builder <user> --confirm true
+zentao updateBuild --buildId <id> --confirm true
+```
+
+## 场景
+
+- 创建版本
+- 更新版本信息
+- 查看项目版本列表

package/skills/zentao-cli/reference/cli.md

@@ -0,0 +1,25 @@
+# CLI 参考
+
+## 启动
+
+```bash
+zentao help
+zentao list
+zentao --role qa getMyBugs --limit 50
+```
+
+## 常见参数
+
+- `--role full|dev|pm|qa`
+- `--version`
+
+## 常见形式
+
+- `zentao <command> --key value`
+- `zentao --role qa <command> --key value`
+
+## 场景
+
+- 手工查数据
+- 排查问题
+- 批量执行脚本