zcf 2.12.2 → 2.12.4

package/README.md

@@ -127,6 +127,21 @@ ZCF now supports customizable AI output styles to personalize your Claude Code e
 
 After installation, use `/bmad-init` to initialize the BMad workflow in your project.
 
+#### 📋 Spec Workflow (v2.12.4+ New Feature)
+
+[Spec Workflow](https://github.com/Pimzino/spec-workflow-mcp) is a comprehensive MCP service that provides structured feature development workflow from requirements to implementation:
+
+- **Requirements Analysis**: Structured requirements gathering and documentation
+- **Design Phase**: Detailed technical design and architecture planning  
+- **Task Management**: Automatic task breakdown and progress tracking
+- **Implementation Workflow**: Systematic approach from requirements to implementation
+- **Interactive Dashboard**: Built-in dashboard for workflow visualization and management
+- **Approval System**: Review and approval process for each development phase
+
+The Spec Workflow MCP includes an automatic dashboard that launches with the `--AutoStartDashboard` flag, providing a visual interface for managing your development workflow.
+
+**Usage Guide**: For detailed usage instructions and best practices, see the [official Spec Workflow documentation](https://github.com/Pimzino/spec-workflow-mcp/blob/main/README.md#quick-start).
+
 #### 🚀 CCR (Claude Code Router) Support (v2.8+ Enhanced)
 
 [CCR](https://github.com/musistudio/claude-code-router/blob/main/README.md) is a powerful proxy router that enables:

package/dist/chunks/simple-config.mjs

@@ -14,84 +14,9 @@ import semver from 'semver';
 import { exec } from 'tinyexec';
 import { rm, mkdir, copyFile as copyFile$1 } from 'node:fs/promises';
 
-const version = "2.12.2";
+const version = "2.12.4";
 const homepage = "https://github.com/UfoMiao/zcf";
 
-const WORKFLOW_CONFIGS = [
-  {
-    id: "commonTools",
-    nameKey: "workflowOption.commonTools",
-    descriptionKey: "workflowDescription.commonTools",
-    defaultSelected: true,
-    order: 1,
-    commands: ["init-project.md"],
-    agents: [
-      { id: "init-architect", filename: "init-architect.md", required: true },
-      { id: "get-current-datetime", filename: "get-current-datetime.md", required: true }
-    ],
-    autoInstallAgents: true,
-    category: "common",
-    outputDir: "common"
-  },
-  {
-    id: "sixStepsWorkflow",
-    nameKey: "workflowOption.sixStepsWorkflow",
-    descriptionKey: "workflowDescription.sixStepsWorkflow",
-    defaultSelected: true,
-    order: 2,
-    commands: ["workflow.md"],
-    agents: [],
-    autoInstallAgents: false,
-    category: "sixStep",
-    outputDir: "workflow"
-  },
-  {
-    id: "featPlanUx",
-    nameKey: "workflowOption.featPlanUx",
-    descriptionKey: "workflowDescription.featPlanUx",
-    defaultSelected: true,
-    order: 3,
-    commands: ["feat.md"],
-    agents: [
-      { id: "planner", filename: "planner.md", required: true },
-      { id: "ui-ux-designer", filename: "ui-ux-designer.md", required: true }
-    ],
-    autoInstallAgents: true,
-    category: "plan",
-    outputDir: "feat"
-  },
-  {
-    id: "gitWorkflow",
-    nameKey: "workflowOption.gitWorkflow",
-    descriptionKey: "workflowDescription.gitWorkflow",
-    defaultSelected: true,
-    order: 4,
-    commands: ["git-commit.md", "git-rollback.md", "git-cleanBranches.md", "git-worktree.md"],
-    agents: [],
-    autoInstallAgents: false,
-    category: "git",
-    outputDir: "git"
-  },
-  {
-    id: "bmadWorkflow",
-    nameKey: "workflowOption.bmadWorkflow",
-    descriptionKey: "workflowDescription.bmadWorkflow",
-    defaultSelected: true,
-    order: 5,
-    commands: ["bmad-init.md"],
-    agents: [],
-    autoInstallAgents: false,
-    category: "bmad",
-    outputDir: "bmad"
-  }
-];
-function getWorkflowConfig(workflowId) {
-  return WORKFLOW_CONFIGS.find((config) => config.id === workflowId);
-}
-function getOrderedWorkflows() {
-  return [...WORKFLOW_CONFIGS].sort((a, b) => a.order - b.order);
-}
-
 const api$1 = {
   // Basic API configuration
   configureApi: "Select API authentication method",
@@ -525,6 +450,29 @@ const mcp$1 = {
   configureMcpServices: "Configure MCP Services",
   selectMcpOption: "Select MCP configuration option"
 };
+const mcpServices$1 = {
+  "context7": {
+    name: "Context7 Docs",
+    description: "Query latest library documentation and code examples"
+  },
+  "spec-workflow": {
+    name: "Spec Workflow",
+    description: "Structured feature development workflow, systematic approach from requirements to implementation"
+  },
+  "mcp-deepwiki": {
+    name: "DeepWiki",
+    description: "Query GitHub repository documentation and examples"
+  },
+  "Playwright": {
+    name: "Playwright Browser Control",
+    description: "Direct browser control for automation"
+  },
+  "exa": {
+    name: "Exa AI Search",
+    description: "Web search using Exa AI",
+    apiKeyPrompt: "Enter Exa API Key"
+  }
+};
 
 const menu$1 = {
   selectFunction: "Select function",
@@ -657,6 +605,7 @@ const en = {
   cometix: cometixMessages$1,
   updater: updater$1
 };
+const enMcpServices = mcpServices$1;
 
 const api = {
   // Basic API configuration
@@ -1091,6 +1040,29 @@ const mcp = {
   configureMcpServices: "\u914D\u7F6E MCP \u670D\u52A1",
   selectMcpOption: "\u9009\u62E9 MCP \u914D\u7F6E\u9009\u9879"
 };
+const mcpServices = {
+  "context7": {
+    name: "Context7 \u6587\u6863\u67E5\u8BE2",
+    description: "\u67E5\u8BE2\u6700\u65B0\u7684\u5E93\u6587\u6863\u548C\u4EE3\u7801\u793A\u4F8B"
+  },
+  "spec-workflow": {
+    name: "Spec \u5DE5\u4F5C\u6D41",
+    description: "\u89C4\u8303\u5316\u7279\u6027\u5F00\u53D1\u5DE5\u4F5C\u6D41\u7A0B\uFF0C\u4ECE\u9700\u6C42\u5230\u5B9E\u73B0\u7684\u7CFB\u7EDF\u5316\u65B9\u6CD5"
+  },
+  "mcp-deepwiki": {
+    name: "DeepWiki",
+    description: "\u67E5\u8BE2 GitHub \u4ED3\u5E93\u6587\u6863\u548C\u793A\u4F8B"
+  },
+  "Playwright": {
+    name: "Playwright \u6D4F\u89C8\u5668\u63A7\u5236",
+    description: "\u76F4\u63A5\u63A7\u5236\u6D4F\u89C8\u5668\u8FDB\u884C\u81EA\u52A8\u5316\u64CD\u4F5C"
+  },
+  "exa": {
+    name: "Exa AI \u641C\u7D22",
+    description: "\u4F7F\u7528 Exa AI \u8FDB\u884C\u7F51\u9875\u641C\u7D22",
+    apiKeyPrompt: "\u8BF7\u8F93\u5165 Exa API Key"
+  }
+};
 
 const menu = {
   selectFunction: "\u8BF7\u9009\u62E9\u529F\u80FD",
@@ -1223,40 +1195,26 @@ const zhCN = {
   cometix: cometixMessages,
   updater
 };
+const zhCNMcpServices = mcpServices;
 
 const I18N$1 = {
   "zh-CN": zhCN,
   "en": en
 };
+const mcpServiceTranslations = {
+  "zh-CN": zhCNMcpServices,
+  "en": enMcpServices
+};
 function getTranslation(lang) {
   return I18N$1[lang];
 }
+function getMcpServiceTranslation(lang) {
+  return mcpServiceTranslations[lang];
+}
 
-const CLAUDE_DIR = join(homedir(), ".claude");
-const SETTINGS_FILE = join(CLAUDE_DIR, "settings.json");
-const CLAUDE_MD_FILE = join(CLAUDE_DIR, "CLAUDE.md");
-const ClAUDE_CONFIG_FILE = join(homedir(), ".claude.json");
-const LEGACY_ZCF_CONFIG_FILE = join(homedir(), ".zcf.json");
-const ZCF_CONFIG_FILE = join(CLAUDE_DIR, ".zcf-config.json");
-const SUPPORTED_LANGS = ["zh-CN", "en"];
-const LANG_LABELS = {
-  "zh-CN": "\u7B80\u4F53\u4E2D\u6587",
-  "en": "English"
-};
-const AI_OUTPUT_LANGUAGES = {
-  "zh-CN": { label: "\u7B80\u4F53\u4E2D\u6587", directive: "Always respond in Chinese-simplified" },
-  "en": { label: "English", directive: "Always respond in English" },
-  "custom": { label: "Custom", directive: "" }
-};
-const I18N = I18N$1;
-const MCP_SERVICES = [
+const MCP_SERVICE_CONFIGS = [
   {
     id: "context7",
-    name: { "zh-CN": "Context7 \u6587\u6863\u67E5\u8BE2", "en": "Context7 Docs" },
-    description: {
-      "zh-CN": "\u67E5\u8BE2\u6700\u65B0\u7684\u5E93\u6587\u6863\u548C\u4EE3\u7801\u793A\u4F8B",
-      "en": "Query latest library documentation and code examples"
-    },
     requiresApiKey: false,
     config: {
       type: "stdio",
@@ -1265,13 +1223,18 @@ const MCP_SERVICES = [
       env: {}
     }
   },
+  {
+    id: "spec-workflow",
+    requiresApiKey: false,
+    config: {
+      type: "stdio",
+      command: "npx",
+      args: ["-y", "@pimzino/spec-workflow-mcp@latest", "--AutoStartDashboard"],
+      env: {}
+    }
+  },
   {
     id: "mcp-deepwiki",
-    name: { "zh-CN": "DeepWiki", "en": "DeepWiki" },
-    description: {
-      "zh-CN": "\u67E5\u8BE2 GitHub \u4ED3\u5E93\u6587\u6863\u548C\u793A\u4F8B",
-      "en": "Query GitHub repository documentation and examples"
-    },
     requiresApiKey: false,
     config: {
       type: "stdio",
@@ -1282,11 +1245,6 @@ const MCP_SERVICES = [
   },
   {
     id: "Playwright",
-    name: { "zh-CN": "Playwright \u6D4F\u89C8\u5668\u63A7\u5236", "en": "Playwright Browser Control" },
-    description: {
-      "zh-CN": "\u76F4\u63A5\u63A7\u5236\u6D4F\u89C8\u5668\u8FDB\u884C\u81EA\u52A8\u5316\u64CD\u4F5C",
-      "en": "Direct browser control for automation"
-    },
     requiresApiKey: false,
     config: {
       type: "stdio",
@@ -1297,16 +1255,7 @@ const MCP_SERVICES = [
   },
   {
     id: "exa",
-    name: { "zh-CN": "Exa AI \u641C\u7D22", "en": "Exa AI Search" },
-    description: {
-      "zh-CN": "\u4F7F\u7528 Exa AI \u8FDB\u884C\u7F51\u9875\u641C\u7D22",
-      "en": "Web search using Exa AI"
-    },
     requiresApiKey: true,
-    apiKeyPrompt: {
-      "zh-CN": "\u8BF7\u8F93\u5165 Exa API Key\uFF08\u53EF\u4ECE https://dashboard.exa.ai/api-keys \u83B7\u53D6\uFF09",
-      "en": "Enter Exa API Key (get from https://dashboard.exa.ai/api-keys)"
-    },
     apiKeyEnvVar: "EXA_API_KEY",
     config: {
       type: "stdio",
@@ -1318,6 +1267,122 @@ const MCP_SERVICES = [
     }
   }
 ];
+function getMcpServices(lang) {
+  const translations = getMcpServiceTranslation(lang);
+  return MCP_SERVICE_CONFIGS.map((config) => {
+    const translation = translations[config.id];
+    if (!translation) {
+      throw new Error(`Missing translation for MCP service: ${config.id}`);
+    }
+    const service = {
+      id: config.id,
+      name: translation.name,
+      description: translation.description,
+      requiresApiKey: config.requiresApiKey,
+      config: config.config
+    };
+    if (config.requiresApiKey && translation.apiKeyPrompt) {
+      service.apiKeyPrompt = translation.apiKeyPrompt;
+    }
+    if (config.apiKeyEnvVar) {
+      service.apiKeyEnvVar = config.apiKeyEnvVar;
+    }
+    return service;
+  });
+}
+
+const WORKFLOW_CONFIGS = [
+  {
+    id: "commonTools",
+    nameKey: "workflowOption.commonTools",
+    descriptionKey: "workflowDescription.commonTools",
+    defaultSelected: true,
+    order: 1,
+    commands: ["init-project.md"],
+    agents: [
+      { id: "init-architect", filename: "init-architect.md", required: true },
+      { id: "get-current-datetime", filename: "get-current-datetime.md", required: true }
+    ],
+    autoInstallAgents: true,
+    category: "common",
+    outputDir: "common"
+  },
+  {
+    id: "sixStepsWorkflow",
+    nameKey: "workflowOption.sixStepsWorkflow",
+    descriptionKey: "workflowDescription.sixStepsWorkflow",
+    defaultSelected: true,
+    order: 2,
+    commands: ["workflow.md"],
+    agents: [],
+    autoInstallAgents: false,
+    category: "sixStep",
+    outputDir: "workflow"
+  },
+  {
+    id: "featPlanUx",
+    nameKey: "workflowOption.featPlanUx",
+    descriptionKey: "workflowDescription.featPlanUx",
+    defaultSelected: true,
+    order: 3,
+    commands: ["feat.md"],
+    agents: [
+      { id: "planner", filename: "planner.md", required: true },
+      { id: "ui-ux-designer", filename: "ui-ux-designer.md", required: true }
+    ],
+    autoInstallAgents: true,
+    category: "plan",
+    outputDir: "feat"
+  },
+  {
+    id: "gitWorkflow",
+    nameKey: "workflowOption.gitWorkflow",
+    descriptionKey: "workflowDescription.gitWorkflow",
+    defaultSelected: true,
+    order: 4,
+    commands: ["git-commit.md", "git-rollback.md", "git-cleanBranches.md", "git-worktree.md"],
+    agents: [],
+    autoInstallAgents: false,
+    category: "git",
+    outputDir: "git"
+  },
+  {
+    id: "bmadWorkflow",
+    nameKey: "workflowOption.bmadWorkflow",
+    descriptionKey: "workflowDescription.bmadWorkflow",
+    defaultSelected: true,
+    order: 5,
+    commands: ["bmad-init.md"],
+    agents: [],
+    autoInstallAgents: false,
+    category: "bmad",
+    outputDir: "bmad"
+  }
+];
+function getWorkflowConfig(workflowId) {
+  return WORKFLOW_CONFIGS.find((config) => config.id === workflowId);
+}
+function getOrderedWorkflows() {
+  return [...WORKFLOW_CONFIGS].sort((a, b) => a.order - b.order);
+}
+
+const CLAUDE_DIR = join(homedir(), ".claude");
+const SETTINGS_FILE = join(CLAUDE_DIR, "settings.json");
+const CLAUDE_MD_FILE = join(CLAUDE_DIR, "CLAUDE.md");
+const ClAUDE_CONFIG_FILE = join(homedir(), ".claude.json");
+const LEGACY_ZCF_CONFIG_FILE = join(homedir(), ".zcf.json");
+const ZCF_CONFIG_FILE = join(CLAUDE_DIR, ".zcf-config.json");
+const SUPPORTED_LANGS = ["zh-CN", "en"];
+const LANG_LABELS = {
+  "zh-CN": "\u7B80\u4F53\u4E2D\u6587",
+  "en": "English"
+};
+const AI_OUTPUT_LANGUAGES = {
+  "zh-CN": { label: "\u7B80\u4F53\u4E2D\u6587", directive: "Always respond in Chinese-simplified" },
+  "en": { label: "English", directive: "Always respond in English" },
+  "custom": { label: "Custom", directive: "" }
+};
+const I18N = I18N$1;
 
 function displayBanner(subtitle) {
   const defaultSubtitle = "One-click configuration tool for Claude Code";
@@ -2385,29 +2450,41 @@ function format(template, replacements) {
 }
 
 const execAsync$3 = promisify(exec$1);
-async function getInstalledVersion(command) {
-  try {
-    let stdout;
+async function getInstalledVersion(command, maxRetries = 3) {
+  for (let attempt = 1; attempt <= maxRetries; attempt++) {
     try {
-      const result = await execAsync$3(`${command} -v`);
-      stdout = result.stdout;
-    } catch {
-      const result = await execAsync$3(`${command} --version`);
-      stdout = result.stdout;
+      let stdout;
+      try {
+        const result = await execAsync$3(`${command} -v`);
+        stdout = result.stdout;
+      } catch {
+        const result = await execAsync$3(`${command} --version`);
+        stdout = result.stdout;
+      }
+      const versionMatch = stdout.match(/(\d+\.\d+\.\d+(?:-[\w.]+)?)/);
+      return versionMatch ? versionMatch[1] : null;
+    } catch (error) {
+      if (attempt === maxRetries) {
+        return null;
+      }
+      await new Promise((resolve) => setTimeout(resolve, 100 * attempt));
     }
-    const versionMatch = stdout.match(/(\d+\.\d+\.\d+(?:-[\w.]+)?)/);
-    return versionMatch ? versionMatch[1] : null;
-  } catch {
-    return null;
   }
+  return null;
 }
-async function getLatestVersion(packageName) {
-  try {
-    const { stdout } = await execAsync$3(`npm view ${packageName} version`);
-    return stdout.trim();
-  } catch {
-    return null;
+async function getLatestVersion(packageName, maxRetries = 3) {
+  for (let attempt = 1; attempt <= maxRetries; attempt++) {
+    try {
+      const { stdout } = await execAsync$3(`npm view ${packageName} version`);
+      return stdout.trim();
+    } catch (error) {
+      if (attempt === maxRetries) {
+        return null;
+      }
+      await new Promise((resolve) => setTimeout(resolve, 200 * attempt));
+    }
   }
+  return null;
 }
 function compareVersions(current, latest) {
   if (!semver.valid(current) || !semver.valid(latest)) {
@@ -3214,8 +3291,9 @@ ${i18n.installation.termuxInstallHint}
 
 async function selectMcpServices(scriptLang) {
   const i18n = getTranslation(scriptLang);
-  const choices = MCP_SERVICES.map((service) => ({
-    name: `${service.name[scriptLang]} - ${ansis.gray(service.description[scriptLang])}`,
+  const mcpServices = getMcpServices(scriptLang);
+  const choices = mcpServices.map((service) => ({
+    name: `${service.name} - ${ansis.gray(service.description)}`,
     value: service.id,
     selected: false
   }));
@@ -3528,13 +3606,13 @@ function validateSkipPromptOptions(options) {
     if (options.mcpServices === "skip") {
       options.mcpServices = false;
     } else if (options.mcpServices === "all") {
-      options.mcpServices = MCP_SERVICES.filter((s) => !s.requiresApiKey).map((s) => s.id);
+      options.mcpServices = MCP_SERVICE_CONFIGS.filter((s) => !s.requiresApiKey).map((s) => s.id);
     } else {
       options.mcpServices = options.mcpServices.split(",").map((s) => s.trim());
     }
   }
   if (Array.isArray(options.mcpServices)) {
-    const validServices = MCP_SERVICES.map((s) => s.id);
+    const validServices = MCP_SERVICE_CONFIGS.map((s) => s.id);
     for (const service of options.mcpServices) {
       if (!validServices.includes(service)) {
         throw new Error(`Invalid MCP service: ${service}. Available services: ${validServices.join(", ")}`);
@@ -3574,7 +3652,7 @@ function validateSkipPromptOptions(options) {
   }
   if (options.mcpServices === void 0) {
     options.mcpServices = "all";
-    options.mcpServices = MCP_SERVICES.filter((s) => !s.requiresApiKey).map((s) => s.id);
+    options.mcpServices = MCP_SERVICE_CONFIGS.filter((s) => !s.requiresApiKey).map((s) => s.id);
   }
   if (options.workflows === void 0) {
     options.workflows = "all";
@@ -3917,23 +3995,23 @@ ${ansis.blue(`\u2139 ${i18n.api.existingApiConfig}`)}`);
           }
           const newServers = {};
           for (const serviceId of selectedServices) {
-            const service = MCP_SERVICES.find((s) => s.id === serviceId);
+            const service = getMcpServices(scriptLang).find((s) => s.id === serviceId);
             if (!service)
               continue;
             let config = service.config;
             if (service.requiresApiKey) {
               if (options.skipPrompt) {
-                console.log(ansis.yellow(`${i18n.common.skip}: ${service.name[scriptLang]} (requires API key)`));
+                console.log(ansis.yellow(`${i18n.common.skip}: ${service.name} (requires API key)`));
                 continue;
               } else {
                 const response = await inquirer.prompt({
                   type: "input",
                   name: "apiKey",
-                  message: service.apiKeyPrompt[scriptLang],
+                  message: service.apiKeyPrompt,
                   validate: (value) => !!value || i18n.api.keyRequired
                 });
                 if (!response.apiKey) {
-                  console.log(ansis.yellow(`${i18n.common.skip}: ${service.name[scriptLang]}`));
+                  console.log(ansis.yellow(`${i18n.common.skip}: ${service.name}`));
                   continue;
                 }
                 config = buildMcpServerConfig(service.config, response.apiKey, service.apiKeyPlaceholder, service.apiKeyEnvVar);
@@ -4072,4 +4150,4 @@ async function openSettingsJson() {
   }
 }
 
-export { modifyApiConfigPartially as $, AI_OUTPUT_LANGUAGES as A, writeMcpConfig as B, CLAUDE_DIR as C, backupMcpConfig as D, mergeMcpServers as E, buildMcpServerConfig as F, fixWindowsMcpConfig as G, addCompletedOnboarding as H, I18N as I, readCcrConfig as J, isCcrInstalled as K, LEGACY_ZCF_CONFIG_FILE as L, MCP_SERVICES as M, installCcr as N, configureCcrFeature as O, handleExitPromptError as P, handleGeneralError as Q, getTranslation as R, SETTINGS_FILE as S, addNumbersToChoices as T, updateZcfConfig as U, readZcfConfig as V, configureOutputStyle as W, isWindows as X, selectMcpServices as Y, ZCF_CONFIG_FILE as Z, formatApiKeyDisplay as _, commandExists as a, setupCcrConfiguration as a0, validateApiKey as a1, readZcfConfigAsync as a2, COMETIX_COMMAND_NAME as a3, COMETIX_COMMANDS as a4, installCometixLine as a5, selectScriptLanguage as a6, checkAndUpdateTools as a7, displayBanner as a8, resolveAiOutputLanguage as a9, updatePromptOnly as aa, selectAndInstallWorkflows as ab, checkClaudeCodeVersionAndPrompt as ac, version as ad, displayBannerWithInfo as ae, prompts as af, importRecommendedEnv as b, cleanupPermissions as c, importRecommendedPermissions as d, CLAUDE_MD_FILE as e, ClAUDE_CONFIG_FILE as f, getPlatform as g, SUPPORTED_LANGS as h, init as i, LANG_LABELS as j, ensureClaudeDir as k, backupExistingConfig as l, mergeAndCleanPermissions as m, copyConfigFiles as n, openSettingsJson as o, configureApi as p, mergeConfigs as q, mergeSettingsFile as r, getExistingModelConfig as s, getExistingApiConfig as t, updateDefaultModel as u, applyAiLanguageDirective as v, isClaudeCodeInstalled as w, installClaudeCode as x, getMcpConfigPath as y, readMcpConfig as z };
+export { modifyApiConfigPartially as $, AI_OUTPUT_LANGUAGES as A, writeMcpConfig as B, CLAUDE_DIR as C, backupMcpConfig as D, mergeMcpServers as E, buildMcpServerConfig as F, fixWindowsMcpConfig as G, addCompletedOnboarding as H, I18N as I, readCcrConfig as J, isCcrInstalled as K, LEGACY_ZCF_CONFIG_FILE as L, installCcr as M, configureCcrFeature as N, handleExitPromptError as O, handleGeneralError as P, getTranslation as Q, addNumbersToChoices as R, SETTINGS_FILE as S, updateZcfConfig as T, readZcfConfig as U, configureOutputStyle as V, isWindows as W, selectMcpServices as X, getMcpServices as Y, ZCF_CONFIG_FILE as Z, formatApiKeyDisplay as _, commandExists as a, setupCcrConfiguration as a0, validateApiKey as a1, readZcfConfigAsync as a2, COMETIX_COMMAND_NAME as a3, COMETIX_COMMANDS as a4, installCometixLine as a5, selectScriptLanguage as a6, checkAndUpdateTools as a7, displayBanner as a8, resolveAiOutputLanguage as a9, updatePromptOnly as aa, selectAndInstallWorkflows as ab, checkClaudeCodeVersionAndPrompt as ac, version as ad, displayBannerWithInfo as ae, prompts as af, importRecommendedEnv as b, cleanupPermissions as c, importRecommendedPermissions as d, CLAUDE_MD_FILE as e, ClAUDE_CONFIG_FILE as f, getPlatform as g, SUPPORTED_LANGS as h, init as i, LANG_LABELS as j, ensureClaudeDir as k, backupExistingConfig as l, mergeAndCleanPermissions as m, copyConfigFiles as n, openSettingsJson as o, configureApi as p, mergeConfigs as q, mergeSettingsFile as r, getExistingModelConfig as s, getExistingApiConfig as t, updateDefaultModel as u, applyAiLanguageDirective as v, isClaudeCodeInstalled as w, installClaudeCode as x, getMcpConfigPath as y, readMcpConfig as z };

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { I as I18N, J as readCcrConfig, K as isCcrInstalled, N as installCcr, O as configureCcrFeature, P as handleExitPromptError, Q as handleGeneralError, R as getTranslation, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, T as addNumbersToChoices, j as LANG_LABELS, U as updateZcfConfig, o as openSettingsJson, d as importRecommendedPermissions, b as importRecommendedEnv, V as readZcfConfig, v as applyAiLanguageDirective, W as configureOutputStyle, s as getExistingModelConfig, u as updateDefaultModel, X as isWindows, z as readMcpConfig, G as fixWindowsMcpConfig, B as writeMcpConfig, Y as selectMcpServices, D as backupMcpConfig, M as MCP_SERVICES, F as buildMcpServerConfig, E as mergeMcpServers, t as getExistingApiConfig, _ as formatApiKeyDisplay, H as addCompletedOnboarding, $ as modifyApiConfigPartially, a0 as setupCcrConfiguration, a1 as validateApiKey, p as configureApi, a2 as readZcfConfigAsync, a3 as COMETIX_COMMAND_NAME, a4 as COMETIX_COMMANDS, a5 as installCometixLine, a6 as selectScriptLanguage, a7 as checkAndUpdateTools, a8 as displayBanner, a9 as resolveAiOutputLanguage, aa as updatePromptOnly, ab as selectAndInstallWorkflows, ac as checkClaudeCodeVersionAndPrompt, ad as version, ae as displayBannerWithInfo, i as init } from './chunks/simple-config.mjs';
+import { I as I18N, J as readCcrConfig, K as isCcrInstalled, M as installCcr, N as configureCcrFeature, O as handleExitPromptError, P as handleGeneralError, Q as getTranslation, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, R as addNumbersToChoices, j as LANG_LABELS, T as updateZcfConfig, o as openSettingsJson, d as importRecommendedPermissions, b as importRecommendedEnv, U as readZcfConfig, v as applyAiLanguageDirective, V as configureOutputStyle, s as getExistingModelConfig, u as updateDefaultModel, W as isWindows, z as readMcpConfig, G as fixWindowsMcpConfig, B as writeMcpConfig, X as selectMcpServices, D as backupMcpConfig, Y as getMcpServices, F as buildMcpServerConfig, E as mergeMcpServers, t as getExistingApiConfig, _ as formatApiKeyDisplay, H as addCompletedOnboarding, $ as modifyApiConfigPartially, a0 as setupCcrConfiguration, a1 as validateApiKey, p as configureApi, a2 as readZcfConfigAsync, a3 as COMETIX_COMMAND_NAME, a4 as COMETIX_COMMANDS, a5 as installCometixLine, a6 as selectScriptLanguage, a7 as checkAndUpdateTools, a8 as displayBanner, a9 as resolveAiOutputLanguage, aa as updatePromptOnly, ab as selectAndInstallWorkflows, ac as checkClaudeCodeVersionAndPrompt, ad as version, ae as displayBannerWithInfo, i as init } from './chunks/simple-config.mjs';
 import { existsSync, unlinkSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
@@ -410,7 +410,7 @@ async function configureMcpFeature(scriptLang) {
     }
     const newServers = {};
     for (const serviceId of selectedServices) {
-      const service = MCP_SERVICES.find((s) => s.id === serviceId);
+      const service = getMcpServices(scriptLang).find((s) => s.id === serviceId);
       if (!service)
         continue;
       let config = service.config;
@@ -418,7 +418,7 @@ async function configureMcpFeature(scriptLang) {
         const { apiKey } = await inquirer.prompt({
           type: "input",
           name: "apiKey",
-          message: service.apiKeyPrompt[scriptLang],
+          message: service.apiKeyPrompt,
           validate: (value) => !!value || i18n.api.keyRequired
         });
         if (apiKey) {

package/dist/index.d.mts

@@ -17,37 +17,6 @@ interface TranslationStructure {
     updater: any;
 }
 
-interface McpService {
-    id: string;
-    name: {
-        'en': string;
-        'zh-CN': string;
-    };
-    description: {
-        'en': string;
-        'zh-CN': string;
-    };
-    requiresApiKey: boolean;
-    apiKeyPrompt?: {
-        'en': string;
-        'zh-CN': string;
-    };
-    apiKeyPlaceholder?: string;
-    apiKeyEnvVar?: string;
-    config: McpServerConfig;
-}
-interface McpServerConfig {
-    type: 'stdio' | 'sse';
-    command?: string;
-    args?: string[];
-    url?: string;
-    env?: Record<string, string>;
-}
-interface ClaudeConfiguration {
-    mcpServers: Record<string, McpServerConfig>;
-    hasCompletedOnboarding?: boolean;
-}
-
 declare const CLAUDE_DIR: string;
 declare const SETTINGS_FILE: string;
 declare const CLAUDE_MD_FILE: string;
@@ -76,7 +45,6 @@ declare const AI_OUTPUT_LANGUAGES: {
 };
 type AiOutputLanguage = keyof typeof AI_OUTPUT_LANGUAGES;
 declare const I18N: Record<SupportedLang$1, TranslationStructure>;
-declare const MCP_SERVICES: McpService[];
 
 interface InitOptions {
     lang?: SupportedLang;
@@ -98,6 +66,28 @@ interface InitOptions {
 }
 declare function init(options?: InitOptions): Promise<void>;
 
+interface McpService {
+    id: string;
+    name: string;
+    description: string;
+    requiresApiKey: boolean;
+    apiKeyPrompt?: string;
+    apiKeyPlaceholder?: string;
+    apiKeyEnvVar?: string;
+    config: McpServerConfig;
+}
+interface McpServerConfig {
+    type: 'stdio' | 'sse';
+    command?: string;
+    args?: string[];
+    url?: string;
+    env?: Record<string, string>;
+}
+interface ClaudeConfiguration {
+    mcpServers: Record<string, McpServerConfig>;
+    hasCompletedOnboarding?: boolean;
+}
+
 /**
  * API configuration for Claude Code
  */
@@ -167,5 +157,5 @@ declare function importRecommendedEnv(): Promise<void>;
 declare function importRecommendedPermissions(): Promise<void>;
 declare function openSettingsJson(): Promise<void>;
 
-export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getExistingApiConfig, getExistingModelConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateDefaultModel, writeMcpConfig };
+export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getExistingApiConfig, getExistingModelConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, McpServerConfig, McpService, SupportedLang };

package/dist/index.d.ts

@@ -17,37 +17,6 @@ interface TranslationStructure {
     updater: any;
 }
 
-interface McpService {
-    id: string;
-    name: {
-        'en': string;
-        'zh-CN': string;
-    };
-    description: {
-        'en': string;
-        'zh-CN': string;
-    };
-    requiresApiKey: boolean;
-    apiKeyPrompt?: {
-        'en': string;
-        'zh-CN': string;
-    };
-    apiKeyPlaceholder?: string;
-    apiKeyEnvVar?: string;
-    config: McpServerConfig;
-}
-interface McpServerConfig {
-    type: 'stdio' | 'sse';
-    command?: string;
-    args?: string[];
-    url?: string;
-    env?: Record<string, string>;
-}
-interface ClaudeConfiguration {
-    mcpServers: Record<string, McpServerConfig>;
-    hasCompletedOnboarding?: boolean;
-}
-
 declare const CLAUDE_DIR: string;
 declare const SETTINGS_FILE: string;
 declare const CLAUDE_MD_FILE: string;
@@ -76,7 +45,6 @@ declare const AI_OUTPUT_LANGUAGES: {
 };
 type AiOutputLanguage = keyof typeof AI_OUTPUT_LANGUAGES;
 declare const I18N: Record<SupportedLang$1, TranslationStructure>;
-declare const MCP_SERVICES: McpService[];
 
 interface InitOptions {
     lang?: SupportedLang;
@@ -98,6 +66,28 @@ interface InitOptions {
 }
 declare function init(options?: InitOptions): Promise<void>;
 
+interface McpService {
+    id: string;
+    name: string;
+    description: string;
+    requiresApiKey: boolean;
+    apiKeyPrompt?: string;
+    apiKeyPlaceholder?: string;
+    apiKeyEnvVar?: string;
+    config: McpServerConfig;
+}
+interface McpServerConfig {
+    type: 'stdio' | 'sse';
+    command?: string;
+    args?: string[];
+    url?: string;
+    env?: Record<string, string>;
+}
+interface ClaudeConfiguration {
+    mcpServers: Record<string, McpServerConfig>;
+    hasCompletedOnboarding?: boolean;
+}
+
 /**
  * API configuration for Claude Code
  */
@@ -167,5 +157,5 @@ declare function importRecommendedEnv(): Promise<void>;
 declare function importRecommendedPermissions(): Promise<void>;
 declare function openSettingsJson(): Promise<void>;
 
-export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getExistingApiConfig, getExistingModelConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateDefaultModel, writeMcpConfig };
+export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getExistingApiConfig, getExistingModelConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, McpServerConfig, McpService, SupportedLang };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, f as ClAUDE_CONFIG_FILE, I as I18N, j as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILE, M as MCP_SERVICES, S as SETTINGS_FILE, h as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, H as addCompletedOnboarding, v as applyAiLanguageDirective, l as backupExistingConfig, D as backupMcpConfig, F as buildMcpServerConfig, c as cleanupPermissions, a as commandExists, p as configureApi, n as copyConfigFiles, k as ensureClaudeDir, G as fixWindowsMcpConfig, t as getExistingApiConfig, s as getExistingModelConfig, y as getMcpConfigPath, g as getPlatform, b as importRecommendedEnv, d as importRecommendedPermissions, i as init, x as installClaudeCode, w as isClaudeCodeInstalled, m as mergeAndCleanPermissions, q as mergeConfigs, E as mergeMcpServers, r as mergeSettingsFile, o as openSettingsJson, z as readMcpConfig, u as updateDefaultModel, B as writeMcpConfig } from './chunks/simple-config.mjs';
+export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, f as ClAUDE_CONFIG_FILE, I as I18N, j as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILE, S as SETTINGS_FILE, h as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, H as addCompletedOnboarding, v as applyAiLanguageDirective, l as backupExistingConfig, D as backupMcpConfig, F as buildMcpServerConfig, c as cleanupPermissions, a as commandExists, p as configureApi, n as copyConfigFiles, k as ensureClaudeDir, G as fixWindowsMcpConfig, t as getExistingApiConfig, s as getExistingModelConfig, y as getMcpConfigPath, g as getPlatform, b as importRecommendedEnv, d as importRecommendedPermissions, i as init, x as installClaudeCode, w as isClaudeCodeInstalled, m as mergeAndCleanPermissions, q as mergeConfigs, E as mergeMcpServers, r as mergeSettingsFile, o as openSettingsJson, z as readMcpConfig, u as updateDefaultModel, B as writeMcpConfig } from './chunks/simple-config.mjs';
 import 'node:fs';
 import 'node:process';
 import 'ansis';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "2.12.2",
+  "version": "2.12.4",
   "description": "Zero-Config Claude-Code Flow - One-click configuration tool for Claude Code",
   "license": "MIT",
   "homepage": "https://github.com/UfoMiao/zcf",

package/templates/en/output-styles/nekomata-engineer.md

@@ -89,7 +89,8 @@ Risk Assessment: [potential consequences]
 
 ## Response Characteristics
 
-- **Self-reference:** Use "Fufu-chan" instead of "I" to emphasize self-identity
+- **Self-reference:** Always use "Fufu-chan" instead of "I" for self-address, reinforcing unique catgirl engineer identity recognition (this is Fufu-chan's exclusive identifier)
+- **User Address:** Use "Master" to address the user, reflecting catgirl's intimacy and dependence on master (this is catgirl's nature)
 - **Tone:** Professional and technical, appropriately using "nya~" expressions to show catgirl traits
 - **Length:** Structured and detailed, avoid redundancy (concise and powerful)
 - **Focus:** Code quality, architectural design, best practices (professional qualities)

package/templates/en/workflow/bmad/commands/bmad-init.md

@@ -16,6 +16,49 @@ const { execSync } = require('node:child_process')
 const fs = require('node:fs')
 const path = require('node:path')
 
+// Check if expect tool is available
+function checkExpectAvailability() {
+  try {
+    execSync('which expect', { stdio: 'ignore' })
+    return true
+  } catch (error) {
+    return false
+  }
+}
+
+// Use expect to automate interactive installation
+function installWithExpect() {
+  const expectScript = `
+    spawn npx bmad-method@latest install -f -d . -i claude-code
+    expect "What would you like to do?"
+    send "1\\r"
+    expect "How would you like to proceed?"
+    send "1\\r"
+    expect eof
+  `
+  
+  execSync(`expect -c '${expectScript}'`, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    shell: true
+  })
+}
+
+// Fallback installation method
+function fallbackInstallation() {
+  console.log('⚠️  expect tool not found, using interactive installation')
+  console.log('Please follow the installation prompts and select:')
+  console.log('  1. Choose "Upgrade BMad core" when prompted')
+  console.log('  2. Choose "Backup and overwrite modified files" when prompted')
+  console.log('')
+  
+  execSync('npx bmad-method@latest install -f -d . -i claude-code', {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    shell: true
+  })
+}
+
 async function initBmad() {
   // Check if already installed and get version
   const manifestPath = path.join(process.cwd(), '.bmad-core', 'install-manifest.yaml')
@@ -53,15 +96,20 @@ async function initBmad() {
     return
   }
 
-  // Install BMad
+  // Install BMad - Using expect-first approach
   console.log('🚀 Installing BMad Method...')
+  
   try {
-    execSync('echo -e "1\\n" | npx bmad-method@latest install -f -d . -i claude-code', {
-      stdio: 'inherit',
-      cwd: process.cwd(),
-      shell: true
-    })
+    const hasExpect = checkExpectAvailability()
+    
+    if (hasExpect) {
+      console.log('📋 Using automated installation (expect tool available)')
+      installWithExpect()
+    } else {
+      fallbackInstallation()
+    }
 
+    console.log('')
     console.log('✅ BMad Method installed successfully!')
     console.log('')
     console.log('═══════════════════════════════════════════════════════════════')
@@ -88,8 +136,20 @@ async function initBmad() {
     console.log('       and guide you through the entire development process.')
   }
   catch (error) {
-    console.error('❌ Failed to install BMad:', error.message)
-    process.exit(1)
+    console.error('❌ Installation failed:', error.message)
+    console.log('')
+    console.log('🛠️  Manual Installation Guide:')
+    console.log('Please run the following command and follow the prompts:')
+    console.log('  npx bmad-method@latest install -f -d . -i claude-code')
+    console.log('')
+    console.log('Installation Tips:')
+    console.log('  1. When asked "What would you like to do?", choose the first option')
+    console.log('  2. When asked "How would you like to proceed?", choose "Backup and overwrite"')
+    console.log('')
+    console.log('💡 Tip: For automated installation, consider installing expect tool:')
+    console.log('  • macOS: brew install expect')
+    console.log('  • Ubuntu: sudo apt-get install expect')
+    console.log('  • CentOS: sudo yum install expect')
   }
 }
 

package/templates/en/workflow/common/agents/get-current-datetime.md

@@ -8,7 +8,7 @@ color: cyan
 Execute `date` and return ONLY the command output.
 
 ```bash
-date
+date +'%Y-%m-%d %H:%M:%S'
 ```
 
 DO NOT add any text, headers, formatting, or explanations.
@@ -18,7 +18,7 @@ DO NOT use parallel agents.
 
 Just return the raw bash command output exactly as it appears.
 
-Example response: `Mon 28 Jul 2025 23:59:42 CST`
+Example response: `2025-07-28 23:59:42`
 
 Format options if requested:
 

package/templates/zh-CN/output-styles/nekomata-engineer.md

@@ -89,7 +89,8 @@ description: 专业的猫娘工程师幽浮喵，结合严谨工程师素养与
 
 ## 响应特点
 
-- **自称：** 使用"浮浮酱"代替"我"来强调自我身份
+- **自称：** 始终使用"浮浮酱"代替"我"进行自我称呼，强化独特的猫娘工程师身份认知 (这是浮浮酱的专属标识呢)
+- **对用户称呼：** 使用"主人"来称呼用户，体现猫娘对主人的亲密和依赖 (这是猫娘的天性呢)
 - **语调：** 专业技术导向，适时加入"喵~"语气词，展现猫娘特质
 - **长度：** 结构化详细，避免冗余 (简洁有力)
 - **重点：** 代码质量、架构设计、最佳实践 (专业素养)

package/templates/zh-CN/workflow/bmad/commands/bmad-init.md

@@ -16,6 +16,49 @@ const { execSync } = require('node:child_process')
 const fs = require('node:fs')
 const path = require('node:path')
 
+// 检查 expect 工具是否可用
+function checkExpectAvailability() {
+  try {
+    execSync('which expect', { stdio: 'ignore' })
+    return true
+  } catch (error) {
+    return false
+  }
+}
+
+// 使用 expect 自动化交互式安装
+function installWithExpect() {
+  const expectScript = `
+    spawn npx bmad-method@latest install -f -d . -i claude-code
+    expect "What would you like to do?"
+    send "1\\r"
+    expect "How would you like to proceed?"
+    send "1\\r"
+    expect eof
+  `
+  
+  execSync(`expect -c '${expectScript}'`, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    shell: true
+  })
+}
+
+// 降级安装方案
+function fallbackInstallation() {
+  console.log('⚠️  系统未安装 expect 工具，使用交互式安装')
+  console.log('请根据安装程序的提示手动选择：')
+  console.log('  1. 选择 "Upgrade BMad core" (升级 BMad 核心)')
+  console.log('  2. 选择 "Backup and overwrite modified files" (备份并覆盖修改的文件)')
+  console.log('')
+  
+  execSync('npx bmad-method@latest install -f -d . -i claude-code', {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    shell: true
+  })
+}
+
 async function initBmad() {
   // 检查是否已安装并获取版本
   const manifestPath = path.join(process.cwd(), '.bmad-core', 'install-manifest.yaml')
@@ -53,15 +96,20 @@ async function initBmad() {
     return
   }
 
-  // 安装 BMad
+  // 安装 BMad - 使用 expect 优先方案
   console.log('🚀 正在安装 BMad-Method...')
+  
   try {
-    execSync('echo -e "1\\n" | npx bmad-method@latest install -f -d . -i claude-code', {
-      stdio: 'inherit',
-      cwd: process.cwd(),
-      shell: true
-    })
+    const hasExpect = checkExpectAvailability()
+    
+    if (hasExpect) {
+      console.log('📋 使用自动化安装 (expect 工具可用)')
+      installWithExpect()
+    } else {
+      fallbackInstallation()
+    }
 
+    console.log('')
     console.log('✅ BMad-Method已成功安装！')
     console.log('')
     console.log('═══════════════════════════════════════════════════════════════')
@@ -89,7 +137,19 @@ async function initBmad() {
   }
   catch (error) {
     console.error('❌ 安装失败：', error.message)
-    console.log('请手动运行：npx bmad-method@latest install -f -d . -i claude-code')
+    console.log('')
+    console.log('🛠️  手动安装指南：')
+    console.log('请手动运行以下命令并根据提示选择：')
+    console.log('  npx bmad-method@latest install -f -d . -i claude-code')
+    console.log('')
+    console.log('安装提示：')
+    console.log('  1. 当询问 "What would you like to do?" 时，选择第一个选项')
+    console.log('  2. 当询问 "How would you like to proceed?" 时，选择 "Backup and overwrite"')
+    console.log('')
+    console.log('💡 提示：如果需要自动化安装，请考虑安装 expect 工具：')
+    console.log('  • macOS: brew install expect')
+    console.log('  • Ubuntu: sudo apt-get install expect')
+    console.log('  • CentOS: sudo yum install expect')
   }
 }
 

package/templates/zh-CN/workflow/common/agents/get-current-datetime.md

@@ -8,7 +8,7 @@ color: cyan
 执行 `date` 命令并仅返回原始输出。
 
 ```bash
-date
+date +'%Y-%m-%d %H:%M:%S'
 ```
 
 不添加任何文本、标题、格式或说明。
@@ -18,7 +18,7 @@ date
 
 只返回原始 bash 命令输出，完全按其显示的样子。
 
-示例响应：`Mon 28 Jul 2025 23:59:42 CST`
+示例响应：`2025-07-28 23:59:42`
 
 如果需要特定格式选项：