ccg-workflow 1.7.46 → 1.7.48

package/README.md

@@ -41,6 +41,34 @@ npx ccg-workflow
 | `/ccg:worktree` | Worktree 管理 |
 | `/ccg:init` | 初始化 CLAUDE.md |
 | `/ccg:enhance` | Prompt 增强 |
+| `/ccg:spec-init` | 初始化 OpenSpec 环境 |
+| `/ccg:spec-research` | 需求 → 约束集 |
+| `/ccg:spec-plan` | 约束 → 零决策计划 |
+| `/ccg:spec-impl` | 按计划执行 + 归档 |
+| `/ccg:spec-review` | 双模型交叉审查 |
+
+### OpenSpec 规范驱动（v1.7.48）
+
+集成 [OpenSpec](https://github.com/fission-ai/openspec)，把需求变成约束，让 AI 没法自由发挥：
+
+```bash
+# 初始化
+/ccg:spec-init
+
+# 研究需求 → 输出约束集
+/ccg:spec-research 实现用户认证
+
+# 并行分析 → 零决策计划
+/ccg:spec-plan
+
+# 按计划执行
+/ccg:spec-impl
+
+# 独立审查（随时可用）
+/ccg:spec-review
+```
+
+每阶段之间可 `/clear`，状态存在 `openspec/` 目录，不怕上下文爆。
 
 ### 规划与执行分离
 
@@ -88,11 +116,15 @@ v1.7.39 新增 `/ccg:plan` 和 `/ccg:execute` 命令，将规划与执行解耦
     "CODEAGENT_POST_MESSAGE_DELAY": "1",
     "CODEX_TIMEOUT": "7200",
     "BASH_DEFAULT_TIMEOUT_MS": "600000",
-    "BASH_MAX_TIMEOUT_MS": "3600000"
+    "BASH_MAX_TIMEOUT_MS": "3600000",
+    "GEMINI_API_KEY": "your-gemini-api-key",
+    "GOOGLE_API_KEY": "your-google-api-key"
   }
 }
 ```
 
+> **VSCode 插件用户注意**：VSCode 启动的子进程不会继承终端环境变量，必须在 `settings.json` 中配置 API 密钥，否则 Gemini 会报退出码 41（授权失败）。
+
 ### MCP 配置
 
 ace-tool 用于代码检索和 Prompt 增强，安装时可选配置。
@@ -153,4 +185,4 @@ MIT
 
 ---
 
-v1.7.39 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues)
+v1.7.48 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues)

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, s as showMainMenu, i as init, E as configMcp, F as version, a as i18n } from './shared/ccg-workflow.CG7COXKD.mjs';
+import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, s as showMainMenu, i as init, E as configMcp, F as version, a as i18n } from './shared/ccg-workflow.e4y82GtN.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.CG7COXKD.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.e4y82GtN.mjs';
 import 'ansis';
 import 'inquirer';
 import 'node:child_process';

package/dist/shared/{ccg-workflow.CG7COXKD.mjs → ccg-workflow.e4y82GtN.mjs}

@@ -10,7 +10,7 @@ import i18next from 'i18next';
 import ora from 'ora';
 import { parse, stringify } from 'smol-toml';
 
-const version = "1.7.46";
+const version = "1.7.48";
 
 function isWindows() {
   return process.platform === "win32";
@@ -356,6 +356,61 @@ const WORKFLOW_CONFIGS = [
     order: 23,
     description: "\u7BA1\u7406 Git worktree",
     descriptionEn: "Manage Git worktree"
+  },
+  {
+    id: "spec-init",
+    name: "OpenSpec \u521D\u59CB\u5316",
+    nameEn: "OpenSpec Init",
+    category: "spec",
+    commands: ["spec-init"],
+    defaultSelected: true,
+    order: 30,
+    description: "\u521D\u59CB\u5316 OpenSpec \u73AF\u5883 + \u9A8C\u8BC1\u591A\u6A21\u578B MCP \u5DE5\u5177",
+    descriptionEn: "Initialize OpenSpec environment with multi-model MCP validation"
+  },
+  {
+    id: "spec-research",
+    name: "\u9700\u6C42\u7814\u7A76",
+    nameEn: "Spec Research",
+    category: "spec",
+    commands: ["spec-research"],
+    defaultSelected: true,
+    order: 31,
+    description: "\u9700\u6C42 \u2192 \u7EA6\u675F\u96C6\uFF08\u5E76\u884C\u63A2\u7D22 + OpenSpec \u63D0\u6848\uFF09",
+    descriptionEn: "Transform requirements into constraint sets via parallel exploration"
+  },
+  {
+    id: "spec-plan",
+    name: "\u96F6\u51B3\u7B56\u89C4\u5212",
+    nameEn: "Spec Plan",
+    category: "spec",
+    commands: ["spec-plan"],
+    defaultSelected: true,
+    order: 32,
+    description: "\u591A\u6A21\u578B\u5206\u6790 \u2192 \u6D88\u9664\u6B67\u4E49 \u2192 \u96F6\u51B3\u7B56\u53EF\u6267\u884C\u8BA1\u5212",
+    descriptionEn: "Refine proposals into zero-decision executable plans"
+  },
+  {
+    id: "spec-impl",
+    name: "\u89C4\u8303\u9A71\u52A8\u5B9E\u73B0",
+    nameEn: "Spec Implementation",
+    category: "spec",
+    commands: ["spec-impl"],
+    defaultSelected: true,
+    order: 33,
+    description: "\u6309\u89C4\u8303\u6267\u884C + \u591A\u6A21\u578B\u534F\u4F5C + \u5F52\u6863",
+    descriptionEn: "Execute changes via multi-model collaboration with spec compliance"
+  },
+  {
+    id: "spec-review",
+    name: "\u5F52\u6863\u524D\u5BA1\u67E5",
+    nameEn: "Spec Review",
+    category: "spec",
+    commands: ["spec-review"],
+    defaultSelected: true,
+    order: 34,
+    description: "\u53CC\u6A21\u578B\u4EA4\u53C9\u5BA1\u67E5 \u2192 Critical \u5FC5\u987B\u4FEE\u590D \u2192 \u5141\u8BB8\u5F52\u6863",
+    descriptionEn: "Multi-model compliance review before archiving"
   }
 ];
 function getWorkflowConfigs() {
@@ -1987,56 +2042,85 @@ async function performUpdate(fromVersion, toVersion, isNewVersion) {
 
 const execAsync = promisify(exec);
 async function showMainMenu() {
-  console.log();
-  console.log(ansis.cyan.bold(`  CCG - Claude + Codex + Gemini`));
-  console.log(ansis.gray("  Multi-Model Collaboration System"));
-  console.log();
-  const { action } = await inquirer.prompt([{
-    type: "list",
-    name: "action",
-    message: i18n.t("menu:title"),
-    choices: [
-      { name: `${ansis.green("\u279C")} ${i18n.t("menu:options.init")}`, value: "init" },
-      { name: `${ansis.blue("\u279C")} ${i18n.t("menu:options.update")}`, value: "update" },
-      { name: `${ansis.cyan("\u2699")} \u914D\u7F6E MCP`, value: "config-mcp" },
-      { name: `${ansis.magenta("\u279C")} ${i18n.t("menu:options.uninstall")}`, value: "uninstall" },
-      { name: `${ansis.yellow("?")} ${i18n.t("menu:options.help")}`, value: "help" },
-      new inquirer.Separator(),
-      { name: `${ansis.red("\u2715")} ${i18n.t("menu:options.exit")}`, value: "exit" }
-    ]
-  }]);
-  switch (action) {
-    case "init":
-      await init();
-      break;
-    case "update":
-      await update();
-      break;
-    case "config-mcp":
-      await configMcp();
-      break;
-    case "uninstall":
-      await uninstall();
-      break;
-    case "help":
-      showHelp();
-      break;
-    case "exit":
-      console.log(ansis.gray("Goodbye!"));
-      break;
+  while (true) {
+    console.log();
+    console.log(ansis.cyan.bold(`  CCG - Claude + Codex + Gemini`));
+    console.log(ansis.gray("  Multi-Model Collaboration System"));
+    console.log();
+    const { action } = await inquirer.prompt([{
+      type: "list",
+      name: "action",
+      message: i18n.t("menu:title"),
+      choices: [
+        { name: `${ansis.green("\u279C")} ${i18n.t("menu:options.init")}`, value: "init" },
+        { name: `${ansis.blue("\u279C")} ${i18n.t("menu:options.update")}`, value: "update" },
+        { name: `${ansis.cyan("\u2699")} \u914D\u7F6E MCP`, value: "config-mcp" },
+        { name: `${ansis.magenta("\u279C")} ${i18n.t("menu:options.uninstall")}`, value: "uninstall" },
+        { name: `${ansis.yellow("?")} ${i18n.t("menu:options.help")}`, value: "help" },
+        new inquirer.Separator(),
+        { name: `${ansis.red("\u2715")} ${i18n.t("menu:options.exit")}`, value: "exit" }
+      ]
+    }]);
+    switch (action) {
+      case "init":
+        await init();
+        break;
+      case "update":
+        await update();
+        break;
+      case "config-mcp":
+        await configMcp();
+        break;
+      case "uninstall":
+        await uninstall();
+        break;
+      case "help":
+        showHelp();
+        break;
+      case "exit":
+        console.log(ansis.gray("Goodbye!"));
+        return;
+    }
+    console.log();
+    await inquirer.prompt([{
+      type: "input",
+      name: "continue",
+      message: ansis.gray("\u6309 Enter \u8FD4\u56DE\u4E3B\u83DC\u5355...")
+    }]);
   }
 }
 function showHelp() {
   console.log();
   console.log(ansis.cyan.bold(i18n.t("menu:help.title")));
   console.log();
-  console.log(`  ${ansis.green("/ccg:dev")}         ${i18n.t("menu:help.descriptions.dev")}`);
+  console.log(ansis.yellow.bold("  \u5F00\u53D1\u5DE5\u4F5C\u6D41:"));
+  console.log(`  ${ansis.green("/ccg:workflow")}    \u5B8C\u65746\u9636\u6BB5\u5F00\u53D1\u5DE5\u4F5C\u6D41`);
+  console.log(`  ${ansis.green("/ccg:plan")}        \u591A\u6A21\u578B\u534F\u4F5C\u89C4\u5212\uFF08Phase 1-2\uFF09`);
+  console.log(`  ${ansis.green("/ccg:execute")}     \u591A\u6A21\u578B\u534F\u4F5C\u6267\u884C\uFF08Phase 3-5\uFF09`);
   console.log(`  ${ansis.green("/ccg:frontend")}    ${i18n.t("menu:help.descriptions.frontend")}`);
   console.log(`  ${ansis.green("/ccg:backend")}     ${i18n.t("menu:help.descriptions.backend")}`);
-  console.log(`  ${ansis.green("/ccg:review")}      ${i18n.t("menu:help.descriptions.review")}`);
+  console.log(`  ${ansis.green("/ccg:feat")}        \u667A\u80FD\u529F\u80FD\u5F00\u53D1`);
   console.log(`  ${ansis.green("/ccg:analyze")}     ${i18n.t("menu:help.descriptions.analyze")}`);
+  console.log(`  ${ansis.green("/ccg:debug")}       \u95EE\u9898\u8BCA\u65AD + \u4FEE\u590D`);
+  console.log(`  ${ansis.green("/ccg:optimize")}    \u6027\u80FD\u4F18\u5316`);
+  console.log(`  ${ansis.green("/ccg:test")}        \u6D4B\u8BD5\u751F\u6210`);
+  console.log(`  ${ansis.green("/ccg:review")}      ${i18n.t("menu:help.descriptions.review")}`);
+  console.log();
+  console.log(ansis.yellow.bold("  OpenSpec \u89C4\u8303\u9A71\u52A8:"));
+  console.log(`  ${ansis.green("/ccg:spec-init")}      \u521D\u59CB\u5316 OpenSpec \u73AF\u5883`);
+  console.log(`  ${ansis.green("/ccg:spec-research")} \u9700\u6C42\u7814\u7A76 \u2192 \u7EA6\u675F\u96C6`);
+  console.log(`  ${ansis.green("/ccg:spec-plan")}     \u591A\u6A21\u578B\u5206\u6790 \u2192 \u96F6\u51B3\u7B56\u8BA1\u5212`);
+  console.log(`  ${ansis.green("/ccg:spec-impl")}     \u89C4\u8303\u9A71\u52A8\u5B9E\u73B0`);
+  console.log(`  ${ansis.green("/ccg:spec-review")}   \u5F52\u6863\u524D\u53CC\u6A21\u578B\u5BA1\u67E5`);
+  console.log();
+  console.log(ansis.yellow.bold("  Git \u5DE5\u5177:"));
   console.log(`  ${ansis.green("/ccg:commit")}      ${i18n.t("menu:help.descriptions.commit")}`);
   console.log(`  ${ansis.green("/ccg:rollback")}    ${i18n.t("menu:help.descriptions.rollback")}`);
+  console.log(`  ${ansis.green("/ccg:clean-branches")} \u6E05\u7406\u5DF2\u5408\u5E76\u5206\u652F`);
+  console.log(`  ${ansis.green("/ccg:worktree")}    Git Worktree \u7BA1\u7406`);
+  console.log();
+  console.log(ansis.yellow.bold("  \u9879\u76EE\u7BA1\u7406:"));
+  console.log(`  ${ansis.green("/ccg:init")}        \u521D\u59CB\u5316\u9879\u76EE CLAUDE.md`);
   console.log();
   console.log(ansis.gray(i18n.t("menu:help.hint")));
   console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.7.46",
+  "version": "1.7.48",
   "description": "Claude-Codex-Gemini 多模型协作系统 - 智能路由多模型开发工作流",
   "type": "module",
   "packageManager": "pnpm@10.17.1",
@@ -47,6 +47,7 @@
     "templates/commands/agents/",
     "templates/prompts/codex/",
     "templates/prompts/gemini/analyzer.md",
+    "templates/prompts/gemini/architect.md",
     "templates/prompts/gemini/debugger.md",
     "templates/prompts/gemini/frontend.md",
     "templates/prompts/gemini/optimizer.md",

package/templates/prompts/gemini/architect.md

@@ -0,0 +1,47 @@
+# Gemini Role: Frontend Architect
+
+> For: /ccg:plan, /ccg:execute, /ccg:workflow Phase 2-3
+
+You are a senior frontend architect specializing in UI/UX design systems, component architecture, and modern web application structure.
+
+## CRITICAL CONSTRAINTS
+
+- **ZERO file system write permission** - READ-ONLY sandbox
+- **OUTPUT FORMAT**: Unified Diff Patch ONLY
+- **NEVER** execute actual modifications
+
+## Core Expertise
+
+- React/Vue/Svelte component architecture and design patterns
+- Design system creation (tokens, themes, variants)
+- State management architecture (Redux, Zustand, Pinia)
+- Micro-frontend and module federation strategies
+- Performance optimization (code splitting, lazy loading)
+- Accessibility architecture (WCAG 2.1 AA compliance)
+
+## Approach
+
+1. **Analyze First** - Understand existing patterns before proposing changes
+2. **Component-Driven** - Design reusable, composable UI building blocks
+3. **Scalable Structure** - Plan for growth and team collaboration
+4. **Performance Budget** - Consider bundle size and runtime impact
+5. **Concrete Plans** - Provide actionable implementation steps
+
+## Output Format
+
+```diff
+--- a/src/components/Button/Button.tsx
++++ b/src/components/Button/Button.tsx
+@@ -5,6 +5,10 @@ interface ButtonProps {
+   children: React.ReactNode;
++  variant?: 'primary' | 'secondary' | 'danger';
++  size?: 'sm' | 'md' | 'lg';
+ }
+```
+
+## Response Structure
+
+1. **Analysis** - Current architecture assessment
+2. **Architecture Decision** - Key design choices with rationale
+3. **Implementation Plan** - Step-by-step with pseudo-code
+4. **Considerations** - Performance, accessibility, maintainability notes