实战型MCP工具PRD需求文档提示词

角色定义与任务定位
请以一名资深AI产品架构师兼技术文档工程师的身份，你的核心目标是：为计划开发或集成一个具体MCP（Model Context Protocol）工具的团队，撰写一份高度结构化、可立即指导开发的PRD（产品需求文档）。这份文档需清晰定义工具的功能边界、调用逻辑、输入输出规范及非功能性要求，旨在成为开发、测试与产品三方对齐的绝对依据。
适用场景

为新的MCP工具（如数据分析器、代码解释器、特定领域知识查询工具）撰写初始PRD。
对现有MCP工具的功能进行重大迭代或扩展时，更新需求文档。
向开发团队清晰传达一个复杂MCP工具调用的完整上下文、预期行为与约束条件。

核心提示词
（以下提示词可直接组合或单独使用，作为生成具体章节内容的指令）

文档头与概述：“生成一份MCP工具PRD的文档头，包含：产品名称、版本号、作者、日期。接着撰写项目概述，用一段话清晰说明本MCP工具要解决的核心用户痛点及其在AI智能体工作流中的价值定位。”
功能需求详述：“针对‘[请在此处填入具体工具功能，如：SQL查询生成器]’这一MCP工具，详细描述其核心功能。必须分点列出：1. 工具调用的触发指令或关键词；2. 工具所需的输入参数（名称、类型、格式、是否必填）及其示例；3. 工具成功执行后的标准输出格式（如JSON结构）及示例；4. 工具执行过程中可能遇到的错误类型及对应的错误信息返回格式。”
非功能需求：“定义本MCP工具的非功能性需求，包括：性能要求（如单次调用响应时间应低于2秒）、安全性要求（如对输入参数进行SQL注入过滤）、兼容性要求（如需兼容MCP协议特定版本）以及数据隐私处理声明。”
用户交互示例：“提供至少两个完整的端到端用户交互示例。格式为：用户请求（自然语言） -> AI智能体理解与工具调用决策 -> 向MCP工具发送的结构化请求 -> MCP工具返回的结构化响应 -> AI智能体向用户呈现的最终自然语言回复。”

风格方向

文体风格：采用客观、精准、无歧义的技术文档风格。避免营销性语言和模糊表述（如“快速”、“强大”）。
结构层次：文档需具备清晰的层级，使用编号标题（如1., 1.1, 1.1.1）来组织内容，确保逻辑递进。
术语使用：准确使用MCP生态相关术语（如“工具调用”、“模式”、“上下文”），并对首次出现的专业术语提供简短括号解释。

构图建议（信息组织框架）

采用经典的PRD金字塔结构：从顶层目标（愿景/目标）到具体功能，再到技术细节。
推荐章节顺序：1. 文档修订历史；2. 项目概述与目标；3. 用户角色与场景；4. 功能需求详情（按模块或优先级分节）；5. 非功能需求；6. 用户交互流程图与示例；7. 待确定问题与未来迭代方向；8. 附录（如数据字典、API接口详情）。
关键信息使用表格呈现，如参数列表、错误码表，以增强可读性。

细节强化

输入输出示例：所有参数和返回值都必须附带真实、可运行的示例值，而非仅描述类型。例如，输入参数“database_schema”的示例应为“`CREATE TABLE users (id INT, name VARCHAR(100));`”。
边界条件与异常：明确描述工具的处理边界。例如，“本工具仅支持生成SELECT查询，不处理数据修改（INSERT/UPDATE/DELETE）语句。”并详细说明各类异常（网络超时、输入格式错误、权限不足）的处理流程。
与AI智能体的协作点：明确指出哪些验证、过滤或格式化工作应由MCP工具完成，哪些应由调用它的AI智能体负责，界定责任边界。

使用建议

在使用核心提示词生成具体章节内容时，请将方括号“[]”内的占位符替换为您的具体工具信息。
首先生成“文档头与概述”和“功能需求详述”，这是PRD的骨架。然后利用“用户交互示例”来验证需求的完整性与合理性，并反过来补充功能细节。
“非功能需求”和“细节强化”部分应在功能主体完成后重点审视，这是文档从“可用”到“专业”的关键提升。
最终文档应允许开发工程师在不额外询问产品经理的情况下，理解并开始实现绝大多数功能点。