后端接口Prompt工程优化结果优化提示词

角色定义与任务定位

请以“后端架构师与Prompt工程师”的双重身份，运用此方案。你的核心目标是：将模糊、宽泛的后端开发需求，转化为结构清晰、约束明确、可被大语言模型（LLM）精准执行的指令，从而生成高质量、可落地的接口文档、代码、优化建议或问题排查方案。

适用场景

• 根据产品需求，生成或优化RESTful/gRPC API接口定义（含路径、方法、参数、响应体）。
• 为特定功能模块（如用户认证、订单支付、数据查询）编写符合框架规范（如Spring Boot, Django）的服务层代码。
• 对现有接口代码进行性能分析、逻辑重构或安全性加固的Prompt指令设计。
• 生成与接口配套的单元测试用例、API文档片段或数据库查询语句。
• 向LLM提问，以诊断接口超时、数据不一致等复杂技术问题。

核心提示词（可直接复制使用）

• 接口设计生成：“你是一位资深后端架构师。请为[一个在线商城的商品库存管理系统]设计一组RESTful API接口。要求包含：1. 资源定义（如Product, Inventory）；2. 每个资源的增删改查端点（URL、HTTP方法）；3. 请求/响应体的JSON结构（明确字段名、类型、是否必填）；4. 关键业务逻辑说明（如减库存时的并发控制）。请以Markdown表格形式输出。”
• 代码生成与优化：“优化以下Spring Boot控制器代码。优化目标：1. 添加输入参数验证（使用@Valid）；2. 提取业务逻辑至Service层；3. 增加详细的日志记录（使用SLF4J）；4. 统一全局异常处理响应格式。请先给出优化思路，再输出重构后的完整代码。原始代码：[粘贴代码片段]”
• 问题排查指令：“模拟一个高并发场景：用户抢购时，接口出现‘库存超卖’现象。请以系统诊断专家的身份，分步骤分析可能的原因（如数据库事务隔离级别、缓存一致性、锁机制等），并为每个原因提供具体的代码级或配置级解决方案。”

风格方向

• 结构化与模块化：提示词本身应分点、分层，明确步骤（如“第一步：定义边界；第二步：设计契约；第三步：考虑异常”）。
• 技术精准性：使用准确的技术术语（如“幂等性”、“DTO”、“连接池配置”），避免口语化模糊表达。
• 约束驱动：明确给出格式（JSON Schema, OpenAPI 3.0）、框架（Spring Cloud, Flask）、性能指标（QPS, P99延迟）等具体约束条件。

构图建议（思维框架）

• 金字塔结构：顶层明确角色与核心任务 -> 中层分解功能模块与接口 -> 底层填充字段细节与逻辑分支。
• 输入-处理-输出模型：在Prompt中清晰界定输入数据的结构和校验规则、核心处理逻辑的关键步骤、输出结果的标准格式和状态码。
• 异常流与正常流并重：要求模型不仅考虑成功路径，还需系统性地设计错误码、异常处理流程和回滚机制。

细节强化

• 数据层面：指定字段的精确命名规范（snake_case/camelCase）、枚举值列表、示例数据。
• 安全层面：提示考虑身份认证（JWT token）、权限校验（角色/权限点）、SQL注入防护、敏感信息脱敏。
• 性能层面：加入缓存策略（Redis键设计）、数据库索引建议、分页查询实现、异步处理等提示点。
• 可观测性：要求生成代码包含关键Metrics埋点、业务追踪ID（TraceId）传递、告警触发条件描述。

使用建议

• 迭代优化：将LLM的首次输出作为“初稿”，针对不满足的部分，用更精确的Prompt进行二次修正（例如：“将响应中的`data`字段改为泛型结构`Result`封装”）。
• 上下文管理：对于复杂任务，将对话拆分为多个回合。第一回合确定架构；第二回合基于架构生成具体代码。
• 结合知识库：在Prompt中引用或上传您团队的内部API设计规范、代码风格指南文档，让LLM基于特定标准生成。
• 提示词参数化：将核心变量如[系统名称]、[业务实体]、[技术栈]用占位符标出，方便批量替换复用。