bmall-mcp 1.8.8 → 1.8.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -204,6 +204,13 @@ src/
204
204
 
205
205
  ## Changelog
206
206
 
207
+ ### v1.8.9 (2026-03-16)
208
+ - ✅ 优化工作流输出:一次性返回所有需要处理的文档任务
209
+ - ✅ 支持并行处理:AI可以同时处理多个文档,提高效率
210
+ - ✅ 减少交互次数:从多次返回改为一次返回完整任务列表
211
+ - ✅ 完善Figma提示:像PDF一样提供具体的工具调用步骤
212
+ - ✅ 统一提示格式:所有文档都有清晰的操作指引
213
+
207
214
  ### v1.8.8 (2026-03-16)
208
215
  - ✅ 优化PDF读取流程:同时使用read_pdf_text和read_by_ocr两个工具
209
216
  - ✅ 简化流程:不再输出中间文件,直接合并到origin-requirement.md
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/requirements/index.ts"],"names":[],"mappings":"AAyBA,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,0BAA0B;IAClC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAmCD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,iBAAiB,CAAC;QAClD,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,CAAC,CA2KD"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/requirements/index.ts"],"names":[],"mappings":"AAyBA,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,0BAA0B;IAClC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAmCD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,iBAAiB,CAAC;QAClD,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,CAAC,CA2ND"}
@@ -47,100 +47,131 @@ export async function generateRequirements(params) {
47
47
  projectRoot = getProjectRoot(params.requirementSource.path);
48
48
  }
49
49
  debugLog(`计算项目根目录`, { projectRoot, cwd: process.cwd() });
50
- // 2.1 处理需求文档(优先处理)
50
+ // 2.1 检查所有文档状态,收集需要处理的文档
51
+ const originDocPath = buildOutputPath(params.featureName, "origin-requirement.md", projectRoot);
52
+ const designDocPath = params.designSource ? buildOutputPath(params.featureName, "design-doc.md", projectRoot) : null;
53
+ const backendDocPath = params.backendSource ? buildOutputPath(params.featureName, "backend-doc.md", projectRoot) : null;
54
+ debugLog(`检查文档状态`, { originDocPath, designDocPath, backendDocPath });
55
+ // 检查各个文档是否已存在
51
56
  const savedRequirement = await tryReadSavedRequirement(params.featureName, projectRoot);
57
+ const savedDesign = params.designSource ? await tryReadSavedDesign(params.featureName, projectRoot) : null;
58
+ const savedBackend = params.backendSource ? await tryReadSavedBackend(params.featureName, projectRoot) : null;
59
+ debugLog(`文档状态检查结果`, {
60
+ savedRequirement: !!savedRequirement,
61
+ savedDesign: !!savedDesign,
62
+ savedBackend: !!savedBackend
63
+ });
64
+ // 收集需要处理的文档
65
+ const tasks = [];
66
+ // 检查需求文档
52
67
  if (!savedRequirement) {
53
- debugLog(`未找到需求文档,需要处理`);
54
- const requirementResult = await processRequirementDocument(params.requirementSource, params.featureName);
68
+ debugLog(`需求文档未找到,需要处理`);
69
+ const requirementResult = await processRequirementDocument(params.requirementSource, params.featureName, "origin-requirement.md");
55
70
  if (!requirementResult.success) {
56
71
  debugLog(`需求文档需要进一步处理`, { requirementResult });
57
- return {
58
- success: false,
59
- message: requirementResult.message,
60
- needsAction: requirementResult.needsAction,
61
- };
72
+ tasks.push({
73
+ name: "需求文档 (PRD)",
74
+ outputPath: originDocPath,
75
+ source: params.requirementSource,
76
+ status: "needs_processing",
77
+ processingInstruction: requirementResult.message
78
+ });
79
+ }
80
+ else {
81
+ debugLog(`需求文档已处理`);
62
82
  }
63
- debugLog(`需求文档已保存`);
64
- }
65
- else {
66
- debugLog(`需求文档已存在`, { contentLength: savedRequirement.length });
67
83
  }
