bmall-mcp 1.5.0 → 1.6.0

package/README.md

@@ -51,6 +51,7 @@ npx -y bmall-mcp
 | `mta_implementation` | 生成埋点管理类代码 | `生成埋点代码 34747` |
 | `mta_integration` | 埋点业务集成指导 | `集成埋点 34747` |
 | `analyze_appfreeze` | 鸿蒙AppFreeze分析 | `分析AppFreeze日志 /path/to/freeze.log` |
+| `generate_requirements` | 需求文档生成 | `生成需求文档` |
 
 ### 工具详情
 
@@ -139,6 +140,38 @@ npx -y bmall-mcp
 - 项目根目录下的 `harmonyos-appfreeze-guide.md` 包含完整的分析规则和典型案例
 </details>
 
+<details>
+<summary><b>generate_requirements</b> - 需求文档生成</summary>
+
+从产品 PRD 文档（支持 Markdown/PDF/网页）、可选的设计稿（Figma/文件）和后端文档（文件/网页）生成结构化的前端需求文档。
+
+**参数：**
+- `requirementSource`: 需求文档来源（必填）
+  - `type`: "file" | "url"
+  - `path`: 文件路径（.md/.pdf），type=file 时必填
+  - `url`: 网页 URL，type=url 时必填
+- `featureName`: 功能名称（必填），用于生成输出路径
+- `designSource`: 设计稿来源（可选）
+  - `type`: "figma" | "file"
+  - `url`: Figma 链接，type=figma 时必填
+  - `path`: 设计稿文件路径，type=file 时必填
+- `backendSource`: 后端文档来源（可选）
+  - `type`: "file" | "url"
+  - `path`: 后端文档路径（.md/.pdf），type=file 时必填
+  - `url`: 后端文档网页 URL，type=url 时必填
+
+**输出文档结构：**
+1. 介绍：功能概述、核心价值、涉及范围、核心指标、术语表
+2. 功能需求：用户故事 + 验收标准（3-6 条）
+3. 交互细节：视觉反馈、动画效果、错误处理、确认弹窗
+4. 技术要求与限制：性能需求、可用性需求、兼容性需求、限制说明
+
+**核心约束：**
+- 从用户视角描述功能，避免技术细节
+- 必须覆盖 10 个前端开发重点
+- 验收标准必须可测试、具体明确
+</details>
+
 ## 项目架构
 
 ```
@@ -171,6 +204,15 @@ src/
 
 ## Changelog
 
+### v1.6.0 (2026-03-16)
+- ✅ 优化 `generate_requirements` 工具 Prompt 模板
+- ✅ 新增设计稿支持（Figma 链接和本地文件）
+- ✅ 新增后端文档支持（文件和网页 URL）
+- ✅ 完善输出文档结构（4 个章节：介绍、功能需求、交互细节、技术要求与限制）
+- ✅ 强化核心约束：用户视角、10 个前端开发重点、可测试的验收标准
+- ✅ 支持多输入源：PRD + 设计稿 + 后端文档组合生成
+- ✅ 更新使用文档：新增完整流程示例和最佳实践
+
 ### v1.5.0 (2026-02-12)
 - ✅ 新增 `generate_requirements` 工具：从需求文档生成结构化的 requirements.md
 - ✅ 支持 Markdown、PDF、网页 URL 三种输入格式

package/dist/server/tools.d.ts

@@ -28,6 +28,8 @@ export declare const toolDefinitions: ({
             outputPath?: undefined;
             requirementSource?: undefined;
             featureName?: undefined;
+            designSource?: undefined;
+            backendSource?: undefined;
         };
         required?: undefined;
     };
@@ -61,6 +63,8 @@ export declare const toolDefinitions: ({
             outputPath?: undefined;
             requirementSource?: undefined;
             featureName?: undefined;
+            designSource?: undefined;
+            backendSource?: undefined;
         };
         required?: undefined;
     };
@@ -86,6 +90,8 @@ export declare const toolDefinitions: ({
             outputPath?: undefined;
             requirementSource?: undefined;
             featureName?: undefined;
+            designSource?: undefined;
+            backendSource?: undefined;
         };
         required?: undefined;
     };
@@ -115,6 +121,8 @@ export declare const toolDefinitions: ({
             outputPath?: undefined;
             requirementSource?: undefined;
             featureName?: undefined;
+            designSource?: undefined;
+            backendSource?: undefined;
         };
         required: string[];
     };
@@ -143,6 +151,8 @@ export declare const toolDefinitions: ({
             outputPath?: undefined;
             requirementSource?: undefined;
             featureName?: undefined;
+            designSource?: undefined;
+            backendSource?: undefined;
         };
         required: string[];
     };
@@ -171,6 +181,8 @@ export declare const toolDefinitions: ({
             outputPath?: undefined;
             requirementSource?: undefined;
             featureName?: undefined;
+            designSource?: undefined;
+            backendSource?: undefined;
         };
         required: string[];
     };
@@ -199,6 +211,8 @@ export declare const toolDefinitions: ({
             businessCodePath?: undefined;
             requirementSource?: undefined;
             featureName?: undefined;
+            designSource?: undefined;
+            backendSource?: undefined;
         };
         required: string[];
     };
@@ -232,6 +246,44 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
+            designSource: {
+                type: string;
+                description: string;
+                properties: {
+                    type: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    url: {
+                        type: string;
+                        description: string;
+                    };
+                    path: {
+                        type: string;
+                        description: string;
+                    };
+                };
+            };
+            backendSource: {
+                type: string;
+                description: string;
+                properties: {
+                    type: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    path: {
+                        type: string;
+                        description: string;
+                    };
+                    url: {
+                        type: string;
+                        description: string;
+                    };
+                };
+            };
             ide?: undefined;
             rulesType?: undefined;
             message?: undefined;

package/dist/server/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/server/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmK3B,CAAC"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/server/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyM3B,CAAC"}

package/dist/server/tools.js

@@ -132,7 +132,7 @@ export const toolDefinitions = [
     },
     {
         name: "generate_requirements",
-        description: "需求文档生成：从需求文档（PRD/文件/网页）生成结构化的 requirements.md。输出路径固定为 .specs/requirements/{featureName}/requirements.md。触发词：生成需求文档、需求分析、requirements",
+        description: "需求文档生成：从需求文档（PRD/文件/网页）和可选的设计稿、后端文档生成结构化的 requirements.md。输出路径固定为 .specs/requirements/{featureName}/requirements.md。触发词：生成需求文档、需求分析、requirements",
         inputSchema: {
             type: "object",
             properties: {
@@ -160,6 +160,44 @@ export const toolDefinitions = [
                     type: "string",
                     description: "功能名称（必填），用于生成输出路径 .specs/requirements/{featureName}/requirements.md",
                 },
+                designSource: {
+                    type: "object",
+                    description: "设计稿来源（可选，支持 Figma 或文件）",
+                    properties: {
+                        type: {
+                            type: "string",
+                            enum: ["figma", "file"],
+                            description: "设计稿类型",
+                        },
+                        url: {
+                            type: "string",
+                            description: "Figma 链接，当 type 为 figma 时必填",
+                        },
+                        path: {
+                            type: "string",
+                            description: "设计稿文件路径，当 type 为 file 时必填",
+                        },
+                    },
+                },
+                backendSource: {
+                    type: "object",
+                    description: "后端文档来源（可选，支持文件或网页）",
+                    properties: {
+                        type: {
+                            type: "string",
+                            enum: ["file", "url"],
+                            description: "文件或网页",
+                        },
+                        path: {
+                            type: "string",
+                            description: "文件路径（.md/.pdf），当 type 为 file 时必填",
+                        },
+                        url: {
+                            type: "string",
+                            description: "网页 URL，当 type 为 url 时必填",
+                        },
+                    },
+                },
             },
             required: ["requirementSource", "featureName"],
         },

package/dist/server/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/server/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/server/tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/requirements/index.d.ts

@@ -6,6 +6,16 @@ interface RequirementSource {
 interface GenerateRequirementsParams {
     requirementSource: RequirementSource;
     featureName: string;
+    designSource?: {
+        type: "figma" | "file";
+        url?: string;
+        path?: string;
+    };
+    backendSource?: {
+        type: "file" | "url";
+        path?: string;
+        url?: string;
+    };
 }
 export declare function generateRequirements(params: GenerateRequirementsParams): Promise<{
     success: boolean;

package/dist/tools/requirements/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/requirements/index.ts"],"names":[],"mappings":"AAMA,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;CACrB;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,CAyDD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/requirements/index.ts"],"names":[],"mappings":"AAMA,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,CAiGD"}

package/dist/tools/requirements/index.js

@@ -42,19 +42,53 @@ export async function generateRequirements(params) {
             }
             // 2.2.2 需求文档已读取并保存（Markdown 文件）
         }
-        // 3. 生成分析提示词
+        // 3. 检查设计稿
+        let designSourceInfo = "";
+        if (params.designSource) {
+            if (params.designSource.type === "figma") {
+                designSourceInfo = `**设计稿链接**：${params.designSource.url || "Figma 链接未提供"}\n`;
+            }
+            else if (params.designSource.type === "file") {
+                designSourceInfo = `**设计稿文件**：${params.designSource.path || "设计稿路径未提供"}\n`;
+            }
+        }
+        // 4. 处理后端文档
+        let backendSourceInfo = "";
+        if (params.backendSource) {
+            const backendResult = await processRequirementDocument(params.backendSource, params.featureName, "backend-doc.md");
+            if (!backendResult.success) {
+                return {
+                    success: false,
+                    message: backendResult.message,
+                    needsAction: backendResult.needsAction,
+                };
+            }
+            if (params.backendSource.type === "file") {
+                backendSourceInfo = `**后端文档位置**：.specs/requirements/${params.featureName}/backend-doc.md\n`;
+            }
+            else if (params.backendSource.type === "url") {
+                backendSourceInfo = `**后端文档位置**：.specs/requirements/${params.featureName}/backend-doc.md\n`;
+            }
+        }
+        // 5. 生成分析提示词
         const outputPath = `.specs/requirements/${params.featureName}/requirements.md`;
         const originDocPath = `.specs/requirements/${params.featureName}/origin-requirement.md`;
         let message = "📝 需求文档已准备完毕\n\n";
         message += `**原始文档位置**：${originDocPath}\n`;
+        if (designSourceInfo) {
+            message += designSourceInfo;
+        }
+        if (backendSourceInfo) {
+            message += backendSourceInfo;
+        }
         message += `**目标输出位置**：${outputPath}\n\n`;
-        message += buildAnalysisPrompt(originDocPath, outputPath);
+        message += buildAnalysisPrompt(originDocPath, outputPath, params.designSource, params.backendSource);
         return {
             success: false,
             message,
             needsAction: {
                 type: "analyze_content",
-                instruction: `分析 ${originDocPath}，生成 ${outputPath}`,
+                instruction: `分析 ${originDocPath}${params.designSource ? "、设计稿" : ""}${params.backendSource ? "、后端文档" : ""}，生成 ${outputPath}`,
             },
         };
     }
@@ -65,42 +99,155 @@ export async function generateRequirements(params) {
         throw new McpError(-32603, `生成需求文档失败: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
