Claude Code 自己写了 5 小时代码,我全程没碰键盘
3 种角色、5 个 Agent、1 套自我纠错闭环。Claude Code 稳定跑了 5 个小时,21 个模块全部交付。提示词全开源。
不是"做一个 PPT",是"跑一个工程"
表面看是 21 个视频分镜文件。本质上是一个多模块、有质量门禁、能自我修复的工程项目。
每页模块要经过三道质检(布局/美观/动画),查出问题自动打回去修,修完再检,最多三轮。21 个模块 × 最多 4 轮开发 × 3 维测试 = 一个不小的工程。
单靠一个 AI?上下文干三四页就爆了。于是有了这套流水线——
总览:
开发测试循环展开:
核心就三条规矩:
| 角色 | 能干嘛 | 不能干嘛 |
|---|---|---|
| 大管家 | 派活、看 PASS/FAIL、记日志 | 不读代码、不读报告正文 |
| 程序员 | 读指南→写代码→自检→提交 | 不碰测试报告以外的东西 |
| 质检员×3 | 读代码→审查→写报告 | 绝不碰输出文件 |
最绝的一招:Resume
Claude Code 的子 Agent 有个隐藏特性:可以通过一个内部 ID,让它"接着上次聊"。也就是说,程序员修 bug 的时候,脑子里还记着它写代码时的思路——不需要你跟它重新解释一遍。
问题是怎么拿到这个 ID?官方没给直接接口。我们搞了个土办法:
探测文件系统 → 找到最新 agent 的元数据文件 → 抠出裸 ID
然后用这个 ID 叫它回来接着干活。
实测:一个页面来回修了 3 次,程序员的上下文从 1.5 万 token 涨到 6.2 万——它不是每次重来,而是越修越懂这个页面。
反过来,质检员每次都是全新启动。为什么?新眼睛没有惯性,不会因为"上次看过这里没问题"就跳过去。
| 程序员 | 质检员 | |
|---|---|---|
| 模式 | Resume(有记忆) | 每批新启动(无记忆) |
| 像什么 | 老工匠,越做越熟 | 新人,永远警觉 |
| 上下文 | 1.5万→6.2万 token | 每次从零开始 |
经验库:犯了错别白犯
程序员每次修完 bug,必须写一条经验到lessons-learned.md。但有三条"入档标准":
❌ “page14 的阶梯图 CSS class 要通用” → 换项目就没用了
✅ “可复用的视觉组件用通用 class 名” → 换项目照样生效
❌ “把 padding 从 20px 改成 16px” → 记了个值而已
✅ “flex column + height:100% + 居中 = 大面积空白” → 记的是模式
三条标准:
- 写为什么错,不写改了什么值
- 写哪种模式容易错,不写哪个页面错了
- 换了下个项目还有用吗?没用就别记
新来的程序员开工前第一件事:读lessons-learned.md。page01 踩的坑,page05 不会再踩——这就是自动免疫。
人发现 bug → 教会 AI → 再也不会漏
这是我们跑出来的最漂亮的循环:
你每发现一个 bug,不是修掉就完了,而是把它变成质检员的一项永久技能。Skill 文件就是技能载体。你的审查能力在往 AI 身上"复制"。
监控面板:一眼看清谁在跑
主调度和监控面板完全解耦——只靠一个 JSON 文件约定字段名。换了调度系统,监控照样用。
bashserve-monitor.sh# 就一行,python -m http.server# → http://localhost:8888/monitor.html好钢用在刀刃上:模型怎么配
5 个 Agent,傻傻全用最强模型?那钱包要哭。
不同的活,配不同档位的模型:
| 用 Opus(最强,贵) | 用 Haiku(够用,便宜) |
|---|---|
| 规划师:一次性任务,要深度思考 | 布局质检:规则匹配,不烧脑 |
| 程序员:写代码,要质量 | 美观质检:按 checklist 打分 |
| 动画质检:算时间差,小学数学 |
账怎么算:
一个页面跑一轮:程序员(Opus)约 1.5 万 token,质检 ×3(Haiku)约 3K×3=9K token。如果质检也用 Opus,多花 3-5 倍的钱,结果一样。
质检员的活是"有没有命中反模式?颜色对不对?间距差几 px?"——这些是规则判断,不需要推理能力。Haiku 完全够用,而且跑得更快。
能省多少?21 页做下来,三个质检员如果全用 Opus,成本大概翻 4 倍。省下来的钱够再做一个项目。
原则一句话:需要创造/决策的用 Opus,需要对照清单检查的用 Haiku。
几个你没注意到的设计心思
1. "大管家不读内容"有多重要?
如果大管家读完测试报告再转述给程序员,同一份内容塞进了两个 Agent 的上下文——大管家先炸,转述的内容再炸程序员。
只传文件路径:质检员写报告 → 程序员自己读报告。谁需要谁读,不搞传话。
❌ 大管家读报告→转述→程序员(同一份内容,占两份上下文)
✅ 质检员写报告→程序员直接读(一份内容,一份上下文)
2. 不信任架构 = 质量保障
- 程序员不能说自己过了 —— 必须质检员说了算
- 质检员不能改代码 —— 必须程序员来修
- 大管家不能替程序员改 —— 必须程序员自己来
任何一个人越权,闭环就破了。
3. 上下文窗口的"选品策略"
| 进程序员上下文 | 不进 |
|---|---|
| 设计指南(怎么做) | 素材原文(传路径就行) |
| 之前踩过的坑 | 测试报告(用的时候再读) |
| 自己写的 CSS 结构 | 其他页面的内容 |
精打细算——上下文窗口是很贵的,每一 kb 都得问一句"真的需要吗?"
直接拿走的文件
全在 GitHub:github.com/STEPHENXING/multi-agent-in-cc
| 文件 | 干嘛的 | 你能怎么用 |
|---|---|---|
AGENTS.md | 大管家的大脑,16 条铁律 | 换你的项目,改页面结构就行 |
.claude/agents/*.md | 5 个 Agent 定义(约100行/个) | 直接复用角色分工 |
.claude/skills/*.md | 5 个审查 Skill | 单独用也行——让任意 Claude 按这个标准查质量 |
monitor.html | 实时监控面板 | 纯静态,零依赖 |
serve-monitor.sh | 一行启动 webserver | python -m http.server而已 |
拿走改成你自己的项目
这套框架虽然是为"分镜制作"这个场景设计的,但三角色模型、Resume 机制、经验库——跟具体产出物没关系,是通用的。
你要改什么
假设你要做一个代码审查系统(程序员写代码,质检员查 bug):
| 要改的(业务相关) | 不用动的(框架层) |
|---|---|
| Agent 定义里的"干什么" | 三角色分工结构 |
| Skill 里的审查标准 | Resume 机制 + ID 获取方式 |
| AGENTS.md 里的页面概念 | flow-log 监控体系 |
| lessons-learned 的领域 | 经验库的过滤原则 |
三步改完
第 1 步:换 Agent 定义
.claude/agents/下的 5 个文件:
dg-planner.md→ 你的规划师要读什么、产出什么dg-slide-dev.md→ 你的程序员用什么工具、怎么写代码dg-slide-tester-*.md→ 你的质检员查什么维度、用什么 skill
只改 “触发场景” 和 “工作流程” 部分,工具列表、模型选择保留。
第 2 步:换 Skill
.claude/skills/下的审查 skill:原来是检查 padding、颜色、动画间距,改成检查你的质量标准(代码规范?安全漏洞?API 设计?)。
M0-M3 的思路保留——把你最常发现的 bug 写成"零容忍规则"。
第 3 步:换 AGENTS.md 里的业务词
全文替换:
- “幻灯片” → 你的产出物
- “page” → 你的任务单元
- “index.html(输出主文件)” → 你的产出物文件名
流程结构(Plan → Dev → Test → Fix)不用动。
偷懒起步
gitclone https://github.com/STEPHENXING/multi-agent-in-cc.git your-projectcdyour-project# 1. 删掉幻灯片相关的 Skill 内容,换成你的# 2. 改 .claude/agents/*.md 里的角色描述# 3. 把 AGENTS.md 里的 "page" 换成你的任务单元# 4. 开干:"读 AGENTS.md。我的项目是 {你的项目描述},开始做第一批。"核心骨架(Agent 分工、Resume、经验库、监控)——不动。只换外面的"皮"。
说到底
5 个小时,21 个模块,0 次手动改代码。Claude Code 自己在跑——规划、开发、检查、修 bug、再检查。我只做了两件事:定流程,和发现 bug 后把它写成规则塞进 tester 脑子里。
这不是"AI 写了个 PPT"。这是你用流程设计了一套能自我纠错的生产线,然后它自己转了 5 个小时。
想复用这套东西做你自己的项目,记住两件事:
- Agent 之间怎么传递信息(传路径,不传内容)
- 出了错怎么发现、怎么修(tester 不能改、dev 不能判、主调度只认 PASS/FAIL)
想清楚这两点,剩下的让它跑。
全部代码和提示词:github.com/STEPHENXING/multi-agent-in-cc