68
- // 2.2 检查设计稿(如果有且未保存)
69
- let designSourceInfo = "";
70
- if (params.designSource) {
71
- const savedDesign = await tryReadSavedDesign(params.featureName, projectRoot);
72
- if (!savedDesign) {
73
- debugLog(`设计稿未保存,需要处理`);
74
- let designResult;
75
- if (params.designSource.type === "file") {
76
- const designProjectRoot = getProjectRoot(params.designSource.path);
77
- debugLog(`设计稿项目根目录`, { designProjectRoot });
78
- designResult = await processRequirementDocument(params.designSource, params.featureName, "design-doc.md");
79
- }
80
- else if (params.designSource.type === "figma") {
81
- // Figma 链接类型,返回提示让 AI 处理
82
- designResult = {
83
- success: false,
84
- message: `🎨 检测到 Figma 设计稿链接
85
-
86
- 请使用 Figma MCP 读取设计稿并保存到文件`,
87
- needsAction: {
88
- type: "analyze_content",
89
- instruction: `使用 Figma MCP 读取设计稿 ${params.designSource.url},保存到 ${buildOutputPath(params.featureName, "design-doc.md", projectRoot)}。完成后立即保存文件,不要把内容放在上下文中。保存后重新调用 generate_requirements 工具。`,
90
- },
91
- };
92
- }
93
- else {
94
- // 未知类型,默认返回成功
95
- debugLog(`设计稿类型未知,跳过`);
96
- designResult = { success: true, message: "设计稿已处理" };
97
- }
84
+ // 检查设计稿
85
+ if (params.designSource && !savedDesign) {
86
+ debugLog(`设计稿未找到,需要处理`);
87
+ if (params.designSource.type === "file") {
88
+ const designResult = await processRequirementDocument({
89
+ type: "file",
90
+ path: params.designSource.path
91
+ }, params.featureName, "design-doc.md");
98
92
  if (!designResult.success) {
99
93
  debugLog(`设计稿需要进一步处理`, { designResult });
100
- return {
101
- success: false,
102
- message: designResult.message,
103
- needsAction: designResult.needsAction,
104
- };
94
+ tasks.push({
95
+ name: "设计稿",
96
+ outputPath: designDocPath,
97
+ source: params.designSource,
98
+ status: "needs_processing",
99
+ processingInstruction: designResult.message
100
+ });
101
+ }
102
+ else {
103
+ debugLog(`设计稿已处理`);
105
104
  }
106
- debugLog(`设计稿已保存`);
107
- designSourceInfo = `**设计稿位置**:${buildOutputPath(params.featureName, "design-doc.md", projectRoot)}\n`;
108
105
  }
109
- else {
110
- debugLog(`设计稿已存在`);
111
- designSourceInfo = `**设计稿位置**:${buildOutputPath(params.featureName, "design-doc.md", projectRoot)}\n`;
106
+ else if (params.designSource.type === "figma") {
107
+ tasks.push({
108
+ name: "设计稿 (Figma)",
109
+ outputPath: designDocPath,
110
+ source: params.designSource,
111
+ status: "needs_processing",
112
+ processingInstruction: `🎨 检测到 Figma 设计稿链接
113
+
114
+ 请读取以下 Figma 设计稿并保存到文件:
115
+
116
+ - Figma 链接:${params.designSource.url}
117
+ - 保存到:\`${designDocPath}\`
118
+
119
+ 读取完成后,重新调用 \`generate_requirements\` 工具`
120
+ });
112
121
  }
113
122
  }
114
- // 2.3 检查后端文档(如果有且未保存)
115
- let backendSourceInfo = "";
116
- if (params.backendSource) {
117
- const savedBackend = await tryReadSavedBackend(params.featureName, projectRoot);
118
- if (!savedBackend) {
119
- debugLog(`后端文档未保存,需要处理`);
120
- const backendProjectRoot = params.backendSource.type === "file"
121
- ? getProjectRoot(params.backendSource.path)
122
- : projectRoot;
123
- debugLog(`后端文档项目根目录`, { backendProjectRoot });
124
- const backendResult = await processRequirementDocument(params.backendSource, params.featureName, "backend-doc.md");
125
- if (!backendResult.success) {
126
- debugLog(`后端文档需要进一步处理`, { backendResult });
127
- return {
128
- success: false,
129
- message: backendResult.message,
130
- needsAction: backendResult.needsAction,
131
- };
132
- }
133
- debugLog(`后端文档已保存`);
134
- backendSourceInfo = `**后端文档位置**:${buildOutputPath(params.featureName, "backend-doc.md", backendProjectRoot)}\n`;
123
+ // 检查后端文档
124
+ if (params.backendSource && !savedBackend) {
125
+ debugLog(`后端文档未找到,需要处理`);
126
+ const backendResult = await processRequirementDocument(params.backendSource, params.featureName, "backend-doc.md");
127
+ if (!backendResult.success) {
128
+ debugLog(`后端文档需要进一步处理`, { backendResult });
129
+ tasks.push({
130
+ name: "后端文档",
131
+ outputPath: backendDocPath,
132
+ source: params.backendSource,
133
+ status: "needs_processing",
134
+ processingInstruction: backendResult.message
135
+ });
135
136
  }
136
137
  else {
137
- debugLog(`后端文档已存在`);
138
- backendSourceInfo = `**后端文档位置**:${buildOutputPath(params.featureName, "backend-doc.md", projectRoot)}\n`;
138
+ debugLog(`后端文档已处理`);
139
139
  }
140
140
  }
141
+ // 如果有需要处理的任务,返回完整工作流
142
+ if (tasks.length > 0) {
143
+ debugLog(`发现 ${tasks.length} 个需要处理的任务`);
144
+ let message = `📋 需要处理以下文档(共 ${tasks.length} 个)\n\n`;
145
+ tasks.forEach((task, index) => {
146
+ message += `### 任务 ${index + 1}:${task.name}\n`;
147
+ message += task.processingInstruction;
148
+ message += `\n\n`;
149
+ });
150
+ message += `⚠️ **重要提示**:\n`;
151
+ message += `- 每个任务处理完成后,立即保存文件,**不要把文件内容放在上下文中**\n`;
152
+ message += `- 所有任务完成后,重新调用 \`generate_requirements\` 工具\n`;
153
+ message += `- 这样可以避免上下文过长,提高处理效率\n`;
154
+ return {
155
+ success: false,
156
+ message,
157
+ needsAction: {
158
+ type: "process_documents",
159
+ instruction: `按顺序或并行处理上述 ${tasks.length} 个任务,每个任务完成后立即保存文件。所有任务完成后重新调用 generate_requirements 工具。`
160
+ }
161
+ };
162
+ }
163
+ // 所有文档都已准备好
164
+ debugLog(`所有文档已准备完毕`);
165
+ let designSourceInfo = "";
166
+ if (savedDesign) {
167
+ designSourceInfo = `**设计稿位置**:${designDocPath}\n`;
168
+ }
169
+ let backendSourceInfo = "";
170
+ if (savedBackend) {
171
+ backendSourceInfo = `**后端文档位置**:${backendDocPath}\n`;
172
+ }
141
173
  // 5. 生成分析提示词
142
174
  const outputPath = buildOutputPath(params.featureName, "requirements.md", projectRoot);
143
- const originDocPath = buildOutputPath(params.featureName, "origin-requirement.md", projectRoot);
144
175
  debugLog(`生成输出路径`, { outputPath, originDocPath, projectRoot });
145
176
  let message = "📝 需求文档已准备完毕\n\n";
146
177
  message += `**原始文档位置**:${originDocPath}\n`;
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/requirements/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/requirements/index.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bmall-mcp",
3
- "version": "1.8.8",
3
+ "version": "1.8.9",
4
4
  "description": "MCP Server for bmall development rules and tools",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -108,117 +108,165 @@ export async function generateRequirements(
108
108
  }
109
109
  debugLog(`计算项目根目录`, { projectRoot, cwd: process.cwd() });
110
110
 
111
- // 2.1 处理需求文档(优先处理)
111
+ // 2.1 检查所有文档状态,收集需要处理的文档
112
+ const originDocPath = buildOutputPath(params.featureName, "origin-requirement.md", projectRoot);
113
+ const designDocPath = params.designSource ? buildOutputPath(params.featureName, "design-doc.md", projectRoot) : null;
114
+ const backendDocPath = params.backendSource ? buildOutputPath(params.featureName, "backend-doc.md", projectRoot) : null;
115
+
116
+ debugLog(`检查文档状态`, { originDocPath, designDocPath, backendDocPath });
117
+
118
+ // 检查各个文档是否已存在
112
119
  const savedRequirement = await tryReadSavedRequirement(params.featureName, projectRoot);
120
+ const savedDesign = params.designSource ? await tryReadSavedDesign(params.featureName, projectRoot) : null;
121
+ const savedBackend = params.backendSource ? await tryReadSavedBackend(params.featureName, projectRoot) : null;
122
+
123
+ debugLog(`文档状态检查结果`, {
124
+ savedRequirement: !!savedRequirement,
125
+ savedDesign: !!savedDesign,
126
+ savedBackend: !!savedBackend
127
+ });
128
+
129
+ // 收集需要处理的文档
130
+ const tasks: Array<{
131
+ name: string;
132
+ outputPath: string;
133
+ source?: any;
134
+ status: "exists" | "needs_processing";
135
+ processingInstruction?: string;
136
+ }> = [];
137
+
138
+ // 检查需求文档
113
139
  if (!savedRequirement) {
114
- debugLog(`未找到需求文档,需要处理`);
140
+ debugLog(`需求文档未找到,需要处理`);
115
141
  const requirementResult = await processRequirementDocument(
116
142
  params.requirementSource,
117
- params.featureName
143
+ params.featureName,
144
+ "origin-requirement.md"
118
145
  );
119
-
146
+
120
147
  if (!requirementResult.success) {
121
148
  debugLog(`需求文档需要进一步处理`, { requirementResult });
122
- return {
123
- success: false,
124
- message: requirementResult.message!,
125
- needsAction: requirementResult.needsAction,
126
- };
149
+ tasks.push({
150
+ name: "需求文档 (PRD)",
151
+ outputPath: originDocPath,
152
+ source: params.requirementSource,
153
+ status: "needs_processing",
154
+ processingInstruction: requirementResult.message!
155
+ });
156
+ } else {
157
+ debugLog(`需求文档已处理`);
127
158
  }
128
- debugLog(`需求文档已保存`);
129
- } else {
130
- debugLog(`需求文档已存在`, { contentLength: savedRequirement.length });
131
159
  }
132
-
133
- // 2.2 检查设计稿(如果有且未保存)
134
- let designSourceInfo = "";
135
- if (params.designSource) {
136
- const savedDesign = await tryReadSavedDesign(params.featureName, projectRoot);
160
+
161
+ // 检查设计稿
162
+ if (params.designSource && !savedDesign) {
163
+ debugLog(`设计稿未找到,需要处理`);
137
164
 
138
- if (!savedDesign) {
139
- debugLog(`设计稿未保存,需要处理`);
140
- let designResult: ProcessResult;
141
-
142
- if (params.designSource.type === "file") {
143
- const designProjectRoot = getProjectRoot(params.designSource.path!);
144
- debugLog(`设计稿项目根目录`, { designProjectRoot });
145
-
146
- designResult = await processRequirementDocument(
147
- params.designSource as any,
148
- params.featureName,
149
- "design-doc.md"
150
- );
151
- } else if (params.designSource.type === "figma") {
152
- // Figma 链接类型,返回提示让 AI 处理
153
- designResult = {
154
- success: false,
155
- message: `🎨 检测到 Figma 设计稿链接
156
-
157
- 请使用 Figma MCP 读取设计稿并保存到文件`,
158
- needsAction: {
159
- type: "analyze_content" as any,
160
- instruction: `使用 Figma MCP 读取设计稿 ${params.designSource.url},保存到 ${buildOutputPath(params.featureName, "design-doc.md", projectRoot)}。完成后立即保存文件,不要把内容放在上下文中。保存后重新调用 generate_requirements 工具。`,
161
- },
162
- };
163
- } else {
164
- // 未知类型,默认返回成功
165
- debugLog(`设计稿类型未知,跳过`);
166
- designResult = { success: true, message: "设计稿已处理" };
167
- }
165
+ if (params.designSource.type === "file") {
166
+ const designResult = await processRequirementDocument(
167
+ {
168
+ type: "file",
169
+ path: params.designSource.path
170
+ },
171
+ params.featureName,
172
+ "design-doc.md"
173
+ );
168
174
 
169
175
  if (!designResult.success) {
170
176
  debugLog(`设计稿需要进一步处理`, { designResult });
171
- return {
172
- success: false,
173
- message: designResult.message!,
174
- needsAction: designResult.needsAction,
175
- };
177
+ tasks.push({
178
+ name: "设计稿",
179
+ outputPath: designDocPath!,
180
+ source: params.designSource,
181
+ status: "needs_processing",
182
+ processingInstruction: designResult.message!
183
+ });
184
+ } else {
185
+ debugLog(`设计稿已处理`);
176
186
  }
177
- debugLog(`设计稿已保存`);
178
- designSourceInfo = `**设计稿位置**:${buildOutputPath(params.featureName, "design-doc.md", projectRoot)}\n`;
179
- } else {
180
- debugLog(`设计稿已存在`);
181
- designSourceInfo = `**设计稿位置**:${buildOutputPath(params.featureName, "design-doc.md", projectRoot)}\n`;
187
+ } else if (params.designSource.type === "figma") {
188
+ tasks.push({
189
+ name: "设计稿 (Figma)",
190
+ outputPath: designDocPath!,
191
+ source: params.designSource,
192
+ status: "needs_processing",
193
+ processingInstruction: `🎨 检测到 Figma 设计稿链接
194
+
195
+ 请读取以下 Figma 设计稿并保存到文件:
196
+
197
+ - Figma 链接:${params.designSource.url}
198
+ - 保存到:\`${designDocPath}\`
199
+
200
+ 读取完成后,重新调用 \`generate_requirements\` 工具`
201
+ });
182
202
  }
183
203
  }
184
-
185
- // 2.3 检查后端文档(如果有且未保存)
186
- let backendSourceInfo = "";
187
- if (params.backendSource) {
188
- const savedBackend = await tryReadSavedBackend(params.featureName, projectRoot);
204
+
205
+ // 检查后端文档
206
+ if (params.backendSource && !savedBackend) {
207
+ debugLog(`后端文档未找到,需要处理`);
208
+ const backendResult = await processRequirementDocument(
209
+ params.backendSource,
210
+ params.featureName,
211
+ "backend-doc.md"
212
+ );
189
213
 
190
- if (!savedBackend) {
191
- debugLog(`后端文档未保存,需要处理`);
192
- const backendProjectRoot = params.backendSource.type === "file"
193
- ? getProjectRoot(params.backendSource.path!)
194
- : projectRoot;
195
- debugLog(`后端文档项目根目录`, { backendProjectRoot });
196
-
197
- const backendResult = await processRequirementDocument(
198
- params.backendSource,
199
- params.featureName,
200
- "backend-doc.md"
201
- );
202
-
203
- if (!backendResult.success) {
204
- debugLog(`后端文档需要进一步处理`, { backendResult });
205
- return {
206
- success: false,
207
- message: backendResult.message!,
208
- needsAction: backendResult.needsAction,
209
- };
210
- }
211
- debugLog(`后端文档已保存`);
212
- backendSourceInfo = `**后端文档位置**:${buildOutputPath(params.featureName, "backend-doc.md", backendProjectRoot)}\n`;
214
+ if (!backendResult.success) {
215
+ debugLog(`后端文档需要进一步处理`, { backendResult });
216
+ tasks.push({
217
+ name: "后端文档",
218
+ outputPath: backendDocPath!,
219
+ source: params.backendSource,
220
+ status: "needs_processing",
221
+ processingInstruction: backendResult.message!
222
+ });
213
223
  } else {
214
- debugLog(`后端文档已存在`);
215
- backendSourceInfo = `**后端文档位置**:${buildOutputPath(params.featureName, "backend-doc.md", projectRoot)}\n`;
224
+ debugLog(`后端文档已处理`);
216
225
  }
217
226
  }
227
+
228
+ // 如果有需要处理的任务,返回完整工作流
229
+ if (tasks.length > 0) {
230
+ debugLog(`发现 ${tasks.length} 个需要处理的任务`);
231
+
232
+ let message = `📋 需要处理以下文档(共 ${tasks.length} 个)\n\n`;
233
+
234
+ tasks.forEach((task, index) => {
235
+ message += `### 任务 ${index + 1}:${task.name}\n`;
236
+ message += task.processingInstruction;
237
+ message += `\n\n`;
238
+ });
239
+
240
+ message += `⚠️ **重要提示**:\n`;
241
+ message += `- 每个任务处理完成后,立即保存文件,**不要把文件内容放在上下文中**\n`;
242
+ message += `- 所有任务完成后,重新调用 \`generate_requirements\` 工具\n`;
243
+ message += `- 这样可以避免上下文过长,提高处理效率\n`;
244
+
245
+ return {
246
+ success: false,
247
+ message,
248
+ needsAction: {
249
+ type: "process_documents" as any,
250
+ instruction: `按顺序或并行处理上述 ${tasks.length} 个任务,每个任务完成后立即保存文件。所有任务完成后重新调用 generate_requirements 工具。`
251
+ }
252
+ };
253
+ }
254
+
255
+ // 所有文档都已准备好
256
+ debugLog(`所有文档已准备完毕`);
257
+
258
+ let designSourceInfo = "";
259
+ if (savedDesign) {
260
+ designSourceInfo = `**设计稿位置**:${designDocPath}\n`;
261
+ }
262
+
263
+ let backendSourceInfo = "";
264
+ if (savedBackend) {
265
+ backendSourceInfo = `**后端文档位置**:${backendDocPath}\n`;
266
+ }
218
267
 
219
268
  // 5. 生成分析提示词
220
269
  const outputPath = buildOutputPath(params.featureName, "requirements.md", projectRoot);
221
- const originDocPath = buildOutputPath(params.featureName, "origin-requirement.md", projectRoot);
222
270
  debugLog(`生成输出路径`, { outputPath, originDocPath, projectRoot });
223
271
 
224
272
  let message = "📝 需求文档已准备完毕\n\n";