ccg-workflow 1.7.50 → 1.7.52

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.DmpTp5qU.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.BqEmGd17.mjs';
 import 'inquirer';
 import 'node:child_process';
 import 'node:util';
@@ -135,30 +135,30 @@ async function setupCommands(cli) {
   } catch {
     await initI18n("zh-CN");
   }
-  cli.command("", "Show interactive menu (default)").option("--lang, -l <lang>", "Display language (zh-CN, en)").action(async (options) => {
+  cli.command("", "\u663E\u793A\u4EA4\u4E92\u5F0F\u83DC\u5355\uFF08\u9ED8\u8BA4\uFF09").option("--lang, -l <lang>", "\u663E\u793A\u8BED\u8A00 (zh-CN, en)").action(async (options) => {
     if (options.lang) {
       await initI18n(options.lang);
     }
     await showMainMenu();
   });
-  cli.command("init", "Initialize CCG multi-model collaboration system").alias("i").option("--lang, -l <lang>", "Display language (zh-CN, en)").option("--force, -f", "Force overwrite existing configuration").option("--skip-prompt, -s", "Skip all interactive prompts (non-interactive mode)").option("--skip-mcp", "Skip MCP configuration (used during update)").option("--frontend, -F <models>", "Frontend models (comma-separated: gemini,codex,claude)").option("--backend, -B <models>", "Backend models (comma-separated: codex,gemini,claude)").option("--mode, -m <mode>", "Collaboration mode (parallel, smart, sequential)").option("--workflows, -w <workflows>", 'Workflows to install (comma-separated or "all")').option("--install-dir, -d <path>", "Installation directory (default: ~/.claude)").action(async (options) => {
+  cli.command("init", "\u521D\u59CB\u5316 CCG \u591A\u6A21\u578B\u534F\u4F5C\u7CFB\u7EDF").alias("i").option("--lang, -l <lang>", "\u663E\u793A\u8BED\u8A00 (zh-CN, en)").option("--force, -f", "\u5F3A\u5236\u8986\u76D6\u73B0\u6709\u914D\u7F6E").option("--skip-prompt, -s", "\u8DF3\u8FC7\u6240\u6709\u4EA4\u4E92\u5F0F\u63D0\u793A\uFF08\u975E\u4EA4\u4E92\u6A21\u5F0F\uFF09").option("--skip-mcp", "\u8DF3\u8FC7 MCP \u914D\u7F6E\uFF08\u66F4\u65B0\u65F6\u4F7F\u7528\uFF09").option("--frontend, -F <models>", "\u524D\u7AEF\u6A21\u578B\uFF08\u9017\u53F7\u5206\u9694: gemini,codex,claude\uFF09").option("--backend, -B <models>", "\u540E\u7AEF\u6A21\u578B\uFF08\u9017\u53F7\u5206\u9694: codex,gemini,claude\uFF09").option("--mode, -m <mode>", "\u534F\u4F5C\u6A21\u5F0F (parallel, smart, sequential)").option("--workflows, -w <workflows>", '\u8981\u5B89\u88C5\u7684\u5DE5\u4F5C\u6D41\uFF08\u9017\u53F7\u5206\u9694\u6216 "all"\uFF09').option("--install-dir, -d <path>", "\u5B89\u88C5\u76EE\u5F55\uFF08\u9ED8\u8BA4: ~/.claude\uFF09").action(async (options) => {
     if (options.lang) {
       await initI18n(options.lang);
     }
     await init(options);
   });
-  cli.command("diagnose-mcp", "Diagnose MCP configuration issues").action(async () => {
+  cli.command("diagnose-mcp", "\u8BCA\u65AD MCP \u914D\u7F6E\u95EE\u9898").action(async () => {
     await diagnoseMcp();
   });
-  cli.command("fix-mcp", "Fix Windows MCP configuration issues").action(async () => {
+  cli.command("fix-mcp", "\u4FEE\u590D Windows MCP \u914D\u7F6E\u95EE\u9898").action(async () => {
     await fixMcp();
   });
-  cli.command("config <subcommand>", "Configure CCG settings").action(async (subcommand) => {
+  cli.command("config <subcommand>", "\u914D\u7F6E CCG \u8BBE\u7F6E").action(async (subcommand) => {
     if (subcommand === "mcp") {
       await configMcp();
     } else {
-      console.log(ansis.red(`Unknown subcommand: ${subcommand}`));
-      console.log(ansis.gray("Available subcommands: mcp"));
+      console.log(ansis.red(`\u672A\u77E5\u5B50\u547D\u4EE4: ${subcommand}`));
+      console.log(ansis.gray("\u53EF\u7528\u5B50\u547D\u4EE4: mcp"));
     }
   });
   cli.help((sections) => customizeHelp(sections));

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.DmpTp5qU.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.BqEmGd17.mjs';
 import 'ansis';
 import 'inquirer';
 import 'node:child_process';

package/dist/shared/{ccg-workflow.DmpTp5qU.mjs → ccg-workflow.BqEmGd17.mjs}

@@ -10,7 +10,7 @@ import i18next from 'i18next';
 import ora from 'ora';
 import { parse, stringify } from 'smol-toml';
 
-const version = "1.7.50";
+const version = "1.7.52";
 
 function isWindows() {
   return process.platform === "win32";
@@ -1863,20 +1863,23 @@ async function update() {
     }
     console.log();
     const effectiveNeedsUpdate = hasUpdate || needsWorkflowUpdate;
+    let defaultConfirm = effectiveNeedsUpdate;
     let message;
     if (hasUpdate) {
-      message = `\u786E\u8BA4\u8981\u66F4\u65B0\u5230 v${latestVersion} \u5417\uFF1F\uFF08\u5148\u4E0B\u8F7D\u6700\u65B0\u5305 \u2192 \u5220\u9664\u65E7\u5DE5\u4F5C\u6D41 \u2192 \u5B89\u88C5\u65B0\u5DE5\u4F5C\u6D41\uFF09`;
+      message = `\u53D1\u73B0\u65B0\u7248\u672C v${latestVersion} (\u5F53\u524D: v${currentVersion})\uFF0C\u662F\u5426\u66F4\u65B0\uFF1F`;
+      defaultConfirm = true;
     } else if (needsWorkflowUpdate) {
       message = `\u68C0\u6D4B\u5230\u672C\u5730\u5DE5\u4F5C\u6D41\u7248\u672C (v${localVersion}) \u4F4E\u4E8E\u5F53\u524D\u7248\u672C (v${currentVersion})\uFF0C\u662F\u5426\u66F4\u65B0\uFF1F`;
+      defaultConfirm = true;
     } else {
-      message = "\u5F53\u524D\u5DF2\u662F\u6700\u65B0\u7248\u672C\u3002\u8981\u91CD\u65B0\u5B89\u88C5\u5417\uFF1F\uFF08\u5148\u4E0B\u8F7D\u6700\u65B0\u5305 \u2192 \u5220\u9664\u65E7\u5DE5\u4F5C\u6D41 \u2192 \u5B89\u88C5\u65B0\u5DE5\u4F5C\u6D41\uFF09";
+      message = `\u5F53\u524D\u5DF2\u662F\u6700\u65B0\u7248\u672C (v${currentVersion})\u3002\u662F\u5426\u5F3A\u5236\u91CD\u65B0\u5B89\u88C5/\u4FEE\u590D\u5DE5\u4F5C\u6D41\uFF1F`;
+      defaultConfirm = false;
     }
     const { confirmUpdate } = await inquirer.prompt([{
       type: "confirm",
       name: "confirmUpdate",
       message,
-      default: effectiveNeedsUpdate
-      // Default to true if needs update
+      default: defaultConfirm
     }]);
     if (!confirmUpdate) {
       console.log(ansis.gray("\u5DF2\u53D6\u6D88\u66F4\u65B0"));
@@ -2078,7 +2081,7 @@ async function showMainMenu() {
         showHelp();
         break;
       case "exit":
-        console.log(ansis.gray("Goodbye!"));
+        console.log(ansis.gray("\u518D\u89C1\uFF01"));
         return;
     }
     console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.7.50",
+  "version": "1.7.52",
   "description": "Claude-Codex-Gemini 多模型协作系统 - 智能路由多模型开发工作流",
   "type": "module",
   "packageManager": "pnpm@10.17.1",

package/templates/commands/spec-impl.md

@@ -12,16 +12,17 @@ description: '按规范执行 + 多模型协作 + 归档'
 - **NEVER** apply Codex/Gemini prototypes directly—all outputs are reference only.
 - **MANDATORY**: Request `unified diff patch` format from external models; they have zero write permission.
 - Keep implementation strictly within `tasks.md` scope—no scope creep.
-- Refer to `openspec/AGENTS.md` for conventions.
+- Refer to `openspec/config.yaml` for conventions.
 
 **Steps**
-1. **Select Proposal**
+1. **Select Change**
    - Run `openspec list` to inspect Active Changes.
-   - Confirm with user which proposal ID to implement.
-   - Run `openspec show <proposal_id>` to review tasks.
+   - Confirm with user which change ID to implement.
+   - Run `openspec show <change_id>` to review tasks.
 
-2. **Apply OpenSpec Change**
-   - Run `/openspec:apply <proposal_id>` to enter implementation mode.
+2. **Apply OPSX Change**
+   - Use `/ccg:spec-impl` (which uses OpenSpec skills internally) to enter implementation mode.
+   - This skill will guide you through the tasks defined in `tasks.md`.
 
 3. **Identify Minimal Verifiable Phase**
    - Review `tasks.md` and identify the **smallest verifiable phase**.
@@ -104,7 +105,7 @@ description: '按规范执行 + 多模型协作 + 归档'
 
 10. **Archive on Completion**
     - When ALL tasks in `tasks.md` are marked `[x]`:
-    - Run `/openspec:archive <proposal_id>`
+    - The agent will use OpenSpec skills to archive the change.
     - This merges spec deltas to `openspec/specs/` and moves change to archive.
 
 **Reference**
@@ -118,6 +119,5 @@ Implementation is complete when:
 - [ ] All tasks in `tasks.md` marked `[x]`
 - [ ] All multi-model reviews passed
 - [ ] Side-effect review confirmed no regressions
-- [ ] `openspec validate <id>` returns zero issues
 - [ ] Change archived successfully
 <!-- CCG:SPEC:IMPL:END -->

package/templates/commands/spec-init.md

@@ -1,9 +1,9 @@
 ---
-description: '初始化 OpenSpec 环境 + 验证多模型 MCP 工具'
+description: '初始化 OpenSpec (OPSX) 环境 + 验证多模型 MCP 工具'
 ---
 <!-- CCG:SPEC:INIT:START -->
 **Core Philosophy**
-- OpenSpec provides the specification framework; CCG adds multi-model collaboration.
+- OPSX provides the specification framework; CCG adds multi-model collaboration.
 - This phase ensures all tools are ready before any development work begins.
 - Fail fast: detect missing dependencies early rather than mid-workflow.
 
@@ -20,18 +20,24 @@ description: '初始化 OpenSpec 环境 + 验证多模型 MCP 工具'
 
 2. **Check and Install OpenSpec**
    - Verify if `openspec` CLI is installed: `openspec --version`
-   - If not installed:
+   - If not installed or not found:
      ```bash
      npm install -g @fission-ai/openspec@latest
      ```
-   - Confirm installation success.
+   - **Path Verification**:
+     - If `openspec` command is not found after installation:
+       1. Find npm global bin: `npm bin -g`
+       2. Add to PATH temporarily for this session: `export PATH=$PATH:$(npm bin -g)`
+       3. **CRITICAL**: Instruct user to add this path to their shell profile (e.g., `~/.zshrc`, `~/.bashrc`, or Windows Environment Variables) to make it permanent.
+   - Confirm installation success by running `openspec --version` again.
 
-3. **Initialize OpenSpec for Current Project**
+3. **Initialize OpenSpec (OPSX) for Current Project**
    - Run:
      ```bash
      openspec init --tools claude
      ```
    - Verify `openspec/` directory structure is created.
+   - Verify `.claude/skills/` contains `openspec-*` skills.
    - Report any errors with remediation steps.
 
 4. **Validate Multi-Model MCP Tools**
@@ -47,8 +53,13 @@ description: '初始化 OpenSpec 环境 + 验证多模型 MCP 工具'
    - For each unavailable tool, display warning with installation instructions.
 
 5. **Validate Context Retrieval MCP** (Optional)
-   - Check if `mcp__ace-tool__search_context` is available.
-   - If not, suggest: "Run `npx ccg-workflow` and select ace-tool MCP option."
+   - **Check Active Tool**: Is `mcp__ace-tool__search_context` available in the current session?
+   - **Check Configuration**: If tool is missing, check `~/.claude.json` (or `%APPDATA%\Claude\claude.json` on Windows) for `"ace-tool"` or `"ace-tool-rs"` in `mcpServers`.
+   - **Diagnosis**:
+     - If tool available: Mark as "✓ Active".
+     - If config exists but tool missing: Mark as "⚠️ Configured but inactive (Try restarting Claude)".
+     - If neither: Mark as "○ Not installed (Optional)".
+   - If not installed/configured, suggest: "Run `npx ccg-workflow` and select ace-tool MCP option."
 
 6. **Summary Report**
    Display status table:
@@ -57,12 +68,20 @@ description: '初始化 OpenSpec 环境 + 验证多模型 MCP 工具'
    ─────────────────────────────────
    OpenSpec CLI              ✓/✗
    Project initialized       ✓/✗
+   OPSX Skills               ✓/✗
    codeagent-wrapper         ✓/✗
    Codex backend             ✓/✗
    Gemini backend            ✓/✗
    ace-tool MCP              ✓/✗ (optional)
    ```
-   If any required components missing, list actions before proceeding.
+
+   **Next Steps (Use CCG Encapsulated Commands)**
+   1. Start Research: `/ccg:spec-research "description"`
+   2. Plan & Design: `/ccg:spec-plan`
+   3. Implement: `/ccg:spec-impl` (Includes auto-review & archive)
+
+   **Standalone Tools (Available Anytime)**
+   - Code Review: `/ccg:spec-review` (Independent dual-model review)
 
 **Reference**
 - OpenSpec CLI: `openspec --help`

package/templates/commands/spec-plan.md

@@ -12,13 +12,13 @@ description: '多模型分析 → 消除歧义 → 零决策可执行计划'
 - Do not proceed to implementation until every ambiguity is resolved.
 - Multi-model collaboration is **mandatory**: use both Codex and Gemini.
 - If constraints cannot be fully specified, escalate to user or return to research phase.
-- Refer to `openspec/AGENTS.md` for conventions; run `openspec update` if missing.
+- Refer to `openspec/config.yaml` for project conventions.
 
 **Steps**
-1. **Select Proposal**
+1. **Select Change**
    - Run `openspec list` to display Active Changes.
-   - Confirm with user which proposal ID to refine.
-   - Run `openspec show <proposal_id>` to review current state.
+   - Confirm with user which change ID to refine.
+   - Run `openspec status --change <change_id>` to review current state.
 
 2. **Multi-Model Implementation Analysis (PARALLEL)**
    - **CRITICAL**: You MUST launch BOTH Codex AND Gemini in a SINGLE message with TWO Bash tool calls.
@@ -29,7 +29,7 @@ description: '多模型分析 → 消除歧义 → 零决策可执行计划'
    **FIRST Bash call (Codex)**:
    ```
    Bash({
-     command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF'\nAnalyze proposal <proposal_id> from backend perspective:\n- Implementation approach\n- Technical risks\n- Alternative architectures\n- Edge cases and failure modes\nOUTPUT: JSON with analysis\nEOF",
+     command: "~/.claude/bin/codeagent-wrapper --backend codex - \"$PWD\" <<'EOF'\nAnalyze change <change_id> from backend perspective:\n- Implementation approach\n- Technical risks\n- Alternative architectures\n- Edge cases and failure modes\nOUTPUT: JSON with analysis\nEOF",
      run_in_background: true,
      timeout: 300000,
      description: "Codex: backend analysis"
@@ -39,7 +39,7 @@ description: '多模型分析 → 消除歧义 → 零决策可执行计划'
    **SECOND Bash call (Gemini) - IN THE SAME MESSAGE**:
    ```
    Bash({
-     command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF'\nAnalyze proposal <proposal_id> from frontend/integration perspective:\n- Maintainability assessment\n- Scalability considerations\n- Integration conflicts\nOUTPUT: JSON with analysis\nEOF",
+     command: "~/.claude/bin/codeagent-wrapper --backend gemini - \"$PWD\" <<'EOF'\nAnalyze change <change_id> from frontend/integration perspective:\n- Maintainability assessment\n- Scalability considerations\n- Integration conflicts\nOUTPUT: JSON with analysis\nEOF",
      run_in_background: true,
      timeout: 300000,
      description: "Gemini: frontend analysis"
@@ -82,28 +82,28 @@ description: '多模型分析 → 消除歧义 → 零决策可执行计划'
    - **Monotonicity**: Ordering guarantees (e.g., timestamps increase)
    - **Bounds**: Value ranges, size limits, rate constraints
 
-5. **Update OpenSpec Documents**
-   - Run `/openspec:proposal <proposal_id>` to update specs with:
-     * All resolved constraints
-     * PBT properties in spec format
-     * Zero-decision task sequence
-   - Run `openspec validate <proposal_id>` to verify format.
+5. **Update OPSX Artifacts**
+   - The agent will use OpenSpec skills to generate/update:
+     * specs (Requirements + PBT)
+     * design (Technical decisions)
+     * tasks (Zero-decision implementation plan)
+   - Ensure all resolved constraints and PBT properties are included in the generated artifacts.
 
 6. **Context Checkpoint**
    - Report current context usage.
-   - If approaching 80K tokens, suggest: "Run `/clear` and continue with `/ccg:spec:impl`"
+   - If approaching 80K tokens, suggest: "Run `/clear` and continue with `/ccg:spec-impl`"
 
 **Exit Criteria**
-A proposal is ready for implementation only when:
+A change is ready for implementation only when:
 - [ ] All multi-model analyses completed and synthesized
 - [ ] Zero ambiguities remain (verified by step 3 audit)
 - [ ] All PBT properties documented with falsification strategies
-- [ ] `openspec validate <id>` returns zero issues
+- [ ] Artifacts (specs, design, tasks) generated via OpenSpec skills
 - [ ] User has explicitly approved all constraint decisions
 
 **Reference**
-- Inspect proposal: `openspec show <id> --json`
-- Check conflicts: `openspec list --specs`
+- Inspect change: `openspec status --change <id> --verbose`
+- Check conflicts: `openspec workflow schemas`
 - Search patterns: `rg -n "INVARIANT:|PROPERTY:" openspec/`
 - Use `AskUserQuestion` for ANY ambiguity—never assume
 <!-- CCG:SPEC:PLAN:END -->

package/templates/commands/spec-research.md

@@ -1,12 +1,12 @@
 ---
-description: '需求 → 约束集（并行探索 + OpenSpec 提案）'
+description: '需求 → 约束集（并行探索 + OPSX 提案）'
 ---
 <!-- CCG:SPEC:RESEARCH:START -->
 **Core Philosophy**
 - Research produces **constraint sets**, not information dumps. Each constraint narrows the solution space.
 - Constraints tell subsequent stages "don't consider this direction," enabling mechanical execution without decisions.
 - Output: 约束集合 + 可验证的成功判据 (constraint sets + verifiable success criteria).
-- Strictly adhere to OpenSpec rules when writing spec-structured documents.
+- Strictly adhere to OPSX rules when writing spec-structured documents.
 
 **Guardrails**
 - **STOP! BEFORE ANY OTHER ACTION**: You MUST call `mcp__ace-tool__enhance_prompt` FIRST. This is NON-NEGOTIABLE.
@@ -30,9 +30,9 @@ description: '需求 → 约束集（并行探索 + OpenSpec 提案）'
    - Wait for enhanced prompt result.
    - Use enhanced prompt for ALL subsequent steps.
 
-1. **Generate OpenSpec Proposal**
-   - Run: `/openspec:proposal $ARGUMENTS`
-   - This scaffolds `openspec/changes/<name>/` with proposal.md, tasks.md, specs/.
+1. **Generate OPSX Change**
+   - The agent will automatically initialize a new change or continue an existing one using OpenSpec skills.
+   - This scaffolds `openspec/changes/<name>/` with proposal.md.
 
 2. **Initial Codebase Assessment**
    - Use `mcp__ace-tool__search_context` to scan codebase.
@@ -78,8 +78,8 @@ description: '需求 → 约束集（并行探索 + OpenSpec 提案）'
      * Suggest defaults when applicable
    - Capture responses as additional constraints.
 
-7. **Finalize OpenSpec Proposal**
-   - Transform constraint sets into OpenSpec format:
+7. **Finalize OPSX Proposal**
+   - Transform constraint sets into OPSX format:
      * **Context**: User need + discovered constraints
      * **Requirements**: Each constraint becomes requirement with scenario
      * **Success Criteria**: Derived from hints and user confirmations
@@ -91,11 +91,10 @@ description: '需求 → 约束集（并行探索 + OpenSpec 提案）'
 
 8. **Context Checkpoint**
    - Report current context usage.
-   - If approaching 80K tokens, suggest: "Run `/clear` and continue with `/ccg:spec:plan`"
+   - If approaching 80K tokens, suggest: "Run `/clear` and continue with `/ccg:spec-plan`"
 
 **Reference**
-- Review constraints: `rg -n "Constraint:|MUST|MUST NOT" openspec/specs`
+- OPSX CLI: `openspec status`, `openspec show`
 - Check prior research: `ls openspec/changes/*/`
-- Use `openspec show <name>` to inspect proposal structure
 - Use `AskUserQuestion` for ANY ambiguity—never assume or guess
 <!-- CCG:SPEC:RESEARCH:END -->