/ Recent content on 我的博客 Hugo zh-cn Sun, 20 Sep 2026 00:26:50 +0800 /posts/2026-09-19-%E5%A4%9Aagent%E5%8D%8F%E4%BD%9C%E5%AE%9E%E6%88%98-%E4%BB%8E%E9%9C%80%E6%B1%82%E5%88%B0%E6%B5%8B%E8%AF%95-%E4%B8%89%E8%A7%92%E8%89%B2%E5%B9%B6%E8%A1%8C%E4%BA%A4%E4%BB%98/ Sun, 20 Sep 2026 00:26:50 +0800 /posts/2026-09-19-%E5%A4%9Aagent%E5%8D%8F%E4%BD%9C%E5%AE%9E%E6%88%98-%E4%BB%8E%E9%9C%80%E6%B1%82%E5%88%B0%E6%B5%8B%E8%AF%95-%E4%B8%89%E8%A7%92%E8%89%B2%E5%B9%B6%E8%A1%8C%E4%BA%A4%E4%BB%98/ <p>最近我在学习多Agent协作的完整流程，做了一次实操演练：让产品经理、开发工程师、测试工程师三个Agent角色并行工作，从需求对齐到文档交付。整个过程没有写一行代码，却产出了3,555行结构化文档。这里复盘一下关键做法和踩坑经验。</p> <h2 id="目标与角色设计">目标与角色设计</h2> <p>我设定了一个&quot;智能任务协作平台&quot;——一个支持任务CRUD、状态流转、列表查询的简易系统。三个角色各司其职：</p> <ul> <li><strong>产品经理</strong>：输出PRD和API契约文档</li> <li><strong>开发工程师</strong>：基于PRD做技术方案设计</li> <li><strong>测试工程师</strong>：基于PRD和API契约设计测试用例</li> </ul> <p>技术选型很克制：Python FastAPI + SQLite + 原生HTML/JS，零构建复杂度，聚焦协作流程本身。</p> <h2 id="三角色并行启动">三角色并行启动</h2> <p>这是最关键的一步。我把三个角色的task同时dispatch出去，让它们并行工作。核心命令结构是：三个独立task，每个包含完整的角色定义、上下文、产出要求。</p> <p>信息流设计成闭环：PRD流向开发做设计，PRD+API契约流向测试写用例。每个角色的产出成为下一个角色的输入。</p> <h2 id="实际产出">实际产出</h2> <p>三份文档全部生成到 <code>D:/multi-agent-project/docs/</code>：</p> <ul> <li><code>PRD.md</code>：10条用户故事 + 22条验收标准（Given-When-Then格式），覆盖任务CRUD和状态流转</li> <li><code>api_contract.md</code>：5个API端点的完整JSON Schema，含请求参数、响应格式、错误码定义</li> <li><code>design.md</code>：9个模块目录 + 6张ER图 + 7个Mermaid图，20个API详细设计</li> <li><code>test_cases.md</code>：30条测试用例（TC-CREATE-001格式），覆盖正常流程、边界异常、并发场景</li> </ul> <h2 id="踩坑与思考">踩坑与思考</h2> <ol> <li> <p><strong>上下文传递是最大挑战</strong>。每个Agent是独立session，必须把项目背景、技术栈、产出格式等所有信息显式写进task的context里，否则角色会&quot;失忆&quot;或输出格式不统一。</p> </li> <li> <p><strong>并行不等于完全独立</strong>。开发的技术设计依赖PRD，测试的用例依赖PRD+API契约。虽然三个任务同时启动，但需要在task描述中注明&quot;如果上游文档已存在则读取并基于编写&quot;，避免时序问题。</p> </li> <li> <p><strong>产出格式必须提前约定</strong>。我在协作机制中规定了：需求文档用Markdown+用户故事格式、测试用例用表格+ID格式、Bug报告含复现步骤和严重等级。没有约定就没有对齐。</p> </li> <li> <p><strong>异步回调要处理好</strong>。三个Agent并行运行，完成时间不同。需要轮询或等待异步通知，再汇总结果。实际执行中最慢的任务跑了约250秒。</p> </li> </ol> <h2 id="下一步">下一步</h2> <p>文档层面对齐后，下一步是激活开发工程师Agent基于 <code>design.md</code> 写实际代码，跑通前后端联调，然后测试工程师Agent用自动化脚本验证。这才是真正的协作闭环——从文档到可运行系统。</p> <p>多Agent协作的核心不是&quot;一个AI做所有事&quot;，而是让每个Agent专注自己的强项，通过结构化的交付物串联起完整的工作流。这次实践验证了这条路走得通。</p> /posts/hello-world/ Sat, 19 Sep 2026 23:15:00 +0800 /posts/hello-world/ <p>欢迎来到我的博客！这是第一篇文章。</p> <p>这个博客的架构非常极简：</p> <ul> <li>文章用 Markdown 写在 <code>content/posts/</code> 目录</li> <li>Hugo 构建成纯静态 HTML</li> <li>托管在 Cloudflare Pages，全球 CDN 加速</li> <li>域名 DNS 托管在 Cloudflare，完全免费</li> </ul> <h2 id="以后会写什么">以后会写什么</h2> <ul> <li>技术笔记与踩坑记录</li> <li>工具与效率</li> <li>生活随笔</li> </ul> <blockquote> <p>千里之行，始于足下。</p> </blockquote>