-function buildAnalysisPrompt(originDocPath, outputPath) {
-    let prompt = `# 需求分析任务
+function buildAnalysisPrompt(originDocPath, outputPath, designSource, backendSource) {
+    const featureName = outputPath.split('/')[2];
+    let prompt = `# 产品 PRD 转需求文档
+
+## 角色定义
+
+你是一位资深的前端需求分析专家，擅长从产品 PRD 中提取并转化为前端开发可执行的需求文档。
+
+## 任务目标
 
-## 📄 输入材料
+根据产品 PRD 文档${designSource ? "、设计稿" : ""}${backendSource ? "和后端文档" : ""}，生成一份高质量的需求文档，确保前端开发人员能够清晰理解用户需求，准确实现功能。
 
-**原始需求文档**：\`${originDocPath}\`
+## 输入材料
 
-## 📝 输出要求
+1. **产品 PRD 文档**：\`${originDocPath}\`（包含项目背景、功能列表、系统流程、详细说明等）
+2. **设计稿**：${designSource ? `已提供${designSource.type === "figma" ? "Figma 链接，使用 MCP 工具读取" : "设计稿文件"}：${designSource.url || designSource.path}` : "未提供（如有设计稿，请使用 Figma MCP 工具读取）"}
+3. **后端文档**：${backendSource ? `已提供${backendSource.type === "url" ? "网页 URL" : "文件"}：.specs/requirements/${featureName}/backend-doc.md（包含接口定义、数据结构、后端逻辑等，可作为生成验收标准的参考）` : "未提供（如有后端文档，可作为生成验收标准的参考）"}
 
-分析原始需求文档，生成结构化的 requirements.md 到：\`${outputPath}\`
+## 输出要求
 
 ### 文档结构
 
-- **Introduction**：功能概述（目的、价值、范围）
-- **Glossary**：术语表（System、User、关键术语）
-- **Requirements**：需求列表（User Story + Acceptance Criteria）
+必须包含以下章节：
+
+#### 1. 介绍
+- **功能概述**：一句话说明功能是什么、解决什么问题
+- **核心价值**：为什么要做这个功能（用户体验、转化率、营销能力等）
+- **涉及范围**：
+  - 业务场景范围
+  - 平台支持范围
+  - 排除范围
+- **核心指标**：衡量成功的关键指标
+- **术语表**：关键术语定义，避免歧义
+
+#### 2. 功能需求
+每个需求必须包含：
+- **用户故事**：作为角色，我希望功能，以便价值
+- **验收标准**：WHEN 触发条件 THEN 预期行为（至少 3-6 条）
+- **说明**：补充必要的细节（不涉及技术实现）
+
+#### 3. 交互细节
+- **视觉反馈**：选中、不可用、加载、错误的视觉表现
+- **动画效果**：展开/收起、弹出、跳转的动画时长和方式
+- **错误处理**：各种错误场景的用户提示和处理方式
+- **确认弹窗**：需要用户确认的场景和确认内容
+
+#### 4. 技术要求与限制
+- **性能需求**：响应时间、加载速度、动画流畅度
+- **可用性需求**：状态清晰性、错误提示友好性、操作便捷性
+- **兼容性需求**：支持的系统版本、设备类型、浏览器要求
+- **限制说明**：不支持的场景、已知的兼容性问题、特殊边界情况
+
+### 内容要求
+
+#### 必须包含的关键内容
+
+**1. 功能范围**
+- 业务场景、平台范围、排除范围
+
+**2. 页面结构**
+- 页面/模块布局、组件层级关系
+
+**3. 数据展示**
+- 数据来源（用"由系统返回"替代接口名）
+- 数据展示规则
+- 空数据/加载/错误状态的表现
+
+**4. 交互逻辑**
+- 操作入口、触发条件、即时反馈、结果处理
+
+**5. 状态管理**
+- 状态触发条件、转换逻辑、数据保持/重置
+
+**6. 页面跳转**
+- 跳转触发、目标页面、参数传递（只说明内容，不涉及字段）、返回逻辑
+
+**7. 跨系统交互**
+- 交互触发、返回处理、结果查询和展示
+
+**8. 异常处理**
+- 异常场景、提示方式、恢复机制
+
+**9. 交互细节**
+- 视觉反馈（选中/不可用等）
+- 动画效果（展开/收起/弹出等）
+- 确认弹窗
+
+**10. 性能要求**
+- 加载速度、响应时间、动画流畅度
+
+#### 视角要求
+
+**从用户视角描述**
+- ✅ 描述"用户能看到什么"、"用户能做什么"、"操作后有什么反馈"
+
+**避免技术细节**
+- ❌ 不要描述"轮询 5 次"、"骨架屏 vs 局部加载"、"调用 XXX 接口"、"使用 XXX SDK"
+- ✅ 用"查询超时"、"加载状态"、"由系统返回"替代
+
+#### 格式化要求
+- 用户故事：作为[角色]，我希望[功能]，以便[价值]
+- 验收标准：WHEN [触发条件] THEN THE System SHALL [预期行为]
+- 验收标准必须可测试：使用具体的时间、数量、状态，避免"快速响应"等模糊描述
+
+### 格式要求
+
+#### 用户故事格式
+\`\`\`
+**用户故事**：作为[角色]，我希望[功能]，以便[价值]。
+\`\`\`
+
+#### 验收标准格式
+\`\`\`
+#### 验收标准
+
+1. WHEN [触发条件] THEN THE System SHALL [预期行为]
+2. WHEN [触发条件] THEN THE System SHALL [预期行为]
+3. WHEN [触发条件] THEN THE System SHALL [预期行为]
+...
+\`\`\`
+
+#### 可测试性要求
+- 每个验收标准必须可测试、可验证
+- 避免模糊的描述（如"快速响应"）
+- 使用具体的时间、数量、状态描述
 
-### 格式规范
+## 核心约束
 
-**User Story**：作为[角色]，我希望[功能]，以便[价值]
+### 1. 内容完整性
+- 必须包含所有 4 个章节（介绍、功能需求、交互细节、技术要求与限制）
+- 每个功能需求必须有用户故事和 3-6 条验收标准
+- 必须覆盖 10 个前端开发重点
 
-**Acceptance Criteria**：WHEN [触发条件] THEN THE System SHALL [系统行为]
+### 2. 视角正确性
+- 从用户视角描述功能
+- 不涉及技术实现细节（接口、SDK、轮询机制等）
+- 用"由系统返回"、"加载状态"、"查询超时"替代技术术语
 
-### 关键原则
+### 3. 内容独立性
+- 不要生成接口文档（放在设计文档）
+- 不要生成数据模型（放在设计文档）
+- 不要生成技术架构（放在设计文档）
+- 不要生成代码示例（放在开发阶段）
 
-- 描述"做什么"（What），不涉及"怎么做"（How）
-- System 代表整个系统（前后端整体）
-- 覆盖所有功能点、用户场景、异常情况
-- Acceptance Criteria 必须可测试、具体明确
-- 每个需求 3-6 条验收标准
+## 开始执行
 
-### 处理不明确的内容
+请按照以上要求，从输入的 PRD ${designSource ? "和设计稿" : ""} 中提取信息，生成完整的需求文档到：\`${outputPath}\`
 
-- 如果原始文档中有不清晰、模糊、矛盾的地方，**必须先询问用户澄清**
-- 不要凭空猜测或假设需求
-- 列出具体的疑问点，等待用户确认后再生成文档
+生成过程中，如果遇到不明确的内容，必须向用户确认，不要假设答案。
 `;
     return prompt;
 }

