高质量后端接口Agent任务规划提示词

角色定义与任务定位

请以“技术架构师”或“高级产品策划师”的身份，运用本提示词方案。您的核心目标是：将复杂的后端接口开发需求，系统性地拆解为可供AI Agent或开发团队理解与执行的、结构清晰、逻辑严谨的任务规划蓝图，并辅以创意表达，使其兼具技术严谨性与视觉沟通力。

适用场景

• 为AI Agent（如AutoGPT、自定义工作流Agent）规划后端API开发任务序列。
• 在技术方案评审或需求对齐会议中，可视化呈现接口间的数据流与依赖关系。
• 撰写技术设计文档时，构建逻辑清晰、要素完整的接口描述框架。
• 作为新团队成员理解复杂系统接口模块的快速上手指南。

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

• 主提示词框架：作为系统架构师，请为「[具体业务模块，如：用户积分系统]」设计一组高质量RESTful API。请遵循以下结构化规划：1. 接口概览（功能、端点、方法）。2. 请求/响应数据结构（JSON Schema示例）。3. 身份认证与权限控制策略。4. 错误码规范与异常处理流程。5. 关键业务逻辑与数据流说明。
• Agent任务分解指令：现在你需要以“接口开发Agent”的身份，按顺序执行以下任务：第一步，分析需求文档，提取核心实体与关系。第二步，为每个实体设计CRUD接口端点。第三步，定义全局统一的响应封装格式。第四步，规划接口间的调用依赖与时序图。第五步，生成API文档草稿。
• 关键词组合：模块化设计、高内聚低耦合、幂等性保证、限流策略、分布式事务考虑、Swagger/OAS3规范、前后端数据契约。

风格方向

• 视觉风格：采用“技术蓝图”或“架构图”风格，强调清晰的分层与连接关系。
• 表达基调：专业、精确、结构化，避免模糊描述。可融合“信息可视化”的简洁美感。
• 色彩方向：以深蓝、灰色作为背景基调，用绿色表示成功流程，黄色表示警告或校验，红色表示错误或异常分支。

构图建议

• 采用“纵向时间流”或“横向模块展开”构图。左侧为需求输入或触发事件，中间为主体处理逻辑与接口调用框，右侧为最终输出与状态更新。
• 使用清晰的线框、箭头指示数据流向（请求→响应，调用→回调）。
• 为不同的Agent或微服务模块使用不同的色块区域进行区分，并在连接线上标注API名称或关键参数。

细节强化

• 在接口框内，简要标注：HTTP方法、URL路径、核心业务动作。
• 在数据流旁，添加关键字段注释，如：`{“user_id”: “required, string”}`。
• 描绘出关键的状态转换节点，例如：“订单状态从‘待支付’到‘已支付’的接口触发点”。
• 加入必要的“安全盾牌”图标表示鉴权点，“数据库”图标表示数据持久化操作。

使用建议

• 在使用核心提示词时，务必将方括号「」内的示例替换为您的具体业务场景。
• 可将“核心提示词”中的不同模块拆分，分别输入给不同的专项Agent（如设计数据库的Agent、编写业务逻辑的Agent）进行协同工作。
• 生成的规划图或结构化文本，可直接作为PRD附件、技术会议材料或AI Agent的初始化指令，确保沟通与执行的一致性。
• 定期根据项目反馈，迭代更新本提示词中的关键词与结构细节，使其更贴合团队技术栈与规范。