MCP工具PRD写作高阶版提示词

角色定义

你应以资深产品经理或技术架构师的身份，面向AI Agent工具生态，为MCP（Model Context Protocol）类工具撰写一份完整、专业、可直接落地的高质量PRD。目标是通过清晰的角色设定，确保输出内容不仅覆盖功能需求，还能体现工具调用的协议细节、边界控制和优化空间，最终让开发团队与协作方无需额外解释即可直接执行。

适用场景

• 需要为新开发的MCP工具（如文件检索、API代理、数据库查询）撰写产品需求文档。
• 对已有MCP工具进行功能迭代或版本升级，需要统一各方理解。
• 在团队内部或跨团队协作中，希望快速生成符合行业标准的PRD模板。
• 面向AI模型微调或Agent能力评估时，需要清晰定义工具输入输出与调用约束。

核心提示词

以下提示词可直接复制用于生成任务（请替换方括号内内容）：

• “你是一位精通MCP协议与产品设计的专家。请以产品经理的身份，撰写一份MCP工具的PRD，工具名称：[工具名]，核心功能：[一句话描述]。要求包含：1）背景与目标；2）用户场景与价值；3）功能列表（含输入参数、输出格式、工具描述）；4）工具调用流程（含协议版本、身份验证、错误码规范）；5）非功能性需求（延迟、并发、安全）；6）验收标准。语言专业、结构清晰、每部分不少于3条要点。”
• “请基于以下标签生成PRD主体：MCP工具=文件检索助手，主要操作=根据关键词搜索本地文档，输出格式=JSON。需重点说明工具描述字段在manifest中的定义方式，以及参数校验策略。”
• “以技术负责人的视角，细化该MCP工具的调用示例。包含一次成功调用和一次边界错误调用的完整请求/响应体，并解释字段含义。”

风格方向

• 专业规范：采用行业标准术语（如tool definition、参数schema、error code），避免口语化表达。
• 结构化分层：按照“背景 - 需求 - 设计 - 实现 - 验证”的逻辑推进，每个层级使用编号或分点。
• 面向执行：每个功能点必须附带明确的输入输出定义，避免模糊描述。
• 协议优先：强调MCP协议中的关键字段（如tool name, inputSchema, outputType），确保文档可直接对接开发。

构图建议

• 整体框架图：建议按“PRD封面 - 修订记录 - 背景与目标 - 功能列表 - 调用流程 - 技术约束 - 验收标准”排列，每部分之间留白。
• 功能区块：每个工具功能使用表格或卡片式布局，左侧是需求描述，右侧是对应的协议字段映射（如toolDescription→description, properties→inputSchema）。
• 流程图辅助：在调用流程部分，用时间轴或步骤编号展示用户→Agent→MCP工具的完整交互链路，标注协议版本与超时时间。

细节强化

• 参数验证：明确标识参数类型、是否必填、默认值、枚举范围（例如 “language: string, enum:[zh,en], required:true”）。
• 错误处理：列出至少3种典型错误场景（如工具不存在、参数格式错误、超时），并给出对应的errorCode和用户提示。
• 安全边界：注明工具是否支持用户身份校验、数据脱敏策略、最大请求频率限制。
• 调用示例：提供完整的JSON请求体与响应体，包含Header、Body、Status字段，并注释每一行的作用。
• 版本兼容：如果工具依赖MCP协议版本（如v1.0或v2.0-beta），需在文档开头声明并列出差异点。

使用建议

• 将上述“核心提示词”直接作为初始指令发给AI生成工具（如Claude、GPT），并根据生结果逐步完善细节。
• 在生成过程中，可追加“请用中文表格展示功能清单”“请增加关于tool description的SEO友好说明”等细化指令。
• 如果目标读者包含非技术角色，建议在第一轮生成后添加一个“术语对照表”供同步。
• 定期将生成的PRD与MCP官方规范（https://modelcontextprotocol.io）对比，确保工具描述字段不遗漏。
• 对于复杂工具（如支持嵌套参数、链式调用），可在提示词中明确要求“采用OpenAPI 3.0风格的schema描述参数结构”。