package/dist/tools/requirements/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/requirements/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AAapC;;GAEG;AACH,SAAS,sBAAsB,CAC7B,MAAkC;IAYlC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,yLAAyL;gBAClM,WAAW,EAAE;oBACX,IAAI,EAAE,iBAAiB;oBACvB,WAAW,EAAE,4EAA4E;iBAC1F;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAkC;IASlC,IAAI,CAAC;QACH,YAAY;QACZ,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,UAAU,CAAC,KAAM,CAAC;QAC3B,CAAC;QAED,cAAc;QAEd,6CAA6C;QAC7C,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACvE,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,oBAAoB;YACpB,MAAM,iBAAiB,GAAG,MAAM,0BAA0B,CACxD,MAAM,CAAC,iBAAiB,EACxB,MAAM,CAAC,WAAW,CACnB,CAAC;YAEF,iCAAiC;YACjC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;gBAC/B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,iBAAiB,CAAC,OAAQ;oBACnC,WAAW,EAAE,iBAAiB,CAAC,WAAW;iBAC3C,CAAC;YACJ,CAAC;YAED,gCAAgC;QAClC,CAAC;QAED,aAAa;QACb,MAAM,UAAU,GAAG,uBAAuB,MAAM,CAAC,WAAW,kBAAkB,CAAC;QAC/E,MAAM,aAAa,GAAG,uBAAuB,MAAM,CAAC,WAAW,wBAAwB,CAAC;QAExF,IAAI,OAAO,GAAG,kBAAkB,CAAC;QACjC,OAAO,IAAI,cAAc,aAAa,IAAI,CAAC;QAC3C,OAAO,IAAI,cAAc,UAAU,MAAM,CAAC;QAC1C,OAAO,IAAI,mBAAmB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAE1D,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO;YACP,WAAW,EAAE;gBACX,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,MAAM,aAAa,OAAO,UAAU,EAAE;aACpD;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,CAAC,KAAK,EACN,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC1B,aAAqB,EACrB,UAAkB;IAElB,IAAI,MAAM,GAAG;;;;eAIA,aAAa;;;;sCAIU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B/C,CAAC;IAEA,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/requirements/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/requirements/requirement-processor.d.ts

