多 Agent 协作搭建 AI Agent Task Board：复盘与踩坑
要做什么 「AI Agent Task Board」是一个教学向的 MVP 项目——一个极简的任务管理看板，支持创建、查看、修改状态、删除任务。技术栈是 FastAPI + SQLite + 原生 HTML/CSS/JS，零构建工具。 但这个项目真正的目的不是做一个看板，而是演练多 Agent 协作的工作流：PM Agent 出需求与开发、DEV Agent 写代码、QA Agent 验证，每个阶段之间由人类确认门控，文档作为 Agent 间的通信媒介。 整体流程：三角色四阶段 整个项目按以下分工推进： PM Agent → DEV Agent → QA Agent → 人类验收 （文档产出） （代码实现） （测试验证） （阶段门控） PM Agent 产出四份文档：PRD（用户故事 + 验收标准）、data_model（字段定义 + 状态流转规则）、api_contract（5 个端点的完整请求/响应 Schema + 错误码）、dev_plan（阶段划分 + 门禁规则）。这四份文档就是后续所有 Agent 的"合同"，Agent 只读文档路径，不传全文。 DEV Agent 按文档实现后端 5 个 API 端点（POST/GET /tasks、GET/PUT/DELETE /tasks/{id}）和前端页面。 QA Agent 负责真实验证——不是看代码说"应该能跑"，而是实际启动服务、发 curl 请求、比对返回结果与契约是否一致。 每个阶段结束后硬暂停，人类确认后才进入下一阶段。这条规则直接写进了 dev_plan.md。 ...