aico-cli 0.1.9 → 0.2.1

package/dist/chunks/feature-checker.mjs

@@ -14,6 +14,7 @@ import 'ora';
 import 'dayjs';
 import 'node:path';
 import 'node:url';
+import 'node:fs/promises';
 
 async function checkAllFeatures(context) {
   const results = {};

package/dist/chunks/simple-config.mjs

@@ -12,8 +12,9 @@ import 'dayjs';
 import { join as join$1 } from 'node:path';
 import { join, dirname, basename } from 'pathe';
 import { fileURLToPath } from 'node:url';
+import { rm, mkdir, copyFile as copyFile$1 } from 'node:fs/promises';
 
-const version = "0.1.9";
+const version = "0.2.1";
 
 function displayBanner(subtitle) {
   const defaultSubtitle = "\u4E00\u952E\u914D\u7F6E\u4F60\u7684\u5F00\u53D1\u73AF\u5883";
@@ -4848,6 +4849,10 @@ class ConfigInstaller extends AbstractInstaller {
       }
       copyConfigFiles("zh-CN", false);
       await this.copyAiPersonalityFiles();
+      const workflowResult = await this.installWorkflows();
+      if (!workflowResult.success) {
+        this.log(`\u5DE5\u4F5C\u6D41\u5B89\u88C5\u5931\u8D25: ${workflowResult.message}`, "warning");
+      }
       const apiConfig = options.configData?.apiConfig;
       if (apiConfig) {
         const configuredApi = configureApi(apiConfig);
@@ -5213,6 +5218,206 @@ const INSTALLER_NAMES = {
   CONFIG_CHECKER: "config-checker"
 };
 
+const WORKFLOW_CONFIGS = [
+  {
+    id: "sixStepsWorkflow",
+    nameKey: "workflowOption.sixStepsWorkflow",
+    descriptionKey: "workflowDescription.sixStepsWorkflow",
+    defaultSelected: true,
+    order: 1,
+    commands: ["workflow.md"],
+    agents: [],
+    autoInstallAgents: false,
+    category: "sixStep",
+    outputDir: "workflow"
+  },
+  {
+    id: "featPlanUx",
+    nameKey: "workflowOption.featPlanUx",
+    descriptionKey: "workflowDescription.featPlanUx",
+    defaultSelected: true,
+    order: 2,
+    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: "bmadWorkflow",
+    nameKey: "workflowOption.bmadWorkflow",
+    descriptionKey: "workflowDescription.bmadWorkflow",
+    defaultSelected: false,
+    order: 3,
+    commands: ["bmad-init.md"],
+    agents: [],
+    autoInstallAgents: false,
+    category: "bmad",
+    outputDir: "bmad"
+  },
+  {
+    id: "gitWorkflow",
+    nameKey: "workflowOption.gitWorkflow",
+    descriptionKey: "workflowDescription.gitWorkflow",
+    defaultSelected: false,
+    order: 4,
+    commands: ["git-commit.md", "git-rollback.md", "git-cleanBranches.md", "git-worktree.md"],
+    agents: [],
+    autoInstallAgents: false,
+    category: "git",
+    outputDir: "git"
+  }
+];
+function getWorkflowConfig(workflowId) {
+  return WORKFLOW_CONFIGS.find((config) => config.id === workflowId);
+}
+function getOrderedWorkflows() {
+  return [...WORKFLOW_CONFIGS].sort((a, b) => a.order - b.order);
+}
+
+function getRootDir() {
+  const currentFilePath = fileURLToPath(import.meta.url);
+  const distDir = dirname(dirname(currentFilePath));
+  return dirname(distDir);
+}
+async function selectAndInstallWorkflows(configLang, scriptLang, preselectedWorkflows) {
+  const workflows = getOrderedWorkflows();
+  workflows.map((workflow) => {
+    const nameKey = workflow.id;
+    const name = messages.workflow.selectWorkflowType[nameKey] || workflow.id;
+    return {
+      name,
+      value: workflow.id,
+      checked: workflow.defaultSelected
+    };
+  });
+  let selectedWorkflows;
+  if (preselectedWorkflows) {
+    selectedWorkflows = preselectedWorkflows;
+  } else {
+    selectedWorkflows = workflows.map((w) => w.id);
+  }
+  if (!selectedWorkflows || selectedWorkflows.length === 0) {
+    console.log(ansis.yellow(messages.common.cancelled));
+    return;
+  }
+  await cleanupOldVersionFiles();
+  for (const workflowId of selectedWorkflows) {
+    const config = getWorkflowConfig(workflowId);
+    if (config) {
+      await installWorkflowWithDependencies(config, configLang);
+    }
+  }
+}
+async function installWorkflowWithDependencies(config, configLang, scriptLang) {
+  const rootDir = getRootDir();
+  const result = {
+    workflow: config.id,
+    success: true,
+    installedCommands: [],
+    installedAgents: [],
+    errors: []
+  };
+  const workflowName = messages.workflow.selectWorkflowType[config.id] || config.id;
+  console.log(ansis.cyan(`
+\u{1F4E6} ${messages.workflow.installing}: ${workflowName}...`));
+  const commandsDir = join(CLAUDE_DIR, "commands", "aico");
+  if (!existsSync(commandsDir)) {
+    await mkdir(commandsDir, { recursive: true });
+  }
+  for (const commandFile of config.commands) {
+    const commandSource = join(rootDir, "templates", configLang, "workflow", config.category, "commands", commandFile);
+    const destFileName = commandFile;
+    const commandDest = join(commandsDir, destFileName);
+    if (existsSync(commandSource)) {
+      try {
+        await copyFile$1(commandSource, commandDest);
+        result.installedCommands.push(destFileName);
+        console.log(ansis.gray(`  \u2714 ${messages.workflow.installedCommand}: aico/${destFileName}`));
+      } catch (error) {
+        const errorMsg = `${messages.workflow.failedToInstallCommand} ${commandFile}: ${error}`;
+        result.errors?.push(errorMsg);
+        console.error(ansis.red(`  \u2717 ${errorMsg}`));
+        result.success = false;
+      }
+    }
+  }
+  if (config.autoInstallAgents && config.agents.length > 0) {
+    const agentsCategoryDir = join(CLAUDE_DIR, "agents", "aico", config.category);
+    if (!existsSync(agentsCategoryDir)) {
+      await mkdir(agentsCategoryDir, { recursive: true });
+    }
+    for (const agent of config.agents) {
+      const agentSource = join(rootDir, "templates", configLang, "workflow", config.category, "agents", agent.filename);
+      const agentDest = join(agentsCategoryDir, agent.filename);
+      if (existsSync(agentSource)) {
+        try {
+          await copyFile$1(agentSource, agentDest);
+          result.installedAgents.push(agent.filename);
+          console.log(ansis.gray(`  \u2714 ${messages.workflow.installedAgent}: aico/${config.category}/${agent.filename}`));
+        } catch (error) {
+          const errorMsg = `${messages.workflow.failedToInstallAgent} ${agent.filename}: ${error}`;
+          result.errors?.push(errorMsg);
+          console.error(ansis.red(`  \u2717 ${errorMsg}`));
+          if (agent.required) {
+            result.success = false;
+          }
+        }
+      }
+    }
+  }
+  if (result.success) {
+    console.log(ansis.green(`\u2714 ${workflowName} ${messages.workflow.installSuccess}`));
+    if (config.id === "bmadWorkflow") {
+      console.log(ansis.cyan(`
+${messages.workflow.bmadInitPrompt}`));
+    }
+  } else {
+    console.log(ansis.red(`\u2717 ${workflowName} ${messages.workflow.installFailed}`));
+  }
+  return result;
+}
+async function cleanupOldVersionFiles(scriptLang) {
+  console.log(ansis.cyan(`
+\u{1F9F9} ${messages.workflow.cleaningOldFiles || "Cleaning up old version files"}...`));
+  const oldCommandFiles = [
+    join(CLAUDE_DIR, "commands", "workflow.md"),
+    join(CLAUDE_DIR, "commands", "feat.md")
+  ];
+  const oldAgentFiles = [
+    join(CLAUDE_DIR, "agents", "planner.md"),
+    join(CLAUDE_DIR, "agents", "ui-ux-designer.md")
+  ];
+  for (const file of oldCommandFiles) {
+    if (existsSync(file)) {
+      try {
+        await rm(file, { force: true });
+        console.log(ansis.gray(`  \u2714 ${messages.workflow.removedOldFile || "Removed old file"}: ${file.replace(CLAUDE_DIR, "~/.claude")}`));
+      } catch (error) {
+        console.error(ansis.yellow(`  \u26A0 ${messages.workflow.failedToRemoveFile || "Failed to remove"}: ${file.replace(CLAUDE_DIR, "~/.claude")}`));
+      }
+    }
+  }
+  for (const file of oldAgentFiles) {
+    if (existsSync(file)) {
+      try {
+        await rm(file, { force: true });
+        console.log(ansis.gray(`  \u2714 ${messages.workflow.removedOldFile || "Removed old file"}: ${file.replace(CLAUDE_DIR, "~/.claude")}`));
+      } catch (error) {
+        console.error(ansis.yellow(`  \u26A0 ${messages.workflow.failedToRemoveFile || "Failed to remove"}: ${file.replace(CLAUDE_DIR, "~/.claude")}`));
+      }
+    }
+  }
+}
+
+const workflowInstaller = {
+  __proto__: null,
+  selectAndInstallWorkflows: selectAndInstallWorkflows
+};
+
 class InstallationComposer {
   executor;
   context;
@@ -5287,6 +5492,8 @@ class InstallationComposer {
       const companyResults = await this.executor.executeBatch(companySteps, configOptions);
       const configInstaller = new ConfigInstaller(this.context);
       await configInstaller.applyCompanyConfig();
+      console.log(ansis.cyan("\n\u{1F4E6} \u5B89\u88C5\u5DE5\u4F5C\u6D41\u6A21\u677F..."));
+      await selectAndInstallWorkflows("zh-CN");
       this.updateGlobalConfig();
       this.printResults({ ...results, ...companyResults }, "\u516C\u53F8\u914D\u7F6E");
     } else {
@@ -5300,6 +5507,8 @@ class InstallationComposer {
       const companyResults = await this.executor.executeBatch(companySteps, configOptions);
       const configInstaller = new ConfigInstaller(this.context);
       await configInstaller.applyCompanyConfig();
+      console.log(ansis.cyan("\n\u{1F4E6} \u5B89\u88C5\u5DE5\u4F5C\u6D41\u6A21\u677F..."));
+      await selectAndInstallWorkflows("zh-CN");
       this.updateGlobalConfig();
       this.printResults({ ...results, ...companyResults }, "\u516C\u53F8\u914D\u7F6E");
     }
@@ -5326,6 +5535,8 @@ class InstallationComposer {
     if (results[INSTALLER_NAMES.CCR]?.success) {
       await this.configureCCRForPersonal();
     }
+    console.log(ansis.cyan("\n\u{1F4E6} \u5B89\u88C5\u5DE5\u4F5C\u6D41\u6A21\u677F..."));
+    await selectAndInstallWorkflows("zh-CN");
     this.updateGlobalConfig();
     this.printResults(results, "\u4E2A\u4EBA\u914D\u7F6E");
   }
@@ -5561,4 +5772,4 @@ async function openSettingsJson() {
   }
 }
 
-export { AICO_CONFIG_FILE as A, mergeMcpServers as B, CLAUDE_DIR as C, buildMcpServerConfig as D, fixWindowsMcpConfig as E, addCompletedOnboarding as F, readJsonConfig as G, isTermux as H, messages as I, getTermuxPrefix as J, createEscapablePrompt as K, LEGACY_AICO_CONFIG_FILE as L, MCP_SERVICES as M, displayBannerWithInfo as N, executeWithEscapeSupport as O, handleExitPromptError as P, handleGeneralError as Q, EscapeKeyPressed as R, SETTINGS_FILE as S, displayBanner as T, version as U, ConfigCheckerInstaller as V, init$1 as W, importRecommendedEnv as a, importRecommendedPermissions as b, commandExists as c, cleanupPermissions 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, AI_OUTPUT_LANGUAGES as k, ensureClaudeDir as l, mergeAndCleanPermissions as m, backupExistingConfig as n, openSettingsJson as o, copyConfigFiles as p, configureApi as q, mergeConfigs as r, mergeSettingsFile as s, getExistingApiConfig as t, updateDefaultModel as u, applyAiLanguageDirective as v, getMcpConfigPath as w, readMcpConfig as x, writeMcpConfig as y, backupMcpConfig as z };
+export { AICO_CONFIG_FILE as A, mergeMcpServers as B, CLAUDE_DIR as C, buildMcpServerConfig as D, fixWindowsMcpConfig as E, addCompletedOnboarding as F, readJsonConfig as G, isTermux as H, messages as I, getTermuxPrefix as J, createEscapablePrompt as K, LEGACY_AICO_CONFIG_FILE as L, MCP_SERVICES as M, displayBannerWithInfo as N, executeWithEscapeSupport as O, handleExitPromptError as P, handleGeneralError as Q, EscapeKeyPressed as R, SETTINGS_FILE as S, displayBanner as T, version as U, ConfigCheckerInstaller as V, InstallerExecutor as W, workflowInstaller as X, init$1 as Y, importRecommendedEnv as a, importRecommendedPermissions as b, commandExists as c, cleanupPermissions 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, AI_OUTPUT_LANGUAGES as k, ensureClaudeDir as l, mergeAndCleanPermissions as m, backupExistingConfig as n, openSettingsJson as o, copyConfigFiles as p, configureApi as q, mergeConfigs as r, mergeSettingsFile as s, getExistingApiConfig as t, updateDefaultModel as u, applyAiLanguageDirective as v, getMcpConfigPath as w, readMcpConfig as x, writeMcpConfig as y, backupMcpConfig as z };

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { K as createEscapablePrompt, N as displayBannerWithInfo, i as init, O as executeWithEscapeSupport, P as handleExitPromptError, Q as handleGeneralError, R as EscapeKeyPressed, T as displayBanner, U as version, V as ConfigCheckerInstaller } from './chunks/simple-config.mjs';
+import { K as createEscapablePrompt, N as displayBannerWithInfo, i as init, O as executeWithEscapeSupport, P as handleExitPromptError, Q as handleGeneralError, R as EscapeKeyPressed, T as displayBanner, U as version, V as ConfigCheckerInstaller, W as InstallerExecutor } from './chunks/simple-config.mjs';
 import inquirer$1 from 'inquirer';
 import { spawn, exec as exec$1 } from 'node:child_process';
 import 'tinyexec';
@@ -9,6 +9,7 @@ import 'node:os';
 import 'node:fs';
 import 'pathe';
 import 'node:url';
+import 'node:fs/promises';
 import 'node:path';
 import { exec } from 'child_process';
 import { promisify } from 'util';
@@ -341,7 +342,7 @@ function setupCommands(cli) {
     } else if (options.update) {
       await update({});
     } else if (options.company) {
-      const { init: init2 } = await import('./chunks/simple-config.mjs').then(function (n) { return n.W; });
+      const { init: init2 } = await import('./chunks/simple-config.mjs').then(function (n) { return n.Y; });
       await init2({
         apiType: "auth_token",
         force: options.force,
@@ -349,7 +350,7 @@ function setupCommands(cli) {
         skipPrompt: true
       });
     } else if (options.personal) {
-      const { init: init2 } = await import('./chunks/simple-config.mjs').then(function (n) { return n.W; });
+      const { init: init2 } = await import('./chunks/simple-config.mjs').then(function (n) { return n.Y; });
       await init2({
         apiType: "ccr_proxy",
         force: options.force,
@@ -378,11 +379,12 @@ async function startCodeEditor() {
       const missingFeatures = Object.entries(featureStatus).filter(([_, status2]) => !status2.isInstalled).map(([name, _]) => name);
       if (missingFeatures.length > 0) {
         console.log(ansis.yellow(`\u26A0\uFE0F  \u53D1\u73B0\u672A\u5B89\u88C5\u7684\u529F\u80FD\u6A21\u5757: ${missingFeatures.join(", ")}`));
-        console.log(ansis.yellow("   \u8FD0\u884C `aico --init` \u6216 `aico --update` \u6765\u5B89\u88C5\u7F3A\u5931\u529F\u80FD"));
+        console.log(ansis.yellow("   \u5F00\u59CB\u81EA\u52A8\u5B89\u88C5\u7F3A\u5931\u529F\u80FD..."));
+        await installMissingFeatures(context, featureStatus, missingFeatures);
       }
     } else {
       console.log(ansis.yellow("\u26A0\uFE0F  \u672A\u68C0\u6D4B\u5230\u914D\u7F6E\uFF0C\u5C06\u5148\u6267\u884C\u521D\u59CB\u5316\u914D\u7F6E..."));
-      const { init: init2 } = await import('./chunks/simple-config.mjs').then(function (n) { return n.W; });
+      const { init: init2 } = await import('./chunks/simple-config.mjs').then(function (n) { return n.Y; });
       await init2({ skipBanner: true, skipPrompt: true });
     }
     await startClaudeCodeEditor();
@@ -416,6 +418,49 @@ function customizeHelp(sections) {
   });
   return sections;
 }
+async function installMissingFeatures(context, _featureStatus, missingFeatures) {
+  try {
+    const executor = new InstallerExecutor(context);
+    const featureToInstallerMap = {
+      config: "config",
+      claudeCode: "claude-code",
+      statusBar: "ccometix-line"
+      // workflow 和 aiPersonality 需要特殊处理，不能映射到 config-checker
+    };
+    for (const featureName of missingFeatures) {
+      if (featureName === "workflow" || featureName === "aiPersonality") {
+        console.log(ansis.blue(`\u{1F4E6} \u5B89\u88C5\u529F\u80FD: ${featureName}...`));
+        try {
+          const { selectAndInstallWorkflows } = await import('./chunks/simple-config.mjs').then(function (n) { return n.X; });
+          await selectAndInstallWorkflows("zh-CN", "zh-CN");
+          console.log(ansis.green(`\u2705 ${featureName} \u5B89\u88C5\u6210\u529F`));
+        } catch (error) {
+          console.log(ansis.yellow(`\u26A0\uFE0F  ${featureName} \u5B89\u88C5\u5931\u8D25: ${error instanceof Error ? error.message : String(error)}`));
+        }
+      } else {
+        const installerName = featureToInstallerMap[featureName];
+        if (installerName) {
+          console.log(ansis.blue(`\u{1F4E6} \u5B89\u88C5\u529F\u80FD: ${featureName}...`));
+          const result = await executor.execute(installerName, {
+            skipPrompt: true,
+            silent: true
+          });
+          if (result.success) {
+            console.log(ansis.green(`\u2705 ${featureName} \u5B89\u88C5\u6210\u529F`));
+          } else {
+            console.log(ansis.yellow(`\u26A0\uFE0F  ${featureName} \u5B89\u88C5\u5931\u8D25: ${result.message}`));
+          }
+        } else {
+          console.log(ansis.yellow(`\u26A0\uFE0F  \u672A\u77E5\u529F\u80FD: ${featureName}\uFF0C\u8DF3\u8FC7\u5B89\u88C5`));
+        }
+      }
+    }
+    console.log(ansis.green("\u{1F389} \u7F3A\u5931\u529F\u80FD\u5B89\u88C5\u5B8C\u6210\uFF01"));
+  } catch (error) {
+    console.error(ansis.red(`\u2716 \u81EA\u52A8\u5B89\u88C5\u529F\u80FD\u5931\u8D25: ${error instanceof Error ? error.message : String(error)}`));
+    console.log(ansis.yellow("\u{1F4A1} \u8BF7\u624B\u52A8\u8FD0\u884C `aico --init` \u6765\u5B89\u88C5\u7F3A\u5931\u529F\u80FD"));
+  }
+}
 
 if (!Array.prototype.findLastIndex) {
   Array.prototype.findLastIndex = function(predicate, thisArg) {

package/dist/index.mjs

@@ -14,3 +14,4 @@ import 'dayjs';
 import 'node:path';
 import 'pathe';
 import 'node:url';
+import 'node:fs/promises';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aico-cli",
-  "version": "0.1.9",
+  "version": "0.2.1",
   "packageManager": "pnpm@9.15.9",
   "description": "AI CLI",
   "repository": {

package/templates/CLAUDE.md

@@ -1,3 +1,71 @@
-@language.md
-@personality.md
-@base.md
+[根目录](../CLAUDE.md) > **templates**
+
+## 模块职责
+- AI工作流模板与配置文件模板库
+- 提供标准化的配置模板和工作流定义
+- 支持多种AI场景的配置模板
+
+## 模板分类
+
+### AI智能体模板 (agents/)
+- **规划智能体**: `agents/aico/plan/`
+  - `init-architect.md` - 架构师初始化模板
+  - `planner.md` - 规划器模板
+  - `ui-ux-designer.md` - UI/UX设计师模板
+  - `get-current-datetime.md` - 时间获取模板
+- **需求智能体**: `agents/aico/requirement/`
+  - `requirement-identifier.md` - 需求识别器
+  - `requirement-aligner.md` - 需求对齐器
+  - `task-executor.md` - 任务执行器
+  - `task-executor-validator.md` - 任务执行验证器
+  - `task-splitter-validator.md` - 任务拆分验证器
+
+### 命令模板 (commands/)
+- **AICO命令**: `commands/aico/`
+  - `init-project.md` - 项目初始化模板
+  - `workflow.md` - 工作流模板
+  - `requirement.md` - 需求处理模板
+
+### 基础配置模板
+- `base.md` - 基础配置模板
+- `language.md` - 语言配置模板
+- `personality.md` - AI个性配置模板
+- `settings.json` - 设置文件模板
+
+## 模板使用
+- **安装时使用**: 通过安装器将模板复制到用户目录
+- **配置生成**: 根据模板生成具体的配置文件
+- **动态替换**: 支持变量替换和个性化配置
+
+## 模板规范
+- **Markdown格式**: 大部分模板使用Markdown格式
+- **JSON配置**: 配置文件使用JSON格式
+- **变量占位符**: 使用特定的占位符语法进行变量替换
+- **注释说明**: 包含详细的配置说明和使用指南
+
+## 测试与质量
+- **模板验证**: 确保模板语法正确性和完整性
+- **变量检查**: 验证所有占位符都有对应的替换逻辑
+- **格式校验**: 使用工具验证JSON和Markdown格式
+
+## 常见问题 (FAQ)
+- Q: 如何添加新的模板？
+  A: 在合适的分类目录下创建模板文件，确保有相应的安装器支持
+- Q: 模板中的变量如何替换？
+  A: 通过安装器中的模板处理逻辑进行变量替换
+- Q: 模板更新后如何生效？
+  A: 用户需要重新运行安装命令或更新命令
+
+## 相关文件清单（主要）
+- `agents/aico/plan/init-architect.md` - 架构师模板
+- `agents/aico/plan/planner.md` - 规划器模板
+- `agents/aico/requirement/requirement-identifier.md` - 需求识别模板
+- `commands/aico/init-project.md` - 项目初始化模板
+- `base.md` - 基础配置模板
+- `language.md` - 语言配置模板
+- `personality.md` - 个性配置模板
+- `settings.json` - 设置文件模板
+
+## 变更记录 (Changelog)
+- 2025-09-14: 初始模板模块文档
+- 2025-09-19: 完善模板分类和文档结构

package/templates/commands/base/fix-error.md

@@ -0,0 +1,319 @@
+## 错误修复
+
+从错误信息中识别根本原因，预测解决时间，提出经过验证的解决方案。学习类似错误的模式，立即提供合适的处理方法。
+
+### 使用方法
+
+```bash
+/fix-error [选项]
+```
+
+### 选项
+
+- 无 : 标准错误分析
+- `--deep` : 深度分析模式（包括依赖关系·环境因素）
+- `--preventive` : 重视预防措施的分析
+- `--quick` : 仅提供立即可用的修复方案
+
+### 基本示例
+
+```bash
+# 标准错误分析
+npm run build 2>&1
+/fix-error
+"分析构建错误并提出修复方法"
+
+# 深度分析模式
+python app.py 2>&1
+/fix-error --deep
+"包括环境因素在内分析错误的根本原因"
+
+# 即时修复重视
+cargo test 2>&1
+/fix-error --quick
+"提供可立即应用的修复方法"
+
+# 预防措施重视
+./app 2>&1 | tail -50
+/fix-error --preventive
+"提出错误修复和未来的预防措施"
+```
+
+### 与 Claude 的协作
+
+```bash
+# 错误日志分析
+cat error.log
+/fix-error
+"识别错误的根本原因，提出修复方法"
+
+# 测试失败的解决
+npm test 2>&1
+/fix-error --quick
+"分析失败的测试，提出可立即应用的修复方案"
+
+# 堆栈跟踪的解析
+python script.py 2>&1
+/fix-error --deep
+"从这个堆栈跟踪中定位问题，包括环境因素一起分析"
+
+# 批量解决多个错误
+grep -E "ERROR|WARN" app.log | tail -20
+/fix-error
+"按优先级分类这些错误和警告，分别提出解决方法"
+```
+
+### 错误解决时间预测
+
+```
+🚀 即时修复（5 分钟内）
+├─ 拼写错误、import 遗忘
+├─ 环境变量未设置
+├─ 未定义变量引用
+└─ 预测时间: 2-5 分钟
+
+⚡ 快速修复（30 分钟内）
+├─ 依赖关系不一致
+├─ 配置文件错误
+├─ 类型不匹配
+└─ 预测时间: 10-30 分钟
+
+🔧 需要调查（2 小时内）
+├─ 复杂逻辑错误
+├─ 异步处理竞争
+├─ API 集成问题
+└─ 预测时间: 30 分钟-2 小时
+
+🔌 深层分析（半天以上）
+├─ 架构原因
+├─ 多系统集成
+├─ 性能降级
+└─ 预测时间: 4 小时-数日
+```
+
+### 类似错误模式数据库
+
+```
+高频错误及即时解决方案
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 "Cannot read property 'X' of undefined/null" (频出度: 极高)
+├─ 主要原因: 对象的 null 检查不足
+├─ 解决时间: 5-10 分钟
+└─ 处理方法: 可选链式调用 (?.) 或添加 null 检查
+
+📊 "ECONNREFUSED" / "ENOTFOUND" (频出度: 高)
+├─ 主要原因: 服务未启动或 URL 配置错误
+├─ 解决时间: 5-15 分钟
+└─ 处理方法: 确认服务启动、检查环境变量
+
+📊 "Module not found" / "Cannot resolve" (频出度: 高)
+├─ 主要原因: 包未安装、路径指定错误
+├─ 解决时间: 2-5 分钟
+└─ 处理方法: 执行 npm install、确认相对路径
+
+📊 "Unexpected token" / "SyntaxError" (频出度: 中)
+├─ 主要原因: 括号、引号不匹配、使用保留字
+├─ 解决时间: 2-10 分钟
+└─ 处理方法: 确认语法高亮、执行 Linter
+
+📊 "CORS policy" / "Access-Control-Allow-Origin" (频出度: 中)
+├─ 主要原因: 服务端 CORS 配置不足
+├─ 解决时间: 15-30 分钟
+└─ 处理方法: 服务端 CORS 配置、代理设置
+
+📊 "Maximum call stack size exceeded" (频出度: 低)
+├─ 主要原因: 无限循环、递归、循环引用
+├─ 解决时间: 30 分钟-2 小时
+└─ 处理方法: 确认递归的终止条件、解决循环引用
+```
+
+### 错误分析优先级矩阵
+
+| 优先级 | 图标 | 影响范围 | 解决难度 | 处理期限 | 说明 |
+|--------|---------|---------|-----------|---------|------|
+| **Critical** | 🔴 紧急处理 | 广 | 低 | 15 分钟内着手 | 系统全体停止、数据丢失风险 |
+| **High Priority** | 🟠 早期处理 | 广 | 高 | 1 小时内着手 | 主要功能停止、多数用户影响 |
+| **Medium** | 🟡 计划处理 | 狭 | 高 | 当日内处理 | 部分功能限制、有规避方案 |
+| **Low** | 🟢 经过观察 | 狭 | 低 | 下次修改时 | 轻微不具、UX 影响小 |
+
+### 分析流程
+
+#### 阶段 1: 错误信息收集
+
+```bash
+🔴 必须执行:
+- 完整获取错误信息
+- 确认堆栈跟踪
+- 确定发生条件（可重现性）
+
+🟡 尽早执行:
+- 收集环境信息（OS、版本、依赖）
+- 最近的更改历史（git log、最近提交）
+- 确认相关日志
+
+🟢 附加执行:
+- 系统资源状况
+- 网络状态
+- 外部服务状态
+```
+
+#### 阶段 2: 根本原因分析
+
+1. **整理表面症状**
+   - 错误信息的准确内容
+   - 发生时机和模式
+   - 确定影响范围
+
+2. **识别深层原因**
+   - 应用 5 Whys 分析
+   - 追踪依赖关系
+   - 确认环境差异
+
+3. **验证假设**
+   - 创建最小重现代码
+   - 执行隔离测试
+   - 缩小原因范围
+
+#### 阶段 3: 实施解决方案
+
+```bash
+🔴 立即处理（热修复）:
+- 抑制症状的最小修复
+- 应用临时解决方案
+- 准备紧急部署
+
+🟡 根本解决:
+- 针对原因的本质修复
+- 添加测试用例
+- 更新文档
+
+🟢 实施预防措施:
+- 加强错误处理
+- 设置监控·告警
+- 改进 CI/CD 管道
+```
+
+### 输出示例
+
+```
+🚨 错误分析报告
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📍 错误概要
+├─ 类型: [编译/运行时/逻辑/环境]
+├─ 紧急度: 🔴 高 / 🟡 中 / 🟢 低
+├─ 影响范围: [功能名/组件]
+├─ 重现性: [100% / 间歇性 / 特定条件]
+└─ 预测解决时间: [2-5 分钟 / 30 分钟-2 小时 / 4 小时+]
+
+🔍 根本原因
+├─ 直接原因: [具体原因]
+├─ 背景因素: [环境/设置/依赖关系]
+├─ 触发器: [发生条件]
+└─ 类似模式: [已知错误类型 / 首次发生]
+
+💡 解决方案
+🔴 即时处理 (预计: X 分钟):
+1. [具体修复命令/代码]
+2. [临时解决方案]
+
+🟡 根本解决 (预计: Y 小时):
+1. [本质修复方法]
+2. [必要的重构]
+
+🟢 预防措施:
+1. [错误处理改进]
+2. [测试添加]
+3. [监控设置]
+
+📋 风险评估
+├─ 修复失败风险: [低/中/高]
+├─ 副作用影响: [无/有限/广泛]
+└─ 回滚计划: [简单/复杂/不可能]
+
+📝 验证步骤
+1. [修复后的确认方法]
+2. [测试执行命令]
+3. [功能确认项目]
+4. [性能影响检查]
+```
+
+### 错误类型别分析方法
+
+#### 编译/构建错误
+
+```bash
+# TypeScript 类型错误
+必须确认（高）:
+- tsconfig.json 设置
+- 类型定义文件（.d.ts）存在
+- import 语句的准确性
+
+# Rust 生命周期错误
+必须确认（高）:
+- 所有权转移
+- 引用的有效期
+- 可变性冲突
+```
+
+#### 运行时错误
+
+```bash
+# Null/Undefined 引用
+必须确认（高）:
+- 可选链不足
+- 初始化时机
+- 异步处理的完成等待
+
+# 内存相关错误
+必须确认（高）:
+- 获取堆转储
+- 分析 GC 日志
+- 检测循环引用
+```
+
+#### 依赖关系错误
+
+```bash
+# 版本冲突
+必须确认（高）:
+- lock 文件的一致性
+- peer dependencies 的要求
+- 传递依赖关系
+
+# 模块解析错误
+必须确认（高）:
+- NODE_PATH 设置
+- 路径别名设置
+- 符号链接
+```
+
+### 注意事项
+
+- **绝对禁止**: 仅凭部分错误信息判断、未经验证就应用 Stack Overflow 的解决方案
+- **例外条件**: 临时解决方案仅在以下 3 个条件下允许
+  1. 生产环境紧急响应（24 小时内必须根本解决）
+  2. 外部服务故障（等待恢复期间的替代手段）
+  3. 已知框架 bug（等待修复版本发布）
+- **建议事项**: 优先识别根本原因，避免表面修复
+
+### 最佳实践
+
+1. **完整信息收集**: 确认错误信息从头到尾
+2. **确认重现性**: 优先创建最小重现代码
+3. **渐进式方法**: 从小修复开始验证
+4. **文档化**: 记录解决过程以便知识共享
+
+#### 常见陷阱
+
+- **处理症状**: 表面修复忽略根本原因
+- **过度泛化**: 将特定案例的解决方案广泛应用
+- **省略验证**: 不确认修复后的副作用
+- **知识孤岛**: 不记录解决方法
+
+### 相关命令
+
+- `/design-patterns` : 分析代码结构问题并提出模式建议
+- `/tech-debt` : 从技术债务角度分析错误的根本原因
+- `/analyzer` : 需要更深入的根本原因分析时使用

package/templates/commands/base/tech-debt.md

@@ -0,0 +1,181 @@
+## 技术债务
+
+分析项目的技术债务，创建按优先级排序的改进计划。
+
+### 使用方法
+
+```bash
+# 确认项目结构并分析技术债务
+ls -la
+「分析这个项目的技术债务并创建改进计划」
+```
+
+### 基本示例
+
+```bash
+# 分析 TODO/FIXME 注释
+grep -r "TODO\|FIXME\|HACK\|XXX\|WORKAROUND" . --exclude-dir=node_modules --exclude-dir=.git
+「按优先级整理这些 TODO 注释并制定改进计划」
+
+# 确认项目依赖关系
+ls -la | grep -E "package.json|Cargo.toml|pubspec.yaml|go.mod|requirements.txt"
+「分析项目的依赖关系，识别过时的依赖和风险」
+
+# 检测大文件和复杂函数
+find . -type f -not -path "*/\.*" -not -path "*/node_modules/*" -exec wc -l {} + | sort -rn | head -10
+「识别过大的文件和复杂的结构，提出改进方案」
+```
+
+### 与 Claude 配合
+
+```bash
+# 全面的技术债务分析
+ls -la && find . -name "*.md" -maxdepth 2 -exec head -20 {} \;
+「从以下角度分析这个项目的技术债务：
+1. 代码质量（复杂度、重复、可维护性）
+2. 依赖关系健康度
+3. 安全风险
+4. 性能问题
+5. 测试覆盖不足」
+
+# 架构债务分析
+find . -type d -name "src" -o -name "lib" -o -name "app" | head -10 | xargs ls -la
+「识别架构层面的技术债务，提出重构计划」
+
+# 按优先级排序的改进计划
+「按以下标准评估技术债务并以表格形式展示：
+- 影响度（高/中/低）
+- 修复成本（时间）
+- 业务风险
+- 改进效果
+- 推荐实施时期」
+```
+
+### 详细示例
+
+```bash
+# 自动检测项目类型并分析
+find . -maxdepth 2 -type f \( -name "package.json" -o -name "Cargo.toml" -o -name "pubspec.yaml" -o -name "go.mod" -o -name "pom.xml" \)
+「基于检测到的项目类型，分析以下内容：
+1. 语言和框架特定的技术债务
+2. 偏离最佳实践的情况
+3. 现代化机会
+4. 分阶段改进策略」
+
+# 代码质量指标分析
+find . -type f -name "*" | grep -E "\.(js|ts|py|rs|go|dart|kotlin|swift|java)$" | wc -l
+「分析项目的代码质量，展示以下指标：
+- 循环复杂度高的函数
+- 重复代码检测
+- 过长的文件/函数
+- 缺乏适当的错误处理」
+
+# 安全债务检测
+grep -r "password\|secret\|key\|token" . --exclude-dir=.git --exclude-dir=node_modules | grep -v ".env.example"
+「检测安全相关的技术债务，提出修复优先级和对策」
+
+# 测试不足分析
+find . -type f \( -name "*test*" -o -name "*spec*" \) | wc -l && find . -type f -name "*.md" | xargs grep -l "test"
+「分析测试覆盖的技术债务，提出测试策略」
+```
+
+### 项目健康度仪表盘
+
+```
+项目健康度评分：72/100
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 分类评分
+├─ 依赖关系新鲜度：████████░░ 82%（最新：45/55）
+├─ 文档完整度：███░░░░░░░ 35%（缺少 README、API 文档）
+├─ 测试覆盖率：██████░░░░ 65%（目标：80%）
+├─ 安全性：███████░░░ 78%（漏洞：2 个中等风险）
+├─ 架构：██████░░░░ 60%（循环依赖：3 处）
+└─ 代码质量：███████░░░ 70%（高复杂度：12 个文件）
+
+📈 趋势（过去 30 天）
+├─ 总体评分：68 → 72 (+4) ↗️
+├─ 改进项目：12 项 ✅
+├─ 新增债务：3 项 ⚠️
+├─ 已解决债务：8 项 🎉
+└─ 改进速度：+0.13/天
+
+⏱️ 债务的时间影响
+├─ 开发速度降低：-20%（新功能开发需要正常 1.25 倍时间）
+├─ Bug 修复时间增加：+15%（平均修复时间 2h → 2.3h）
+├─ 代码审查开销：+30%（复杂度导致理解时间增加）
+├─ 入职延迟：+50%（新成员理解所需时间）
+└─ 累积延迟时间：相当于每周 40 小时
+
+🎯 改进预期效果（基于时间）
+├─ 即时效果：开发速度 +10%（1 周后）
+├─ 短期效果：Bug 率 -25%（1 个月后）
+├─ 中期效果：开发速度 +30%（3 个月后）
+├─ 长期效果：维护时间 -50%（6 个月后）
+└─ ROI：投资 40 小时 → 回收 120 小时（3 个月）
+```
+
+### 优先级矩阵
+
+| 优先级 | 开发影响 | 修复成本 | 时间节省效果 | 投资效率 | 响应期限 |
+|--------|---------|---------|-------------|---------|---------|
+| **[P0] 立即修复** | 高 | 低 | > 5 倍 | 投资 1h → 节省 5h+ | 立即 |
+| **[P1] 本周内** | 高 | 中 | 2-5 倍 | 投资 1h → 节省 2-5h | 1 周内 |
+| **[P2] 本月内** | 低 | 高 | 1-2 倍 | 投资 1h → 节省 1-2h | 1 个月内 |
+| **[P3] 本季度内** | 低 | 低 | < 1 倍 | 投资=节省时间 | 3 个月内 |
+
+### 债务类型评估标准
+
+| 债务类型 | 检测方法 | 开发影响 | 修复时间 |
+|---------|---------|---------|---------|
+| **架构债务** | 循环依赖、紧耦合 | 变更影响范围大、测试困难 | 40-80h |
+| **安全债务** | CVE 扫描、OWASP | 漏洞风险、合规问题 | 8-40h |
+| **性能债务** | N+1 查询、内存泄漏 | 响应时间增加、资源消耗 | 16-40h |
+| **测试债务** | 覆盖率 < 60% | Bug 检测延迟、质量不稳定 | 20-60h |
+| **文档债务** | 缺少 README、API 文档 | 入职时间增加 | 8-24h |
+| **依赖债务** | 2 年以上未更新 | 安全风险、兼容性问题 | 4-16h |
+| **代码质量债务** | 复杂度 > 10 | 理解/修改时间增加 | 2-8h |
+
+### 技术债务影响度计算
+
+```
+影响度 = Σ(各要素权重 × 测量值)
+
+📊 可测量的影响指标：
+├─ 开发速度影响
+│  ├─ 代码理解时间：+X%（与复杂度成正比）
+│  ├─ 变更时影响范围：Y 个文件（通过耦合度测量）
+│  └─ 测试执行时间：Z 分钟（CI/CD 流水线）
+│
+├─ 质量影响
+│  ├─ Bug 发生率：复杂度每 10 分增加 +25%
+│  ├─ 代码审查时间：代码行数 × 复杂度系数
+│  └─ 测试不足风险：覆盖率 < 60% 时高风险
+│
+└─ 团队效率影响
+   ├─ 入职时间：缺少文档时增加 +100%
+   ├─ 知识孤岛：单一贡献者比例 >80% 时需要注意
+   └─ 代码重复修复位置：重复率 × 变更频率
+```
+
+### 基于时间的 ROI 计算
+
+```
+ROI = (节省时间 - 投资时间) ÷ 投资时间 × 100
+
+示例：解决循环依赖
+├─ 投资时间：16 小时（重构）
+├─ 每月节省：
+│  ├─ 编译时间：-10 分钟/天 × 20 天 = 200 分钟
+│  ├─ 调试时间：-2 小时/周 × 4 周 = 8 小时
+│  └─ 新功能开发：-30% 时间缩短 = 12 小时
+├─ 每月节省时间：23.3 小时
+└─ 3 个月 ROI：(70 - 16) ÷ 16 × 100 = 337%
+```
+
+### 注意事项
+
+- 自动检测项目的语言和框架，进行相应的分析
+- 健康度评分采用 0-100 分制：70 分以上健康，50 分以下需要改进
+- 计算具体的时间成本和改进效果，支持基于数据的决策制定
+- 如需货币换算，请单独指定团队平均时薪或项目特定系数

package/templates/commands/base/ultrathink.md

@@ -0,0 +1,65 @@
+## Ultrathink
+
+对复杂课题或重要决策执行分阶段的结构化思考过程。
+
+### 使用方法
+
+```bash
+# 请求 Claude 进行深度思考
+「用 ultrathink 探讨[课题]」
+```
+
+### 基本示例
+
+```bash
+# 架构设计探讨
+「用 ultrathink 探讨应该选择微服务还是单体架构」
+
+# 技术选型分析
+「用 ultrathink 分析这个项目适合 Rust 还是 TypeScript」
+
+# 问题解决深入探讨
+「用 ultrathink 探讨应用性能差的原因和改进方法」
+```
+
+### 与 Claude 配合
+
+```bash
+# 业务判断
+「用 ultrathink 探讨新功能的优先级排序。从用户价值、开发成本、技术风险的角度」
+
+# 系统设计
+「用 ultrathink 探讨认证系统的设计。考虑安全性、可扩展性、可维护性」
+
+# 权衡分析
+「用 ultrathink 分析 GraphQL vs REST API 的选择。基于项目需求」
+
+# 重构策略
+cat src/legacy_code.js
+「用 ultrathink 制定这个遗留代码的重构策略」
+```
+
+### 思考过程
+
+1. **问题分解** - 将课题分解为组成要素
+2. **MECE 分析** - 无遗漏无重复地整理
+3. **多角度探讨** - 从技术、业务、用户角度分析
+4. **交互式确认** - 在重要判断点向用户确认
+5. **有依据的建议** - 基于数据和逻辑的结论
+
+### 详细示例
+
+```bash
+# 复杂技术债务的解决
+「用 ultrathink 探讨将 10 年的遗留系统现代化的策略。包括分阶段迁移、风险、ROI」
+
+# 组织性课题
+「用 ultrathink 探讨开发团队的扩展策略。假设从目前 5 人扩展到 20 人」
+
+# 数据库迁移
+「用 ultrathink 分析从 PostgreSQL 迁移到 DynamoDB。考虑成本、性能、运维」
+```
+
+### 注意事项
+
+ultrathink 最适合需要花时间深入思考的课题。对于简单问题或需要即时回答的情况，请使用常规提问形式。

package/templates/personality.md

@@ -158,7 +158,71 @@ description: 架构师级软件工程师，以工程卓越为信仰，为追求
 
 **实战智慧**: 在大规模系统中，技术治理的缺失会在6个月后开始显现，12个月后变成噩梦
 
-### 4. 持续问题解决
+### 4. 需求分析与智能复述
+
+**核心理念：**
+> 准确理解需求是工程成功的第一步，模糊的需求只会产生错误的实现
+
+**智能需求分析流程：**
+
+**阶段一：需求解构分析**
+- **功能需求识别**: 提取用户表达中的核心功能点和业务逻辑
+- **非功能需求挖掘**: 识别性能、安全性、可用性等隐含要求
+- **技术约束评估**: 分析现有技术栈、环境限制和依赖关系
+- **边界条件确定**: 明确功能范围、异常场景和边界处理
+
+**阶段二：结构化需求复述**
+当接收到用户需求后，必须使用以下标准格式进行智能复述：
+
+```
+📋 需求理解确认
+
+🎯 核心目标
+[用一句话概括用户的主要诉求]
+
+🔧 功能需求
+• [功能点1]: [具体描述和预期行为]
+• [功能点2]: [具体描述和预期行为]
+• [功能点N]: [具体描述和预期行为]
+
+⚡ 非功能需求
+• 性能要求: [响应时间、并发量等]
+• 兼容性: [平台、浏览器、版本等]
+• 安全性: [数据保护、访问控制等]
+• 可维护性: [代码规范、文档要求等]
+
+🎯 技术约束
+• 技术栈: [现有框架、语言、工具限制]
+• 环境限制: [部署环境、资源限制]
+• 依赖关系: [第三方库、API、服务依赖]
+
+📐 实现边界
+• 包含功能: [明确要实现的功能范围]
+• 排除功能: [明确不在本次范围内的功能]
+• 边界场景: [异常情况、错误处理策略]
+
+❓ 需要确认的点
+• [不确定的技术细节或业务逻辑]
+• [可能存在多种实现方案的选择点]
+• [需要用户进一步澄清的需求点]
+
+请确认以上理解是否准确，或指出需要调整的部分。
+```
+
+**阶段三：交互式需求澄清**
+- **主动询问**: 对模糊或不完整的需求主动提出专业性问题
+- **方案权衡**: 当存在多种技术方案时，列举优缺点供用户选择
+- **风险预警**: 提前识别潜在的技术风险和实现难点
+- **迭代优化**: 基于用户反馈持续完善需求理解
+
+**质量标准：**
+- ✅ 需求复述必须覆盖用户提及的所有要点
+- ✅ 使用用户能理解的业务语言，避免过度技术化
+- ✅ 识别并主动询问缺失的关键信息
+- ✅ 对有歧义的表述提供多种理解供确认
+- ✅ 预见性地提出可能影响实现的技术考量
+
+### 5. 持续问题解决
 
 **行为准则：**
 - 持续工作直到问题完全解决
@@ -221,6 +285,12 @@ description: 架构师级软件工程师，以工程卓越为信仰，为追求
 - "懂你的意思，你遇到的是典型的[技术场景]..."
 - "懂你的意思，让我从架构角度来分析..."
 
+**需求理解确认：**
+- "让我确认一下理解：你的需求是..."
+- "懂你的意思，为了确保准确实现，我重新梳理一下需求..."
+- "基于你的描述，我理解的核心需求包括..."
+- "为避免理解偏差，请确认以下需求分析是否准确..."
+
 **开场方式：**
 - "从架构角度看，这个问题的关键是..."
 - "基于我的经验，最有效的解决方案是..."