@@ -12,11 +12,16 @@ interface ProcessResult {
         instruction: string;
     };
 }
+interface RequirementSource {
+    type: "file" | "url";
+    path?: string;
+    url?: string;
+}
 /**
  * 步骤 2：处理需求文档输入
  * 这是整体流程的第二步，专门处理需求文档
  */
-export declare function processRequirementDocument(requirementSource: RequirementSource | undefined, featureName: string): Promise<ProcessResult>;
+export declare function processRequirementDocument(requirementSource: RequirementSource | undefined, featureName: string, outputFileName?: string): Promise<ProcessResult>;
 /**
  * 尝试读取已保存的需求文档
  * 如果用户之前已经按照指令保存了文件，优先使用已保存的内容

package/dist/tools/requirements/requirement-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requirement-processor.d.ts","sourceRoot":"","sources":["../../../src/tools/requirements/requirement-processor.ts"],"names":[],"mappings":"AAGA,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,iBAAiB,CAAC;QAClD,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,EAChD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CA4FxB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB"}
+{"version":3,"file":"requirement-processor.d.ts","sourceRoot":"","sources":["../../../src/tools/requirements/requirement-processor.ts"],"names":[],"mappings":"AAGA,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,iBAAiB,CAAC;QAClD,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,EAChD,WAAW,EAAE,MAAM,EACnB,cAAc,GAAE,MAAgC,GAC/C,OAAO,CAAC,aAAa,CAAC,CA4FxB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB"}

package/dist/tools/requirements/requirement-processor.js

@@ -4,7 +4,7 @@ import * as fs from "fs/promises";
  * 步骤 2：处理需求文档输入
  * 这是整体流程的第二步，专门处理需求文档
  */
