高阶版MCP工具产品需求写作提示词

角色定义与任务定位

请以“资深MCP工具产品架构师”的身份，运用本提示词方案。你的核心目标是：为即将开发或集成的MCP（Model Context Protocol）工具，撰写一份结构完整、描述精确、可直接驱动开发与AI工具调用的高阶产品需求文档（PRD）。

适用场景

• 为新的MCP服务器（Server）或客户端（Client）工具撰写初始需求。
• 为现有MCP工具增加新的工具（Tools）或能力（Capabilities）。
• 定义复杂的多工具调用工作流与交互逻辑。
• 向开发团队清晰传达技术实现边界与AI交互规范。

核心提示词

以下提示词组合可直接用于生成需求草案或结构化内容：

• “作为MCP工具产品架构师，请为[工具名称，如：‘智能图表生成器’]撰写一份产品需求文档。重点描述：1. 工具的核心功能与解决的问题；2. 它需要暴露（expose）的MCP工具列表，每个工具的名称、输入参数（JSON Schema）、输出格式；3. 一个完整的端到端调用流程示例。”
• “请详细设计一个MCP工具调用流程，涉及[工具A]、[工具B]、[工具C]的链式或条件调用。包括：触发条件、数据流转路径、错误处理机制以及最终输出的结构化数据格式。”
• “定义以下MCP工具的元数据（metadata）：工具名称、描述、输入参数（要求使用严格的JSON Schema定义，包括类型、必填项、枚举值、示例）、输出说明。工具列表：[请在此列出工具名]。”

风格方向

• 技术严谨性：使用精确的技术术语（如“JSON-RPC 2.0”、“schema”、“stderr流”），避免模糊口语。
• 结构化表达：文档应层次分明，采用模块化标题（如概述、工具定义、流程、非功能性需求）。
• 目标导向：每项需求都应关联明确的用户价值或业务目标，说明“为什么”需要此功能。
• 可执行性：需求描述应足够具体，使开发者和AI都能无歧义地理解实现方式。

构图建议（文档结构）

• 顶层框架：采用“背景与目标 -> 工具详述 -> 调用流程图 -> 非功能性需求 -> 验收标准”的叙事逻辑。
• 核心模块聚焦：将“工具定义”部分作为视觉中心，用表格或清晰列表展示工具名、参数、示例。
• 流程可视化引导：用文字引导绘制序列图或流程图，描述用户指令、AI决策、工具调用、数据返回的完整闭环。

细节强化

• 参数定义：为每个输入参数提供详细的JSON Schema描述，包括`type`, `description`, `enum`（如有），并给出具体示例值。
• 错误处理：明确列出工具可能返回的错误码（error code）及含义，定义异常情况下的降级或重试策略。
• 性能与安全：补充非功能性需求，如超时设置、速率限制、输入数据验证、敏感信息处理建议。
• 版本与兼容性：注明初始版本号，并考虑向后兼容性策略。

使用建议

• 将“核心提示词”部分直接复制到你的AI协作平台（如Claude, ChatGPT等），作为生成需求初稿的指令。
• 在“细节强化”部分选取关键点，作为需求评审（Review）时的检查清单，确保文档的完备性。
• 根据实际项目阶段，可先聚焦于“工具定义”完成MVP（最小可行产品），再逐步完善“完整流程”和“非功能性需求”。
• 生成的文档应与MCP官方协议文档风格保持一致，便于开发者无缝对接。