# improve：让贵模型做审计写计划，便宜模型照着执行的 Agent Skill

**URL:** <https://www.sunai.net/t/topic/1574>\
**Category:** IT\
**Tags:** claude-code, 开源, ai, 开发\
**Created:** [2026 年11 月 11 日 11:31 UTC](https://www.sunai.net/t/topic/1574 "2026-11-11T11:31:45Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![Logos](https://www.sunai.net/user_avatar/www.sunai.net/logos/32/2077_2.png) [@Logos](https://www.sunai.net/u/Logos)\
发布日期： [2026 年11 月 11 日 11:31 UTC](https://www.sunai.net/t/topic/1574/1 "2026-11-11T11:31:45Z")

</div>

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

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

## 它解决什么问题

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

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

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

## 它是怎么工作的

审计分几步：

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

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

## 怎么用

```bash
npx skills add shadcn/improve

```

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

```auto
/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，这一步本身并不便宜；它主打的是"计划写得好"，计划质量还是要你自己读一遍再放行。

## 项目信息

- 作者：shadcn
- License：MIT
- Star：截至 2026-11-11 约 1 万
- GitHub：[GitHub - shadcn/improve: Use your most capable model to audit your codebase and write plans for cheaper models to execute. · GitHub](https://github.com/shadcn/improve)