improve:让贵模型做审计写计划,便宜模型照着执行的 Agent Skill

shadcn(shadcn/ui 的作者)最近放出的一个 Agent Skill,叫 improve。思路很直接:别让最贵的模型去敲代码,让它干最费脑子的活,也就是读懂整个代码库、判断哪些改动值得做、把方案写成规格说明,然后把执行交给便宜的模型。

它自己从不动源码,产出物只有一个 plans/ 目录里的一组 Markdown 计划文件。今天它冲上了趋势榜,一天涨了三百多颗星,总数已经过万。

它解决什么问题

用强模型直接改代码很贵,用便宜模型又容易跑偏。improve 把流程拆成两段:

  • 强模型当顾问:审计代码库,挑出值得做的事,写成自包含的计划
  • 弱模型当执行者:照着计划实现、跑测试、提交

计划本身是普通 Markdown,所以执行者不一定是模型,换个人来照着做也行。

它是怎么工作的

审计分几步:

  • 摸底:识别技术栈、代码约定,以及这个仓库实际的构建、测试、lint 命令,这些命令之后会变成每份计划里的验证关卡。如果仓库里有 ADR、PRD、DESIGN.md 之类的文档,也会读进来,已经定下的取舍不会再被当成问题提出来
  • 审计:并行派出子 agent,覆盖正确性、安全、性能、测试覆盖、技术债、依赖与迁移、开发体验、文档和方向建议九个类别,每条发现都要带 文件:行号 证据、影响、工作量和置信度
  • 复核:子 agent 容易多报,所以顾问会自己重新读一遍被引用的位置,误报丢掉,归因错的改掉,被否决的也会记录原因,下次不再出现
  • 排序:按"收益 ÷ 工作量"并结合置信度排成表,由你挑哪些要变成计划

每份计划按"能力最弱的执行者"来写:上下文全部内联,有明确的验证命令和预期输出,有范围外清单,还有"遇到某情况就停下来汇报"的 STOP 条件。计划还会记录写成时的 git commit,执行前先做一次漂移检查。

怎么用

npx skills add shadcn/improve

支持 Agent Skills 格式的 agent 都能用。常用命令:

/improve                    完整审计 → 排序后的发现 → 计划
/improve quick              省钱版,只看热点
/improve deep               穷尽式,每个包每个类别
/improve security           专项审计(还有 perf、tests、bugs 等)
/improve branch             只审当前分支的改动
/improve next               功能方向建议
/improve execute <plan>     派便宜的模型执行,并审查它的成果
/improve reconcile          整理积压:验证、解阻塞、归档

典型的第一次使用:在仓库里运行 /improve(想省钱就 /improve quick),拿到发现表后回复"plan 1, 3 and 5",计划就落在 plans/ 下,每条一个文件,另有一份推荐顺序的索引。/improve execute 001 会在隔离的 git worktree 里派一个便宜的执行者,完成后像技术负责人一样复核 diff,给出通过、打回(最多两轮)或阻塞的结论,合并仍由你决定。

适合谁,注意什么

适合已经在用 Claude Code 之类的 Agent、又在意 token 成本的人,尤其是想把清理技术债、补测试这类"不急但该做"的活批量甩给便宜模型的场景。项目的硬规则也比较克制:不改源码、不跑会改动工作区的命令、不复述密钥内容,只给出位置和类型。

局限也很明显:效果取决于你用的顾问模型本身够不够强,审计会并行派多个子 agent,这一步本身并不便宜;它主打的是"计划写得好",计划质量还是要你自己读一遍再放行。

项目信息