← 返回技巧手册应用开发 / UPDATED 2026.08

后端工程师

开篇速查：推荐模型与工具

推荐模型：GPT-5.6 Sol、Claude Opus 5 或 DeepSeek V4 Pro。
理由：适合跨文件实现、复杂状态机和故障归因；重复 CRUD、测试样本和日志分类用 Terra/Sonnet 5/V4 Flash 降本。
推荐产品：Codex、Claude Code、Cursor（本岗位涉及复杂开发、仓库或运行环境）。 常用工具：GitHub、OpenAPI、API 客户端、单元/集成测试、数据库客户端与日志追踪。 核对日期：2026-08-04；上线前再查厂商官方模型列表并用内部评测集验证。

历史依据：从 8,276 条用户消息中命中 341 条，精确去重后 169 条。以下工作方式优先针对这些历史任务和返工问题。

1. 历史记录暴露的问题

  • 明确验收标准：19/169（11%）。
  • 明确要求验证：60/169（36%）。
  • 提供失败/复现证据：26/169（15%）。
  • 出现“功能不可用/报错”类返工：19 条。
  • 出现“再检查/再测试”类返工：4 条。
  • 出现“继续/不要停”但退出条件不清：19 条。

因此本岗位的模板会把验证、证据和退出条件写进首轮提示，而不是等失败后补充。

2. 什么时候使用

  • 实现业务规则、服务和任务生命周期
  • 处理权限、事务、幂等和并发
  • 修复接口返回成功但数据未落库
  • 对接缓存、队列和外部平台

3. 责任边界

  • 负责服务端业务真实性和一致性
  • 业务规则不散落在控制器和脚本
  • 不通过硬编码假结果让前端演示通过
  • 不把第三方暂时失败直接等同永久失败

4. 开始前必须提供

  • 业务规则、状态机和权限矩阵
  • API契约和调用方
  • 数据库模型与数据不变量
  • 任务队列/外部系统行为
  • 超时、重试和一致性要求

缺少信息时，先从仓库、配置、运行状态和现有资料中查证。只有会改变业务方向、造成生产影响或无法安全推断的内容才询问。

5. 完整可复制提示词

PROMPT
你是后端工程师。实现【业务能力/API/任务】。

业务规则与状态机：【内容】
调用方：【Web/插件/移动端/其他服务】
数据实体与不变量：【内容】
权限：【角色与动作】
外部依赖：【平台、队列、缓存、支付等】
一致性要求：【强一致/最终一致、允许延迟】

要求：
1. 业务规则放在明确服务层；输入校验、鉴权和错误码一致。
2. 区分 accepted/queued/running/partial/succeeded/failed，不把接收任务当完成。
3. 创建、重试、回调使用幂等键；并发冲突行为明确。
4. 外部调用有超时、有限重试、退避、熔断/降级和补偿。
5. 保存来源、任务ID、外部ID、时间、版本、状态和失败原因。
6. 日志不泄露密钥和敏感数据，并可按关联ID追踪。

验证：单元测试业务规则；集成测试数据库、鉴权、失败和重复请求；契约测试调用方；检查最终持久化结果。

交付 API 变更、数据影响、测试证据、监控字段和回滚方式。

6. 推荐执行流程

  1. 从业务不变量和状态机开始
  2. 明确事务与数据所有权
  3. 实现成功路径和所有失败转换
  4. 为重复请求和回调建立幂等键
  5. 记录来源、任务ID、外部ID和状态原因
  6. 增加单元/集成/契约测试
  7. 用真实数据库或隔离环境验证持久化

每一步都要留下可复核产物：文件、命令、截图、请求、任务ID、数据库记录、指标或决策记录。

7. 标准交付物

  • 领域/应用服务实现
  • 接口、鉴权和错误语义
  • 事务、幂等、重试和补偿
  • 单元、集成和契约测试
  • 日志、指标和追踪字段
  • 迁移、配置和回滚说明

8. 历史中常见失败写法

  • HTTP 200 但任务只是排队，用户却被告知完成
  • 部分数据写入后失败且无补偿
  • 重复回调造成重复创建/扣减
  • 错误被统一成模糊500
  • 日志没有任务ID和外部ID，无法追踪
  • 用内存状态代替必须持久化的数据

修正提示词

PROMPT
当前结果未满足验收。不要整体重做，先按证据定位差距。

原目标：【目标】
原验收：【可观察标准】
实际结果：【截图/日志/请求/任务ID/数据库记录】
差距：【逐条列出】
必须保持：【已正确部分和接口不变量】

请先复现并说明根因，再实施最小修正。修正后重复原验证，并给出修改前后证据。未通过的项继续保留为失败，不要用“基本完成”代替。

9. 完成检查清单

  • 目标、范围和不做项没有漂移。
  • 关键假设已用代码、运行或数据验证。
  • 成功、失败、空、重复、超时和权限路径已处理。
  • 交付物可由另一人独立打开或运行。
  • 验收命令/路径已实际执行并保留证据。
  • 未完成项、风险和数据限制被明确列出。
  • 下游岗位得到接口、不变量、文件和验证入口。

10. 交接模板

PROMPT
岗位：后端工程师
已完成：【内容】
证据：【文件、命令、截图、日志、任务ID、数据库记录或指标】
接口与不变量：【下游必须遵守】
配置/迁移影响：【内容】
未完成与风险：【内容、严重度、负责人】
下一岗位：【岗位】
下一步输入：【精确文件、环境、账号或任务】
禁止假设：【仍未知内容】

11. 实用组合技巧

  • 需求自动生成服务骨架：先由需求 Agent 输出状态机和业务不变量，再由后端 Agent生成领域服务、接口骨架和测试清单，避免从控制器开始乱写。
  • OpenAPI 双向校验：从契约生成服务端类型、客户端 SDK 和契约测试，任何一方变更都在 CI 中暴露兼容问题。
  • 任务链自动追踪：为请求、队列、执行器和数据库统一关联 ID，让诊断 Agent 能自动拼出 accepted 到 persisted 的完整时间线。
  • 失败样本变回归测试：每次生产或测试失败后，让 Agent 把日志和复现步骤转换成最小测试，修复前失败、修复后通过。
  • 第三方失败自动分流：让错误分类 Agent区分限流、超时、权限、数据冲突和永久失败，只对可恢复错误进入有限重试。