0. 先说结论
先交代结果. 从一句话想法到本地能跑的周刊站,我满打满算花了一个下午外加半个晚上,其中真正需要我盯着屏幕动手的部分，三个小时就封顶了。搁以前一个人从零手写,这个体量我给自己留三天,还不敢打包票不出岔子。
多Agent并行这个词，发布会PPT里见得太多了。真跑起来到底什么体感,是这篇文章想回答的问题。核心观点先摞在这儿，并行的成败,八成取决于开工前你有没有把边界写死。目录没画清楚，三个Agent真能把同一个项目改成三个项目，后面踩坑实录里有实锤。
1. 为什么选这个题材
程序员的通病,订阅源几百个，收藏夹全是灰,周报全凭记忆。与其焦虑，不如让机器每周替我干这活。
项目说穿了很简单. 从Hacker News和dev.to两个公开接口把热门技术文章拉下来,按领域分类去重，自动拼成一期周刊，Markdown和网页两种载体，定时生成,归档可查。挑这两个数据源是有讲究的，公开,免key,零反爬风险,你照着文章做不会在数据源上翻车。
| 模块 | 内容 |
|---|---|
| 数据接入 | Hacker News API + dev.to API，公开免key |
| 周刊生成 | 规则化提取，分类组装 |
| Web展示 | 列表页加详情页,移动端适配 |
| 自动化 | 定时任务自动出新刊 |
选这个项目看起来随意，其实我是按这波升级的四个新能力反推的. 模块天然能拆三份,正好压测多Agent并行。周刊生成本身就是个定时任务,正好测自动化。干到一半换手机看进度,正好测三端同步. PRD和周刊文件产出成堆,正好测产物管理。一个项目把新能力全串一遍,这买卖划算。
2. 全链路八步,提示词都能直接抄
Step 0 环境
官网下载全新TRAE,登录,完事。
Step 1 一句话想法变成PRD
先立个规矩,不让它上来就写代码。很多人用AI的方式是一句话需求直接要代码，然后收获一坨能跑的惊吓。AI Development的第一步，是把需求当工程问题去拆。我把想法原样丢给Agent模式，顺手加了几个约束。
P1 提示词,直接抄走就能用
text
我要做一个开发者资讯周刊站 dev-weekly,从公开数据源
(Hacker News API, dev.to API)抓取热门技术文章,去重并按
领域分类(AI/前端/后端/工具等),自动组装成一期周刊
(Markdown + 网页两种载体),支持定时生成与归档浏览。
技术栈为 Next.js + TypeScript,数据落地为 JSON 文件,不引入数据库。
请先输出 PRD,包含功能清单、页面结构、数据流、里程碑拆分,
并明确指出哪些模块可以并行开发。先不要写代码,等我确认。
PRD两轮定稿。有个细节得夸,它主动补了数据源的缓存策略和失败兜底，这俩我原文里压根没提。我要改的只有一处,期号从自增改成按日期生成,免得定时任务重号。
Step 2 把并行边界画死
P2 提示词
text
基于刚才的 PRD,把工作拆成 3 个可并行的任务组,目录严格隔离
- A组(前端) src/app 与 components,负责周刊列表页、详情页、响应式
- B组(数据) src/lib/sources,负责抓取、去重、分类、缓存
- C组(生成) src/scripts 与 docs,负责周刊模板组装、导出、README
每组给出任务清单与验收标准,列出组间集成点,
保证每组可立即开工、互不阻塞。这步看着多此一举，其实是全文最值钱的一步. AI不怕任务难，怕边界糊。边界写进提示词，三个Agent才打不起来。
Step 3 三个Agent并行开工
Agent模式同时开三个会话，一人领一组。
P3 前端组
text
你负责 dev-weekly 项目 A组(前端)任务,目录范围仅限 src/app
与 components,禁止改动其他组的文件。要求,周刊列表页(按期数
分组)与周刊详情页(文章列表、外链跳转、来源标签),移动端适配。
B组数据接口未就绪,先在 src/lib/mock.ts 写 mock 数据并在接口处
留 TODO。验收标准,npm run dev 可运行,两个页面无报错渲染。P4 数据组
text
你负责 dev-weekly 项目 B组(数据管线)任务,目录范围仅限
src/lib/sources。要求,分别接入 Hacker News topstories API 与
dev.to API(https://dev.to/api/articles?top=1),归一化为统一结构
{title, url, source, tags, score, date},按关键词分类
(AI/前端/后端/DevOps/工具),按 url 去重,加缓存避免重复抓取。
对外只暴露一个 getData() 函数供 C组调用,附带单元测试。P5 生成与文档组
text
你负责 dev-weekly 项目 C组(周刊生成)任务,目录范围仅限
src/scripts 与 docs。要求,基于 getData()(先用 mock 版,后续集成
时替换)生成 {期号, 日期, 分领域文章列表, 编者按},期号按日期
自动生成(如 2026-10-18 期),导出 Markdown 到 content/weekly/,
提供 src/scripts/build-weekly.ts 命令行脚本并在 package.json 中
增加 build:weekly 脚本,另写 README(含本地运行与定时运行说明)。
验收标准,npm run build:weekly 可产出一期完整周刊文件。
三个会话同时跑起来的那一刻，确实有点小科幻. 前后脚全部完工，冲突只有一个，三个Agent都往package.json里塞依赖,文件撞车了。这个坑后面细说，先卖个关子。
Step 4 集成,先丢回给Agent试
集成点很明确，A组的mock换成B组的真实接口,C组的假getData换成真版。我的做法是先把集成整体丢回Agent模式，让它自己先试一把。卡住的位置就是你该接管的位置，这句是全文最想让你带走的话。
P6 集成提示词
text
现在做集成,将 src/lib/mock.ts 及相关 mock 调用,替换为
src/lib/sources 的真实 getData(),接口签名与类型按 B组定义对齐。
修复所有编译与运行错误。验收,npm run dev 无报错且列表页显示
真实数据,npm run build:weekly 产出新一期。完成后列出修改的
文件清单。它卡在了类型对齐上. mock是A组凭想象写的，真实接口是B组按PRD定义的，有几处字段对不齐，屏幕红了一片。这就是我要的边界信号。切回IDE模式接管，上下文都还在，不用重新喂，把B组的类型定义直接指给它看，两三个来回就收敛了。集成这种脏活,人工盯梢不丢人。
Step 5 验收
bash
npm install && npm run dev # 网页可访问
npm run build:weekly # 手动产出一期命令跑下来，页面正常渲染，第一期周刊文件躺进了content/weekly/. 中间顺手修了一处样式小毛病，无伤大雅。
Step 6 周刊交给定时任务
在TRAE的自动化任务入口配了个任务，每天早上九点跑一次build:weekly,配置动作前后两分钟. 到写稿这会儿,它已经无人值守攒了好几期,运行记录看图。
Step 7 三端接力
测试链路是这样的，桌面端任务干到一半我直接合盖走人，路上掏出手机看进度，状态完整，Agent跑到哪一步一清二楚。手机上安排点轻活没问题，真要动代码还是回电脑。回到桌面，上下文没丢,接着干。
三端同步这功能,用之前我当它是噱头,用过一次就回不去了. 通勤路上掏出手机看AI替我干活，这种踏实感谁用谁知道。
Step 8 产物归档
回头找这个项目的三类产出，PRD,周刊文件，README. 关键词一打，几秒钟的事。
3. 数据对比
| 指标 | 手写,我估 | 全新TRAE,实测 |
|---|---|---|
| 总耗时 | 三天起步 | 一下午加半个晚上 |
| 需要我动手的环节 | 全程 | 十次上下 |
| 从想法到可运行 | 三天 | 一天之内 |
| 交付物 | 代码 | 代码,PRD,README,周刊归档 |
估的归估的,实测的归实测的，欢迎评论区对线。
4. 踩坑实录
坑1,package.json撞车. 三个Agent并行,每个都觉得自己该加点依赖,同一个文件三只手一起改，冲突几乎是注定的。处理方式简单粗暴,回头在P2里补了一行，package.json只许C组动，依赖统一归C组管，重跑一遍就干净了。教训，并行的边界要细到单个文件级别。
坑2,mock结构对不齐. A组的mock是凭想象写的，B组的真实接口按PRD来，俩结构有几处出入，集成时红了一片。处理，切IDE,让TRAE以B组类型为准逐个对齐。教训,mock的数据结构应该在拆任务时就冻结成一份三方共用的定义,这事一句提示词就能办。
两个坑有个共同点,锅在人不在AI. 提示词里少写一句，后面就得用集成时间来还，这笔账很公平。
5. 可复用的八步
- 想法先让Agent出PRD,禁掉直接写码
- 并行分组时,把目录边界写进提示词
- 每个Agent给一条短验收标准
- 集成先丢回Agent试一次,卡住的位置就是你该接管的位置
- 用命令验收,别靠肉眼
- 重复劳动全部交给定时任务
- 三端切换,甩一次手试试
- 交付物进产物管理归档
提示词不用自己发明,P1到P6换个项目名就能搬。
6. 最后的判断
这波升级里,补全快慢那点提升我几乎无感,真正改变我的是工作形态。一个人带一队Agent,在我这个项目里成立了,前提有两条，模块能拆干净,边界提前写死。强耦合的小项目就别硬上并行了,单会话老老实实写反而快。
需求拆解,目录边界,最终验收,这三件事暂时还是人的活. AI负责推进，你负责兜底，这个分工现在刚刚好。
想把经验带走的话就这句，先写边界，再谈并行。