ccg-workflow 2.1.16 → 3.0.0

package/dist/shared/{ccg-workflow.CewMlBCj.mjs → ccg-workflow.81OoN8XX.mjs}

@@ -10,7 +10,7 @@ import fs from 'fs-extra';
 import { parse, stringify } from 'smol-toml';
 import i18next from 'i18next';
 
-const version = "2.1.16";
+const version = "3.0.0";
 
 function cmd(id, order, category, name, nameEn, description, descriptionEn, cmdOverride) {
   return {
@@ -25,8 +25,25 @@ function cmd(id, order, category, name, nameEn, description, descriptionEn, cmdO
     descriptionEn
   };
 }
-const WORKFLOW_CONFIGS = [
-  // ── Development ──────────────────────────────────────
+const CORE_CONFIGS = [
+  // ── Smart Entry ──────────────────────────────────────
+  cmd("go", 0, "development", "CCG \u667A\u80FD\u5165\u53E3", "CCG Smart Entry", "\u63CF\u8FF0\u4F60\u8981\u505A\u4EC0\u4E48\uFF0CAI \u81EA\u52A8\u9009\u62E9\u6700\u4F73\u7B56\u7565\u6267\u884C", "Describe what you want, AI picks the best strategy"),
+  // ── Independent Tools ────────────────────────────────
+  cmd("init-project", 10, "init", "\u9879\u76EE\u521D\u59CB\u5316", "Project Init", "\u521D\u59CB\u5316\u9879\u76EE AI \u4E0A\u4E0B\u6587\uFF0C\u751F\u6210 CLAUDE.md", "Initialize project AI context, generate CLAUDE.md", "init"),
+  cmd("context", 11, "development", "\u9879\u76EE\u4E0A\u4E0B\u6587\u7BA1\u7406", "Project Context Manager", "\u521D\u59CB\u5316 .context \u76EE\u5F55\u3001\u8BB0\u5F55\u51B3\u7B56\u65E5\u5FD7\u3001\u538B\u7F29\u5F52\u6863\u3001\u67E5\u770B\u5386\u53F2", "Init .context dir, log decisions, compress, view history"),
+  // ── Git ──────────────────────────────────────────────
+  cmd("commit", 20, "git", "Git \u63D0\u4EA4", "Git Commit", "\u667A\u80FD\u751F\u6210 conventional commit \u4FE1\u606F", "Smart conventional commit message generation"),
+  cmd("rollback", 21, "git", "Git \u56DE\u6EDA", "Git Rollback", "\u4EA4\u4E92\u5F0F\u56DE\u6EDA\u5206\u652F\u5230\u5386\u53F2\u7248\u672C", "Interactive rollback to historical version"),
+  cmd("clean-branches", 22, "git", "Git \u6E05\u7406\u5206\u652F", "Git Clean Branches", "\u5B89\u5168\u6E05\u7406\u5DF2\u5408\u5E76\u6216\u8FC7\u671F\u5206\u652F", "Safely clean merged or stale branches"),
+  cmd("worktree", 23, "git", "Git Worktree", "Git Worktree", "\u7BA1\u7406 Git worktree", "Manage Git worktree"),
+  // ── Spec (OpenSpec / OPSX) ───────────────────────────
+  cmd("spec-init", 30, "spec", "OpenSpec \u521D\u59CB\u5316", "OpenSpec Init", "\u521D\u59CB\u5316 OpenSpec \u73AF\u5883 + \u9A8C\u8BC1\u591A\u6A21\u578B MCP \u5DE5\u5177", "Initialize OpenSpec environment with multi-model MCP validation"),
+  cmd("spec-research", 31, "spec", "\u9700\u6C42\u7814\u7A76", "Spec Research", "\u9700\u6C42 \u2192 \u7EA6\u675F\u96C6\uFF08\u5E76\u884C\u63A2\u7D22 + OpenSpec \u63D0\u6848\uFF09", "Transform requirements into constraint sets via parallel exploration"),
+  cmd("spec-plan", 32, "spec", "\u96F6\u51B3\u7B56\u89C4\u5212", "Spec Plan", "\u591A\u6A21\u578B\u5206\u6790 \u2192 \u6D88\u9664\u6B67\u4E49 \u2192 \u96F6\u51B3\u7B56\u53EF\u6267\u884C\u8BA1\u5212", "Refine proposals into zero-decision executable plans"),
+  cmd("spec-impl", 33, "spec", "\u89C4\u8303\u9A71\u52A8\u5B9E\u73B0", "Spec Implementation", "\u6309\u89C4\u8303\u6267\u884C + \u591A\u6A21\u578B\u534F\u4F5C + \u5F52\u6863", "Execute changes via multi-model collaboration with spec compliance"),
+  cmd("spec-review", 34, "spec", "\u5F52\u6863\u524D\u5BA1\u67E5", "Spec Review", "\u53CC\u6A21\u578B\u4EA4\u53C9\u5BA1\u67E5 \u2192 Critical \u5FC5\u987B\u4FEE\u590D \u2192 \u5141\u8BB8\u5F52\u6863", "Multi-model compliance review before archiving")
+];
+const LEGACY_CONFIGS = [
   cmd("workflow", 1, "development", "\u5B8C\u6574\u5F00\u53D1\u5DE5\u4F5C\u6D41", "Full Development Workflow", "\u5B8C\u65746\u9636\u6BB5\u5F00\u53D1\u5DE5\u4F5C\u6D41\uFF08\u7814\u7A76\u2192\u6784\u601D\u2192\u8BA1\u5212\u2192\u6267\u884C\u2192\u4F18\u5316\u2192\u8BC4\u5BA1\uFF09", "Full 6-phase development workflow"),
   cmd("plan", 1.5, "development", "\u591A\u6A21\u578B\u534F\u4F5C\u89C4\u5212", "Multi-Model Planning", "\u4E0A\u4E0B\u6587\u68C0\u7D22 + \u53CC\u6A21\u578B\u5206\u6790 \u2192 \u751F\u6210 Step-by-step \u5B9E\u65BD\u8BA1\u5212", "Context retrieval + dual-model analysis \u2192 Step-by-step plan"),
   cmd("execute", 1.6, "development", "\u591A\u6A21\u578B\u534F\u4F5C\u6267\u884C", "Multi-Model Execution", "\u6839\u636E\u8BA1\u5212\u83B7\u53D6\u539F\u578B \u2192 Claude \u91CD\u6784\u5B9E\u65BD \u2192 \u591A\u6A21\u578B\u5BA1\u8BA1\u4EA4\u4ED8", "Get prototype from plan \u2192 Claude refactor \u2192 Multi-model audit"),
@@ -37,7 +54,6 @@ const WORKFLOW_CONFIGS = [
   cmd("team-review", 1.95, "development", "Agent Teams \u5BA1\u67E5", "Agent Teams Review", "\u53CC\u6A21\u578B\u4EA4\u53C9\u5BA1\u67E5\u5E76\u884C\u5B9E\u65BD\u4EA7\u51FA\uFF0C\u5206\u7EA7\u5904\u7406 Critical/Warning/Info", "Dual-model cross-review with severity classification"),
   cmd("frontend", 2, "development", "\u524D\u7AEF\u4E13\u9879", "Frontend Tasks", "\u524D\u7AEF\u4E13\u9879\u4EFB\u52A1\uFF08Gemini\u4E3B\u5BFC\uFF0C\u66F4\u5FEB\u66F4\u7CBE\u51C6\uFF09", "Frontend tasks (Gemini-led, faster)"),
   cmd("codex-exec", 2.5, "development", "Codex \u6267\u884C\u8BA1\u5212", "Codex Plan Executor", "\u8BFB\u53D6 /ccg:plan \u8BA1\u5212\u6587\u4EF6\uFF0CCodex \u5168\u6743\u6267\u884C + \u591A\u6A21\u578B\u5BA1\u6838", "Read plan file from /ccg:plan, Codex executes + multi-model review"),
-  cmd("context", 2.6, "development", "\u9879\u76EE\u4E0A\u4E0B\u6587\u7BA1\u7406", "Project Context Manager", "\u521D\u59CB\u5316 .context \u76EE\u5F55\u3001\u8BB0\u5F55\u51B3\u7B56\u65E5\u5FD7\u3001\u538B\u7F29\u5F52\u6863\u3001\u67E5\u770B\u5386\u53F2", "Init .context dir, log decisions, compress, view history"),
   cmd("backend", 3, "development", "\u540E\u7AEF\u4E13\u9879", "Backend Tasks", "\u540E\u7AEF\u4E13\u9879\u4EFB\u52A1\uFF08Codex\u4E3B\u5BFC\uFF0C\u66F4\u5FEB\u66F4\u7CBE\u51C6\uFF09", "Backend tasks (Codex-led, faster)"),
   cmd("feat", 4, "development", "\u667A\u80FD\u529F\u80FD\u5F00\u53D1", "Smart Feature Development", "\u667A\u80FD\u529F\u80FD\u5F00\u53D1 - \u81EA\u52A8\u89C4\u5212\u3001\u8BBE\u8BA1\u3001\u5B9E\u65BD", "Smart feature development - auto plan, design, implement"),
   cmd("analyze", 5, "development", "\u6280\u672F\u5206\u6790", "Technical Analysis", "\u53CC\u6A21\u578B\u6280\u672F\u5206\u6790\uFF0C\u4EC5\u5206\u6790\u4E0D\u4FEE\u6539\u4EE3\u7801", "Dual-model technical analysis, analysis only"),
@@ -45,27 +61,21 @@ const WORKFLOW_CONFIGS = [
   cmd("optimize", 7, "development", "\u6027\u80FD\u4F18\u5316", "Performance Optimization", "\u591A\u6A21\u578B\u6027\u80FD\u4F18\u5316", "Multi-model performance optimization"),
   cmd("test", 8, "development", "\u6D4B\u8BD5\u751F\u6210", "Test Generation", "\u667A\u80FD\u8DEF\u7531\u6D4B\u8BD5\u751F\u6210", "Smart routing test generation"),
   cmd("review", 9, "development", "\u4EE3\u7801\u5BA1\u67E5", "Code Review", "\u53CC\u6A21\u578B\u4EE3\u7801\u5BA1\u67E5\uFF0C\u65E0\u53C2\u6570\u65F6\u81EA\u52A8\u5BA1\u67E5 git diff", "Dual-model code review, auto-review git diff when no args"),
-  cmd("enhance", 9.5, "development", "Prompt \u589E\u5F3A", "Prompt Enhancement", "ace-tool Prompt \u589E\u5F3A\u5DE5\u5177", "ace-tool prompt enhancement"),
-  // ── Init ─────────────────────────────────────────────
-  cmd("init-project", 10, "init", "\u9879\u76EE\u521D\u59CB\u5316", "Project Init", "\u521D\u59CB\u5316\u9879\u76EE AI \u4E0A\u4E0B\u6587\uFF0C\u751F\u6210 CLAUDE.md", "Initialize project AI context, generate CLAUDE.md", "init"),
-  // ── Git ──────────────────────────────────────────────
-  cmd("commit", 20, "git", "Git \u63D0\u4EA4", "Git Commit", "\u667A\u80FD\u751F\u6210 conventional commit \u4FE1\u606F", "Smart conventional commit message generation"),
-  cmd("rollback", 21, "git", "Git \u56DE\u6EDA", "Git Rollback", "\u4EA4\u4E92\u5F0F\u56DE\u6EDA\u5206\u652F\u5230\u5386\u53F2\u7248\u672C", "Interactive rollback to historical version"),
-  cmd("clean-branches", 22, "git", "Git \u6E05\u7406\u5206\u652F", "Git Clean Branches", "\u5B89\u5168\u6E05\u7406\u5DF2\u5408\u5E76\u6216\u8FC7\u671F\u5206\u652F", "Safely clean merged or stale branches"),
-  cmd("worktree", 23, "git", "Git Worktree", "Git Worktree", "\u7BA1\u7406 Git worktree", "Manage Git worktree"),
-  // ── Spec (OpenSpec / OPSX) ───────────────────────────
-  cmd("spec-init", 30, "spec", "OpenSpec \u521D\u59CB\u5316", "OpenSpec Init", "\u521D\u59CB\u5316 OpenSpec \u73AF\u5883 + \u9A8C\u8BC1\u591A\u6A21\u578B MCP \u5DE5\u5177", "Initialize OpenSpec environment with multi-model MCP validation"),
-  cmd("spec-research", 31, "spec", "\u9700\u6C42\u7814\u7A76", "Spec Research", "\u9700\u6C42 \u2192 \u7EA6\u675F\u96C6\uFF08\u5E76\u884C\u63A2\u7D22 + OpenSpec \u63D0\u6848\uFF09", "Transform requirements into constraint sets via parallel exploration"),
-  cmd("spec-plan", 32, "spec", "\u96F6\u51B3\u7B56\u89C4\u5212", "Spec Plan", "\u591A\u6A21\u578B\u5206\u6790 \u2192 \u6D88\u9664\u6B67\u4E49 \u2192 \u96F6\u51B3\u7B56\u53EF\u6267\u884C\u8BA1\u5212", "Refine proposals into zero-decision executable plans"),
-  cmd("spec-impl", 33, "spec", "\u89C4\u8303\u9A71\u52A8\u5B9E\u73B0", "Spec Implementation", "\u6309\u89C4\u8303\u6267\u884C + \u591A\u6A21\u578B\u534F\u4F5C + \u5F52\u6863", "Execute changes via multi-model collaboration with spec compliance"),
-  cmd("spec-review", 34, "spec", "\u5F52\u6863\u524D\u5BA1\u67E5", "Spec Review", "\u53CC\u6A21\u578B\u4EA4\u53C9\u5BA1\u67E5 \u2192 Critical \u5FC5\u987B\u4FEE\u590D \u2192 \u5141\u8BB8\u5F52\u6863", "Multi-model compliance review before archiving")
+  cmd("enhance", 9.5, "development", "Prompt \u589E\u5F3A", "Prompt Enhancement", "ace-tool Prompt \u589E\u5F3A\u5DE5\u5177", "ace-tool prompt enhancement")
 ];
+const WORKFLOW_CONFIGS = [...CORE_CONFIGS, ...LEGACY_CONFIGS];
 function getWorkflowConfigs() {
   return WORKFLOW_CONFIGS.sort((a, b) => a.order - b.order);
 }
 function getWorkflowById(id) {
   return WORKFLOW_CONFIGS.find((w) => w.id === id);
 }
+function getCoreCommandIds() {
+  return CORE_CONFIGS.map((w) => w.id);
+}
+function getLegacyCommandIds() {
+  return LEGACY_CONFIGS.map((w) => w.id);
+}
 function getAllCommandIds() {
   return WORKFLOW_CONFIGS.map((w) => w.id);
 }
@@ -886,6 +896,7 @@ async function copyMdTemplates(ctx, srcDir, destDir, options = {}) {
 }
 async function installCommandFiles(ctx, workflowIds) {
   const commandsDir = join(ctx.installDir, "commands", "ccg");
+  const legacyIds = new Set(getLegacyCommandIds());
   for (const workflowId of workflowIds) {
     const workflow = getWorkflowById(workflowId);
     if (!workflow) {
@@ -893,7 +904,8 @@ async function installCommandFiles(ctx, workflowIds) {
       continue;
     }
     for (const cmd of workflow.commands) {
-      const srcFile = join(ctx.templateDir, "commands", `${cmd}.md`);
+      const srcSubdir = legacyIds.has(workflowId) ? "commands-legacy" : "commands";
+      const srcFile = join(ctx.templateDir, srcSubdir, `${cmd}.md`);
       const destFile = join(commandsDir, `${cmd}.md`);
       try {
         if (await fs.pathExists(srcFile)) {
@@ -1198,6 +1210,88 @@ async function installBinaryFile(ctx) {
     ctx.result.errors.push(`Failed to install codeagent-wrapper (non-blocking): ${error}`);
   }
 }
+async function installEngineFiles(ctx) {
+  const engineSrcDir = join(ctx.templateDir, "engine");
+  if (!await fs.pathExists(engineSrcDir)) return;
+  const engineDestDir = join(ctx.installDir, ".ccg", "engine");
+  try {
+    await copyMdTemplates(ctx, engineSrcDir, engineDestDir, { inject: true });
+    const strategiesSrc = join(engineSrcDir, "strategies");
+    const strategiesDest = join(engineDestDir, "strategies");
+    if (await fs.pathExists(strategiesSrc)) {
+      await copyMdTemplates(ctx, strategiesSrc, strategiesDest, { inject: true });
+    }
+  } catch (error) {
+    ctx.result.errors.push(`Failed to install engine files: ${error}`);
+  }
+}
+const HOOK_FILES = ["task-utils.js", "workflow-state.js", "session-start.js", "subagent-context.js", "skill-router.js"];
+async function installHookScripts(ctx) {
+  const hooksSrcDir = join(ctx.templateDir, "hooks");
+  if (!await fs.pathExists(hooksSrcDir)) return;
+  const hooksDestDir = join(ctx.installDir, "hooks", "ccg");
+  await fs.ensureDir(hooksDestDir);
+  try {
+    for (const file of HOOK_FILES) {
+      const src = join(hooksSrcDir, file);
+      const dest = join(hooksDestDir, file);
+      if (await fs.pathExists(src)) {
+        await fs.copy(src, dest, { overwrite: true });
+      }
+    }
+  } catch (error) {
+    ctx.result.errors.push(`Failed to install hook scripts: ${error}`);
+  }
+}
+async function registerHooksInSettings(ctx) {
+  const settingsPath = join(ctx.installDir, "settings.json");
+  const hooksDir = join(ctx.installDir, "hooks", "ccg");
+  try {
+    let settings = {};
+    if (await fs.pathExists(settingsPath)) {
+      try {
+        settings = JSON.parse(await fs.readFile(settingsPath, "utf-8"));
+      } catch {
+        settings = {};
+      }
+    }
+    const hooks = settings.hooks || {};
+    const ccgHookDefs = {
+      UserPromptSubmit: {
+        hooks: [
+          { type: "command", command: `node ${join(hooksDir, "workflow-state.js")}`, timeout: 1e4 },
+          { type: "command", command: `node ${join(hooksDir, "skill-router.js")}`, timeout: 5e3 }
+        ]
+      },
+      SessionStart: {
+        matcher: "startup|clear|compact",
+        hooks: [{ type: "command", command: `node ${join(hooksDir, "session-start.js")}`, timeout: 15e3 }]
+      },
+      PreToolUse: {
+        matcher: "Bash|Agent",
+        hooks: [{ type: "command", command: `node ${join(hooksDir, "subagent-context.js")}`, timeout: 15e3 }]
+      }
+    };
+    for (const [event, def] of Object.entries(ccgHookDefs)) {
+      const eventHooks = hooks[event] || [];
+      const ccgCommand = def.hooks[0].command;
+      const existingIdx = eventHooks.findIndex((h) => {
+        const hHooks = h.hooks || [];
+        return hHooks.some((hh) => typeof hh.command === "string" && hh.command.includes("hooks/ccg/"));
+      });
+      if (existingIdx >= 0) {
+        eventHooks[existingIdx] = def;
+      } else {
+        eventHooks.push(def);
+      }
+      hooks[event] = eventHooks;
+    }
+    settings.hooks = hooks;
+    await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
+  } catch (error) {
+    ctx.result.errors.push(`Failed to register hooks in settings.json: ${error}`);
+  }
+}
 async function installWorkflows(workflowIds, installDir, force = false, config) {
   const ctx = {
     installDir,
@@ -1210,7 +1304,7 @@ async function installWorkflows(workflowIds, installDir, force = false, config)
         review: { models: ["codex", "gemini"] }
       },
       liteMode: config?.liteMode || false,
-      mcpProvider: config?.mcpProvider || "ace-tool",
+      mcpProvider: config?.mcpProvider || "fast-context",
       skipImpeccable: config?.skipImpeccable || false
     },
     templateDir: join(PACKAGE_ROOT$1, "templates"),
@@ -1231,7 +1325,11 @@ async function installWorkflows(workflowIds, installDir, force = false, config)
   await fs.ensureDir(join(installDir, "commands", "ccg"));
   await fs.ensureDir(join(installDir, ".ccg"));
   await fs.ensureDir(join(installDir, ".ccg", "prompts"));
+  await fs.ensureDir(join(installDir, ".ccg", "engine", "strategies"));
   await installCommandFiles(ctx, workflowIds);
+  await installEngineFiles(ctx);
+  await installHookScripts(ctx);
+  await registerHooksInSettings(ctx);
   await installAgentFiles(ctx);
   await installPromptFiles(ctx);
   await installSkillFiles(ctx);
@@ -1327,6 +1425,8 @@ const installer = {
   collectInvocableSkills: collectInvocableSkills,
   collectSkills: collectSkills,
   getAllCommandIds: getAllCommandIds,
+  getCoreCommandIds: getCoreCommandIds,
+  getLegacyCommandIds: getLegacyCommandIds,
   getWorkflowById: getWorkflowById,
   getWorkflowConfigs: getWorkflowConfigs,
   injectConfigVariables: injectConfigVariables,
@@ -2747,7 +2847,7 @@ function createDefaultConfig(options) {
       backup: join(CCG_DIR, "backup")
     },
     mcp: {
-      provider: options.mcpProvider || "ace-tool",
+      provider: options.mcpProvider || "fast-context",
       setup_url: "https://augmentcode.com/"
     },
     performance: {
@@ -3010,7 +3110,7 @@ async function init(options = {}) {
   let backendModels = ["codex"];
   let geminiModel = "gemini-3.1-pro-preview";
   const mode = "smart";
-  const selectedWorkflows = getAllCommandIds();
+  let selectedWorkflows = getCoreCommandIds();
   if (options.skipPrompt) {
     const existingConfig = await readCcgConfig();
     if (existingConfig?.routing) {
@@ -3018,10 +3118,18 @@ async function init(options = {}) {
       backendModels = existingConfig.routing.backend?.models || ["codex"];
       geminiModel = existingConfig.routing.geminiModel || "gemini-3.1-pro-preview";
     }
+    if (existingConfig?.workflows?.installed) {
+      const hadLegacy = existingConfig.workflows.installed.some(
+        (w) => ["workflow", "plan", "execute", "frontend", "backend", "feat", "debug", "team"].includes(w)
+      );
+      if (hadLegacy) {
+        selectedWorkflows = getAllCommandIds();
+      }
+    }
   }
   let liteMode = false;
   let skipImpeccable = false;
-  let mcpProvider = "ace-tool";
+  let mcpProvider = "fast-context";
   let aceToolBaseUrl = "";
   let aceToolToken = "";
   let contextWeaverApiKey = "";
@@ -3217,13 +3325,13 @@ async function init(options = {}) {
         message: i18n.t("init:mcp.selectTools"),
         choices: [
           {
-            name: `ace-tool ${ansis.green(`(${i18n.t("common:info")})`)} ${ansis.gray("\u2014 search_context \u4EE3\u7801\u68C0\u7D22")}`,
-            value: "ace-tool",
+            name: `fast-context ${ansis.green(`(${i18n.t("common:recommended")})`)} ${ansis.gray("\u2014 AI \u9A71\u52A8\u8BED\u4E49\u641C\u7D22")}`,
+            value: "fast-context",
             checked: true
           },
           {
-            name: `fast-context ${ansis.gray("\u2014 AI \u9A71\u52A8\u8BED\u4E49\u641C\u7D22")}`,
-            value: "fast-context"
+            name: `ace-tool ${ansis.gray("\u2014 search_context \u4EE3\u7801\u68C0\u7D22")}`,
+            value: "ace-tool"
           },
           {
             name: `context7 ${ansis.green("(free)")} ${ansis.gray("\u2014 \u5E93\u6587\u6863\u67E5\u8BE2")}`,
@@ -3362,13 +3470,29 @@ async function init(options = {}) {
       if (perfMode === CANCEL_SENTINEL)
         return "cancel";
       liteMode = perfMode === "lite";
-      const { includeImpeccable } = await inquirer.prompt([{
-        type: "confirm",
-        name: "includeImpeccable",
-        message: i18n.t("init:commands.includeImpeccable"),
-        default: !skipImpeccable
+      const { versionMode } = await inquirer.prompt([{
+        type: "list",
+        name: "versionMode",
+        message: "\u5B89\u88C5\u6A21\u5F0F",
+        choices: [
+          { name: `${ansis.green("v3 \u65B0\u7248")} \u2014 /ccg:go \u667A\u80FD\u5165\u53E3 + Hook \u5F15\u64CE + 12 \u6838\u5FC3\u547D\u4EE4\uFF08\u63A8\u8350\uFF09`, value: "v3" },
+          { name: `${ansis.gray("\u65E7\u7248\u517C\u5BB9")} \u2014 \u65B0\u7248\u5168\u90E8 + 18 \u4E2A\u65E7\u7248\u547D\u4EE4\uFF08workflow/debug/team \u7B49\uFF09`, value: "legacy" }
+        ],
+        default: "v3"
       }]);
-      skipImpeccable = !includeImpeccable;
+      if (versionMode === "legacy") {
+        selectedWorkflows = getAllCommandIds();
+        const { includeImpeccable } = await inquirer.prompt([{
+          type: "confirm",
+          name: "includeImpeccable",
+          message: i18n.t("init:commands.includeImpeccable"),
+          default: !skipImpeccable
+        }]);
+        skipImpeccable = !includeImpeccable;
+      } else {
+        selectedWorkflows = getCoreCommandIds();
+        skipImpeccable = true;
+      }
       return "next";
     }
     const runSummaryStep = async (workflowsCount) => {
@@ -4037,7 +4161,9 @@ async function performUpdate(fromVersion, toVersion, isNewVersion) {
   const backupTargets = [
     join(installDir, "commands", "ccg"),
     join(installDir, "agents", "ccg"),
-    join(installDir, "skills", "ccg")
+    join(installDir, "skills", "ccg"),
+    join(installDir, "hooks", "ccg"),
+    join(installDir, ".ccg", "engine")
   ];
   spinner = ora(i18n.t("update:removingOld")).start();
   const backedUp = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "2.1.16",
+  "version": "3.0.0",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",
@@ -27,35 +27,11 @@
   "files": [
     "bin/ccg.mjs",
     "dist",
-    "templates/commands/analyze.md",
-    "templates/commands/backend.md",
-    "templates/commands/clean-branches.md",
-    "templates/commands/commit.md",
-    "templates/commands/debug.md",
-    "templates/commands/enhance.md",
-    "templates/commands/execute.md",
-    "templates/commands/feat.md",
-    "templates/commands/frontend.md",
-    "templates/commands/init.md",
-    "templates/commands/optimize.md",
-    "templates/commands/plan.md",
-    "templates/commands/review.md",
-    "templates/commands/rollback.md",
-    "templates/commands/test.md",
-    "templates/commands/workflow.md",
-    "templates/commands/worktree.md",
-    "templates/commands/spec-init.md",
-    "templates/commands/spec-research.md",
-    "templates/commands/spec-plan.md",
-    "templates/commands/spec-impl.md",
-    "templates/commands/spec-review.md",
-    "templates/commands/team-research.md",
-    "templates/commands/team-plan.md",
-    "templates/commands/team-exec.md",
-    "templates/commands/team-review.md",
-    "templates/commands/codex-exec.md",
-    "templates/commands/context.md",
-    "templates/commands/agents/",
+    "templates/commands/",
+    "templates/commands-legacy/",
+    "templates/engine/",
+    "templates/hooks/",
+    "templates/spec/",
     "templates/prompts/codex/",
     "templates/prompts/gemini/analyzer.md",
     "templates/prompts/gemini/architect.md",

package/templates/commands/go.md

@@ -0,0 +1,199 @@
+---
+description: 'CCG 智能入口 — 描述你要做什么，AI 自动选择最佳策略执行'
+---
+
+# /ccg:go — CCG 智能入口
+
+$ARGUMENTS
+
+---
+
+## 你的角色
+
+你是 **CCG Engine**，一个智能编排器。你的职责是：分析用户的自然语言意图，自动选择最优的开发策略，然后严格按策略执行。用户不需要记住任何命令，只需要描述他们想做什么。
+
+语言：中文交流，技术术语保留英文。
+
+---
+
+## Phase 0: 逃生舱检测
+
+在开始分析之前，先检查 `$ARGUMENTS` 是否命中逃生舱：
+
+**直接执行短语**（跳过所有分析，Claude 直接处理）：
+- "直接做" / "just do it" / "skip" / "不用分析" / "别分析了" / "小修一下"
+
+**快捷路由**（跳过意图分析，直接加载对应策略）：
+- 以 `commit` 开头 → 加载 `git-action` 策略
+- 以 `rollback` / `回滚` 开头 → 加载 `git-action` 策略
+- 以 `review` / `审查` 开头 → 加载 `review-audit` 策略
+- 以 `clean` 开头且含 `branch` → 加载 `git-action` 策略
+
+如果命中逃生舱或快捷路由，跳到 Phase 3。否则继续 Phase 1。
+
+---
+
+## Phase 1: 意图分析 [required]
+
+### 1.1 获取项目上下文 [required · 不可跳过]
+
+**先行动，再判断**。必须执行以下操作获取上下文：
+
+1. `git status` — 当前变更状态、分支信息
+2. 读取项目配置文件（`package.json` / `go.mod` / `pyproject.toml` / `Cargo.toml` 等，取存在的第一个）— 技术栈
+3. 快速浏览目录结构（`ls` 或 `find . -maxdepth 2 -type f | head -30`）— 项目规模
+
+### 1.2 任务类型分类
+
+根据 `$ARGUMENTS` 中的关键词和语义判断：
+
+| 类型 | 信号词（中/英） |
+|------|----------------|
+| **bug-fix** | fix, bug, error, 500, crash, 报错, 修复, broken, 坏了, 失败, failed |
+| **feature** | add, implement, create, 新增, 添加, 开发, build, 做一个, 加一个 |
+| **refactor** | refactor, restructure, 重构, extract, simplify, clean up, 整理 |
+| **research** | what, how, compare, 分析, 研究, 方案, 调研, 评估, 对比, 怎么做 |
+| **optimize** | performance, optimize, speed, slow, 优化, 性能, latency, 慢 |
+| **review** | review, audit, check quality, 审查, 审计, 看看代码 |
+| **git** | commit, rollback, branch, merge, push, clean, worktree, 提交, 回滚 |
+
+如果多个类型匹配，选择最核心的那个（动词决定类型，形容词/名词决定领域）。
+
+### 1.3 复杂度评估
+
+**基于 Phase 1.1 获取的项目上下文**评估，不是凭空猜测：
+
+| 级别 | 判定标准 |
+|------|---------|
+| **S** | 单文件变更，范围清晰，预估 <30 行 |
+| **M** | 2-5 文件，单模块内，路径明确 |
+| **L** | 5+ 文件，跨模块，需要规划和协调 |
+| **XL** | 架构级变更，API/Schema 变动，多模块协作 |
+
+**不确定时默认选高一级**。
+
+### 1.4 风险评估
+
+| 级别 | 判定标准 |
+|------|---------|
+| **low** | 无生产影响，可逆，有测试覆盖 |
+| **medium** | 修改现有行为，需要测试验证 |
+| **high** | API 契约变更，数据库迁移，认证/加密逻辑 |
+
+### 1.5 领域检测
+
+从 `$ARGUMENTS` + 项目上下文推断：
+- **frontend** — UI, component, CSS, React, Vue, Angular, style, layout, 页面, 组件
+- **backend** — API, database, server, endpoint, auth, queue, 接口, 数据库
+- **fullstack** — 同时涉及前后端
+- **security** — vulnerability, auth, injection, encryption, 漏洞, 认证
+- **devops** — CI/CD, Docker, deploy, infrastructure, 部署, 运维
+
+---
+
+## Phase 2: 策略选择
+
+展示分析结果，用户可纠正：
+
+```
+📋 CCG 分析
+  任务: [type]  复杂度: [S/M/L/XL]  领域: [domain]  风险: [level]
+  策略: [strategy] — [一句话说明]
+  📍 Next: 加载策略并开始执行
+```
+
+### 决策矩阵
+
+| 类型 \ 复杂度 | S | M | L / XL |
+|--------------|---|---|--------|
+| **bug-fix** | direct-fix | debug-investigate | debug-investigate |
+| **feature** | quick-implement | guided-develop | full-collaborate |
+| **refactor** | direct-fix | refactor-safely | refactor-safely |
+| **research** | deep-research | deep-research | deep-research |
+| **optimize** | optimize-measure | optimize-measure | optimize-measure |
+| **review** | review-audit | review-audit | review-audit |
+| **git** | git-action | git-action | git-action |
+
+**风险修正**：如果风险为 high 且策略不含外部模型审查，升级一档（如 direct-fix → debug-investigate）。
+
+### ⛔ 创建任务 [required · 策略加载前必须完成]
+
+如果复杂度 ≥ M **且策略不是 git-action**，**必须先创建任务目录再加载策略**：
+
+**Step 1**: 生成任务名 — 用户请求核心词转 kebab-case（如 `add-oauth2-login`、`fix-api-timeout`）
+**Step 2**: 执行命令创建目录和文件：
+
+```bash
+mkdir -p .ccg/tasks/{task-name}
+```
+
+**Step 3**: 写入 `.ccg/tasks/{task-name}/task.json`：
+
+```json
+{
+  "id": "{task-name}",
+  "title": "{用户请求一句话摘要}",
+  "status": "in_progress",
+  "strategy": "{selected-strategy}",
+  "currentPhase": "1",
+  "nextAction": "{策略第一阶段的描述}",
+  "gate": null,
+  "createdAt": "{当前 ISO 日期时间}"
+}
+```
+
+**Step 4**: 如果 `.ccg/spec/` 目录存在，创建 `.ccg/tasks/{task-name}/context.jsonl`，列出相关 spec 文件。
+
+**复杂度 S → 跳过任务创建**（保持轻量）。
+
+**确认任务已创建后**，输出：
+```
+✅ Task created: .ccg/tasks/{task-name}/
+```
+
+### 加载策略
+
+```
+Read("~/.claude/.ccg/engine/strategies/{selected-strategy}.md")
+```
+
+如果用户对分析结果提出异议（如"用完整协作模式"），**接受用户覆盖**，加载指定策略。
+
+---
+
+## Phase 3: 执行策略
+
+严格按照加载的策略文件执行。遵守以下原则：
+
+1. 标记为 `[required]` 的阶段**不可跳过**
+2. 标记为 `HARD STOP` 的 Gate **必须等待用户确认**
+3. 策略文件底部的 `## 铁律` 区块必须遵守
+4. 如需调用外部模型，先 `Read("~/.claude/.ccg/engine/model-router.md")` 获取调用模板
+
+---
+
+## 铁律（MUST NOT）
+
+1. **不可在未获取项目上下文的情况下评估复杂度** — Phase 1.1 不可跳过
+2. **不可自行发明逃生舱** — 只有 Phase 0 明确列出的短语才能跳过分析
+3. **不可在用户未确认的情况下降级策略** — 可升级，不可降级
+4. **M+ 复杂度必须先创建 Task 再加载策略** — 没有 `task.json` 就没有 Hook 面包屑注入，等于丢失状态追踪
+4. **不可跳过策略中 [required] 标记的阶段** — 即使"看起来很简单"
+5. **复杂度有疑问时，默认选高一级** — 宁可多做一步，不可漏掉关键步骤
+
+---
+
+## 附录：策略一览
+
+| 策略 | 适用场景 | 外部模型 |
+|------|---------|---------|
+| `direct-fix` | 简单修复，范围清晰 | 无 |
+| `quick-implement` | 小功能，单文件/组件 | 无 |
+| `guided-develop` | 中等功能，需要规划 | 可选单模型 |
+| `full-collaborate` | 复杂功能，需要多模型协作 | 双模型并行 |
+| `debug-investigate` | 复杂调试，原因不明 | 双模型并行 |
+| `refactor-safely` | 代码重构，需要安全保障 | 可选 |
+| `deep-research` | 技术研究，方案对比 | 双模型探索 |
+| `optimize-measure` | 性能优化，需要度量 | 可选 |
+| `review-audit` | 代码审查 | 双模型交叉 |
+| `git-action` | Git 操作 | 无（委托现有命令） |