@nick848/sf-cli 1.0.10 → 1.0.11

package/CHANGELOG.md

@@ -9,19 +9,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 **重大重构 - 工作流系统重写**
 
-- ✨ 全新的 `WorkflowSession` 架构 - 7 阶段自动流转
-- 🔄 自动执行流程：context → analysis → bdd → spec → tdd → develop → review
-- ⏸️ 唯一暂停点：spec 阶段等待 y/n 确认
-- 🎯 简化交互：y/n/c 三键操作（确认/重新生成/取消）
+- ✨ 全新的 `WorkflowSession` 架构 - 8 阶段自动流转
+- 🆕 **需求澄清阶段** - 需求不明确时主动引导开发者补充信息
+- 📊 需求清晰度评估 - 自动计算需求清晰度分数
+- ❓ 智能问题生成 - 根据需求内容自动生成澄清问题
+- 🔄 自动执行流程：context → clarify → analysis → bdd → spec → tdd → develop → review
+- ⏸️ 两个暂停点：clarify（需求澄清）、spec（规格确认）
+
+**需求澄清功能**
+
+- 自动检测需求清晰度（长度、动作、UI、数据、交互、边界）
+- 生成针对性澄清问题（范围、界面、数据、交互、边界条件）
+- 支持逐个回答或 `done` 跳过
+- 回答后自动更新精炼需求
 
 **架构改进**
 
-- 📦 `new.ts` - 完全重写，移除旧 WorkflowEngine 依赖
+- 📦 `new.ts` - 完全重写，新增 ClarificationQuestion 接口
 - 📦 `natural.ts` - 简化为工作流输入处理
 - 📦 `executor.ts` - 简化权限控制逻辑
 - 📦 `repl.ts` - 使用 `getActiveSession()` 获取状态
 - 📦 `status.ts` - 支持新 WorkflowPhase 类型显示
-- 📦 `types/index.ts` - 新增 `WorkflowPhase` 类型定义
+- 📦 `types/index.ts` - 新增 `clarify` 阶段
 
 **修复问题**
 

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,7 +1969,7 @@ 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"));
@@ -1930,7 +1978,7 @@ async function executeWorkflow(ctx) {
     }
     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"));
@@ -1951,14 +1999,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(`
@@ -1975,11 +2067,11 @@ async function handleWorkflowInput(input, ctx) {
   if (activeSession.phase === "review") {
     if (trimmed === "review" || trimmed === "\u5BA1\u6838" || trimmed === "pass" || trimmed === "\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)}...`) + 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") {
@@ -1991,6 +2083,122 @@ async function handleWorkflowInput(input, ctx) {
   }
   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 readProjectContext(workingDir) {
   const context = {
     name: path7__namespace.basename(workingDir),
@@ -2072,8 +2280,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 +2298,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 +2358,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 +2395,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 +2485,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 +2522,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 +2538,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 +7128,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 +7144,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,