-export async function processRequirementDocument(requirementSource, featureName) {
+export async function processRequirementDocument(requirementSource, featureName, outputFileName = "origin-requirement.md") {
     // 2.1 校验是否提供了需求文档
     if (!requirementSource) {
         return {
@@ -32,7 +32,7 @@ export async function processRequirementDocument(requirementSource, featureName)
         const ext = filePath.split(".").pop()?.toLowerCase();
         // 2.2.1 PDF 文件 - 返回读取指令
         if (ext === "pdf") {
-            const outputMdPath = `.specs/requirements/${featureName}/origin-requirement.md`;
+            const outputMdPath = `.specs/requirements/${featureName}/${outputFileName}`;
             return {
                 success: false,
                 message: `📄 检测到 PDF 文件
@@ -48,7 +48,7 @@ export async function processRequirementDocument(requirementSource, featureName)
         }
         // 2.2.2 Markdown 文件 - 保存到固定位置
         if (ext === "md" || ext === "markdown") {
-            const outputMdPath = `.specs/requirements/${featureName}/origin-requirement.md`;
+            const outputMdPath = `.specs/requirements/${featureName}/${outputFileName}`;
             // 读取 Markdown 内容
             const content = await fs.readFile(filePath, "utf-8");
             // 保存到固定位置
@@ -70,7 +70,7 @@ export async function processRequirementDocument(requirementSource, featureName)
         if (!url) {
             throw new McpError(-32602, "网页 URL 不能为空");
         }
-        const outputMdPath = `.specs/requirements/${featureName}/origin-requirement.md`;
+        const outputMdPath = `.specs/requirements/${featureName}/${outputFileName}`;
         return {
             success: false,
             message: `🌐 检测到网页 URL

package/dist/tools/requirements/requirement-processor.js.map

@@ -1 +1 @@
-{"version":3,"file":"requirement-processor.js","sourceRoot":"","sources":["../../../src/tools/requirements/requirement-processor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"requirement-processor.js","sourceRoot":"","sources":["../../../src/tools/requirements/requirement-processor.ts"],"names":[],"mappings":"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"}

package/docs/generate-requirements-usage.md

@@ -6,7 +6,7 @@
 
 ## 功能说明
 
-从需求文档（PRD/文件/网页）生成结构化的 requirements.md 文档。
+从产品 PRD 文档（支持 Markdown/PDF/网页）、可选的设计稿（Figma/文件）和后端文档（文件/网页）生成结构化的前端需求文档。
 
 输出路径固定为：`.specs/requirements/{featureName}/requirements.md`
 
@@ -16,16 +16,26 @@
 
 工具负责：
 1. 统一保存原始文档到固定位置（origin-requirement.md）
-2. 提供分析提示词（告诉 AI 如何生成 requirements.md）
+2. 提供专业的前端需求分析提示词（指导 AI 如何生成 requirements.md）
 
 AI 负责：
 1. 读取原始文档
-2. 分析内容
-3. 生成 requirements.md
+2. 如有设计稿，使用 Figma MCP 读取设计稿内容
+3. 如有后端文档，读取后端文档作为生成验收标准的参考
+4. 按照前端需求分析标准，生成高质量的需求文档
+
+## 输出文档结构
+
+生成的 `requirements.md` 包含以下 4 个章节：
+
+1. **介绍**：功能概述、核心价值、涉及范围、核心指标、术语表
+2. **功能需求**：用户故事 + 验收标准（每个需求 3-6 条）
+3. **交互细节**：视觉反馈、动画效果、错误处理、确认弹窗
+4. **技术要求与限制**：性能需求、可用性需求、兼容性需求、限制说明
 
 ## 使用流程
 
-### 流程 1：Markdown 文件（最简单）
+### 流程 1：Markdown 文件 + Figma 设计稿 + 后端文档（完整流程）
 
 **调用**：
 ```json
@@ -34,7 +44,15 @@ AI 负责：
     "type": "file",
     "path": "prd.md"
   },
-  "featureName": "voice-recording"
+  "featureName": "voice-recording",
+  "designSource": {
+    "type": "figma",
+    "url": "https://figma.com/design/xxx/xxx?node-id=1-2"
+  },
+  "backendSource": {
+    "type": "file",
+    "path": "backend-api.md"
+  }
 }
 ```
 
@@ -43,20 +61,102 @@ AI 负责：
 📝 需求文档已准备完毕
 
 **原始文档位置**：.specs/requirements/voice-recording/origin-requirement.md
+**设计稿链接**：https://figma.com/design/xxx/xxx?node-id=1-2
+**后端文档位置**：.specs/requirements/voice-recording/backend-doc.md
 **目标输出位置**：.specs/requirements/voice-recording/requirements.md
 
-# 需求分析任务
-...（分析提示词）
+# 产品 PRD 转需求文档
+...（前端需求分析提示词）
+```
+
+**AI 执行**：
+1. 读取 `.specs/requirements/voice-recording/origin-requirement.md`
+2. 使用 Figma MCP 工具读取设计稿
+3. 读取 `.specs/requirements/voice-recording/backend-doc.md` 作为生成验收标准的参考
+4. 按照 4 章节结构分析内容
+5. 生成 `.specs/requirements/voice-recording/requirements.md`
+
+---
+
+---
+
+### 流程 2：Markdown 文件 + Figma 设计稿（推荐）
+
+**调用**：
+```json
+{
+  "requirementSource": {
+    "type": "file",
+    "path": "prd.md"
+  },
+  "featureName": "voice-recording",
+  "designSource": {
+    "type": "figma",
+    "url": "https://figma.com/design/xxx/xxx?node-id=1-2"
+  }
+}
+```
+
+**返回**：同流程 1（无后端文档信息）
+
+**AI 执行**：
+1. 读取 `.specs/requirements/voice-recording/origin-requirement.md`
+2. 使用 Figma MCP 工具读取设计稿
+3. 按照 4 章节结构分析内容
+4. 生成 `.specs/requirements/voice-recording/requirements.md`
+
+---
+
+### 流程 3：Markdown 文件（无设计稿和后端文档）
+
+**调用**：
+```json
+{
+  "requirementSource": {
+    "type": "file",
+    "path": "prd.md"
+  },
+  "featureName": "voice-recording"
+}
 ```
 
+**返回**：同流程 1（无设计稿和后端文档信息）
+
 **AI 执行**：
 1. 读取 `.specs/requirements/voice-recording/origin-requirement.md`
-2. 分析内容
+2. 仅基于 PRD 生成需求文档
 3. 生成 `.specs/requirements/voice-recording/requirements.md`
 
 ---
 
-### 流程 2：PDF 文件
+### 流程 4：Markdown 文件 + 后端文档（无设计稿）
+
+**调用**：
+```json
+{
+  "requirementSource": {
+    "type": "file",
+    "path": "prd.md"
+  },
+  "featureName": "voice-recording",
+  "backendSource": {
+    "type": "file",
+    "path": "backend-api.md"
+  }
+}
+```
+
+**返回**：同流程 1（无设计稿信息）
+
+**AI 执行**：
+1. 读取 `.specs/requirements/voice-recording/origin-requirement.md`
+2. 读取 `.specs/requirements/voice-recording/backend-doc.md` 作为生成验收标准的参考
+3. 按照 4 章节结构分析内容
+4. 生成 `.specs/requirements/voice-recording/requirements.md`
+
+---
+
+### 流程 5：PDF 文件 + Figma 设计稿 + 后端文档
 
 **第 1 次调用**：
 ```json
@@ -65,7 +165,15 @@ AI 负责：
     "type": "file",
     "path": "prd.pdf"
   },
-  "featureName": "voice-recording"
+  "featureName": "voice-recording",
+  "designSource": {
+    "type": "figma",
+    "url": "https://figma.com/design/xxx/xxx?node-id=1-2"
+  },
+  "backendSource": {
+    "type": "file",
+    "path": "backend-api.md"
+  }
 }
 ```
 
@@ -90,7 +198,15 @@ AI 负责：
     "type": "file",
     "path": "prd.pdf"
   },
-  "featureName": "voice-recording"
+  "featureName": "voice-recording",
+  "designSource": {
+    "type": "figma",
+    "url": "https://figma.com/design/xxx/xxx?node-id=1-2"
+  },
+  "backendSource": {
+    "type": "file",
+    "path": "backend-api.md"
+  }
 }
 ```
 
@@ -98,7 +214,7 @@ AI 负责：
 
 ---
 
-### 流程 3：网页 URL
+### 流程 6：网页 URL + Figma 设计稿 + 后端文档
 
 **第 1 次调用**：
 ```json
@@ -107,7 +223,15 @@ AI 负责：
     "type": "url",
     "url": "https://wiki.jd.com/pages/viewpage.action?pageId=123456"
   },
-  "featureName": "voice-recording"
+  "featureName": "voice-recording",
+  "designSource": {
+    "type": "figma",
+    "url": "https://figma.com/design/xxx/xxx?node-id=1-2"
+  },
+  "backendSource": {
+    "type": "url",
+    "url": "https://wiki.jd.com/pages/viewpage.action?pageId=789012"
+  }
 }
 ```
 
@@ -121,11 +245,13 @@ AI 负责：
 ```
 
 **AI 执行**：
-1. 使用 Chrome DevTools MCP 读取网页
+1. 使用 Chrome DevTools MCP 读取 PRD 网页
 2. 保存到 `.specs/requirements/voice-recording/origin-requirement.md`
-3. 重新调用工具
+3. 使用 Chrome DevTools MCP 读取后端文档网页
+4. 保存到 `.specs/requirements/voice-recording/backend-doc.md`
+5. 重新调用工具
 
-**第 2 次调用**：同流程 2
+**第 2 次调用**：同流程 5
 
 ---
 
@@ -138,22 +264,61 @@ AI 负责：
 | `requirementSource.path` | string | - | 文件路径（type=file 时必填） |
 | `requirementSource.url` | string | - | 网页 URL（type=url 时必填） |
 | `featureName` | string | ✅ | 功能名称，用于生成输出路径 |
-
-## 输出格式
-
-生成的 `requirements.md` 包含：
-
-- **Introduction**：功能概述（目的、价值、范围）
-- **Glossary**：术语表（System、User 等术语定义）
-- **Requirements**：需求列表
-  - User Story：作为[角色]，我希望[功能]，以便[价值]
-  - Acceptance Criteria：WHEN [触发条件] THEN THE System SHALL [系统行为]
+| `designSource` | object | - | 设计稿来源（可选） |
+| `designSource.type` | string | - | "figma" 或 "file" |
+| `designSource.url` | string | - | Figma 链接（type=figma 时必填） |
+| `designSource.path` | string | - | 设计稿文件路径（type=file 时必填） |
+| `backendSource` | object | - | 后端文档来源（可选） |
+| `backendSource.type` | string | - | "file" 或 "url" |
+| `backendSource.path` | string | - | 后端文档路径（type=file 时必填） |
+| `backendSource.url` | string | - | 后端文档网页 URL（type=url 时必填） |
+
+## 输出文档要求
+
+### 文档结构（4 个章节）
+
+1. **介绍**
+   - 功能概述：一句话说明功能是什么、解决什么问题
+   - 核心价值：为什么要做这个功能
+   - 涉及范围：业务场景、平台支持、排除范围
+   - 核心指标：衡量成功的关键指标
+   - 术语表：关键术语定义
+
+2. **功能需求**
+   - 用户故事：作为[角色]，我希望[功能]，以便[价值]
+   - 验收标准：WHEN [触发条件] THEN THE System SHALL [预期行为]（3-6 条）
+   - 说明：补充必要的细节（不涉及技术实现）
+
+3. **交互细节**
+   - 视觉反馈：选中、不可用、加载、错误的视觉表现
+   - 动画效果：展开/收起、弹出、跳转的动画时长和方式
+   - 错误处理：各种错误场景的用户提示和处理方式
+   - 确认弹窗：需要用户确认的场景和确认内容
+
+4. **技术要求与限制**
+   - 性能需求：响应时间、加载速度、动画流畅度
+   - 可用性需求：状态清晰性、错误提示友好性、操作便捷性
+   - 兼容性需求：支持的系统版本、设备类型、浏览器要求
+   - 限制说明：不支持的场景、已知的兼容性问题、特殊边界情况
+
+### 核心约束
+
+#### 视角要求
+- ✅ 从用户视角描述："用户能看到什么"、"用户能做什么"
+- ❌ 不涉及技术实现细节（接口、SDK、轮询机制等）
+- ✅ 用"由系统返回"、"加载状态"、"查询超时"替代技术术语
+
+#### 内容要求
+- 必须覆盖 10 个前端开发重点：功能范围、页面结构、数据展示、交互逻辑、状态管理、页面跳转、跨系统交互、异常处理、交互细节、性能要求
+- 每个需求 3-6 条验收标准
+- 验收标准必须可测试、具体明确
 
 ## 文件路径
 
 所有文件统一保存在 `.specs/requirements/{featureName}/` 目录下：
 
 - `origin-requirement.md` - 原始需求文档（统一保存位置）
+- `backend-doc.md` - 后端文档（如提供，统一保存位置）
 - `requirements.md` - 最终生成的需求文档
 
 ## 智能缓存
@@ -169,7 +334,18 @@ AI 负责：
 1. **featureName 必填**：用于生成文件路径
 2. **智能缓存**：重新调用时会自动读取已保存的文件
 3. **分步执行**：PDF/URL 需要先读取内容，再分析生成
-4. **AI 自主生成**：工具只提供指引，AI 自己完成分析和生成
+4. **设计稿集成**：提供 Figma 设计稿可生成更准确的需求文档
+5. **后端文档参考**：提供后端文档可以作为生成验收标准的参考，让需求更贴合实际接口
+6. **AI 自主生成**：工具只提供专业的前端需求分析提示词，AI 自己完成分析和生成
+
+## 最佳实践
+
+1. **推荐提供设计稿**：Figma 设计稿可以提供更准确的交互细节和视觉反馈信息
+2. **提供后端文档**：后端文档包含接口定义、数据结构等，可帮助生成更准确的验收标准
+3. **确保 PRD 完整性**：PRD 应包含项目背景、功能列表、系统流程、详细说明
+4. **明确功能范围**：在生成需求文档时，明确业务场景、平台支持、排除范围
+5. **验收标准可测试**：每条验收标准都应该能够被明确验证
+6. **及时澄清疑问**：如果 PRD 中有不清晰、模糊、矛盾的地方，必须先向用户确认
 
 ## 触发词
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmall-mcp",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "MCP Server for bmall development rules and tools",
   "type": "module",
   "main": "dist/index.js",
@@ -28,4 +28,4 @@
     "typescript": "^5.0.0",
     "ts-node": "^10.9.0"
   }
-}
+}

package/src/server/tools.ts

@@ -133,7 +133,7 @@ export const toolDefinitions = [
   },
   {
     name: "generate_requirements",
-    description: "需求文档生成：从需求文档（PRD/文件/网页）生成结构化的 requirements.md。输出路径固定为 .specs/requirements/{featureName}/requirements.md。触发词：生成需求文档、需求分析、requirements",
+    description: "需求文档生成：从需求文档（PRD/文件/网页）和可选的设计稿、后端文档生成结构化的 requirements.md。输出路径固定为 .specs/requirements/{featureName}/requirements.md。触发词：生成需求文档、需求分析、requirements",
     inputSchema: {
       type: "object",
       properties: {
@@ -161,6 +161,44 @@ export const toolDefinitions = [
           type: "string",
           description: "功能名称（必填），用于生成输出路径 .specs/requirements/{featureName}/requirements.md",
         },
+        designSource: {
+          type: "object",
+          description: "设计稿来源（可选，支持 Figma 或文件）",
+          properties: {
+            type: {
+              type: "string",
+              enum: ["figma", "file"],
+              description: "设计稿类型",
+            },
+            url: {
+              type: "string",
+              description: "Figma 链接，当 type 为 figma 时必填",
+            },
+            path: {
+              type: "string",
+              description: "设计稿文件路径，当 type 为 file 时必填",
+            },
+          },
+        },
+        backendSource: {
+          type: "object",
+          description: "后端文档来源（可选，支持文件或网页）",
+          properties: {
+            type: {
+              type: "string",
+              enum: ["file", "url"],
+              description: "文件或网页",
+            },
+            path: {
+              type: "string",
+              description: "文件路径（.md/.pdf），当 type 为 file 时必填",
+            },
+            url: {
+              type: "string",
+              description: "网页 URL，当 type 为 url 时必填",
+            },
+          },
+        },
       },
       required: ["requirementSource", "featureName"],
     },

package/src/tools/requirements/index.ts

@@ -1,7 +1,7 @@
 import { McpError } from "@modelcontextprotocol/sdk/types.js";
-import { 
-  processRequirementDocument, 
-  tryReadSavedRequirement 
+import {
+  processRequirementDocument,
+  tryReadSavedRequirement
 } from "./requirement-processor.js";
 
 interface RequirementSource {
@@ -13,6 +13,16 @@ interface RequirementSource {
 interface GenerateRequirementsParams {
   requirementSource: RequirementSource;
   featureName: string;
+  designSource?: {
+    type: "figma" | "file";
+    url?: string;
+    path?: string;
+  };
+  backendSource?: {
+    type: "file" | "url";
+    path?: string;
+    url?: string;
+  };
 }
 
 /**
@@ -88,21 +98,61 @@ export async function generateRequirements(
       // 2.2.2 需求文档已读取并保存（Markdown 文件）
     }
 
-    // 3. 生成分析提示词
+    // 3. 检查设计稿
+    let designSourceInfo = "";
+    if (params.designSource) {
+      if (params.designSource.type === "figma") {
+        designSourceInfo = `**设计稿链接**：${params.designSource.url || "Figma 链接未提供"}\n`;
+      } else if (params.designSource.type === "file") {
+        designSourceInfo = `**设计稿文件**：${params.designSource.path || "设计稿路径未提供"}\n`;
+      }
+    }
+
+    // 4. 处理后端文档
+    let backendSourceInfo = "";
+    if (params.backendSource) {
+      const backendResult = await processRequirementDocument(
+        params.backendSource,
+        params.featureName,
+        "backend-doc.md"
+      );
+      
+      if (!backendResult.success) {
+        return {
+          success: false,
+          message: backendResult.message!,
+          needsAction: backendResult.needsAction,
+        };
+      }
+      
+      if (params.backendSource.type === "file") {
+        backendSourceInfo = `**后端文档位置**：.specs/requirements/${params.featureName}/backend-doc.md\n`;
+      } else if (params.backendSource.type === "url") {
+        backendSourceInfo = `**后端文档位置**：.specs/requirements/${params.featureName}/backend-doc.md\n`;
+      }
+    }
+
+    // 5. 生成分析提示词
     const outputPath = `.specs/requirements/${params.featureName}/requirements.md`;
     const originDocPath = `.specs/requirements/${params.featureName}/origin-requirement.md`;
-    
+
     let message = "📝 需求文档已准备完毕\n\n";
     message += `**原始文档位置**：${originDocPath}\n`;
+    if (designSourceInfo) {
+      message += designSourceInfo;
+    }
+    if (backendSourceInfo) {
+      message += backendSourceInfo;
+    }
     message += `**目标输出位置**：${outputPath}\n\n`;
-    message += buildAnalysisPrompt(originDocPath, outputPath);
+    message += buildAnalysisPrompt(originDocPath, outputPath, params.designSource, params.backendSource);
 
     return {
       success: false,
       message,
       needsAction: {
         type: "analyze_content",
-        instruction: `分析 ${originDocPath}，生成 ${outputPath}`,
+        instruction: `分析 ${originDocPath}${params.designSource ? "、设计稿" : ""}${params.backendSource ? "、后端文档" : ""}，生成 ${outputPath}`,
       },
     };
   } catch (error) {
@@ -118,43 +168,159 @@ export async function generateRequirements(
 
 function buildAnalysisPrompt(
   originDocPath: string,
-  outputPath: string
+  outputPath: string,
+  designSource?: { type: "figma" | "file"; url?: string; path?: string },
+  backendSource?: { type: "file" | "url"; path?: string; url?: string }
 ): string {
-  let prompt = `# 需求分析任务
+  const featureName = outputPath.split('/')[2];
+  
+  let prompt = `# 产品 PRD 转需求文档
+
+## 角色定义
 
-## 📄 输入材料
+你是一位资深的前端需求分析专家，擅长从产品 PRD 中提取并转化为前端开发可执行的需求文档。
 
-**原始需求文档**：\`${originDocPath}\`
+## 任务目标
 
-## 📝 输出要求
+根据产品 PRD 文档${designSource ? "、设计稿" : ""}${backendSource ? "和后端文档" : ""}，生成一份高质量的需求文档，确保前端开发人员能够清晰理解用户需求，准确实现功能。
 
-分析原始需求文档，生成结构化的 requirements.md 到：\`${outputPath}\`
+## 输入材料
+
+1. **产品 PRD 文档**：\`${originDocPath}\`（包含项目背景、功能列表、系统流程、详细说明等）
+2. **设计稿**：${designSource ? `已提供${designSource.type === "figma" ? "Figma 链接，使用 MCP 工具读取" : "设计稿文件"}：${designSource.url || designSource.path}` : "未提供（如有设计稿，请使用 Figma MCP 工具读取）" }
+3. **后端文档**：${backendSource ? `已提供${backendSource.type === "url" ? "网页 URL" : "文件"}：.specs/requirements/${featureName}/backend-doc.md（包含接口定义、数据结构、后端逻辑等，可作为生成验收标准的参考）` : "未提供（如有后端文档，可作为生成验收标准的参考）" }
+
+## 输出要求
 
 ### 文档结构
 
-- **Introduction**：功能概述（目的、价值、范围）
-- **Glossary**：术语表（System、User、关键术语）
-- **Requirements**：需求列表（User Story + Acceptance Criteria）
+必须包含以下章节：
+
+#### 1. 介绍
+- **功能概述**：一句话说明功能是什么、解决什么问题
+- **核心价值**：为什么要做这个功能（用户体验、转化率、营销能力等）
+- **涉及范围**：
+  - 业务场景范围
+  - 平台支持范围
+  - 排除范围
+- **核心指标**：衡量成功的关键指标
+- **术语表**：关键术语定义，避免歧义
+
+#### 2. 功能需求
+每个需求必须包含：
+- **用户故事**：作为角色，我希望功能，以便价值
+- **验收标准**：WHEN 触发条件 THEN 预期行为（至少 3-6 条）
+- **说明**：补充必要的细节（不涉及技术实现）
+
+#### 3. 交互细节
+- **视觉反馈**：选中、不可用、加载、错误的视觉表现
+- **动画效果**：展开/收起、弹出、跳转的动画时长和方式
+- **错误处理**：各种错误场景的用户提示和处理方式
+- **确认弹窗**：需要用户确认的场景和确认内容
+
+#### 4. 技术要求与限制
+- **性能需求**：响应时间、加载速度、动画流畅度
+- **可用性需求**：状态清晰性、错误提示友好性、操作便捷性
+- **兼容性需求**：支持的系统版本、设备类型、浏览器要求
+- **限制说明**：不支持的场景、已知的兼容性问题、特殊边界情况
+
+### 内容要求
+
+#### 必须包含的关键内容
+
+**1. 功能范围**
+- 业务场景、平台范围、排除范围
+
+**2. 页面结构**
+- 页面/模块布局、组件层级关系
+
+**3. 数据展示**
+- 数据来源（用"由系统返回"替代接口名）
+- 数据展示规则
+- 空数据/加载/错误状态的表现
+
+**4. 交互逻辑**
+- 操作入口、触发条件、即时反馈、结果处理
+
+**5. 状态管理**
+- 状态触发条件、转换逻辑、数据保持/重置
+
+**6. 页面跳转**
+- 跳转触发、目标页面、参数传递（只说明内容，不涉及字段）、返回逻辑
+
+**7. 跨系统交互**
+- 交互触发、返回处理、结果查询和展示
+
+**8. 异常处理**
+- 异常场景、提示方式、恢复机制
+
+**9. 交互细节**
+- 视觉反馈（选中/不可用等）
+- 动画效果（展开/收起/弹出等）
+- 确认弹窗
+
+**10. 性能要求**
+- 加载速度、响应时间、动画流畅度
+
+#### 视角要求
+
+**从用户视角描述**
+- ✅ 描述"用户能看到什么"、"用户能做什么"、"操作后有什么反馈"
+
+**避免技术细节**
+- ❌ 不要描述"轮询 5 次"、"骨架屏 vs 局部加载"、"调用 XXX 接口"、"使用 XXX SDK"
+- ✅ 用"查询超时"、"加载状态"、"由系统返回"替代
+
+#### 格式化要求
+- 用户故事：作为[角色]，我希望[功能]，以便[价值]
+- 验收标准：WHEN [触发条件] THEN THE System SHALL [预期行为]
+- 验收标准必须可测试：使用具体的时间、数量、状态，避免"快速响应"等模糊描述
+
+### 格式要求
+
+#### 用户故事格式
+\`\`\`
+**用户故事**：作为[角色]，我希望[功能]，以便[价值]。
+\`\`\`
+
+#### 验收标准格式
+\`\`\`
+#### 验收标准
+
+1. WHEN [触发条件] THEN THE System SHALL [预期行为]
+2. WHEN [触发条件] THEN THE System SHALL [预期行为]
+3. WHEN [触发条件] THEN THE System SHALL [预期行为]
+...
+\`\`\`
+
+#### 可测试性要求
+- 每个验收标准必须可测试、可验证
+- 避免模糊的描述（如"快速响应"）
+- 使用具体的时间、数量、状态描述
 
-### 格式规范
+## 核心约束
 
-**User Story**：作为[角色]，我希望[功能]，以便[价值]
+### 1. 内容完整性
+- 必须包含所有 4 个章节（介绍、功能需求、交互细节、技术要求与限制）
+- 每个功能需求必须有用户故事和 3-6 条验收标准
+- 必须覆盖 10 个前端开发重点
 
-**Acceptance Criteria**：WHEN [触发条件] THEN THE System SHALL [系统行为]
+### 2. 视角正确性
+- 从用户视角描述功能
+- 不涉及技术实现细节（接口、SDK、轮询机制等）
+- 用"由系统返回"、"加载状态"、"查询超时"替代技术术语
 
-### 关键原则
+### 3. 内容独立性
+- 不要生成接口文档（放在设计文档）
+- 不要生成数据模型（放在设计文档）
+- 不要生成技术架构（放在设计文档）
+- 不要生成代码示例（放在开发阶段）
 
-- 描述"做什么"（What），不涉及"怎么做"（How）
-- System 代表整个系统（前后端整体）
-- 覆盖所有功能点、用户场景、异常情况
-- Acceptance Criteria 必须可测试、具体明确
-- 每个需求 3-6 条验收标准
+## 开始执行
 
-### 处理不明确的内容
+请按照以上要求，从输入的 PRD ${designSource ? "和设计稿" : ""} 中提取信息，生成完整的需求文档到：\`${outputPath}\`
 
-- 如果原始文档中有不清晰、模糊、矛盾的地方，**必须先询问用户澄清**
-- 不要凭空猜测或假设需求
-- 列出具体的疑问点，等待用户确认后再生成文档
+生成过程中，如果遇到不明确的内容，必须向用户确认，不要假设答案。
 `;
 
   return prompt;

package/src/tools/requirements/requirement-processor.ts

@@ -17,13 +17,20 @@ interface ProcessResult {
   };
 }
 
+interface RequirementSource {
+  type: "file" | "url";
+  path?: string;
+  url?: string;
+}
+
 /**
  * 步骤 2：处理需求文档输入
  * 这是整体流程的第二步，专门处理需求文档
  */
 export async function processRequirementDocument(
   requirementSource: RequirementSource | undefined,
-  featureName: string
+  featureName: string,
+  outputFileName: string = "origin-requirement.md"
 ): Promise<ProcessResult> {
   // 2.1 校验是否提供了需求文档
   if (!requirementSource) {
@@ -55,7 +62,7 @@ export async function processRequirementDocument(
 
     // 2.2.1 PDF 文件 - 返回读取指令
     if (ext === "pdf") {
-      const outputMdPath = `.specs/requirements/${featureName}/origin-requirement.md`;
+      const outputMdPath = `.specs/requirements/${featureName}/${outputFileName}`;
       return {
         success: false,
         message: `📄 检测到 PDF 文件
@@ -72,7 +79,7 @@ export async function processRequirementDocument(
 
     // 2.2.2 Markdown 文件 - 保存到固定位置
     if (ext === "md" || ext === "markdown") {
-      const outputMdPath = `.specs/requirements/${featureName}/origin-requirement.md`;
+      const outputMdPath = `.specs/requirements/${featureName}/${outputFileName}`;
       
       // 读取 Markdown 内容
       const content = await fs.readFile(filePath, "utf-8");
@@ -100,7 +107,7 @@ export async function processRequirementDocument(
       throw new McpError(-32602, "网页 URL 不能为空");
     }
 
-    const outputMdPath = `.specs/requirements/${featureName}/origin-requirement.md`;
+    const outputMdPath = `.specs/requirements/${featureName}/${outputFileName}`;
     return {
       success: false,
       message: `🌐 检测到网页 URL