@nick848/sf-cli 1.0.10 → 1.0.12

package/dist/cli/index.js

@@ -1794,14 +1794,17 @@ async function handleNew(args, ctx) {
   const requirement = args.join(" ").trim();
   if (!requirement) {
     return {
-      output: chalk9__default.default.red("\u8BF7\u8F93\u5165\u9700\u6C42\u63CF\u8FF0") + chalk9__default.default.gray("\n\u7528\u6CD5: /new <\u9700\u6C42\u63CF\u8FF0>")
+      output: chalk9__default.default.red("\u8BF7\u8F93\u5165\u9700\u6C42\u63CF\u8FF0") + chalk9__default.default.gray("\n\u7528\u6CD5: /new <\u9700\u6C42\u63CF\u8FF0>") + chalk9__default.default.gray("\n\n\u793A\u4F8B:") + chalk9__default.default.gray("\n  /new \u5B9E\u73B0\u7528\u6237\u767B\u5F55\u529F\u80FD") + chalk9__default.default.gray("\n  /new \u6DFB\u52A0\u6570\u636E\u5BFC\u51FA\u4E3AExcel\u7684\u529F\u80FD")
     };
   }
   activeSession = {
     id: generateSessionId(),
     requirement,
+    refinedRequirement: requirement,
     phase: "context",
     context: null,
+    clarityScore: 0,
+    clarificationQuestions: [],
     complexity: 0,
     bddScenarios: [],
     specItems: [],
@@ -1819,10 +1822,13 @@ function handleActiveSession(ctx) {
   const lines = [];
   lines.push(chalk9__default.default.cyan("\u{1F4CB} \u5F53\u524D\u5DE5\u4F5C\u6D41\u72B6\u6001"));
   lines.push("");
-  lines.push(chalk9__default.default.white(`\u9700\u6C42: ${activeSession.requirement}`));
+  lines.push(chalk9__default.default.white(`\u9700\u6C42: ${activeSession.requirement.slice(0, 60)}${activeSession.requirement.length > 60 ? "..." : ""}`));
   lines.push(chalk9__default.default.gray(`\u9636\u6BB5: ${getPhaseLabel(activeSession.phase)}`));
   lines.push("");
-  if (activeSession.phase === "spec") {
+  if (activeSession.phase === "clarify") {
+    lines.push(chalk9__default.default.yellow("\u23F8\uFE0F \u7B49\u5F85\u9700\u6C42\u6F84\u6E05"));
+    lines.push(chalk9__default.default.gray('\u8BF7\u56DE\u7B54\u4E0A\u8FF0\u95EE\u9898\uFF0C\u6216\u8F93\u5165 "done" \u8868\u793A\u56DE\u7B54\u5B8C\u6210'));
+  } else if (activeSession.phase === "spec") {
     lines.push(chalk9__default.default.yellow("\u23F8\uFE0F \u7B49\u5F85\u89C4\u683C\u786E\u8BA4"));
     lines.push("");
     lines.push(chalk9__default.default.green("  y  - \u786E\u8BA4\u89C4\u683C\uFF0C\u7EE7\u7EED\u5DE5\u4F5C\u6D41"));
@@ -1841,7 +1847,7 @@ async function executeWorkflow(ctx) {
   const lines = [];
   try {
     if (activeSession.phase === "context") {
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 1/7: \u9879\u76EE\u4E0A\u4E0B\u6587\u83B7\u53D6 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 1/8: \u9879\u76EE\u4E0A\u4E0B\u6587\u83B7\u53D6 \u2501\u2501\u2501"));
       lines.push("");
       activeSession.context = await readProjectContext(ctx.options.workingDirectory);
       lines.push(chalk9__default.default.gray(`  \u9879\u76EE: ${activeSession.context.name}`));
@@ -1851,13 +1857,46 @@ async function executeWorkflow(ctx) {
       if (activeSession.context.devStandards) {
         lines.push(chalk9__default.default.green("  \u2713 \u5DF2\u8BFB\u53D6\u5F00\u53D1\u89C4\u8303"));
       }
+      activeSession.phase = "clarify";
+    }
+    if (activeSession.phase === "clarify") {
+      lines.push("");
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 2/8: \u9700\u6C42\u6F84\u6E05 \u2501\u2501\u2501"));
+      lines.push("");
+      const clarityResult = analyzeRequirementClarity(
+        activeSession.requirement,
+        activeSession.context
+      );
+      activeSession.clarityScore = clarityResult.score;
+      activeSession.clarificationQuestions = clarityResult.questions;
+      lines.push(chalk9__default.default.gray(`  \u9700\u6C42\u6E05\u6670\u5EA6: ${Math.round(clarityResult.score * 100)}%`));
+      lines.push("");
+      if (clarityResult.score < CLARITY_THRESHOLD && clarityResult.questions.length > 0) {
+        lines.push(chalk9__default.default.yellow("  \u9700\u6C42\u4E0D\u591F\u660E\u786E\uFF0C\u8BF7\u8865\u5145\u4EE5\u4E0B\u4FE1\u606F\uFF1A"));
+        lines.push("");
+        const unansweredQuestions = clarityResult.questions.filter((q) => !q.answered);
+        for (let i = 0; i < Math.min(unansweredQuestions.length, 3); i++) {
+          const q = unansweredQuestions[i];
+          lines.push(chalk9__default.default.white(`  ${i + 1}. ${q.question}`));
+        }
+        if (unansweredQuestions.length > 3) {
+          lines.push(chalk9__default.default.gray(`  ... \u8FD8\u6709 ${unansweredQuestions.length - 3} \u4E2A\u95EE\u9898`));
+        }
+        lines.push("");
+        lines.push(chalk9__default.default.gray('  \u8BF7\u8F93\u5165\u56DE\u7B54\uFF0C\u6216\u8F93\u5165 "done" \u8DF3\u8FC7\u6F84\u6E05'));
+        return { output: lines.join("\n") };
+      }
+      lines.push(chalk9__default.default.green("  \u2713 \u9700\u6C42\u6E05\u6670\uFF0C\u7EE7\u7EED\u4E0B\u4E00\u6B65"));
       activeSession.phase = "analysis";
     }
     if (activeSession.phase === "analysis") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 2/7: \u590D\u6742\u5EA6\u8BC4\u4F30 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 3/8: \u590D\u6742\u5EA6\u8BC4\u4F30 \u2501\u2501\u2501"));
       lines.push("");
-      activeSession.complexity = analyzeComplexity(activeSession.requirement, activeSession.context);
+      activeSession.complexity = analyzeComplexity(
+        activeSession.refinedRequirement,
+        activeSession.context
+      );
       const complexityBar = generateComplexityBar(activeSession.complexity);
       lines.push(chalk9__default.default.gray(`  \u590D\u6742\u5EA6: ${complexityBar} ${activeSession.complexity}/10`));
       if (activeSession.complexity >= COMPLEXITY_THRESHOLD) {
@@ -1869,9 +1908,13 @@ async function executeWorkflow(ctx) {
     }
     if (activeSession.phase === "bdd") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 3/7: BDD \u573A\u666F\u62C6\u89E3 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 4/8: BDD \u573A\u666F\u62C6\u89E3 \u2501\u2501\u2501"));
       lines.push("");
-      activeSession.bddScenarios = generateBDDScenarios(activeSession.requirement, activeSession.context);
+      activeSession.bddScenarios = generateBDDScenarios(
+        activeSession.refinedRequirement,
+        activeSession.context,
+        activeSession.clarificationQuestions
+      );
       for (const scenario of activeSession.bddScenarios) {
         lines.push(chalk9__default.default.white(`  Feature: ${scenario.feature}`));
         for (const s of scenario.scenarios.slice(0, 3)) {
@@ -1885,9 +1928,14 @@ async function executeWorkflow(ctx) {
     }
     if (activeSession.phase === "spec") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 4/7: OpenSpec \u89C4\u683C \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 5/8: OpenSpec \u89C4\u683C \u2501\u2501\u2501"));
       lines.push("");
-      activeSession.specItems = generateSpecItems(activeSession.requirement, activeSession.context, activeSession.bddScenarios);
+      activeSession.specItems = generateSpecItems(
+        activeSession.refinedRequirement,
+        activeSession.context,
+        activeSession.bddScenarios,
+        activeSession.clarificationQuestions
+      );
       const specPath = await saveSpecFile(ctx.options.workingDirectory, activeSession);
       lines.push(chalk9__default.default.green("  \u2713 \u89C4\u683C\u6587\u4EF6\u5DF2\u751F\u6210"));
       lines.push(chalk9__default.default.gray(`  \u8DEF\u5F84: ${specPath}`));
@@ -1910,7 +1958,7 @@ async function executeWorkflow(ctx) {
     }
     if (activeSession.phase === "tdd") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 5/7: TDD \u6D4B\u8BD5\u751F\u6210 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 6/8: TDD \u6D4B\u8BD5\u751F\u6210 \u2501\u2501\u2501"));
       lines.push("");
       activeSession.testFiles = await generateTests(ctx.options.workingDirectory, activeSession);
       lines.push(chalk9__default.default.green("  \u2713 \u6D4B\u8BD5\u6587\u4EF6\u5DF2\u751F\u6210"));
@@ -1921,20 +1969,69 @@ async function executeWorkflow(ctx) {
     }
     if (activeSession.phase === "develop") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 6/7: \u5F00\u53D1\u5B9E\u73B0 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 7/8: \u5F00\u53D1\u5B9E\u73B0 \u2501\u2501\u2501"));
       lines.push("");
-      lines.push(chalk9__default.default.yellow("  \u{1F4DD} \u5F00\u53D1\u9636\u6BB5"));
-      lines.push(chalk9__default.default.gray("  \u8BF7\u8C03\u7528 $frontend-dev \u6267\u884C\u5F00\u53D1\u4EFB\u52A1"));
-      lines.push(chalk9__default.default.gray("  \u6216\u624B\u52A8\u5B9E\u73B0\u4EE3\u7801\u540E\u8F93\u5165 continue \u7EE7\u7EED"));
-      return { output: lines.join("\n") };
+      lines.push(chalk9__default.default.yellow("  \u{1F680} \u6B63\u5728\u8C03\u7528 AI \u751F\u6210\u4EE3\u7801..."));
+      try {
+        const developResult = await executeDevelopment(ctx, activeSession);
+        if (developResult.success) {
+          lines.push(chalk9__default.default.green("  \u2713 \u4EE3\u7801\u751F\u6210\u5B8C\u6210"));
+          for (const file of developResult.files) {
+            lines.push(chalk9__default.default.gray(`    - ${file}`));
+          }
+          activeSession.implFiles = developResult.files;
+          activeSession.phase = "review";
+        } else {
+          lines.push(chalk9__default.default.red(`  \u2717 \u4EE3\u7801\u751F\u6210\u5931\u8D25: ${developResult.error}`));
+          lines.push(chalk9__default.default.gray("  \u8BF7\u624B\u52A8\u5B9E\u73B0\u4EE3\u7801\u540E\u8F93\u5165 continue \u7EE7\u7EED"));
+          return { output: lines.join("\n") };
+        }
+      } catch (error) {
+        lines.push(chalk9__default.default.red(`  \u2717 \u5F00\u53D1\u9636\u6BB5\u51FA\u9519: ${error.message}`));
+        lines.push(chalk9__default.default.gray("  \u8BF7\u624B\u52A8\u5B9E\u73B0\u4EE3\u7801\u540E\u8F93\u5165 continue \u7EE7\u7EED"));
+        return { output: lines.join("\n") };
+      }
     }
     if (activeSession.phase === "review") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 7/7: \u4EE3\u7801\u5BA1\u6838 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 8/8: \u4EE3\u7801\u5BA1\u6838 \u2501\u2501\u2501"));
       lines.push("");
-      lines.push(chalk9__default.default.yellow("  \u{1F50D} \u4EE3\u7801\u5BA1\u6838\u9636\u6BB5"));
-      lines.push(chalk9__default.default.gray("  \u8BF7\u8C03\u7528 $code-reviewer \u6267\u884C\u4EE3\u7801\u5BA1\u6838"));
-      lines.push(chalk9__default.default.gray("  \u6216\u8F93\u5165 review \u5B8C\u6210\u5BA1\u6838"));
+      lines.push(chalk9__default.default.yellow("  \u{1F50D} \u6B63\u5728\u8FDB\u884C\u4EE3\u7801\u5BA1\u6838..."));
+      try {
+        const reviewResult = await executeReview(ctx, activeSession);
+        if (reviewResult.passed) {
+          lines.push(chalk9__default.default.green("  \u2713 \u4EE3\u7801\u5BA1\u6838\u901A\u8FC7"));
+          if (reviewResult.suggestions.length > 0) {
+            lines.push(chalk9__default.default.gray("  \u5EFA\u8BAE:"));
+            for (const s of reviewResult.suggestions.slice(0, 3)) {
+              lines.push(chalk9__default.default.gray(`    - ${s}`));
+            }
+          }
+          await archiveWorkflow(ctx.options.workingDirectory);
+          const summary = activeSession.refinedRequirement;
+          activeSession = null;
+          lines.push("");
+          lines.push(chalk9__default.default.green.bold("\u{1F389} \u5DE5\u4F5C\u6D41\u5DF2\u5B8C\u6210\uFF01"));
+          lines.push(chalk9__default.default.gray(`\u9700\u6C42: ${summary.slice(0, 60)}${summary.length > 60 ? "..." : ""}`));
+          lines.push("");
+          lines.push(chalk9__default.default.cyan("\u4F7F\u7528 /new <\u9700\u6C42> \u5F00\u59CB\u65B0\u7684\u5DE5\u4F5C\u6D41"));
+          return { output: lines.join("\n") };
+        } else {
+          lines.push(chalk9__default.default.red("  \u2717 \u4EE3\u7801\u5BA1\u6838\u672A\u901A\u8FC7"));
+          lines.push(chalk9__default.default.gray("  \u95EE\u9898:"));
+          for (const issue of reviewResult.issues.slice(0, 5)) {
+            lines.push(chalk9__default.default.red(`    - ${issue}`));
+          }
+          lines.push("");
+          lines.push(chalk9__default.default.yellow("  \u8BF7\u4FEE\u590D\u95EE\u9898\u540E\u8F93\u5165 y \u91CD\u65B0\u5BA1\u6838"));
+          lines.push(chalk9__default.default.gray("  \u6216\u8F93\u5165 n \u56DE\u9000\u5230\u89C4\u683C\u9636\u6BB5"));
+          return { output: lines.join("\n") };
+        }
+      } catch (error) {
+        lines.push(chalk9__default.default.red(`  \u2717 \u5BA1\u6838\u9636\u6BB5\u51FA\u9519: ${error.message}`));
+        lines.push(chalk9__default.default.gray("  \u8F93\u5165 pass \u5F3A\u5236\u901A\u8FC7\uFF0C\u6216 fix \u4FEE\u590D\u95EE\u9898"));
+        return { output: lines.join("\n") };
+      }
     }
     return { output: lines.join("\n") };
   } catch (error) {
@@ -1951,14 +2048,58 @@ async function handleWorkflowInput(input, ctx) {
       output: chalk9__default.default.yellow("\u2713 \u5DE5\u4F5C\u6D41\u5DF2\u53D6\u6D88")
     };
   }
+  if (activeSession.phase === "clarify") {
+    if (trimmed === "done" || trimmed === "\u5B8C\u6210" || trimmed === "\u8DF3\u8FC7" || trimmed === "skip") {
+      activeSession.refinedRequirement = buildRefinedRequirement(activeSession);
+      activeSession.phase = "analysis";
+      return executeWorkflow(ctx);
+    }
+    activeSession.clarificationQuestions.filter((q) => q.answered).length;
+    const unansweredQuestions = activeSession.clarificationQuestions.filter((q) => !q.answered);
+    if (unansweredQuestions.length > 0) {
+      const question = unansweredQuestions[0];
+      question.answer = input.trim();
+      question.answered = true;
+      activeSession.refinedRequirement = buildRefinedRequirement(activeSession);
+      const remaining = activeSession.clarificationQuestions.filter((q) => !q.answered);
+      if (remaining.length > 0) {
+        activeSession.clarityScore = calculateClarityScore(activeSession.clarificationQuestions);
+        const lines = [];
+        lines.push(chalk9__default.default.green("  \u2713 \u5DF2\u8BB0\u5F55"));
+        lines.push("");
+        lines.push(chalk9__default.default.yellow("  \u7EE7\u7EED\u56DE\u7B54\uFF1A"));
+        for (let i = 0; i < Math.min(remaining.length, 3); i++) {
+          const q = remaining[i];
+          lines.push(chalk9__default.default.white(`  ${i + 1}. ${q.question}`));
+        }
+        lines.push("");
+        lines.push(chalk9__default.default.gray('  \u8F93\u5165\u56DE\u7B54\uFF0C\u6216 "done" \u8DF3\u8FC7'));
+        return { output: lines.join("\n") };
+      }
+      activeSession.clarityScore = 1;
+      activeSession.phase = "analysis";
+      return executeWorkflow(ctx);
+    }
+    activeSession.phase = "analysis";
+    return executeWorkflow(ctx);
+  }
   if (activeSession.phase === "spec") {
     if (trimmed === "y" || trimmed === "yes" || trimmed === "\u786E\u8BA4") {
       activeSession.phase = "tdd";
       return executeWorkflow(ctx);
     }
     if (trimmed === "n" || trimmed === "no" || trimmed === "\u91CD\u65B0") {
-      activeSession.bddScenarios = generateBDDScenarios(activeSession.requirement, activeSession.context);
-      activeSession.specItems = generateSpecItems(activeSession.requirement, activeSession.context, activeSession.bddScenarios);
+      activeSession.bddScenarios = generateBDDScenarios(
+        activeSession.refinedRequirement,
+        activeSession.context,
+        activeSession.clarificationQuestions
+      );
+      activeSession.specItems = generateSpecItems(
+        activeSession.refinedRequirement,
+        activeSession.context,
+        activeSession.bddScenarios,
+        activeSession.clarificationQuestions
+      );
       const specPath = await saveSpecFile(ctx.options.workingDirectory, activeSession);
       return {
         output: chalk9__default.default.cyan("\u{1F504} \u89C4\u683C\u5DF2\u91CD\u65B0\u751F\u6210") + chalk9__default.default.gray(`
@@ -1973,24 +2114,347 @@ async function handleWorkflowInput(input, ctx) {
     }
   }
   if (activeSession.phase === "review") {
-    if (trimmed === "review" || trimmed === "\u5BA1\u6838" || trimmed === "pass" || trimmed === "\u901A\u8FC7") {
+    if (trimmed === "pass" || trimmed === "\u901A\u8FC7" || trimmed === "\u5F3A\u5236\u901A\u8FC7") {
       await archiveWorkflow(ctx.options.workingDirectory);
-      const summary = activeSession.requirement;
+      const summary = activeSession.refinedRequirement;
       activeSession = null;
       return {
         output: chalk9__default.default.green("\u2713 \u5DE5\u4F5C\u6D41\u5DF2\u5B8C\u6210") + chalk9__default.default.gray(`
-\u9700\u6C42: ${summary}`) + chalk9__default.default.cyan("\n\n\u4F7F\u7528 /new <\u9700\u6C42> \u5F00\u59CB\u65B0\u7684\u5DE5\u4F5C\u6D41")
+\u9700\u6C42: ${summary.slice(0, 60)}${summary.length > 60 ? "..." : ""}`) + chalk9__default.default.cyan("\n\n\u4F7F\u7528 /new <\u9700\u6C42> \u5F00\u59CB\u65B0\u7684\u5DE5\u4F5C\u6D41")
       };
     }
-    if (trimmed === "fail" || trimmed === "\u5931\u8D25" || trimmed === "reject" || trimmed === "\u62D2\u7EDD") {
+    if (trimmed === "y" || trimmed === "yes" || trimmed === "\u91CD\u65B0\u5BA1\u6838" || trimmed === "retry") {
+      return executeWorkflow(ctx);
+    }
+    if (trimmed === "n" || trimmed === "no" || trimmed === "\u56DE\u9000" || trimmed === "rollback") {
       activeSession.phase = "spec";
+      return executeWorkflow(ctx);
+    }
+    if (trimmed === "fix" || trimmed === "\u4FEE\u590D") {
       return {
-        output: chalk9__default.default.yellow("\u21A9\uFE0F \u5BA1\u6838\u672A\u901A\u8FC7\uFF0C\u56DE\u9000\u5230\u89C4\u683C\u9636\u6BB5") + chalk9__default.default.gray("\n\u8BF7\u91CD\u65B0\u786E\u8BA4\u6216\u4FEE\u6539\u89C4\u683C") + chalk9__default.default.yellow("\n\n\u4F7F\u7528 y \u786E\u8BA4\uFF0Cn \u91CD\u65B0\u751F\u6210")
+        output: chalk9__default.default.yellow("\u{1F4DD} \u8BF7\u624B\u52A8\u4FEE\u590D\u4EE3\u7801\u95EE\u9898") + chalk9__default.default.gray("\n\u4FEE\u590D\u5B8C\u6210\u540E\u8F93\u5165 y \u91CD\u65B0\u5BA1\u6838") + chalk9__default.default.gray("\n\u6216\u8F93\u5165 n \u56DE\u9000\u5230\u89C4\u683C\u9636\u6BB5")
       };
     }
   }
   return null;
 }
+function analyzeRequirementClarity(requirement, context) {
+  const questions = [];
+  let score = 0.5;
+  if (requirement.length < 10) {
+    score -= 0.2;
+    questions.push({
+      id: "q-length",
+      question: "\u9700\u6C42\u63CF\u8FF0\u8F83\u77ED\uFF0C\u80FD\u5426\u8BE6\u7EC6\u8BF4\u660E\u5177\u4F53\u8981\u5B9E\u73B0\u4EC0\u4E48\u529F\u80FD\uFF1F",
+      category: "scope",
+      answered: false
+    });
+  } else if (requirement.length >= 50) {
+    score += 0.1;
+  }
+  const actionKeywords = ["\u5B9E\u73B0", "\u6DFB\u52A0", "\u4FEE\u6539", "\u5220\u9664", "\u4F18\u5316", "\u4FEE\u590D", "\u91CD\u6784", "\u5F00\u53D1", "\u521B\u5EFA", "\u8BBE\u8BA1"];
+  const hasAction = actionKeywords.some((kw) => requirement.includes(kw));
+  if (!hasAction) {
+    score -= 0.15;
+    questions.push({
+      id: "q-action",
+      question: "\u8FD9\u662F\u4E00\u4E2A\u65B0\u529F\u80FD\u3001\u4FEE\u6539\u8FD8\u662F\u4FEE\u590D\uFF1F\u8BF7\u8BF4\u660E\u5177\u4F53\u8981\u505A\u4EC0\u4E48\u3002",
+      category: "scope",
+      answered: false
+    });
+  } else {
+    score += 0.1;
+  }
+  if (requirement.match(/界面|页面|组件|按钮|表单|弹窗|布局|样式|UI/)) {
+    score += 0.1;
+    if (!requirement.match(/在.*页面|在.*位置|显示在|位于/)) {
+      questions.push({
+        id: "q-ui-position",
+        question: "\u8FD9\u4E2A\u529F\u80FD\u5E94\u8BE5\u653E\u5728\u54EA\u4E2A\u9875\u9762\u6216\u4F4D\u7F6E\uFF1F",
+        category: "ui",
+        answered: false
+      });
+    }
+  } else {
+    questions.push({
+      id: "q-ui-need",
+      question: "\u8FD9\u4E2A\u529F\u80FD\u9700\u8981\u7528\u6237\u754C\u9762\u5417\uFF1F\u5982\u679C\u9700\u8981\uFF0C\u5927\u6982\u957F\u4EC0\u4E48\u6837\uFF1F",
+      category: "ui",
+      answered: false
+    });
+  }
+  if (requirement.match(/数据|存储|保存|读取|API|接口|数据库|缓存/)) {
+    score += 0.1;
+    if (!requirement.match(/从.*获取|调用.*接口|读取.*数据|来源/)) {
+      questions.push({
+        id: "q-data-source",
+        question: "\u6570\u636E\u4ECE\u54EA\u91CC\u6765\uFF1F\u662F\u8C03\u7528API\u3001\u672C\u5730\u5B58\u50A8\u8FD8\u662F\u5176\u4ED6\u6765\u6E90\uFF1F",
+        category: "data",
+        answered: false
+      });
+    }
+  }
+  if (requirement.match(/点击|输入|选择|拖动|滑动|交互|操作/)) {
+    score += 0.1;
+  } else {
+    if (hasAction && requirement.match(/功能|特性|模块/)) {
+      questions.push({
+        id: "q-interaction",
+        question: "\u7528\u6237\u5982\u4F55\u64CD\u4F5C\u8FD9\u4E2A\u529F\u80FD\uFF1F\u6709\u4EC0\u4E48\u4EA4\u4E92\u6D41\u7A0B\uFF1F",
+        category: "interaction",
+        answered: false
+      });
+    }
+  }
+  if (requirement.match(/异常|错误|失败|边界|特殊情况|空值|验证/)) {
+    score += 0.15;
+  } else {
+    if (requirement.match(/功能|输入|表单|数据/)) {
+      questions.push({
+        id: "q-edge",
+        question: "\u6709\u4EC0\u4E48\u7279\u6B8A\u60C5\u51B5\u6216\u8FB9\u754C\u6761\u4EF6\u9700\u8981\u5904\u7406\uFF1F\u6BD4\u5982\u8F93\u5165\u4E3A\u7A7A\u3001\u6570\u636E\u52A0\u8F7D\u5931\u8D25\u7B49\u3002",
+        category: "edge",
+        answered: false
+      });
+    }
+  }
+  if (requirement.match(/https?:\/\/|参考|参照|类似/)) {
+    score += 0.15;
+  }
+  if (context.framework) {
+    score += 0.05;
+  }
+  const limitedQuestions = questions.slice(0, 5);
+  score = Math.max(0, Math.min(1, score));
+  return { score, questions: limitedQuestions };
+}
+function calculateClarityScore(questions) {
+  const answered = questions.filter((q) => q.answered).length;
+  if (questions.length === 0) return 1;
+  return 0.5 + answered / questions.length * 0.5;
+}
+function buildRefinedRequirement(session) {
+  const parts = [session.requirement];
+  for (const q of session.clarificationQuestions) {
+    if (q.answered && q.answer) {
+      parts.push(`
+\u3010${getCategoryLabel(q.category)}\u3011${q.answer}`);
+    }
+  }
+  return parts.join("");
+}
+function getCategoryLabel(category) {
+  const labels = {
+    scope: "\u8303\u56F4",
+    ui: "\u754C\u9762",
+    data: "\u6570\u636E",
+    interaction: "\u4EA4\u4E92",
+    edge: "\u8FB9\u754C",
+    tech: "\u6280\u672F"
+  };
+  return labels[category] || category;
+}
+async function executeDevelopment(ctx, session) {
+  const workingDir = ctx.options.workingDirectory;
+  const files = [];
+  try {
+    const systemPrompt = buildDevelopmentPrompt(session);
+    const messages = [
+      {
+        role: "system",
+        content: `\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684\u524D\u7AEF\u5F00\u53D1\u5DE5\u7A0B\u5E08\u3002\u8BF7\u6839\u636E\u9700\u6C42\u89C4\u683C\u751F\u6210\u4EE3\u7801\u5B9E\u73B0\u3002
+
+\u8981\u6C42\uFF1A
+1. \u751F\u6210\u5B8C\u6574\u3001\u53EF\u8FD0\u884C\u7684\u4EE3\u7801
+2. \u9075\u5FAA\u9879\u76EE\u73B0\u6709\u7684\u4EE3\u7801\u98CE\u683C\u548C\u89C4\u8303
+3. \u4F7F\u7528\u9879\u76EE\u6307\u5B9A\u7684\u6280\u672F\u6808
+4. \u4EE3\u7801\u8981\u6709\u9002\u5F53\u7684\u6CE8\u91CA
+5. \u8FD4\u56DE\u683C\u5F0F\uFF1A\u6BCF\u4E2A\u6587\u4EF6\u7528 \`\`\`filename \u4EE3\u7801 \`\`\` \u5305\u88F9
+
+\u9879\u76EE\u4FE1\u606F\uFF1A
+- \u540D\u79F0: ${session.context?.name}
+- \u6846\u67B6: ${session.context?.framework || "\u672A\u6307\u5B9A"}
+- \u6280\u672F\u6808: ${session.context?.techStack.join(", ") || "\u672A\u6307\u5B9A"}
+
+${session.context?.devStandards ? `\u5F00\u53D1\u89C4\u8303\uFF1A
+${session.context.devStandards.slice(0, 2e3)}` : ""}`
+      },
+      {
+        role: "user",
+        content: systemPrompt
+      }
+    ];
+    const response = await ctx.modelService.sendMessage(messages, {
+      temperature: 0.3,
+      maxTokens: 8e3,
+      agent: "frontend-dev"
+    });
+    const codeBlocks = parseCodeBlocks(response.content);
+    for (const block of codeBlocks) {
+      const filePath = path7__namespace.join(workingDir, block.filename);
+      const dir = path7__namespace.dirname(filePath);
+      await fs7__namespace.mkdir(dir, { recursive: true });
+      await fs7__namespace.writeFile(filePath, block.code, "utf-8");
+      files.push(block.filename);
+    }
+    if (files.length === 0) {
+      const implDir = path7__namespace.join(workingDir, "src", "features");
+      await fs7__namespace.mkdir(implDir, { recursive: true });
+      const featureName = session.specItems[0]?.title || "feature";
+      const fileName = `${featureName.replace(/[^a-zA-Z0-9]/g, "_")}.ts`;
+      const filePath = path7__namespace.join(implDir, fileName);
+      const stubCode = `/**
+ * ${session.requirement}
+ * 
+ * TODO: \u6B64\u6587\u4EF6\u7531 AI \u81EA\u52A8\u751F\u6210\uFF0C\u8BF7\u6839\u636E\u9700\u6C42\u5B8C\u5584\u5B9E\u73B0
+ */
+
+export function ${featureName.replace(/[^a-zA-Z0-9]/g, "")}() {
+  // TODO: \u5B9E\u73B0\u529F\u80FD
+  console.log('${featureName} - \u5F85\u5B9E\u73B0');
+}
+`;
+      await fs7__namespace.writeFile(filePath, stubCode, "utf-8");
+      files.push(`src/features/${fileName}`);
+    }
+    return { success: true, files };
+  } catch (error) {
+    return {
+      success: false,
+      files: [],
+      error: error.message
+    };
+  }
+}
+function buildDevelopmentPrompt(session) {
+  const lines = [];
+  lines.push("## \u9700\u6C42\u63CF\u8FF0");
+  lines.push(session.refinedRequirement);
+  lines.push("");
+  lines.push("## BDD \u573A\u666F");
+  for (const scenario of session.bddScenarios) {
+    lines.push(`### ${scenario.feature}`);
+    for (const s of scenario.scenarios) {
+      lines.push(`- ${s.name}`);
+    }
+  }
+  lines.push("");
+  lines.push("## \u4EFB\u52A1\u5217\u8868");
+  for (const item of session.specItems) {
+    lines.push(`- [${item.id}] ${item.title}: ${item.description}`);
+  }
+  lines.push("");
+  lines.push("\u8BF7\u6839\u636E\u4EE5\u4E0A\u9700\u6C42\u89C4\u683C\u751F\u6210\u4EE3\u7801\u5B9E\u73B0\u3002");
+  return lines.join("\n");
+}
+function parseCodeBlocks(content) {
+  const blocks = [];
+  const regex = /```(\S+)\n([\s\S]*?)```/g;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    const filename = match[1];
+    const code = match[2].trim();
+    if (["text", "json", "markdown", "md"].includes(filename.toLowerCase())) {
+      continue;
+    }
+    blocks.push({ filename, code });
+  }
+  return blocks;
+}
+async function executeReview(ctx, session) {
+  const workingDir = ctx.options.workingDirectory;
+  const issues = [];
+  const suggestions = [];
+  try {
+    const codeContents = [];
+    for (const file of session.implFiles) {
+      try {
+        const content = await fs7__namespace.readFile(path7__namespace.join(workingDir, file), "utf-8");
+        codeContents.push(`// ${file}
+${content}`);
+      } catch {
+      }
+    }
+    const testContents = [];
+    for (const file of session.testFiles) {
+      try {
+        const content = await fs7__namespace.readFile(path7__namespace.join(workingDir, file), "utf-8");
+        testContents.push(`// ${file}
+${content}`);
+      } catch {
+      }
+    }
+    const messages = [
+      {
+        role: "system",
+        content: `\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684\u4EE3\u7801\u5BA1\u6838\u4E13\u5BB6\u3002\u8BF7\u5BA1\u6838\u4EE5\u4E0B\u4EE3\u7801\u5B9E\u73B0\u662F\u5426\u7B26\u5408\u9700\u6C42\u89C4\u683C\u3002
+
+\u5BA1\u6838\u6807\u51C6\uFF1A
+1. \u4EE3\u7801\u662F\u5426\u6B63\u786E\u5B9E\u73B0\u4E86\u9700\u6C42\u89C4\u683C\u4E2D\u7684\u529F\u80FD
+2. \u4EE3\u7801\u8D28\u91CF\uFF08\u53EF\u8BFB\u6027\u3001\u53EF\u7EF4\u62A4\u6027\uFF09
+3. \u6F5C\u5728\u7684 bug \u548C\u8FB9\u754C\u60C5\u51B5\u5904\u7406
+4. \u4EE3\u7801\u98CE\u683C\u662F\u5426\u7B26\u5408\u9879\u76EE\u89C4\u8303
+5. \u6D4B\u8BD5\u8986\u76D6\u662F\u5426\u5145\u5206
+
+\u8FD4\u56DE\u683C\u5F0F\uFF1A
+- \u5982\u679C\u901A\u8FC7\u5BA1\u6838\uFF0C\u8FD4\u56DE "\u5BA1\u6838\u901A\u8FC7" \u5E76\u5217\u51FA\u6539\u8FDB\u5EFA\u8BAE
+- \u5982\u679C\u4E0D\u901A\u8FC7\uFF0C\u5217\u51FA\u5177\u4F53\u95EE\u9898
+
+\u9879\u76EE\u4FE1\u606F\uFF1A
+- \u6846\u67B6: ${session.context?.framework || "\u672A\u6307\u5B9A"}
+- \u6280\u672F\u6808: ${session.context?.techStack.join(", ") || "\u672A\u6307\u5B9A"}
+
+${session.context?.devStandards ? `\u5F00\u53D1\u89C4\u8303\uFF1A
+${session.context.devStandards.slice(0, 1e3)}` : ""}`
+      },
+      {
+        role: "user",
+        content: `## \u9700\u6C42\u89C4\u683C
+${session.refinedRequirement}
+
+## \u4EFB\u52A1\u5217\u8868
+${session.specItems.map((item) => `- [${item.id}] ${item.title}`).join("\n")}
+
+## \u5B9E\u73B0\u4EE3\u7801
+${codeContents.join("\n\n") || "\uFF08\u65E0\u4EE3\u7801\u6587\u4EF6\uFF09"}
+
+## \u6D4B\u8BD5\u4EE3\u7801
+${testContents.join("\n\n") || "\uFF08\u65E0\u6D4B\u8BD5\u6587\u4EF6\uFF09"}
+
+\u8BF7\u5BA1\u6838\u4EE5\u4E0A\u4EE3\u7801\u5B9E\u73B0\u3002`
+      }
+    ];
+    const response = await ctx.modelService.sendMessage(messages, {
+      temperature: 0.2,
+      maxTokens: 2e3,
+      agent: "code-reviewer"
+    });
+    const result = response.content;
+    const passed = result.includes("\u5BA1\u6838\u901A\u8FC7") || result.includes("\u901A\u8FC7") || !result.includes("\u4E0D\u901A\u8FC7");
+    const issueMatches = result.match(/问题[：:]\s*([\s\S]*?)(?=建议|$)/i);
+    if (issueMatches) {
+      const issueList = issueMatches[1].split(/[\n-]/).filter((s) => s.trim());
+      issues.push(...issueList.map((s) => s.trim()).filter((s) => s));
+    }
+    const suggestionMatches = result.match(/建议[：:]\s*([\s\S]*?)$/i);
+    if (suggestionMatches) {
+      const suggestionList = suggestionMatches[1].split(/[\n-]/).filter((s) => s.trim());
+      suggestions.push(...suggestionList.map((s) => s.trim()).filter((s) => s));
+    }
+    if (issues.length === 0 && !passed) {
+      const lines = result.split("\n").filter((l) => l.includes("\u95EE\u9898") || l.includes("\u9519\u8BEF") || l.includes("\u7F3A\u9677"));
+      issues.push(...lines.map((l) => l.replace(/^[-*]\s*/, "").trim()).filter((l) => l));
+    }
+    if (suggestions.length === 0) {
+      const lines = result.split("\n").filter((l) => l.includes("\u5EFA\u8BAE") || l.includes("\u6539\u8FDB") || l.includes("\u4F18\u5316"));
+      suggestions.push(...lines.map((l) => l.replace(/^[-*]\s*/, "").trim()).filter((l) => l));
+    }
+    return { passed, issues, suggestions };
+  } catch (error) {
+    suggestions.push(`\u5BA1\u6838\u8FC7\u7A0B\u51FA\u9519: ${error.message}`);
+    return { passed: true, issues, suggestions };
+  }
+}
 async function readProjectContext(workingDir) {
   const context = {
     name: path7__namespace.basename(workingDir),
@@ -2072,8 +2536,11 @@ function analyzeComplexity(requirement, context) {
   if (!context.framework) score += 0.5;
   return Math.max(1, Math.min(10, Math.round(score)));
 }
-function generateBDDScenarios(requirement, context) {
+function generateBDDScenarios(requirement, context, questions) {
   const scenarios = [];
+  questions.find((q) => q.category === "ui" && q.answered)?.answer;
+  const interactionAnswer = questions.find((q) => q.category === "interaction" && q.answered)?.answer;
+  const edgeAnswer = questions.find((q) => q.category === "edge" && q.answered)?.answer;
   const features = extractFeatures(requirement);
   for (const feature of features) {
     const scenario = {
@@ -2087,12 +2554,20 @@ function generateBDDScenarios(requirement, context) {
       when: [`\u7528\u6237\u6267\u884C "${feature.title}" \u64CD\u4F5C`],
       then: [`\u7CFB\u7EDF\u5E94\u6B63\u786E\u5904\u7406\u5E76\u8FD4\u56DE\u9884\u671F\u7ED3\u679C`]
     });
-    if (feature.hasInput) {
+    if (interactionAnswer) {
       scenario.scenarios.push({
-        name: `\u8FB9\u754C\u60C5\u51B5: \u8F93\u5165\u9A8C\u8BC1`,
-        given: [`\u7528\u6237\u8FDB\u5165\u8F93\u5165\u754C\u9762`],
-        when: [`\u7528\u6237\u8F93\u5165\u8FB9\u754C\u503C\u6216\u7A7A\u503C`],
-        then: [`\u7CFB\u7EDF\u5E94\u6B63\u786E\u5904\u7406\u8FB9\u754C\u60C5\u51B5`]
+        name: `\u4EA4\u4E92\u6D41\u7A0B: \u7528\u6237\u64CD\u4F5C`,
+        given: [`\u7528\u6237\u8FDB\u5165\u529F\u80FD\u754C\u9762`],
+        when: [`\u7528\u6237\u6309\u7167\u4EE5\u4E0B\u6D41\u7A0B\u64CD\u4F5C: ${interactionAnswer}`],
+        then: [`\u7CFB\u7EDF\u54CD\u5E94\u5E76\u5B8C\u6210\u529F\u80FD`]
+      });
+    }
+    if (feature.hasInput || edgeAnswer) {
+      scenario.scenarios.push({
+        name: `\u8FB9\u754C\u60C5\u51B5: \u5F02\u5E38\u5904\u7406`,
+        given: [`\u7528\u6237\u8FDB\u5165\u529F\u80FD\u754C\u9762`],
+        when: [`\u53D1\u751F\u5F02\u5E38\u60C5\u51B5${edgeAnswer ? `: ${edgeAnswer}` : ""}`],
+        then: [`\u7CFB\u7EDF\u5E94\u6B63\u786E\u5904\u7406\u5F02\u5E38\u5E76\u7ED9\u51FA\u63D0\u793A`]
       });
     }
     scenarios.push(scenario);
@@ -2139,7 +2614,7 @@ function extractFeatures(requirement) {
   }
   return features;
 }
-function generateSpecItems(requirement, context, bddScenarios) {
+function generateSpecItems(requirement, context, bddScenarios, questions) {
   const items = [];
   let id = 1;
   for (const scenario of bddScenarios) {
@@ -2176,11 +2651,33 @@ function formatSpecFile(session) {
   lines.push(`# \u9700\u6C42\u89C4\u683C: ${session.requirement.slice(0, 50)}`);
   lines.push("");
   lines.push(`> \u53D8\u66F4ID: ${session.id}`);
+  lines.push(`> \u9700\u6C42\u6E05\u6670\u5EA6: ${Math.round(session.clarityScore * 100)}%`);
   lines.push(`> \u590D\u6742\u5EA6: ${session.complexity}/10`);
   lines.push(`> \u751F\u6210\u65F6\u95F4: ${session.createdAt.toISOString()}`);
   lines.push("");
   lines.push("---");
   lines.push("");
+  if (session.refinedRequirement !== session.requirement) {
+    lines.push("## \u9700\u6C42\u8BE6\u60C5");
+    lines.push("");
+    lines.push(session.refinedRequirement);
+    lines.push("");
+    lines.push("---");
+    lines.push("");
+  }
+  if (session.clarificationQuestions.some((q) => q.answered)) {
+    lines.push("## \u9700\u6C42\u6F84\u6E05");
+    lines.push("");
+    for (const q of session.clarificationQuestions) {
+      if (q.answered) {
+        lines.push(`**Q: ${q.question}**`);
+        lines.push(`A: ${q.answer}`);
+        lines.push("");
+      }
+    }
+    lines.push("---");
+    lines.push("");
+  }
   lines.push("## BDD \u573A\u666F");
   lines.push("");
   for (const scenario of session.bddScenarios) {
@@ -2244,11 +2741,17 @@ async function archiveWorkflow(workingDir) {
   const content = `# \u5F52\u6863: ${activeSession.requirement.slice(0, 50)}
 
 > \u5F52\u6863\u65F6\u95F4: ${(/* @__PURE__ */ new Date()).toISOString()}
+> \u9700\u6C42\u6E05\u6670\u5EA6: ${Math.round(activeSession.clarityScore * 100)}%
 > \u590D\u6742\u5EA6: ${activeSession.complexity}/10
 
+## \u9700\u6C42\u8BE6\u60C5
+
+${activeSession.refinedRequirement}
+
 ## \u5B8C\u6210\u60C5\u51B5
 
 - [x] \u9879\u76EE\u4E0A\u4E0B\u6587\u83B7\u53D6
+- [x] \u9700\u6C42\u6F84\u6E05
 - [x] \u590D\u6742\u5EA6\u8BC4\u4F30
 - [x] BDD \u573A\u666F\u62C6\u89E3
 - [x] OpenSpec \u89C4\u683C
@@ -2275,6 +2778,7 @@ function generateComplexityBar(score) {
 function getPhaseLabel(phase) {
   const labels = {
     context: "\u9879\u76EE\u4E0A\u4E0B\u6587\u83B7\u53D6",
+    clarify: "\u9700\u6C42\u6F84\u6E05",
     analysis: "\u590D\u6742\u5EA6\u8BC4\u4F30",
     bdd: "BDD \u573A\u666F\u62C6\u89E3",
     spec: "OpenSpec \u89C4\u683C",
@@ -2290,12 +2794,13 @@ function getActiveSession() {
 function clearActiveSession() {
   activeSession = null;
 }
-var MAX_FILE_SIZE2, COMPLEXITY_THRESHOLD, activeSession, new_default;
+var MAX_FILE_SIZE2, COMPLEXITY_THRESHOLD, CLARITY_THRESHOLD, activeSession, new_default;
 var init_new = __esm({
   "src/commands/new.ts"() {
     init_cjs_shims();
     MAX_FILE_SIZE2 = 1024 * 1024;
     COMPLEXITY_THRESHOLD = 6;
+    CLARITY_THRESHOLD = 0.6;
     activeSession = null;
     new_default = handleNew;
   }
@@ -6879,6 +7384,7 @@ var STEP_DISPLAY_NAMES = {
   "apply": "\u5BA1\u67E5",
   "archive": "\u5F52\u6863",
   "context": "\u4E0A\u4E0B\u6587",
+  "clarify": "\u6F84\u6E05",
   "analysis": "\u5206\u6790",
   "bdd": "BDD",
   "spec": "\u89C4\u683C",
@@ -6894,6 +7400,7 @@ var STEP_COLORS = {
   "apply": chalk9__default.default.yellow,
   "archive": chalk9__default.default.gray,
   "context": chalk9__default.default.magenta,
+  "clarify": chalk9__default.default.yellow,
   "analysis": chalk9__default.default.blue,
   "bdd": chalk9__default.default.cyan,
   "spec": chalk9__default.default.green,