项目
综合项目 1：博客 API
使用 Node.js + Express + Prisma + MySQL 实现文章、分类、标签、管理员登录和分页搜索。
产出物一个能服务当前博客项目的后台 API 雏形。
Checklist
阶段任务
- 先写业务需求，不直接让 AI 写代码
- 让 AI 输出接口文档和数据库设计
- 人工检查字段、权限、边界情况和错误码
- 把需求拆成用户故事、接口契约、数据模型、测试用例和部署任务
- 让 AI 分模块生成项目结构和代码
- 每完成一个接口就生成测试用例和 curl 请求
- 用前端页面或接口工具实际调试
- 让 AI 做后端工程质量和安全 Review
- 让 AI 做可观测性 Review：日志、requestId、错误码、监控指标是否足够
- 让 AI 生成部署文档、回滚步骤和排错手册
- 上线后根据日志让 AI 辅助排查并沉淀 error cases
- 沉淀可复用模板：需求、API、数据库、测试、部署、Review、排错
Labs
建议练习
项目
综合项目 2：AI 工具后端
使用 FastAPI 实现文本分析、历史记录、API Key 鉴权和访问次数限制。
产出物一个适合后续接 AI 能力的轻量 API。
项目
综合项目 3：企业风格用户管理
使用 Spring Boot + MyBatis + MySQL 实现用户、角色、权限、登录和统一异常处理。
产出物一个能帮助你看懂企业 Java 后端结构的练习项目。
AI 协作
整理 AI 协作工具包
把需求模板、接口模板、数据库 Review 模板、代码 Review 模板、部署排错模板整理到 ai-prompts.md。
产出物一份后续项目可直接复用的提示词工具包。
API
建立接口测试矩阵
为综合项目列出每个接口的成功、参数错误、未登录、无权限、资源不存在、数据冲突、边界值测试。
产出物一份接口测试矩阵和可执行请求集合。
排错
可观测性 Review
检查综合项目是否具备 requestId、结构化日志、错误码、慢查询日志、健康检查、基础监控和告警入口。
产出物一份上线后排查问题所需的日志和监控清单。
Daily Plan
每日安排
Day 1
把模糊需求改成后端任务
练习先描述业务、角色、数据、权限和边界，不急着生成代码。
- 选择一个综合项目：博客 API、AI 工具后端或用户管理系统
- 写清楚用户角色、核心流程、数据对象和不做什么
- 让 AI 输出接口清单和数据库初稿
- 人工标记不确定点和权限风险
当天产出一份需求说明、接口清单和数据模型草稿。
Day 2
接口文档和数据库定稿
把 AI 的初稿变成前端能联调、后端能实现的契约。
- 补齐每个接口的方法、路径、参数、响应、状态码
- 检查分页、搜索、排序、权限、幂等和错误场景
- 确认表结构、字段类型、唯一约束、索引和关联关系
- 为核心接口补成功、失败、权限、边界、并发场景的测试用例
- 让 AI Review 文档是否有遗漏
当天产出一份可以进入开发的 API 文档和数据库设计。
Day 3
分模块生成代码和测试
控制 AI 的输出边界，每次只生成一个模块，并立刻运行验证。
- 让 AI 先生成项目目录和基础配置
- 按 auth、users、posts、upload 等模块逐个生成
- 每个模块补 curl、Postman 或自动化测试示例
- 运行测试并把报错信息反馈给 AI 修正
- 记录每次 AI 修改的文件影响面和人工确认结果
当天产出一个能本地启动并通过核心接口测试的后端项目。
Day 4
前后端联调和代码 Review
验证接口是否真正适合前端使用，并检查安全和工程质量。
- 用前端页面实际调用核心接口
- 检查 loading、错误提示、鉴权失效、分页空列表等场景
- 让 AI 做安全 Review 和分层 Review
- 让 AI 检查日志、requestId、错误码、慢查询和监控指标
- 修复高优先级问题并记录变更
当天产出一份联调问题清单和 Review 修复记录。
Day 5
部署、排错和沉淀模板
把项目从本地运行推进到可部署，并沉淀以后反复使用的 AI 协作模板。
- 让 AI 生成部署步骤、环境变量说明和 Nginx 配置
- 补充回滚、日志查看、数据库备份和常见故障排查
- 整理 api-design-notes、database-notes、test-notes、deploy-notes、ai-prompts
- 复盘本次 AI 协作哪些提示词有效、哪些容易出错
当天产出一套可复用的后端 AI 协作工作流和部署手册。
Knowledge
知识点解释
AI 最适合在清晰边界里工作。你的价值是定义边界、检查结果、运行验证和排查问题。
方案先行
复杂功能先让 AI 输出方案和文件影响面，再确认是否写代码。
前端类比：类似先看组件拆分和状态设计，再开始写页面。
小步生成
按接口、模块、测试、部署文档分批让 AI 产出，降低出错范围。
前端类比：类似一个页面一个组件地实现和验收。
日志驱动排错
线上问题先收集现象和日志，再让 AI 判断原因。
前端类比：类似前端先看控制台、Network、报错堆栈再修。
验收清单
把接口、测试、权限、日志、部署都写成可检查项，避免只凭感觉完成。
前端类比：类似前端上线前检查响应式、空状态、错误状态和交互路径。
上下文包
给 AI 的材料应包含需求、技术栈、已有目录、相关代码、错误日志和期望输出。
前端类比：类似给协作者一个最小可复现问题，而不是只说页面坏了。
测试矩阵
按接口列出成功、失败、权限、边界、并发等测试场景，确保不是只测 happy path。
前端类比：类似前端为页面列空状态、加载态、错误态、极端数据和权限态。
可观测性
通过日志、指标、TraceId、健康检查和告警，让线上问题能被发现和定位。
前端类比：类似前端错误监控和埋点，只是覆盖服务器、数据库和接口链路。
变更影响面
每次修改前先列出会影响的接口、表结构、权限、测试、前端类型和部署配置。
前端类比：类似改一个组件前先确认哪些页面、状态和 API 类型会受影响。
常见坑点
- 不要把生产数据库权限、密钥和服务器账号直接发给 AI
- 不要让 AI 一次性生成不可验证的大段代码
- 不要跳过测试和接口调试
- 不要只说“报错了”，要给 AI 状态码、日志、命令和环境
- 不要让 AI 改完代码就上线，至少要过接口测试和安全 Review
- 不要只测成功路径，权限、参数错误、空数据和并发重复提交都要覆盖
- 不要忽略日志和监控，上线后没有观测能力就很难排查
Prompts
AI 协作提示词
后端任务模板
你是资深后端工程师，我是前端开发。请帮我实现【功能名称】。背景：项目技术栈【填写】、数据库【填写】、已有接口【填写】、当前需求【填写】。要求：先输出实现方案，不要直接写代码；说明需要新增或修改哪些文件；说明数据库是否需要变更；说明接口请求和响应格式；说明可能的异常情况；等我确认后，再分文件输出代码。接口与数据库定稿模板
请把下面的业务需求整理成可开发的接口文档和数据库设计。要求输出接口路径、方法、权限、请求参数、响应 JSON、错误码、表结构、字段说明、索引、关联关系，并指出哪些地方需要我确认。代码 Review 模板
请从后端工程质量角度 Review 下面的代码。重点检查是否有安全问题、是否有 SQL 注入或权限绕过风险、错误处理是否完整、数据校验是否完整、是否适合生产环境、是否有更清晰的项目分层。请按严重程度列出问题，并给出修改建议。排错模板
我的后端服务部署后访问报错。现象：访问地址【填写】、错误状态码【填写】、Nginx 日志【填写】、后端日志【填写】、服务启动命令【填写】、服务器系统【填写】。请帮我判断可能原因，并按优先级给出排查命令和修复方案。测试矩阵模板
请为下面的 API 文档生成测试矩阵。要求按接口列出成功场景、参数错误、未登录、无权限、资源不存在、数据冲突、边界值、重复提交、分页空结果，并给出 curl 或测试代码示例。可观测性 Review 模板
请从线上排障角度 Review 下面的后端项目。请检查是否有 requestId、结构化日志、统一错误码、健康检查、慢查询记录、关键业务指标、部署日志、Nginx 日志关联方式、告警建议和故障排查 runbook。Acceptance
验收标准
- 能把需求拆成接口、表结构、代码、测试、部署步骤
- 能让 AI 先给方案再写代码
- 能对 AI 生成的代码做风险检查
- 能为核心接口建立测试矩阵
- 能检查上线后的日志和监控是否足够排查问题
- 能完成至少一个综合项目从本地运行到部署
- 能沉淀自己的 api-design-notes、database-notes、test-notes、deploy-notes 和 ai-prompts
Resources
推荐资源
学习标准化接口描述方式。
了解现代后端应用配置、日志和部署原则。
用于安全 Review 时查常见 Web 后端安全清单。
Progress