梦溪笔记 · Mengxi Notes · AGENTS
Anthropic 案例研究:Warp 把 Claude 驱动的代码 review agent 从「80% 凑合的 prompt」进化成「会自我刷新的 skill 文件」。 核心是内层 base skill + 外层 improver skill,中间卡一道人类反馈。
每次出错就人工修补 prompt。能用,但一长就崩——人记不住几百条 prompt 规则。
把上下文塞进 AGENTS.md 文件。比 prompt 好,但还是静态——不会从反馈里学。
把知识编码进文件,再用一个 observer agent 定期读反馈、改 skill。反馈闭环。
§ 01 · 起点
Warp 的代码 review agent 一开始只能用「80% 对、20% 错」的 prompt 撑场面。 工程师被 agent 的「无意义评论」反复折磨。 改 prompt 是给症状打补丁,真正缺的是:反馈机制。
Warp 团队的第一反应是 stopgap solution——根据出错的 review 反推,去人工重写 prompt。能用,但不 scale。
再后来试着扩充 AGENTS.md 这样的上下文文件——也只解决了一部分。
§ 02 · 关键架构
Warp 的核心抽象只有一个:Skill 是一种「文件形式编码的知识」,不进 prompt, agent 在需要时去读。Skill 文件本身可以被另一个 agent 改—— 这就让改进 skill 本身变成一个 agent 任务。
§ 03 · 闭环
因为 skill 是普通文件,agent 改起来就像写代码—— 可以走标准的 PR / review / merge 流程。 一旦合并,下一次内层 agent 启动就直接继承改进。 这就是为什么 Warp 的 review 质量会随时间越变越好。
GitHub Action 监听事件——PR、issue、spec——决定哪个内层 agent 启动。
内层 agent 读 base skill,对当前任务做 review / triage / spec。
人类在 PR 或 issue 里直接评论——thumbs up 或具体原因。
外层 improver 周期跑——拉反馈、总结成 JSON、提议一行改动。
人类 review PR、approve、merge。下一次内层 agent 自动继承。
§ 04 · 一个具体的循环
Warp 给自家开源仓库跑了一个 issue triage agent—— 新 issue 一来,agent 读 skill、打 label、给方向。 第一次跑漏了一个 ready to spec label。维护者在 issue 里直接留了一句反馈, 三天后这个改动进了 skill。
triage.md,给 label、写方向。漏了 ready to spec。12# Label an issue based on what it describes. 13- Add `bug` for reproducible defects. 14- Add `feature` for net-new capability. 15- Add `docs` for documentation-only. 16+ Add `ready to spec` when the issue describes a real, 17+ articulable problem even if UX/UI shape is undefined. 18- Add `needs-investigation` if root cause unclear. 19
§ 05 · 写 skill 的六条
Improver 是不是工作得好,80% 取决于 base skill 写得好不好。 Warp 的写法很反直觉——他们把它当作教一个聪明人,不是在写一段代码。
与其写「变量名必须 snake_case」,不如写「注意重复代码」。指令型比穷举型更可泛化。
给规则背后的 rationale,让 agent 能在新场景下推理——而不是死板地复制规则。
捕获反馈要发生在人已经在工作的地方——PR 评论、issue 评论——别让人额外提交。
好的 skill 不长——它引用资源文件和脚本,而不是把所有上下文都塞进 prompt。
资深工程师的几条详细反馈 > 一百条「👍/👎」。但量大也帮助——两者都重要。
Outer improver skill 是跨场景可复用的——review、triage、spec 都可以共享。值得多花时间打磨。
§ 06 · 开始之前,先回答
Warp 列了五个最常踩的坑——每个都是「听起来明显,做起来才发现是另一回事」。
Skill 是程序性的、稳定的——「怎么做 X」,跨任务不变,主动改。Memory 是 agent 推理时自己写的,永远在变。
折中:模板化的 base loop 共享结构,agent-specific 的权重覆盖在上面。少量 improver 各管一个;一百个共享一个。
假设反馈会错。让 agent 有 sanity-check 的 context,过滤谁的声音算数,关键步骤留人 review。
能的话,先建 verification harness 再让 agent 调。建一个 reference corpus、对比输出、修复、循环。不能的话,靠 deterministic eval + golden output。
盯人已经在盯的全局指标——merge 时间、贡献者数量、成本。把这些指标再喂回 improver agent。部署走 crawl-walk-run。
§ 07 · 余响
任何 agent——不管做什么任务——
只要一开始就在它里面建一个这样的 loop,
把人类反馈信号收下,转成 skill 改动,
它就会从「一次性帮手」
进化成能在组织里复利的系统。
How Warp builds self-improving agents on Claude · Michael Segner · Anthropic · 2026.08.26