实战型测试工程API文档生成提示词

角色定义与任务定位

请以资深测试架构师兼技术文档视觉化设计师的身份，执行本次内容生成任务。你的核心目标是：将复杂的API测试逻辑、接口规范与实战经验，转化为结构清晰、重点突出、易于理解与传播的视觉化文档或图示方案，直接服务于测试团队的知识沉淀、流程规范与新成员培训。

适用场景

• 为内部测试平台或项目编写API测试指南的配图与视觉化说明。
• 创建新API接口的测试用例设计思维导图或流程示意图。
• 生成用于团队技术分享的、关于API自动化测试框架的架构图解。
• 制作API安全测试、性能测试等专项测试的检查清单或步骤图。
• 为自动化测试脚本库生成统一、标准的接口调用示例图。

核心提示词

• 基础组合：professional API testing documentation, clear workflow diagram, modern tech style, flat design, with request/response examples, annotated with key parameters and assertions.
• 流程可视化：step-by-step testing pipeline for RESTful API, from test case design to execution and report, using swimlane diagram to show roles of developer, tester, and CI/CD system.
• 架构图解：architecture diagram of an automated API testing framework, including test client, mock server, database validation, and reporting module, in a clean isometric view.
• 数据示例：visual comparison of JSON request vs. response, highlighting status codes, error messages, and data structure validation points, on a dark-themed developer console.

风格方向

• 视觉风格：现代极简的科技感扁平化设计、单色系或低饱和度双色搭配（如蓝灰/绿灰）、清晰的线条与留白。
• 文档质感：模拟高清UI界面截图、干净的代码编辑器背景、或专业绘图工具输出的矢量图效果。
• 氛围基调：专业、严谨、清晰、具有逻辑性，避免过于娱乐化或抽象艺术化的表达。

构图建议

• 采用左侧流程/右侧详解的布局，左侧用数字编号展示测试步骤，右侧对应展示请求体、响应体或检查点。
• 对于架构图，使用等轴测（Isometric）或层级拓扑图，明确标注各组件名称与数据流向箭头。
• 特写关键部分，如HTTP状态码、认证头信息、异常返回报文，使用便签或高光框进行突出。
• 考虑加入虚拟人物角色（如测试工程师图标）在流程中的关键节点进行操作示意，增强叙事感。

细节强化

• 色彩提示：使用绿色表示“通过/PASS”，红色表示“失败/FAIL”，黄色表示“警告/警告”，蓝色表示“信息/步骤”。
• 材质与元素：轻微渐变和阴影提升卡片感，使用细分割线区分区块，添加微弱的网格线背景体现技术文档特性。
• 文字与标注：所有标注使用等宽字体（如Consolas, Monaco）模拟代码，说明文字使用无衬线字体（如SF Pro, Helvetica）。
• 扩展元素：可加入虚拟的终端窗口、Postman界面、JIRA任务卡、或简单的数据库表结构图作为环境衬托。

使用建议

• 将上述“核心提示词”与“风格方向”、“构图建议”中的描述词组合，作为图像生成AI的直接输入提示词。
• 在生成流程示意图时，提示词中应明确步骤数量（如“5 steps”）和关键动作（如“send request”, “validate schema”, “log result”）。
• 对于需要高度定制化的图表，可先生成基础框架，再使用图像编辑软件局部修改或添加文字说明。
• 本方案生成的图示，建议配套简短的文字说明，形成完整的“图例+解说”文档模块，直接嵌入Confluence、GitHub Wiki等平台。