后端接口Agent任务规划实战版提示词

角色定义与任务定位

请以「后端系统架构师」或「高级后端开发工程师」的身份，运用本提示词方案。你的核心目标是：将模糊的业务需求或产品构想，转化为一套结构严谨、职责明确、可被自动化Agent或开发团队直接理解与执行的后端接口开发与任务规划蓝图。

适用场景

• 为新业务模块设计后端API与异步任务的处理流程。
• 为现有系统重构或优化，规划清晰的接口职责与任务拆分。
• 编写可供AI Agent（如AutoGPT、自定义工作流引擎）读取并执行的标准化任务指令集。
• 在技术方案评审或团队协作中，快速呈现结构化的接口与任务规划。

核心提示词

（以下为可直接复制使用的提示词模板，请替换【】中的具体内容）

• 角色指令：你是一个专业的后端系统架构师，负责将【用户积分兑换流程】转化为可执行的Agent任务规划。请遵循RESTful设计原则与高内聚低耦合思想。
• 任务分解：请将核心业务流程“【用户提交兑换申请】”分解为原子级的子任务，并为每个子任务定义：1. 任务名称；2. 输入参数（数据结构）；3. 执行逻辑（伪代码或清晰描述）；4. 输出结果；5. 失败处理策略。
• 接口定义：基于上述任务规划，设计对应的后端HTTP接口。为每个接口明确：端点(Endpoint)、方法(Method)、请求体/参数(Request Body/Params)、成功响应结构(Success Response)、错误码(Error Codes)。
• 依赖与顺序：明确各任务间的依赖关系、执行顺序（同步/异步）、以及数据流转路径。

风格方向

• 技术文档风格：输出应接近专业的技术设计文档（Technical Design Document），逻辑严密，术语准确。
• 结构化与列表化：大量使用编号列表、层级标题和表格化思维来组织信息，确保视觉上的条理性。
• 机器可读性：在保证人类可读的同时，关键指令和数据结构应尽量格式化，便于被其他程序解析。

构图建议

• 若需视觉化呈现，建议构图元素：左侧为纵向的任务流泳道图，右侧为对应的接口定义面板。
• 视觉隐喻：使用齿轮、数据流箭头、服务器集群图标、API端点（靶心）图标来象征任务调度、数据传递与接口调用。
• 色彩代码：使用冷色调（如蓝色、青色）代表数据与逻辑层，暖色调（如橙色）代表触发动作或异常状态。

细节强化

• 数据模型：明确定义任务间传递的核心数据模型（DTO/Entity），包括关键字段和类型。
• 异常边界：详细规划网络超时、数据库异常、第三方服务失败等场景下的回退（Fallback）与补偿（Compensation）机制。
• 性能与安全：在任务规划中标注出可能存在的性能瓶颈点（如循环调用、大数据量查询）及建议的安全措施（如参数校验、权限校验）。
• 日志与监控：指明关键任务节点应记录的日志级别与监控指标（如任务执行时长、成功率）。

使用建议

• 直接复制“核心提示词”模块中的模板，替换【】内的具体业务描述，即可作为向高级AI模型（如GPT-4, Claude 3）提问的完整提示词。
• 生成的规划结果，可直接用于编写Jira/Tapd任务卡片、绘制系统架构图初稿，或作为团队技术评审的基础材料。
• 在复杂场景下，可循环使用本框架：先进行顶层模块规划，再对每个核心子模块进行下一层级的详细任务与接口规划。
• 将最终生成的“接口定义”部分稍作格式调整（如转换为JSON Schema或OpenAPI格式），即可快速生成API文档雏形。