ccg-workflow 1.7.85 → 1.7.87

package/README.md

@@ -354,4 +354,4 @@ MIT
 
 ---
 
-v1.7.85 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [Contributing](./CONTRIBUTING.md)
+v1.7.86 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [Contributing](./CONTRIBUTING.md)

package/README.zh-CN.md

@@ -354,4 +354,4 @@ MIT
 
 ---
 
-v1.7.82 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [参与贡献](./CONTRIBUTING.md)
+v1.7.86 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [参与贡献](./CONTRIBUTING.md)

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, E as configMcp, F as version } from './shared/ccg-workflow.B9Mj76CP.mjs';
+import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, E as configMcp, F as version } from './shared/ccg-workflow.CJXxHH9w.mjs';
 import 'inquirer';
 import 'node:child_process';
 import 'node:util';

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { c as changeLanguage, x as checkForUpdates, y as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, t as getCurrentVersion, v as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, k as installWorkflows, p as migrateToV1_4_0, q as needsMigration, r as readCcgConfig, s as showMainMenu, o as uninstallAceTool, n as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.B9Mj76CP.mjs';
+export { c as changeLanguage, x as checkForUpdates, y as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, t as getCurrentVersion, v as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, k as installWorkflows, p as migrateToV1_4_0, q as needsMigration, r as readCcgConfig, s as showMainMenu, o as uninstallAceTool, n as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.CJXxHH9w.mjs';
 import 'ansis';
 import 'inquirer';
 import 'node:child_process';

package/dist/shared/{ccg-workflow.B9Mj76CP.mjs → ccg-workflow.CJXxHH9w.mjs}

@@ -10,7 +10,7 @@ import { parse, stringify } from 'smol-toml';
 import i18next from 'i18next';
 import ora from 'ora';
 
-const version = "1.7.85";
+const version = "1.7.87";
 
 function cmd(id, order, category, name, nameEn, description, descriptionEn, cmdOverride) {
   return {
@@ -91,12 +91,23 @@ const __filename$2 = fileURLToPath(import.meta.url);
 const __dirname$2 = dirname(__filename$2);
 function findPackageRoot$1(startDir) {
   let dir = startDir;
-  for (let i = 0; i < 5; i++) {
+  for (let i = 0; i < 10; i++) {
     if (fs.existsSync(join(dir, "package.json"))) {
-      return dir;
+      if (fs.existsSync(join(dir, "templates"))) {
+        return dir;
+      }
     }
-    dir = dirname(dir);
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
   }
+  console.error(
+    `[CCG] \u26A0 PACKAGE_ROOT resolution failed: could not find package.json with templates/ directory.
+  Start dir: ${startDir}
+  Last checked: ${dir}
+  This will cause commands/skills/prompts to not be installed.
+  Please report this issue at: https://github.com/fengshao1227/ccg-workflow/issues`
+  );
   return startDir;
 }
 const PACKAGE_ROOT$1 = findPackageRoot$1(__dirname$2);
@@ -682,7 +693,10 @@ async function downloadBinaryFromRelease(binaryName, destPath) {
 }
 async function copyMdTemplates(ctx, srcDir, destDir, options = {}) {
   const installed = [];
-  if (!await fs.pathExists(srcDir)) return installed;
+  if (!await fs.pathExists(srcDir)) {
+    console.error(`[CCG] Template source directory not found: ${srcDir}`);
+    return installed;
+  }
   await fs.ensureDir(destDir);
   const files = await fs.readdir(srcDir);
   for (const file of files) {
@@ -755,7 +769,10 @@ async function installAgentFiles(ctx) {
 async function installPromptFiles(ctx) {
   const promptsTemplateDir = join(ctx.templateDir, "prompts");
   const promptsDir = join(ctx.installDir, ".ccg", "prompts");
-  if (!await fs.pathExists(promptsTemplateDir)) return;
+  if (!await fs.pathExists(promptsTemplateDir)) {
+    ctx.result.errors.push(`Prompts template directory not found: ${promptsTemplateDir}`);
+    return;
+  }
   for (const model of ["codex", "gemini", "claude"]) {
     try {
       const installed = await copyMdTemplates(
@@ -783,7 +800,11 @@ async function collectSkillNames(dir, depth = 0) {
         names.push(basename(dir));
       }
     }
-  } catch {
+  } catch (error) {
+    const code = error.code;
+    if (code !== "ENOENT") {
+      console.error(`[CCG] Failed to read skills directory ${dir}: ${code || error}`);
+    }
   }
   return names;
 }
@@ -797,7 +818,10 @@ async function removeDirCollectMdNames(dir) {
 async function installSkillFiles(ctx) {
   const skillsTemplateDir = join(ctx.templateDir, "skills");
   const skillsDestDir = join(ctx.installDir, "skills", "ccg");
-  if (!await fs.pathExists(skillsTemplateDir)) return;
+  if (!await fs.pathExists(skillsTemplateDir)) {
+    ctx.result.errors.push(`Skills template directory not found: ${skillsTemplateDir}`);
+    return;
+  }
   try {
     const oldSkillsRoot = join(ctx.installDir, "skills");
     const ccgLegacyItems = ["tools", "orchestration", "SKILL.md", "run_skill.js"];
@@ -808,12 +832,16 @@ async function installSkillFiles(ctx) {
         const oldPath = join(oldSkillsRoot, item);
         const newPath = join(skillsDestDir, item);
         if (await fs.pathExists(oldPath)) {
-          await fs.move(oldPath, newPath, { overwrite: true });
+          try {
+            await fs.move(oldPath, newPath, { overwrite: true });
+          } catch (moveErr) {
+            ctx.result.errors.push(`Skills migration: failed to move ${item}: ${moveErr}`);
+          }
         }
       }
     }
     await fs.copy(skillsTemplateDir, skillsDestDir, {
-      overwrite: ctx.force,
+      overwrite: true,
       errorOnExist: false
     });
     const replacePathsInDir = async (dir) => {
@@ -832,7 +860,13 @@ async function installSkillFiles(ctx) {
       }
     };
     await replacePathsInDir(skillsDestDir);
-    ctx.result.installedSkills = (await collectSkillNames(skillsDestDir)).length;
+    const installedSkills = await collectSkillNames(skillsDestDir);
+    ctx.result.installedSkills = installedSkills.length;
+    if (installedSkills.length === 0) {
+      ctx.result.errors.push(
+        `Skills copy completed but no SKILL.md found in ${skillsDestDir}. Possible cause: file locking (antivirus), permission denied, or path too long. Try running as administrator or disabling antivirus real-time scanning temporarily.`
+      );
+    }
   } catch (error) {
     ctx.result.errors.push(`Failed to install skills: ${error}`);
     ctx.result.success = false;
@@ -893,7 +927,8 @@ function showBinaryDownloadWarning(binDir) {
   console.log(ansis.gray(`       \u2192 \u627E\u5230 ${ansis.white(binaryFileName)} \u5E76\u4E0B\u8F7D`));
   console.log();
   console.log(ansis.white(`    2. \u653E\u5230 / Place at:`));
-  console.log(ansis.cyan(`       ${binDir}/${destFileName}`));
+  const displayPath = process.platform === "win32" ? `${binDir.replace(/\//g, "\\")}\\${destFileName}` : `${binDir}/${destFileName}`;
+  console.log(ansis.cyan(`       ${displayPath}`));
   console.log();
   if (process.platform !== "win32") {
     console.log(ansis.white(`    3. \u52A0\u6743\u9650 / Make executable:`));
@@ -965,6 +1000,12 @@ async function installWorkflows(workflowIds, installDir, force = false, config)
       configPath: ""
     }
   };
+  if (!await fs.pathExists(ctx.templateDir)) {
+    const errorMsg = `Template directory not found: ${ctx.templateDir} (PACKAGE_ROOT=${PACKAGE_ROOT$1}). This usually means the npm package is incomplete or the cache is corrupted. Try: npm cache clean --force && npx ccg-workflow@latest`;
+    ctx.result.errors.push(errorMsg);
+    ctx.result.success = false;
+    return ctx.result;
+  }
   await fs.ensureDir(join(installDir, "commands", "ccg"));
   await fs.ensureDir(join(installDir, ".ccg"));
   await fs.ensureDir(join(installDir, ".ccg", "prompts"));
@@ -974,6 +1015,12 @@ async function installWorkflows(workflowIds, installDir, force = false, config)
   await installSkillFiles(ctx);
   await installRuleFiles(ctx);
   await installBinaryFile(ctx);
+  if (ctx.result.installedCommands.length === 0 && ctx.result.errors.length === 0) {
+    ctx.result.errors.push(
+      `No commands were installed (expected ${workflowIds.length}). Template dir: ${ctx.templateDir}. This may indicate a corrupted package or file permission issue.`
+    );
+    ctx.result.success = false;
+  }
   ctx.result.configPath = join(installDir, "commands", "ccg");
   return ctx.result;
 }
@@ -3126,10 +3173,23 @@ async function init(options = {}) {
     }
     if (result.errors.length > 0) {
       console.log();
-      console.log(ansis.red(`  \u26A0 ${i18n.t("init:installationErrors")}`));
+      if (!result.success) {
+        console.log(ansis.red.bold(`  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557`));
+        console.log(ansis.red.bold(`  \u2551  \u26A0  \u5B89\u88C5\u51FA\u73B0\u9519\u8BEF / Installation errors detected           \u2551`));
+        console.log(ansis.red.bold(`  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D`));
+      } else {
+        console.log(ansis.yellow(`  \u26A0 ${i18n.t("init:installationErrors")}`));
+      }
       result.errors.forEach((error) => {
         console.log(`    ${ansis.red("\u2717")} ${error}`);
       });
+      if (!result.success) {
+        console.log();
+        console.log(ansis.yellow(`  \u5C1D\u8BD5\u4FEE\u590D / Try to fix:`));
+        console.log(ansis.cyan(`    npx ccg-workflow@latest init --force`));
+        console.log(ansis.gray(`    \u5982\u4ECD\u5931\u8D25\uFF0C\u8BF7\u63D0\u4EA4 issue \u5E76\u9644\u4E0A\u4EE5\u4E0A\u9519\u8BEF\u4FE1\u606F`));
+        console.log(ansis.gray(`    If still failing, report an issue with the errors above`));
+      }
     }
     if (result.binInstalled && result.binPath) {
       console.log();
@@ -3384,7 +3444,6 @@ async function performUpdate(fromVersion, toVersion, isNewVersion) {
       } catch {
         const npxCachePath = join(homedir(), ".npm", "_npx");
         try {
-          const fs = await import('fs-extra');
           await fs.remove(npxCachePath);
         } catch {
         }
@@ -3424,22 +3483,43 @@ async function performUpdate(fromVersion, toVersion, isNewVersion) {
       console.log();
     }
   }
-  spinner = ora(i18n.t("update:removingOld")).start();
   const installDir = join(homedir(), ".claude");
+  const BACKUP_SUFFIX = ".ccg-update-bak";
+  const backupTargets = [
+    join(installDir, "commands", "ccg"),
+    join(installDir, "agents", "ccg"),
+    join(installDir, "skills", "ccg")
+  ];
+  spinner = ora(i18n.t("update:removingOld")).start();
+  const backedUp = [];
   try {
-    const uninstallResult = await uninstallWorkflows(installDir, { preserveBinary: true });
-    if (uninstallResult.success) {
-      spinner.succeed(i18n.t("update:oldRemoved"));
-    } else {
-      spinner.warn(i18n.t("update:partialRemoveFailed"));
-      for (const error of uninstallResult.errors) {
-        console.log(ansis.yellow(`  \u2022 ${error}`));
+    for (const dir of backupTargets) {
+      if (await fs.pathExists(dir)) {
+        const backupPath = dir + BACKUP_SUFFIX;
+        if (await fs.pathExists(backupPath)) {
+          await fs.remove(backupPath);
+        }
+        await fs.move(dir, backupPath);
+        backedUp.push(dir);
       }
     }
+    spinner.succeed(i18n.t("update:oldRemoved"));
   } catch (error) {
-    spinner.warn(i18n.t("update:removeFailed", { error: String(error) }));
+    spinner.warn(`Backup failed: ${error}`);
+    for (const dir of backedUp) {
+      const backupPath = dir + BACKUP_SUFFIX;
+      try {
+        if (await fs.pathExists(backupPath)) {
+          await fs.move(backupPath, dir);
+        }
+      } catch {
+      }
+    }
+    console.log(ansis.yellow("  \u65E7\u7248\u672C\u6587\u4EF6\u5DF2\u4FDD\u7559 / Old files preserved"));
+    return;
   }
   spinner = ora(i18n.t("update:installingNew")).start();
+  let installSuccess = false;
   try {
     await execAsync$1(`npx --yes ccg-workflow@latest init --force --skip-mcp --skip-prompt`, {
       timeout: 3e5,
@@ -3449,21 +3529,59 @@ async function performUpdate(fromVersion, toVersion, isNewVersion) {
         CCG_UPDATE_MODE: "true"
       }
     });
-    spinner.succeed(i18n.t("update:installDone"));
-    const config = await readCcgConfig();
-    if (config?.workflows?.installed) {
-      console.log();
-      console.log(ansis.cyan(i18n.t("update:installed", { count: config.workflows.installed.length })));
-      for (const cmd of config.workflows.installed) {
-        console.log(`  ${ansis.gray("\u2022")} /ccg:${cmd}`);
+    const commandsDir = join(installDir, "commands", "ccg");
+    const hasCommands = await fs.pathExists(commandsDir) && (await fs.readdir(commandsDir)).some((f) => f.endsWith(".md"));
+    if (hasCommands) {
+      installSuccess = true;
+      spinner.succeed(i18n.t("update:installDone"));
+      const config = await readCcgConfig();
+      if (config?.workflows?.installed) {
+        console.log();
+        console.log(ansis.cyan(i18n.t("update:installed", { count: config.workflows.installed.length })));
+        for (const cmd of config.workflows.installed) {
+          console.log(`  ${ansis.gray("\u2022")} /ccg:${cmd}`);
+        }
       }
-    }
-    if (!await verifyBinary(installDir)) {
-      showBinaryDownloadWarning(join(installDir, "bin"));
+    } else {
+      spinner.fail(i18n.t("update:installFailed"));
+      console.log(ansis.red("  Install subprocess completed but no command files were created"));
     }
   } catch (error) {
     spinner.fail(i18n.t("update:installFailed"));
     console.log(ansis.red(`${i18n.t("common:error")}: ${error}`));
+  }
+  if (installSuccess) {
+    for (const dir of backedUp) {
+      try {
+        await fs.remove(dir + BACKUP_SUFFIX);
+      } catch {
+      }
+    }
+    if (!await verifyBinary(installDir)) {
+      showBinaryDownloadWarning(join(installDir, "bin"));
+    }
+  } else {
+    console.log();
+    console.log(ansis.yellow.bold("  \u26A0 \u6B63\u5728\u6062\u590D\u65E7\u7248\u672C\u6587\u4EF6 / Restoring old version files..."));
+    let restored = 0;
+    for (const dir of backedUp) {
+      const backupPath = dir + BACKUP_SUFFIX;
+      try {
+        if (await fs.pathExists(dir)) {
+          await fs.remove(dir);
+        }
+        if (await fs.pathExists(backupPath)) {
+          await fs.move(backupPath, dir);
+          restored++;
+        }
+      } catch (restoreErr) {
+        console.log(ansis.red(`  Failed to restore ${dir}: ${restoreErr}`));
+      }
+    }
+    if (restored > 0) {
+      console.log(ansis.green(`  \u2713 \u5DF2\u6062\u590D ${restored} \u4E2A\u76EE\u5F55 / Restored ${restored} directories`));
+      console.log(ansis.gray("    \u65E7\u7248\u547D\u4EE4\u4ECD\u53EF\u6B63\u5E38\u4F7F\u7528 / Old commands still work"));
+    }
     console.log();
     console.log(ansis.yellow(i18n.t("update:manualRetry")));
     console.log(ansis.cyan("  npx ccg-workflow@latest"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.7.85",
+  "version": "1.7.87",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",

package/templates/commands/analyze.md

@@ -70,6 +70,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
 - 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时。
 如果 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**。
 - 若因等待时间过长跳过了等待 TaskOutput 结果，则**必须调用 `AskUserQuestion` 工具询问用户选择继续等待还是 Kill Task。禁止直接 Kill Task。**
+- ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+- ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续用 TaskOutput 轮询，**绝对禁止在 Codex 未返回结果时直接跳过或继续下一阶段**。已启动的 Codex 任务若被跳过 = 浪费 token + 丢失结果。
 
 ---
 

package/templates/commands/backend.md

@@ -79,6 +79,8 @@ EOF",
 
 **会话复用**：每次调用返回 `SESSION_ID: xxx`，后续阶段用 `resume xxx` 复用上下文。阶段 2 保存 `CODEX_SESSION`，阶段 3 和 5 使用 `resume` 复用。
 
+⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。若调用超时，继续等待，禁止跳过或提前终止。
+
 ---
 
 ## 沟通守则

package/templates/commands/codex-exec.md

@@ -120,6 +120,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
 - 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时
 - 若 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**
 - 若因等待时间过长跳过了等待，**必须调用 `AskUserQuestion` 询问用户选择继续等待还是 Kill Task**
+- ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+- ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续用 TaskOutput 轮询，**绝对禁止在 Codex 未返回结果时直接跳过或继续下一阶段**。已启动的 Codex 任务若被跳过 = 浪费 token + 丢失结果。
 
 ---
 

package/templates/commands/debug.md

@@ -70,6 +70,8 @@ EOF
 - 必须指定 `timeout: 600000`，否则默认 30 秒会超时
 - 如果 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**
 - 若等待时间过长，**必须用 `AskUserQuestion` 询问用户是否继续等待，禁止直接 Kill**
+- ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+- ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续用 TaskOutput 轮询，**绝对禁止在 Codex 未返回结果时直接跳过或继续下一阶段**。已启动的 Codex 任务若被跳过 = 浪费 token + 丢失结果。
 
 ---
 

package/templates/commands/execute.md

@@ -107,6 +107,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
 - 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时
 - 若 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**
 - 若因等待时间过长跳过了等待，**必须调用 `AskUserQuestion` 询问用户选择继续等待还是 Kill Task**
+- ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+- ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续用 TaskOutput 轮询，**绝对禁止在 Codex 未返回结果时直接跳过或继续下一阶段**。已启动的 Codex 任务若被跳过 = 浪费 token + 丢失结果。
 
 ---
 

package/templates/commands/feat.md

@@ -76,6 +76,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
 - 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时。
 如果 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**。
 - 若因等待时间过长跳过了等待 TaskOutput 结果，则**必须调用 `AskUserQuestion` 工具询问用户选择继续等待还是 Kill Task。禁止直接 Kill Task。**
+- ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+- ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续用 TaskOutput 轮询，**绝对禁止在 Codex 未返回结果时直接跳过或继续下一阶段**。已启动的 Codex 任务若被跳过 = 浪费 token + 丢失结果。
 
 ---
 

package/templates/commands/frontend.md

@@ -79,6 +79,8 @@ EOF",
 
 **会话复用**：每次调用返回 `SESSION_ID: xxx`，后续阶段用 `resume xxx` 复用上下文。阶段 2 保存 `GEMINI_SESSION`，阶段 3 和 5 使用 `resume` 复用。
 
+⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才报告错误并终止。
+
 ---
 
 ## 沟通守则

package/templates/commands/optimize.md

@@ -75,6 +75,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
 - 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时。
 如果 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**。
 - 若因等待时间过长跳过了等待 TaskOutput 结果，则**必须调用 `AskUserQuestion` 工具询问用户选择继续等待还是 Kill Task。禁止直接 Kill Task。**
+- ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+- ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续用 TaskOutput 轮询，**绝对禁止在 Codex 未返回结果时直接跳过或继续下一阶段**。已启动的 Codex 任务若被跳过 = 浪费 token + 丢失结果。
 
 ---
 

package/templates/commands/plan.md

@@ -66,6 +66,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
 - 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时
 - 若 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**
 - 若因等待时间过长跳过了等待，**必须调用 `AskUserQuestion` 询问用户选择继续等待还是 Kill Task**
+- ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+- ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续用 TaskOutput 轮询，**绝对禁止在 Codex 未返回结果时直接跳过或继续下一阶段**。已启动的 Codex 任务若被跳过 = 浪费 token + 丢失结果。
 
 ---
 

package/templates/commands/review.md

@@ -65,6 +65,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
 - 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时。
 如果 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**。
 - 若因等待时间过长跳过了等待 TaskOutput 结果，则**必须调用 `AskUserQuestion` 工具询问用户选择继续等待还是 Kill Task。禁止直接 Kill Task。**
+- ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+- ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续用 TaskOutput 轮询，**绝对禁止在 Codex 未返回结果时直接跳过或继续下一阶段**。已启动的 Codex 任务若被跳过 = 浪费 token + 丢失结果。
 
 ---
 

package/templates/commands/spec-impl.md

@@ -106,6 +106,9 @@ description: '按规范执行 + 多模型协作 + 归档'
    TaskOutput({ task_id: "<gemini_task_id>", block: true, timeout: 600000 })
    ```
 
+   ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败，最多重试 2 次（间隔 5 秒）。3 次全败才跳过。
+   ⛔ **Codex 结果必须等待**：Codex 执行 5-15 分钟属正常，超时后继续轮询，禁止跳过。
+
    Address any critical findings before proceeding.
 
 8. **Update Task Status**

package/templates/commands/spec-plan.md

@@ -56,6 +56,9 @@ description: '多模型分析 → 消除歧义 → 零决策可执行计划'
    TaskOutput({ task_id: "<gemini_task_id>", block: true, timeout: 600000 })
    ```
 
+   ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败，最多重试 2 次（间隔 5 秒）。3 次全败才跳过。
+   ⛔ **Codex 结果必须等待**：Codex 执行 5-15 分钟属正常，超时后继续轮询，禁止跳过。
+
    - Synthesize responses and present consolidated options to user.
 
 3. **Uncertainty Elimination Audit**

package/templates/commands/spec-research.md

@@ -95,6 +95,9 @@ description: '需求 → 约束集（并行探索 + OPSX 提案）'
    TaskOutput({ task_id: "<gemini_task_id>", block: true, timeout: 600000 })
    ```
 
+   ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败，最多重试 2 次（间隔 5 秒）。3 次全败才跳过。
+   ⛔ **Codex 结果必须等待**：Codex 执行 5-15 分钟属正常，超时后继续轮询，禁止跳过。
+
 5. **Aggregate and Synthesize**
    - Collect all subagent outputs.
    - Merge into unified constraint sets:

package/templates/commands/spec-review.md

@@ -57,6 +57,9 @@ description: '双模型交叉审查（独立工具，随时可用）'
    TaskOutput({ task_id: "<gemini_task_id>", block: true, timeout: 600000 })
    ```
 
+   ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败，最多重试 2 次（间隔 5 秒）。3 次全败才跳过。
+   ⛔ **Codex 结果必须等待**：Codex 执行 5-15 分钟属正常，超时后继续轮询，禁止跳过。
+
 4. **Synthesize Findings**
    - Merge findings from both models.
    - Deduplicate overlapping issues.

package/templates/commands/team-exec.md

@@ -36,9 +36,12 @@ description: 'Agent Teams 并行实施 - 读取计划文件，spawn Builder team
      确认开始？
      ```
 
-3. **创建 Team + spawn Builders**
-   - 创建 Agent Team。
-   - 按 Layer 分组 spawn Builder teammates（Sonnet）。
+3. **使用 TeamCreate 创建 Team，然后 spawn teammates 加入该 Team**
+   - ⛔ **禁止使用普通 Agent 子代理。必须通过 TeamCreate 创建 team，再通过 Agent(team_name=...) spawn teammates 加入 team。**
+   - 先调用 TeamCreate 创建 team。
+   - 为每个子任务调用 TaskCreate 创建 task。
+   - 按 Layer 分组，通过 Agent(team_name=..., name="builder-N") spawn Builder teammates（Sonnet）。
+   - 通过 TaskUpdate(owner="builder-N") 将 task 分配给对应 Builder。
    - 每个 Builder 的 spawn prompt 必须包含：
 
    ```
@@ -70,10 +73,11 @@ description: 'Agent Teams 并行实施 - 读取计划文件，spawn Builder team
    - **依赖关系**：Layer 2 的 Builder 任务设为依赖 Layer 1 的对应任务，等 Layer 1 完成后自动解锁。
    - spawn 完成后，进入 **delegate 模式**，只协调不写码。
 
-4. **监控进度**
-   - 等待所有 Builder 完成。
+4. **通过 TaskList + SendMessage 监控进度**
+   - 通过 TaskList 查看各 task 状态，通过 SendMessage 与 Builder 沟通。
+   - teammates 完成 task 后会自动发消息通知你，无需轮询。
    - 如果某个 Builder 遇到问题并发消息求助：
-     * 分析问题，给出指导建议
+     * 通过 SendMessage 回复指导建议
      * 不要自己写代码替它完成
    - 如果某个 Builder 失败：
      * 记录失败原因
@@ -98,7 +102,7 @@ description: 'Agent Teams 并行实施 - 读取计划文件，spawn Builder team
    3. 提交代码：`git add -A && git commit`
    ```
 
-   - 关闭所有 teammates，清理 team。
+   - 通过 SendMessage 发送 shutdown_request 关闭所有 teammates，清理 team。
 
 **Exit Criteria**
 - [ ] 所有 Builder 任务完成（或明确失败并记录原因）

package/templates/commands/team-plan.md

@@ -51,6 +51,8 @@ description: 'Agent Teams 规划 - Lead 调用 Codex/Gemini 并行分析，产
 
    - 必须指定 `timeout: 600000`，否则默认 30 秒会提前超时。
    - 若 10 分钟后仍未完成，继续轮询，**绝对不要 Kill 进程**。
+   - ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+   - ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续轮询，**绝对禁止在 Codex 未返回结果时直接跳过**。
 
 3. **综合分析 + 任务拆分**
    - 后端方案以 Codex 为准，前端方案以 Gemini 为准。

package/templates/commands/team-research.md

@@ -62,6 +62,9 @@ description: 'Agent Teams 需求研究 - 并行探索代码库，产出约束集
    TaskOutput({ task_id: "<gemini_task_id>", block: true, timeout: 600000 })
    ```
 
+   ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败，最多重试 2 次（间隔 5 秒）。3 次全败才跳过。
+   ⛔ **Codex 结果必须等待**：Codex 执行 5-15 分钟属正常，超时后继续轮询，禁止跳过。
+
 4. **聚合与综合**
    - 合并所有探索输出为统一约束集：
      * **硬约束**：技术限制、不可违反的模式

package/templates/commands/team-review.md

@@ -48,6 +48,9 @@ description: 'Agent Teams 审查 - 双模型交叉审查并行实施的产出，
    TaskOutput({ task_id: "<gemini_task_id>", block: true, timeout: 600000 })
    ```
 
+   ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败，最多重试 2 次（间隔 5 秒）。3 次全败才跳过。
+   ⛔ **Codex 结果必须等待**：Codex 执行 5-15 分钟属正常，超时后继续轮询，禁止跳过。
+
 3. **综合发现**
    - 合并两个模型的发现。
    - 去重重叠问题。

package/templates/commands/test.md

@@ -87,6 +87,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
 - 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时。
 如果 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**。
 - 若因等待时间过长跳过了等待 TaskOutput 结果，则**必须调用 `AskUserQuestion` 工具询问用户选择继续等待还是 Kill Task。禁止直接 Kill Task。**
+- ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+- ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续用 TaskOutput 轮询，**绝对禁止在 Codex 未返回结果时直接跳过或继续下一阶段**。已启动的 Codex 任务若被跳过 = 浪费 token + 丢失结果。
 
 ---
 

package/templates/commands/workflow.md

@@ -97,6 +97,8 @@ TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
 - 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时。
 如果 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**。
 - 若因等待时间过长跳过了等待 TaskOutput 结果，则**必须调用 `AskUserQuestion` 工具询问用户选择继续等待还是 Kill Task。禁止直接 Kill Task。**
+- ⛔ **Gemini 失败必须重试**：若 Gemini 调用失败（非零退出码或输出包含错误信息），最多重试 2 次（间隔 5 秒）。仅当 3 次全部失败时才跳过 Gemini 结果并使用单模型结果继续。
+- ⛔ **Codex 结果必须等待**：Codex 执行时间较长（5-15 分钟）属于正常。TaskOutput 超时后必须继续用 TaskOutput 轮询，**绝对禁止在 Codex 未返回结果时直接跳过或继续下一阶段**。已启动的 Codex 任务若被跳过 = 浪费 token + 丢失结果。
 
 ---
 

package/templates/skills/SKILL.md

@@ -59,14 +59,14 @@ Refactoring:    refactor → /verify-change → /verify-quality → /verify-secu
 
 ```bash
 # Unified runner
-node ~/.claude/skills/run_skill.js <skill-name> [args...]
+node ~/.claude/skills/ccg/run_skill.js <skill-name> [args...]
 
 # Examples
-node ~/.claude/skills/run_skill.js verify-security ./src
-node ~/.claude/skills/run_skill.js verify-quality ./src -v
-node ~/.claude/skills/run_skill.js verify-change --mode staged
-node ~/.claude/skills/run_skill.js verify-module ./my-module
-node ~/.claude/skills/run_skill.js gen-docs ./new-module --force
+node ~/.claude/skills/ccg/run_skill.js verify-security ./src
+node ~/.claude/skills/ccg/run_skill.js verify-quality ./src -v
+node ~/.claude/skills/ccg/run_skill.js verify-change --mode staged
+node ~/.claude/skills/ccg/run_skill.js verify-module ./my-module
+node ~/.claude/skills/ccg/run_skill.js gen-docs ./new-module --force
 ```
 
 ---