@nick848/sf-cli 1.0.3 → 1.0.7

package/dist/cli/index.js

@@ -48,18 +48,38 @@ var os__namespace = /*#__PURE__*/_interopNamespace(os);
 var CommandParser = class {
   slashCommands = [
     "help",
+    "h",
+    "?",
     "init",
+    "i",
     "new",
+    "n",
     "model",
+    "m",
     "update",
+    "u",
     "clear",
+    "c",
     "exit",
+    "e",
+    "q",
+    "quit",
+    "version",
+    "v",
+    // OpenSpec 工作流命令
     "opsx:explore",
     "opsx:new",
     "opsx:continue",
     "opsx:apply",
     "opsx:archive",
-    "opsx:propose"
+    "opsx:propose",
+    "opsx:status",
+    "opsx:cancel",
+    "opsx:rollback",
+    "opsx:confirm",
+    "opsx:next",
+    "opsx:auto",
+    "opsx:test"
   ];
   builtInAgents = [
     "frontend-dev",
@@ -108,8 +128,19 @@ var CommandParser = class {
     if (!command) {
       return { success: false, error: "\u65E0\u6548\u7684\u547D\u4EE4\u683C\u5F0F" };
     }
+    if (command.startsWith("opsx:")) {
+      return {
+        success: true,
+        command: {
+          type: "slash" /* SLASH */,
+          raw: input,
+          command,
+          args
+        }
+      };
+    }
     const isValidCommand = this.slashCommands.some(
-      (cmd) => cmd === command || cmd.startsWith(command)
+      (cmd) => cmd === command
     );
     if (!isValidCommand) {
       return { success: false, error: `\u672A\u77E5\u547D\u4EE4: /${command}` };
@@ -3314,12 +3345,20 @@ async function exitCLI(ctx, options = {}) {
 var DEFAULT_CONFIRMATION_POINTS = [
   {
     type: "spec-review",
-    name: "\u89C4\u8303\u62C6\u89E3\u786E\u8BA4",
-    description: "\u89C4\u8303\u62C6\u89E3\u5DF2\u5B8C\u6210\uFF0C\u8BF7\u786E\u8BA4\u662F\u5426\u7EE7\u7EED\u8FDB\u5165\u8BBE\u8BA1\u9636\u6BB5",
+    name: "\u89C4\u683C\u786E\u8BA4",
+    description: "\u89C4\u683C\u62C6\u5206\u5DF2\u5B8C\u6210\uFF0C\u8BF7\u786E\u8BA4\u89C4\u683C\u6587\u4EF6\u540E\u7EE7\u7EED",
     triggerStep: "explore",
     targetStep: "new",
     required: true
   },
+  {
+    type: "spec-review",
+    name: "\u89C4\u683C\u786E\u8BA4",
+    description: "\u89C4\u683C\u62C6\u5206\u5DF2\u5B8C\u6210\uFF0C\u8BF7\u786E\u8BA4\u89C4\u683C\u6587\u4EF6\u540E\u7EE7\u7EED",
+    triggerStep: "propose",
+    targetStep: "apply",
+    required: true
+  },
   {
     type: "architecture",
     name: "\u67B6\u6784\u8C03\u6574\u786E\u8BA4",
@@ -3355,19 +3394,15 @@ var ConfirmationManager = class {
   confirmationPoints;
   confirmations = /* @__PURE__ */ new Map();
   constructor(customPoints) {
-    const points = customPoints || DEFAULT_CONFIRMATION_POINTS;
-    this.confirmationPoints = new Map(points.map((p) => [p.type, p]));
+    this.confirmationPoints = customPoints || DEFAULT_CONFIRMATION_POINTS;
   }
   /**
    * 获取指定阶段的确认点
    */
   getConfirmationPointForTransition(from, to) {
-    for (const point of this.confirmationPoints.values()) {
-      if (point.triggerStep === from && point.targetStep === to) {
-        return point;
-      }
-    }
-    return void 0;
+    return this.confirmationPoints.find(
+      (point) => point.triggerStep === from && point.targetStep === to
+    );
   }
   /**
    * 检查是否需要确认
@@ -3380,7 +3415,7 @@ var ConfirmationManager = class {
    * 获取确认点详情
    */
   getConfirmationPoint(type) {
-    return this.confirmationPoints.get(type);
+    return this.confirmationPoints.find((point) => point.type === type);
   }
   /**
    * 记录确认
@@ -3424,14 +3459,14 @@ var ConfirmationManager = class {
    * 获取所有确认点
    */
   getAllConfirmationPoints() {
-    return Array.from(this.confirmationPoints.values());
+    return [...this.confirmationPoints];
   }
   /**
    * 获取指定阶段需要清除的确认点
    */
   getConfirmationsToClear(targetStep) {
     const types = [];
-    for (const point of this.confirmationPoints.values()) {
+    for (const point of this.confirmationPoints) {
       const stepOrder = ["explore", "new", "continue", "propose", "apply", "archive"];
       const targetIndex = stepOrder.indexOf(targetStep);
       const triggerIndex = stepOrder.indexOf(point.triggerStep);
@@ -3554,6 +3589,26 @@ var WorkflowEngine = class {
       devStandards: this.devStandards
     };
   }
+  /**
+   * 获取规格文件路径
+   */
+  getSpecFilePath() {
+    if (!this.state) return null;
+    return path6__namespace.join(this.openspecPath, "changes", `${this.state.id}-spec.md`);
+  }
+  /**
+   * 检查规格文件是否存在
+   */
+  async hasSpecFile() {
+    const specPath = this.getSpecFilePath();
+    if (!specPath) return false;
+    try {
+      await fs6__namespace.access(specPath);
+      return true;
+    } catch {
+      return false;
+    }
+  }
   /**
    * 启动新工作流
    */
@@ -3775,6 +3830,92 @@ var WorkflowEngine = class {
   getState() {
     return this.state;
   }
+  /**
+   * 获取所有活跃工作流
+   */
+  async getAllActiveWorkflows() {
+    const workflows = [];
+    const changesDir = path6__namespace.join(this.openspecPath, "changes");
+    try {
+      const files = await fs6__namespace.readdir(changesDir);
+      for (const file of files) {
+        if (!file.endsWith(".md") || file.includes("-spec.md")) continue;
+        const filePath = path6__namespace.join(changesDir, file);
+        const content = await fs6__namespace.readFile(filePath, "utf-8");
+        const state = this.parseChangeRecord(content);
+        if (state && state.status === "running") {
+          workflows.push(state);
+        }
+      }
+    } catch {
+    }
+    if (this.state && !workflows.find((w) => w.id === this.state?.id)) {
+      workflows.unshift(this.state);
+    }
+    return workflows;
+  }
+  /**
+   * 解析变更记录
+   */
+  parseChangeRecord(content) {
+    try {
+      const idMatch = content.match(/^id:\s*(.+)$/m);
+      const titleMatch = content.match(/^title:\s*(.+)$/m);
+      const statusMatch = content.match(/^status:\s*(.+)$/m);
+      const complexityMatch = content.match(/^complexity:\s*(\d+)/m);
+      const workflowMatch = content.match(/^workflow:\s*(.+)$/m);
+      const requirementMatch = content.match(/## 变更概述\s*\n+([\s\S]+?)(?=\n##|$)/);
+      if (!idMatch || !titleMatch) return null;
+      return {
+        id: idMatch[1].trim(),
+        title: titleMatch[1].trim(),
+        status: statusMatch?.[1].trim() || "running",
+        requirement: requirementMatch?.[1].trim() || "",
+        complexity: parseInt(complexityMatch?.[1] || "5", 10),
+        type: workflowMatch?.[1].trim() || "simple",
+        currentStep: "propose",
+        // 默认值，实际值需要从状态文件读取
+        steps: [],
+        artifacts: [],
+        createdAt: /* @__PURE__ */ new Date()
+      };
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * 切换到指定工作流
+   */
+  async switchTo(changeId) {
+    if (this.state) {
+      await this.saveState();
+    }
+    const statePath = path6__namespace.join(this.openspecPath, ".workflow-states", `${changeId}.json`);
+    try {
+      const content = await fs6__namespace.readFile(statePath, "utf-8");
+      this.state = JSON.parse(content, (key, value) => {
+        if (key.endsWith("At") && typeof value === "string") {
+          return new Date(value);
+        }
+        return value;
+      });
+      await this.restoreSnapshots();
+      return true;
+    } catch {
+      const changesDir = path6__namespace.join(this.openspecPath, "changes");
+      const changeFile = path6__namespace.join(changesDir, `${changeId}.md`);
+      try {
+        const content = await fs6__namespace.readFile(changeFile, "utf-8");
+        const parsed = this.parseChangeRecord(content);
+        if (parsed && parsed.status === "running") {
+          this.state = parsed;
+          return true;
+        }
+      } catch {
+      }
+      return false;
+    }
+  }
   /**
    * 获取允许的下一步
    */
@@ -3855,32 +3996,64 @@ var WorkflowEngine = class {
     const changesDir = path6__namespace.join(this.openspecPath, "changes");
     const archiveDir = path6__namespace.join(changesDir, "archive");
     const specDir = path6__namespace.join(this.openspecPath, "spec");
+    const statesDir = path6__namespace.join(this.openspecPath, ".workflow-states");
     await fs6__namespace.mkdir(archiveDir, { recursive: true });
     await fs6__namespace.mkdir(specDir, { recursive: true });
+    await fs6__namespace.mkdir(statesDir, { recursive: true });
   }
   async restoreState() {
-    const statePath = path6__namespace.join(this.openspecPath, ".workflow-state.json");
+    const activePath = path6__namespace.join(this.openspecPath, ".workflow-active.json");
+    let activeId = null;
     try {
-      const content = await fs6__namespace.readFile(statePath, "utf-8");
+      const activeContent = await fs6__namespace.readFile(activePath, "utf-8");
+      const activeData = JSON.parse(activeContent);
+      activeId = activeData.activeId;
+    } catch {
+    }
+    if (activeId) {
+      const statePath = path6__namespace.join(this.openspecPath, ".workflow-states", `${activeId}.json`);
+      try {
+        const content = await fs6__namespace.readFile(statePath, "utf-8");
+        this.state = JSON.parse(content, (key, value) => {
+          if (key.endsWith("At") && typeof value === "string") {
+            return new Date(value);
+          }
+          return value;
+        });
+        return;
+      } catch {
+      }
+    }
+    const oldStatePath = path6__namespace.join(this.openspecPath, ".workflow-state.json");
+    try {
+      const content = await fs6__namespace.readFile(oldStatePath, "utf-8");
       this.state = JSON.parse(content, (key, value) => {
         if (key.endsWith("At") && typeof value === "string") {
           return new Date(value);
         }
         return value;
       });
+      if (this.state) {
+        await this.saveState();
+        await fs6__namespace.unlink(oldStatePath).catch(() => {
+        });
+      }
     } catch (e) {
       const err = e;
       if (err.code !== "ENOENT") {
         console.warn("\u8B66\u544A: \u5DE5\u4F5C\u6D41\u72B6\u6001\u6587\u4EF6\u5DF2\u635F\u574F\uFF0C\u5C06\u91CD\u65B0\u5F00\u59CB");
-        await fs6__namespace.unlink(statePath).catch(() => {
-        });
       }
       this.state = null;
     }
   }
   async saveState() {
-    const statePath = path6__namespace.join(this.openspecPath, ".workflow-state.json");
+    if (!this.state) return;
+    const statesDir = path6__namespace.join(this.openspecPath, ".workflow-states");
+    await fs6__namespace.mkdir(statesDir, { recursive: true });
+    const statePath = path6__namespace.join(statesDir, `${this.state.id}.json`);
     await fs6__namespace.writeFile(statePath, JSON.stringify(this.state, null, 2));
+    const activePath = path6__namespace.join(this.openspecPath, ".workflow-active.json");
+    await fs6__namespace.writeFile(activePath, JSON.stringify({ activeId: this.state.id }, null, 2));
   }
   async restoreSnapshots() {
     const snapshotsPath = path6__namespace.join(this.openspecPath, ".workflow-snapshots.json");
@@ -4015,16 +4188,28 @@ async function handleNew(args, ctx) {
   if (workflowEngine) {
     const existingState = workflowEngine.getState();
     if (existingState && existingState.status === "running") {
-      return {
-        output: chalk9__default.default.yellow("\u5F53\u524D\u5DF2\u6709\u6D3B\u8DC3\u7684\u5DE5\u4F5C\u6D41") + chalk9__default.default.gray(`
+      if (existingState.currentStep === "explore" || existingState.currentStep === "propose") {
+        const specPath = path6__namespace.join(workingDir, "openspec", "changes", `${existingState.id}-spec.md`);
+        if (fs9__namespace.existsSync(specPath)) {
+          return {
+            output: chalk9__default.default.yellow("\u5F53\u524D\u5DE5\u4F5C\u6D41\u6B63\u5728\u7B49\u5F85\u89C4\u683C\u786E\u8BA4") + chalk9__default.default.gray(`
 
 \u5DE5\u4F5C\u6D41: ${existingState.title}`) + chalk9__default.default.gray(`
-\u5F53\u524D\u9636\u6BB5: ${existingState.currentStep}`) + chalk9__default.default.gray(`
+\u53D8\u66F4ID: ${existingState.id}`) + chalk9__default.default.cyan("\n\n\u89C4\u683C\u6587\u4EF6\u5DF2\u751F\u6210:") + chalk9__default.default.white(`
+  ${specPath}`) + chalk9__default.default.yellow("\n\n\u8BF7\u786E\u8BA4\u89C4\u683C\u540E\u7EE7\u7EED:") + chalk9__default.default.gray("\n  /opsx:confirm spec-review  - \u786E\u8BA4\u89C4\u683C") + chalk9__default.default.gray("\n  /opsx:status              - \u67E5\u770B\u8BE6\u60C5")
+          };
+        }
+      }
+      return {
+        output: chalk9__default.default.yellow("\u5F53\u524D\u5DF2\u6709\u6D3B\u8DC3\u7684\u5DE5\u4F5C\u6D41") + chalk9__default.default.white(`
+
+\u{1F4CB} ${existingState.title || existingState.id}`) + chalk9__default.default.gray(`
+\u7C7B\u578B: ${existingState.type} | \u590D\u6742\u5EA6: ${existingState.complexity}/10`) + chalk9__default.default.cyan(`
 
-\u9009\u9879:`) + chalk9__default.default.gray(`
-  1. \u7EE7\u7EED\u5F53\u524D\u5DE5\u4F5C\u6D41: /opsx:${existingState.currentStep}`) + chalk9__default.default.gray(`
-  2. \u53D6\u6D88\u5F53\u524D\u5DE5\u4F5C\u6D41: /opsx:cancel`) + chalk9__default.default.gray(`
-  3. \u67E5\u770B\u5DE5\u4F5C\u6D41\u72B6\u6001: /opsx:status`)
+\u8FDB\u5EA6: ${existingState.steps.map((s) => {
+          const icon = s.status === "completed" ? "\u2713" : s.status === "running" ? "\u25CF" : "\u25CB";
+          return `${icon} ${s.step}`;
+        }).join(" \u2192 ")}`) + chalk9__default.default.yellow("\n\n\u53EF\u7528\u547D\u4EE4:") + chalk9__default.default.white("\n  /opsx:status   - \u67E5\u770B\u5DE5\u4F5C\u6D41\u8BE6\u60C5") + chalk9__default.default.white("\n  /opsx:cancel   - \u53D6\u6D88\u5F53\u524D\u5DE5\u4F5C\u6D41")
       };
     }
   }
@@ -4039,6 +4224,7 @@ async function handleNew(args, ctx) {
 async function newFeature(options, workingDir, workflowEngine) {
   const cwd = workingDir || process.cwd();
   const { requirement, forceComplexity } = options;
+  const lines = [];
   try {
     const stats = await fs6__namespace.stat(cwd);
     if (!stats.isDirectory()) {
@@ -4046,51 +4232,283 @@ async function newFeature(options, workingDir, workflowEngine) {
         output: chalk9__default.default.red(`\u9519\u8BEF: ${cwd} \u4E0D\u662F\u6709\u6548\u76EE\u5F55`)
       };
     }
-  } catch (e) {
+  } catch {
     return {
       output: chalk9__default.default.red(`\u9519\u8BEF: \u76EE\u5F55\u4E0D\u5B58\u5728\u6216\u65E0\u6743\u9650\u8BBF\u95EE ${cwd}`)
     };
   }
-  try {
-    const context = await readProjectContext(cwd);
-    const analysis = forceComplexity ? createForcedAnalysis(forceComplexity) : analyzeComplexity(requirement, context);
-    const workflow = workflowEngine || new WorkflowEngine();
-    if (!workflowEngine) {
-      await workflow.initialize(cwd);
-    }
-    const state = await workflow.start(requirement, analysis.score, {
-      title: extractTitle(requirement)
+  lines.push(chalk9__default.default.cyan("\u{1F50D} \u5206\u6790\u9879\u76EE..."));
+  const context = await readProjectContext(cwd);
+  lines.push(chalk9__default.default.gray(`  \u9879\u76EE: ${context.name}`));
+  lines.push(chalk9__default.default.gray(`  \u7C7B\u578B: ${context.type}`));
+  lines.push(chalk9__default.default.gray(`  \u6846\u67B6: ${context.framework || "\u672A\u8BC6\u522B"}`));
+  lines.push("");
+  lines.push(chalk9__default.default.cyan("\u{1F4CA} \u5206\u6790\u9700\u6C42\u590D\u6742\u5EA6..."));
+  const analysis = forceComplexity ? createForcedAnalysis(forceComplexity) : analyzeComplexity(requirement, context);
+  lines.push(chalk9__default.default.gray(`  \u590D\u6742\u5EA6: ${analysis.score}/10`));
+  lines.push(chalk9__default.default.gray(`  \u6D41\u7A0B\u7C7B\u578B: ${analysis.recommendation === "complex" ? "\u590D\u6742\u6D41\u7A0B" : "\u7B80\u5355\u6D41\u7A0B"}`));
+  for (const factor of analysis.factors) {
+    lines.push(chalk9__default.default.gray(`  - ${factor}`));
+  }
+  lines.push("");
+  lines.push(chalk9__default.default.cyan("\u{1F4CB} \u521D\u59CB\u5316\u5DE5\u4F5C\u6D41..."));
+  const workflow = workflowEngine || new WorkflowEngine();
+  if (!workflowEngine) {
+    await workflow.initialize(cwd);
+  }
+  const state = await workflow.start(requirement, analysis.score, {
+    title: extractTitle(requirement)
+  });
+  lines.push(chalk9__default.default.gray(`  \u53D8\u66F4ID: ${state.id}`));
+  lines.push(chalk9__default.default.gray(`  \u5DE5\u4F5C\u6D41: ${state.type}`));
+  lines.push("");
+  lines.push(chalk9__default.default.cyan("\u{1F4DD} \u751F\u6210\u89C4\u683C\u62C6\u5206..."));
+  const spec = await generateSpec(requirement, context, analysis, state.id);
+  const specPath = await saveSpecFile(cwd, spec);
+  lines.push(chalk9__default.default.green("  \u2713 \u89C4\u683C\u6587\u4EF6\u5DF2\u751F\u6210"));
+  lines.push(chalk9__default.default.gray(`  \u8DEF\u5F84: ${specPath}`));
+  lines.push("");
+  lines.push(chalk9__default.default.cyan.bold("\u{1F4CB} \u89C4\u683C\u6982\u89C8:"));
+  lines.push(chalk9__default.default.white(`
+  ${spec.summary}`));
+  if (spec.items.length > 0) {
+    lines.push("");
+    lines.push(chalk9__default.default.cyan("  \u4EFB\u52A1\u62C6\u5206:"));
+    for (const item of spec.items) {
+      const priorityIcon = item.priority === "high" ? "\u{1F534}" : item.priority === "medium" ? "\u{1F7E1}" : "\u{1F7E2}";
+      lines.push(chalk9__default.default.gray(`    ${priorityIcon} [${item.id}] ${item.title}`));
+    }
+  }
+  if (spec.risks.length > 0) {
+    lines.push("");
+    lines.push(chalk9__default.default.yellow("  \u26A0\uFE0F \u98CE\u9669\u63D0\u793A:"));
+    for (const risk of spec.risks) {
+      lines.push(chalk9__default.default.gray(`    - ${risk}`));
+    }
+  }
+  lines.push("");
+  lines.push(chalk9__default.default.yellow.bold("\u23F3 \u7B49\u5F85\u89C4\u683C\u786E\u8BA4"));
+  lines.push(chalk9__default.default.gray("\n\u8BF7\u68C0\u67E5\u751F\u6210\u7684\u89C4\u683C\u6587\u4EF6\uFF0C\u786E\u8BA4\u540E\u7EE7\u7EED:"));
+  lines.push(chalk9__default.default.white("\n  /opsx:confirm spec-review    - \u786E\u8BA4\u89C4\u683C\uFF0C\u8FDB\u5165\u4E0B\u4E00\u9636\u6BB5"));
+  lines.push(chalk9__default.default.white("  /opsx:rollback explore       - \u89C4\u683C\u4E0D\u7B26\uFF0C\u91CD\u65B0\u62C6\u5206"));
+  lines.push(chalk9__default.default.white("  /opsx:status                 - \u67E5\u770B\u5DE5\u4F5C\u6D41\u72B6\u6001"));
+  return { output: lines.join("\n") };
+}
+async function generateSpec(requirement, context, analysis, changeId) {
+  const spec = {
+    changeId,
+    requirement,
+    summary: "",
+    items: [],
+    architectureNotes: [],
+    risks: [],
+    suggestions: []
+  };
+  spec.summary = generateSummary(requirement);
+  if (analysis.recommendation === "complex") {
+    spec.items = generateComplexTasks(requirement, context, analysis);
+    spec.architectureNotes = generateArchitectureNotes(requirement, context);
+  } else {
+    spec.items = generateSimpleTasks(requirement);
+  }
+  spec.risks = generateRisks(requirement, context, analysis);
+  spec.suggestions = generateSuggestions(requirement, context, analysis);
+  return spec;
+}
+function generateSummary(requirement) {
+  const firstSentence = requirement.split(/[。！？\n]/)[0];
+  return firstSentence.length > 100 ? firstSentence.slice(0, 97) + "..." : firstSentence;
+}
+function generateComplexTasks(requirement, context, analysis) {
+  const items = [];
+  let itemId = 1;
+  const featurePatterns = [
+    { pattern: /用户|登录|注册|认证|权限/, title: "\u7528\u6237\u8BA4\u8BC1\u6A21\u5757", priority: "high" },
+    { pattern: /数据|存储|缓存|数据库/, title: "\u6570\u636E\u5C42\u5B9E\u73B0", priority: "high" },
+    { pattern: /接口|API|请求|响应/, title: "API \u63A5\u53E3\u5F00\u53D1", priority: "high" },
+    { pattern: /界面|页面|组件|UI/, title: "\u754C\u9762\u5F00\u53D1", priority: "medium" },
+    { pattern: /测试|单测|覆盖/, title: "\u6D4B\u8BD5\u7528\u4F8B\u7F16\u5199", priority: "medium" },
+    { pattern: /文档|说明/, title: "\u6587\u6863\u7F16\u5199", priority: "low" },
+    { pattern: /配置|设置/, title: "\u914D\u7F6E\u7BA1\u7406", priority: "low" },
+    { pattern: /优化|性能/, title: "\u6027\u80FD\u4F18\u5316", priority: "medium" },
+    { pattern: /安全|加密/, title: "\u5B89\u5168\u5B9E\u73B0", priority: "high" },
+    { pattern: /日志|监控/, title: "\u65E5\u5FD7\u76D1\u63A7", priority: "low" }
+  ];
+  for (const { pattern, title, priority } of featurePatterns) {
+    if (pattern.test(requirement)) {
+      items.push({
+        id: `T${itemId.toString().padStart(3, "0")}`,
+        title,
+        description: `${title}\u76F8\u5173\u7684\u529F\u80FD\u5B9E\u73B0`,
+        priority,
+        dependencies: itemId > 1 ? [`T${(itemId - 1).toString().padStart(3, "0")}`] : [],
+        estimatedComplexity: priority === "high" ? 3 : priority === "medium" ? 2 : 1
+      });
+      itemId++;
+    }
+  }
+  if (items.length === 0) {
+    items.push({
+      id: "T001",
+      title: "\u9700\u6C42\u5206\u6790\u4E0E\u8BBE\u8BA1",
+      description: "\u5206\u6790\u9700\u6C42\u7EC6\u8282\uFF0C\u8BBE\u8BA1\u5B9E\u73B0\u65B9\u6848",
+      priority: "high",
+      dependencies: [],
+      estimatedComplexity: 2
     });
-    const lines = [
-      chalk9__default.default.green("\u2713 \u9700\u6C42\u5206\u6790\u5B8C\u6210\n"),
-      chalk9__default.default.cyan("\u9879\u76EE\u4FE1\u606F:"),
-      chalk9__default.default.gray(`  \u540D\u79F0: ${context.name}`),
-      chalk9__default.default.gray(`  \u7C7B\u578B: ${context.type}`),
-      chalk9__default.default.gray(`  \u6846\u67B6: ${context.framework || "\u672A\u8BC6\u522B"}`),
-      "",
-      chalk9__default.default.cyan("\u9700\u6C42\u5206\u6790:"),
-      chalk9__default.default.gray(`  \u590D\u6742\u5EA6: ${analysis.score}/10`),
-      chalk9__default.default.gray(`  \u5DE5\u4F5C\u6D41: ${state.type === "complex" ? "\u590D\u6742\u6D41\u7A0B" : "\u7B80\u5355\u6D41\u7A0B"}`),
-      chalk9__default.default.gray(`  \u53D8\u66F4ID: ${state.id}`),
-      "",
-      chalk9__default.default.cyan("\u590D\u6742\u5EA6\u56E0\u7D20:"),
-      ...analysis.factors.map((f) => chalk9__default.default.gray(`  - ${f}`)),
-      "",
-      chalk9__default.default.yellow("\u4E0B\u4E00\u6B65:"),
-      state.type === "complex" ? chalk9__default.default.gray("  \u6267\u884C /opsx:explore \u5F00\u59CB\u63A2\u7D22\u9636\u6BB5") : chalk9__default.default.gray("  \u6267\u884C /opsx:propose \u63D0\u4EA4\u53D8\u66F4\u63D0\u6848")
-    ];
-    return { output: lines.join("\n") };
-  } catch (error) {
-    const err = error;
-    if (err.code === "EACCES") {
-      return {
-        output: chalk9__default.default.red(`\u9519\u8BEF: \u65E0\u6743\u9650\u8BBF\u95EE\u76EE\u5F55 ${cwd}`)
-      };
+    items.push({
+      id: "T002",
+      title: "\u6838\u5FC3\u529F\u80FD\u5B9E\u73B0",
+      description: requirement,
+      priority: "high",
+      dependencies: ["T001"],
+      estimatedComplexity: analysis.score
+    });
+    items.push({
+      id: "T003",
+      title: "\u6D4B\u8BD5\u4E0E\u9A8C\u8BC1",
+      description: "\u7F16\u5199\u6D4B\u8BD5\u7528\u4F8B\uFF0C\u9A8C\u8BC1\u529F\u80FD\u6B63\u786E\u6027",
+      priority: "medium",
+      dependencies: ["T002"],
+      estimatedComplexity: 2
+    });
+  }
+  return items;
+}
+function generateSimpleTasks(requirement, context) {
+  return [
+    {
+      id: "T001",
+      title: "\u5B9E\u73B0\u53D8\u66F4",
+      description: requirement,
+      priority: "high",
+      dependencies: [],
+      estimatedComplexity: 3
+    },
+    {
+      id: "T002",
+      title: "\u6D4B\u8BD5\u9A8C\u8BC1",
+      description: "\u9A8C\u8BC1\u53D8\u66F4\u6B63\u786E\u6027",
+      priority: "medium",
+      dependencies: ["T001"],
+      estimatedComplexity: 1
     }
-    return {
-      output: chalk9__default.default.red(`\u542F\u52A8\u9700\u6C42\u5931\u8D25: ${error.message}`)
-    };
+  ];
+}
+function generateArchitectureNotes(requirement, context) {
+  const notes = [];
+  if (context.framework) {
+    notes.push(`\u9879\u76EE\u4F7F\u7528 ${context.framework} \u6846\u67B6\uFF0C\u9700\u9075\u5FAA\u5176\u6700\u4F73\u5B9E\u8DF5`);
+  }
+  if (requirement.includes("\u6A21\u5757") || requirement.includes("\u7EC4\u4EF6")) {
+    notes.push("\u5EFA\u8BAE\u91C7\u7528\u6A21\u5757\u5316\u8BBE\u8BA1\uFF0C\u4FDD\u6301\u7EC4\u4EF6\u804C\u8D23\u5355\u4E00");
+  }
+  if (requirement.includes("API") || requirement.includes("\u63A5\u53E3")) {
+    notes.push("API \u8BBE\u8BA1\u9700\u8003\u8651\u7248\u672C\u63A7\u5236\u548C\u5411\u540E\u517C\u5BB9");
   }
+  if (context.structure.srcStructure) {
+    notes.push(`\u73B0\u6709\u6E90\u7801\u7ED3\u6784: ${context.structure.srcStructure}`);
+  }
+  return notes;
+}
+function generateRisks(requirement, context, analysis) {
+  const risks = [];
+  if (!context.framework) {
+    risks.push("\u9879\u76EE\u6846\u67B6\u672A\u8BC6\u522B\uFF0C\u53EF\u80FD\u5F71\u54CD\u4EE3\u7801\u98CE\u683C\u4E00\u81F4\u6027");
+  }
+  if (analysis.score >= 7) {
+    risks.push("\u9700\u6C42\u590D\u6742\u5EA6\u8F83\u9AD8\uFF0C\u5EFA\u8BAE\u5206\u9636\u6BB5\u5B9E\u73B0");
+  }
+  if (requirement.includes("\u8FC1\u79FB") || requirement.includes("\u91CD\u6784")) {
+    risks.push("\u6D89\u53CA\u73B0\u6709\u4EE3\u7801\u4FEE\u6539\uFF0C\u9700\u6CE8\u610F\u56DE\u5F52\u6D4B\u8BD5");
+  }
+  if (requirement.includes("\u6743\u9650") || requirement.includes("\u5B89\u5168")) {
+    risks.push("\u6D89\u53CA\u5B89\u5168\u654F\u611F\u529F\u80FD\uFF0C\u9700\u8981\u989D\u5916\u5BA1\u67E5");
+  }
+  return risks;
+}
+function generateSuggestions(requirement, context, analysis) {
+  const suggestions = [];
+  if (context.norms.devStandards) {
+    suggestions.push("\u9879\u76EE\u5DF2\u6709\u5F00\u53D1\u89C4\u8303\uFF0C\u8BF7\u9075\u5FAA\u73B0\u6709\u89C4\u8303");
+  }
+  if (analysis.recommendation === "complex") {
+    suggestions.push("\u590D\u6742\u9700\u6C42\u5EFA\u8BAE\u5148\u8FDB\u884C\u6280\u672F\u8BC4\u5BA1");
+    suggestions.push("\u5EFA\u8BAE\u8C03\u7528 $architect \u83B7\u53D6\u67B6\u6784\u5EFA\u8BAE");
+  }
+  if (context.techStack.length > 0) {
+    suggestions.push(`\u6280\u672F\u6808: ${context.techStack.join(", ")}`);
+  }
+  return suggestions;
+}
+async function saveSpecFile(cwd, spec) {
+  const changesDir = path6__namespace.join(cwd, "openspec", "changes");
+  await fs6__namespace.mkdir(changesDir, { recursive: true });
+  const specPath = path6__namespace.join(changesDir, `${spec.changeId}-spec.md`);
+  const content = formatSpecFile(spec);
+  await fs6__namespace.writeFile(specPath, content, "utf-8");
+  return specPath;
+}
+function formatSpecFile(spec) {
+  const lines = [];
+  lines.push(`# Spec: ${spec.summary}`);
+  lines.push("");
+  lines.push(`> \u53D8\u66F4ID: ${spec.changeId}`);
+  lines.push(`> \u751F\u6210\u65F6\u95F4: ${(/* @__PURE__ */ new Date()).toISOString()}`);
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push("## \u9700\u6C42\u6982\u8FF0");
+  lines.push("");
+  lines.push(spec.requirement);
+  lines.push("");
+  lines.push("## \u4EFB\u52A1\u62C6\u5206");
+  lines.push("");
+  for (const item of spec.items) {
+    const priorityLabel = item.priority === "high" ? "\u{1F534} \u9AD8" : item.priority === "medium" ? "\u{1F7E1} \u4E2D" : "\u{1F7E2} \u4F4E";
+    lines.push(`### ${item.id}: ${item.title}`);
+    lines.push("");
+    lines.push(`- **\u4F18\u5148\u7EA7**: ${priorityLabel}`);
+    lines.push(`- **\u63CF\u8FF0**: ${item.description}`);
+    lines.push(`- **\u9884\u4F30\u590D\u6742\u5EA6**: ${item.estimatedComplexity}/5`);
+    if (item.dependencies.length > 0) {
+      lines.push(`- **\u4F9D\u8D56**: ${item.dependencies.join(", ")}`);
+    }
+    lines.push("");
+  }
+  if (spec.architectureNotes.length > 0) {
+    lines.push("## \u67B6\u6784\u8BF4\u660E");
+    lines.push("");
+    for (const note of spec.architectureNotes) {
+      lines.push(`- ${note}`);
+    }
+    lines.push("");
+  }
+  if (spec.risks.length > 0) {
+    lines.push("## \u26A0\uFE0F \u98CE\u9669\u8BC4\u4F30");
+    lines.push("");
+    for (const risk of spec.risks) {
+      lines.push(`- ${risk}`);
+    }
+    lines.push("");
+  }
+  if (spec.suggestions.length > 0) {
+    lines.push("## \u{1F4A1} \u5EFA\u8BAE");
+    lines.push("");
+    for (const suggestion of spec.suggestions) {
+      lines.push(`- ${suggestion}`);
+    }
+    lines.push("");
+  }
+  lines.push("---");
+  lines.push("");
+  lines.push("## \u786E\u8BA4\u72B6\u6001");
+  lines.push("");
+  lines.push("- [ ] \u89C4\u683C\u5DF2\u5BA1\u9605");
+  lines.push("- [ ] \u4EFB\u52A1\u62C6\u5206\u5DF2\u786E\u8BA4");
+  lines.push("");
+  lines.push("**\u786E\u8BA4\u540E\u6267\u884C**: `/opsx:confirm spec-review`");
+  return lines.join("\n");
 }
 function parseArgs(args) {
   let forceComplexity;
@@ -4115,42 +4533,52 @@ async function readProjectContext(cwd) {
     type: "unknown",
     framework: null,
     techStack: [],
-    description: ""
+    description: "",
+    structure: {
+      directories: [],
+      keyFiles: [],
+      srcStructure: ""
+    },
+    norms: {
+      devStandards: "",
+      patterns: "",
+      weights: ""
+    }
+  };
+  const [agentsContext, configContext, normsContext, structureContext] = await Promise.all([
+    readAgentsMd(cwd),
+    readConfigYaml(cwd),
+    readNorms(cwd),
+    analyzeStructure(cwd)
+  ]);
+  return {
+    ...defaultContext,
+    ...agentsContext,
+    ...configContext,
+    norms: normsContext,
+    structure: structureContext
   };
+}
+async function readAgentsMd(cwd) {
   const agentsPath = path6__namespace.join(cwd, "AGENTS.md");
   try {
     const stats = await fs6__namespace.stat(agentsPath);
     if (stats.size > MAX_FILE_SIZE2) {
       console.warn(`\u8B66\u544A: AGENTS.md \u6587\u4EF6\u8FC7\u5927 (${stats.size} bytes)\uFF0C\u8DF3\u8FC7\u8BFB\u53D6`);
-      return defaultContext;
+      return {};
     }
     const content = await fs6__namespace.readFile(agentsPath, "utf-8");
-    return parseAgentsMd(content, defaultContext);
+    return parseAgentsMd(content);
   } catch (e) {
     const err = e;
     if (err.code !== "ENOENT") {
       console.warn(`\u8B66\u544A: \u65E0\u6CD5\u8BFB\u53D6 AGENTS.md - ${err.message}`);
     }
+    return {};
   }
-  const configPath = path6__namespace.join(cwd, "openspec", "config.yaml");
-  try {
-    const stats = await fs6__namespace.stat(configPath);
-    if (stats.size > MAX_FILE_SIZE2) {
-      console.warn(`\u8B66\u544A: config.yaml \u6587\u4EF6\u8FC7\u5927\uFF0C\u8DF3\u8FC7\u8BFB\u53D6`);
-      return defaultContext;
-    }
-    const content = await fs6__namespace.readFile(configPath, "utf-8");
-    return parseConfigYaml(content, defaultContext);
-  } catch (e) {
-    const err = e;
-    if (err.code !== "ENOENT") {
-      console.warn(`\u8B66\u544A: \u65E0\u6CD5\u8BFB\u53D6 config.yaml - ${err.message}`);
-    }
-  }
-  return defaultContext;
 }
-function parseAgentsMd(content, defaults) {
-  const context = { ...defaults };
+function parseAgentsMd(content) {
+  const context = {};
   const nameMatch = content.match(/\|\s*项目名称\s*\|\s*([^\s|]+)/);
   if (nameMatch) {
     context.name = nameMatch[1];
@@ -4167,10 +4595,32 @@ function parseAgentsMd(content, defaults) {
   if (descMatch) {
     context.description = descMatch[1].trim();
   }
+  const techStackMatch = content.match(/技术栈[：:]\s*([^\n]+)/);
+  if (techStackMatch) {
+    context.techStack = techStackMatch[1].split(/[,，、]/).map((s) => s.trim()).filter(Boolean);
+  }
   return context;
 }
-function parseConfigYaml(content, defaults) {
-  const context = { ...defaults };
+async function readConfigYaml(cwd) {
+  const configPath = path6__namespace.join(cwd, "openspec", "config.yaml");
+  try {
+    const stats = await fs6__namespace.stat(configPath);
+    if (stats.size > MAX_FILE_SIZE2) {
+      console.warn("\u8B66\u544A: config.yaml \u6587\u4EF6\u8FC7\u5927\uFF0C\u8DF3\u8FC7\u8BFB\u53D6");
+      return {};
+    }
+    const content = await fs6__namespace.readFile(configPath, "utf-8");
+    return parseConfigYaml(content);
+  } catch (e) {
+    const err = e;
+    if (err.code !== "ENOENT") {
+      console.warn(`\u8B66\u544A: \u65E0\u6CD5\u8BFB\u53D6 config.yaml - ${err.message}`);
+    }
+    return {};
+  }
+}
+function parseConfigYaml(content) {
+  const context = {};
   const nameMatch = content.match(/name:\s*(.+)/);
   if (nameMatch) {
     context.name = nameMatch[1].trim();
@@ -4185,6 +4635,67 @@ function parseConfigYaml(content, defaults) {
   }
   return context;
 }
+async function readNorms(cwd) {
+  const normsDir = path6__namespace.join(cwd, ".sf-cli", "norms");
+  const norms = {
+    devStandards: "",
+    patterns: "",
+    weights: ""
+  };
+  try {
+    const devStandardsPath = path6__namespace.join(normsDir, "devstanded.md");
+    norms.devStandards = await fs6__namespace.readFile(devStandardsPath, "utf-8").catch(() => "");
+  } catch {
+  }
+  try {
+    const patternsPath = path6__namespace.join(normsDir, "patterns.json");
+    norms.patterns = await fs6__namespace.readFile(patternsPath, "utf-8").catch(() => "");
+  } catch {
+  }
+  try {
+    const weightsPath = path6__namespace.join(normsDir, "weights.json");
+    norms.weights = await fs6__namespace.readFile(weightsPath, "utf-8").catch(() => "");
+  } catch {
+  }
+  return norms;
+}
+async function analyzeStructure(cwd) {
+  const structure = {
+    directories: [],
+    keyFiles: [],
+    srcStructure: ""
+  };
+  try {
+    const entries = await fs6__namespace.readdir(cwd, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory() && !["node_modules", "dist", ".git", "build"].includes(entry.name)) {
+        structure.directories.push(entry.name);
+      }
+    }
+    const keyFiles = [
+      "package.json",
+      "tsconfig.json",
+      "AGENTS.md",
+      "README.md"
+    ];
+    for (const file of keyFiles) {
+      const filePath = path6__namespace.join(cwd, file);
+      try {
+        await fs6__namespace.access(filePath);
+        structure.keyFiles.push(file);
+      } catch {
+      }
+    }
+    const srcDir = path6__namespace.join(cwd, "src");
+    try {
+      const srcEntries = await fs6__namespace.readdir(srcDir, { withFileTypes: true });
+      structure.srcStructure = srcEntries.filter((e) => e.isDirectory()).map((e) => e.name).join("/");
+    } catch {
+    }
+  } catch (e) {
+  }
+  return { structure };
+}
 function analyzeComplexity(requirement, context) {
   let score = 3;
   const factors = [];
@@ -4990,16 +5501,20 @@ async function handleOpsx(command, args, ctx) {
     case "rollback":
       return handleRollback(workflow, args);
     case "confirm":
-      return handleConfirm(workflow, args);
+      return handleConfirm(workflow, args, ctx);
     case "next":
       return handleNext(workflow);
     case "auto":
       return handleAutoSchedule(args);
     case "test":
       return handleRegressionTest(ctx);
+    case "list":
+      return handleList(workflow);
+    case "switch":
+      return handleSwitch(workflow, args);
     default:
       return {
-        output: chalk9__default.default.red(`\u672A\u77E5\u7684OpenSpec\u547D\u4EE4: /${command}`)
+        output: chalk9__default.default.red(`\u672A\u77E5\u7684OpenSpec\u547D\u4EE4: /${command}`) + chalk9__default.default.gray("\n\u53EF\u7528\u547D\u4EE4: /opsx:list, /opsx:status, /opsx:confirm, /opsx:next, /opsx:archive")
       };
   }
 }
@@ -5358,6 +5873,16 @@ async function handleConfirm(workflow, args, ctx) {
   const type = args[0];
   if (!type) {
     const pendingPoint = workflow.getCurrentConfirmationPoint();
+    const specPath = await checkPendingSpec(ctx.options.workingDirectory, state.id);
+    if (specPath) {
+      return {
+        output: chalk9__default.default.cyan("\u{1F4CB} \u89C4\u683C\u6587\u4EF6\u5F85\u786E\u8BA4") + chalk9__default.default.gray(`
+
+\u89C4\u683C\u6587\u4EF6: ${specPath}`) + chalk9__default.default.gray(`
+
+\u8BF7\u68C0\u67E5\u89C4\u683C\u6587\u4EF6\u540E\u786E\u8BA4:`) + chalk9__default.default.white("\n  /opsx:confirm spec-review    - \u786E\u8BA4\u89C4\u683C") + chalk9__default.default.white("\n  /opsx:rollback explore       - \u91CD\u65B0\u62C6\u5206")
+      };
+    }
     if (pendingPoint) {
       return {
         output: chalk9__default.default.cyan("\u5F85\u786E\u8BA4\u7684\u68C0\u67E5\u70B9:") + chalk9__default.default.white(`
@@ -5379,12 +5904,54 @@ ${generateConfirmationPrompt(pendingPoint)}`) + chalk9__default.default.gray(`
   }
   const comment = args.slice(1).join(" ");
   workflow.confirm(type, comment);
-  return {
-    output: chalk9__default.default.green("\u2713 \u5DF2\u786E\u8BA4") + chalk9__default.default.white(`
+  const lines = [];
+  lines.push(chalk9__default.default.green("\u2713 \u5DF2\u786E\u8BA4"));
+  lines.push(chalk9__default.default.white(`
+${point.name}`));
+  if (comment) {
+    lines.push(chalk9__default.default.gray(`
+\u5907\u6CE8: ${comment}`));
+  }
+  if (type === "spec-review") {
+    const allowed = workflow.getAllowedTransitions();
+    if (allowed.length > 0) {
+      const nextStep = allowed[0];
+      try {
+        const transition = await workflow.transition(nextStep);
+        lines.push("");
+        lines.push(chalk9__default.default.cyan(`\u2713 \u5DF2\u81EA\u52A8\u8FDB\u5165 ${nextStep} \u9636\u6BB5`));
+        lines.push(chalk9__default.default.gray(`\u8F6C\u6362: ${transition.from} \u2192 ${transition.to}`));
+        if (nextStep === "new") {
+          lines.push(chalk9__default.default.yellow("\n\u4E0B\u4E00\u6B65: \u8BBE\u8BA1\u65B9\u6848"));
+          lines.push(chalk9__default.default.gray("  \u53EF\u8C03\u7528 $architect \u6216 $frontend-dev \u8FDB\u884C\u8BBE\u8BA1"));
+        } else if (nextStep === "apply") {
+          lines.push(chalk9__default.default.yellow("\n\u4E0B\u4E00\u6B65: \u6267\u884C\u53D8\u66F4"));
+          lines.push(chalk9__default.default.gray("  \u53EF\u8C03\u7528 $frontend-dev \u6267\u884C\u4EE3\u7801\u4FEE\u6539"));
+        }
+        return { output: lines.join("\n") };
+      } catch (e) {
+        if (e instanceof ConfirmationRequiredError) {
+          lines.push(chalk9__default.default.yellow("\n\u26A0 \u8FD8\u9700\u8981\u786E\u8BA4:") + chalk9__default.default.white(`
+${generateConfirmationPrompt(e.point)}`) + chalk9__default.default.cyan(`
 
-${point.name}`) + (comment ? chalk9__default.default.gray(`
-\u5907\u6CE8: ${comment}`) : "") + chalk9__default.default.yellow("\n\n\u4F7F\u7528 /opsx:next \u7EE7\u7EED\u4E0B\u4E00\u9636\u6BB5")
-  };
+\u4F7F\u7528 /opsx:confirm ${e.point.type}`));
+          return { output: lines.join("\n") };
+        }
+        throw e;
+      }
+    }
+  }
+  lines.push(chalk9__default.default.yellow("\n\u4F7F\u7528 /opsx:next \u7EE7\u7EED\u4E0B\u4E00\u9636\u6BB5"));
+  return { output: lines.join("\n") };
+}
+async function checkPendingSpec(workingDirectory, changeId) {
+  const specPath = path6__namespace.join(workingDirectory, "openspec", "changes", `${changeId}-spec.md`);
+  try {
+    await fs9__namespace.promises.access(specPath);
+    return specPath;
+  } catch {
+    return null;
+  }
 }
 async function handleNext(workflow, args, ctx) {
   const state = workflow.getState();
@@ -5420,6 +5987,76 @@ ${generateConfirmationPrompt(e.point)}`) + chalk9__default.default.cyan(`
     throw e;
   }
 }
+async function handleList(workflow, ctx) {
+  const lines = [];
+  const activeWorkflows = await workflow.getAllActiveWorkflows();
+  const currentState = workflow.getState();
+  if (activeWorkflows.length === 0) {
+    return {
+      output: chalk9__default.default.gray("\u5F53\u524D\u6CA1\u6709\u6D3B\u8DC3\u7684\u5DE5\u4F5C\u6D41") + chalk9__default.default.yellow("\n\n\u4F7F\u7528 /new <\u9700\u6C42\u63CF\u8FF0> \u542F\u52A8\u65B0\u5DE5\u4F5C\u6D41")
+    };
+  }
+  lines.push(chalk9__default.default.cyan.bold(`\u{1F4CB} \u6D3B\u8DC3\u5DE5\u4F5C\u6D41 (${activeWorkflows.length})`));
+  lines.push("");
+  for (const wf of activeWorkflows) {
+    const isCurrent = currentState?.id === wf.id;
+    const prefix = isCurrent ? chalk9__default.default.green("\u25B6 ") : "  ";
+    const title = isCurrent ? chalk9__default.default.white(wf.title) : chalk9__default.default.gray(wf.title);
+    const stepIcon = wf.currentStep === "propose" || wf.currentStep === "explore" ? "\u23F3" : wf.currentStep === "apply" ? "\u{1F527}" : wf.currentStep === "archive" ? "\u{1F4E6}" : "\u{1F4DD}";
+    lines.push(`${prefix}${title}`);
+    lines.push(chalk9__default.default.gray(`    ID: ${wf.id}`));
+    lines.push(chalk9__default.default.gray(`    \u9636\u6BB5: ${stepIcon} ${wf.currentStep} | \u590D\u6742\u5EA6: ${wf.complexity}/10`));
+    if (isCurrent) {
+      lines.push(chalk9__default.default.green("    (\u5F53\u524D)"));
+    }
+    lines.push("");
+  }
+  if (activeWorkflows.length > 1) {
+    lines.push(chalk9__default.default.yellow("\u5207\u6362\u5DE5\u4F5C\u6D41:"));
+    lines.push(chalk9__default.default.gray("  /opsx:switch <\u53D8\u66F4ID>"));
+  }
+  lines.push(chalk9__default.default.yellow("\n\u64CD\u4F5C\u547D\u4EE4:"));
+  lines.push(chalk9__default.default.gray("  /opsx:status   - \u67E5\u770B\u5F53\u524D\u5DE5\u4F5C\u6D41\u8BE6\u60C5"));
+  lines.push(chalk9__default.default.gray("  /opsx:confirm  - \u786E\u8BA4\u89C4\u683C"));
+  lines.push(chalk9__default.default.gray("  /opsx:next     - \u8FDB\u5165\u4E0B\u4E00\u9636\u6BB5"));
+  lines.push(chalk9__default.default.gray("  /opsx:cancel   - \u53D6\u6D88\u5F53\u524D\u5DE5\u4F5C\u6D41"));
+  return { output: lines.join("\n") };
+}
+async function handleSwitch(workflow, args, ctx) {
+  const targetId = args[0];
+  if (!targetId) {
+    const activeWorkflows = await workflow.getAllActiveWorkflows();
+    if (activeWorkflows.length === 0) {
+      return {
+        output: chalk9__default.default.gray("\u6CA1\u6709\u53EF\u5207\u6362\u7684\u5DE5\u4F5C\u6D41")
+      };
+    }
+    const lines = [
+      chalk9__default.default.cyan("\u53EF\u7528\u5DE5\u4F5C\u6D41:"),
+      ""
+    ];
+    for (const wf of activeWorkflows) {
+      lines.push(chalk9__default.default.white(`  ${wf.id}`) + chalk9__default.default.gray(` - ${wf.title.slice(0, 30)}...`));
+    }
+    lines.push("");
+    lines.push(chalk9__default.default.gray("\u7528\u6CD5: /opsx:switch <\u53D8\u66F4ID>"));
+    return { output: lines.join("\n") };
+  }
+  const success = await workflow.switchTo(targetId);
+  if (success) {
+    const state = workflow.getState();
+    return {
+      output: chalk9__default.default.green(`\u2713 \u5DF2\u5207\u6362\u5230\u5DE5\u4F5C\u6D41: ${targetId}`) + chalk9__default.default.gray(`
+
+\u9700\u6C42: ${state?.title}`) + chalk9__default.default.cyan(`
+\u5F53\u524D\u9636\u6BB5: ${state?.currentStep}`) + chalk9__default.default.yellow("\n\n\u4F7F\u7528 /opsx:status \u67E5\u770B\u8BE6\u60C5")
+    };
+  } else {
+    return {
+      output: chalk9__default.default.red(`\u5207\u6362\u5931\u8D25: \u627E\u4E0D\u5230\u5DE5\u4F5C\u6D41 ${targetId}`) + chalk9__default.default.gray("\n\u4F7F\u7528 /opsx:list \u67E5\u770B\u6240\u6709\u6D3B\u8DC3\u5DE5\u4F5C\u6D41")
+    };
+  }
+}
 
 // src/commands/runner.ts
 function getVersion() {
@@ -5602,7 +6239,11 @@ var ALLOWED_COMMANDS_WITHOUT_WORKFLOW = [
   "update",
   "u",
   "version",
-  "v"
+  "v",
+  // OpenSpec 工作流管理命令（始终允许）
+  "opsx:status",
+  "opsx:cancel",
+  "opsx:rollback"
 ];
 var STAGE_PERMISSIONS = {
   "explore": {
@@ -5675,6 +6316,12 @@ var CommandExecutor = class {
   checkWorkflowPermission(command, ctx) {
     const workflowEngine = ctx.workflowEngine;
     const workflowState = workflowEngine?.getState();
+    if (command.type === "slash" /* SLASH */) {
+      const cmd = command.command?.toLowerCase();
+      if (cmd?.startsWith("opsx:")) {
+        return { allowed: true };
+      }
+    }
     if (!workflowState) {
       if (command.type === "slash" /* SLASH */) {
         const cmd = command.command?.toLowerCase();