分类： 开发工具｜难度： 入门｜类型： 实操教程｜软件： Improve 标签： 开源、AI 编程、代码审计、Agent Skills、Claude Code｜预计阅读： 约 8 分钟
一、这是什么
Improve 是一个开源的 Agent Skills 技能，作者是 shadcn，作用是让 AI 编程助手先把你的代码库彻底审计一遍，再把值得做的事情写成一份份可以直接执行的实施计划。
2026 年 11 月 12 日，Improve 登上 GitHub 当日热门榜第 4 名，当日新增约 361 个 star，核实时已有约 10,886 个 star，fork 约 443 个。仓库建立于 2026 年 6 月 10 日，采用 MIT 开源协议。
它的核心想法很简单：把最贵的模型用在最值得的地方——理解代码库、判断什么值得做、写出方案；把执行交给便宜的模型。技能本身绝不实现任何功能，计划就是产品。
你 → /improve （强模型，负责建议）
plans/ → 001-fix-n-plus-one.md （一份份独立的方案）
其他智能体 → 按计划实现、测试、上线 （便宜模型，负责执行）
审计覆盖 9 个方向：正确性、安全性、性能、测试覆盖、技术债、依赖与迁移、开发体验、文档，以及发展方向（功能建议，每一条都必须引用代码库里的证据，不写空泛的想法）。每一条发现都附带文件和行号证据、影响、工作量和置信度。
它适合这些人：代码库越写越大、想系统梳理一次技术债的人；想让强模型出主意、又不想为每一行执行都付高价的人；以及团队里想把“先审计、再排期、再执行”做成固定流程的人。
二、开始前先确认
- 先装好 Node.js：安装命令用的是
npx，需要本机有 Node.js 环境。没有的话先去 nodejs.org 装一个长期支持版。 - 准备一个支持 Agent Skills 格式的 AI 编程助手：本教程以 Claude Code 为例，其他支持 Agent Skills 格式的助手也可以，安装和使用方式相同。
- 准备一个要审计的代码仓库：可以是你自己的项目，也可以先拿一个开源项目练手，比如官方示例里审计过的 shadcn/ui。
- 执行计划需要 Git：把计划交给便宜模型执行时，技能会在一个隔离的 git worktree（工作区）里操作，所以仓库要是 Git 仓库。
- 审计要花强模型的额度：第一次先用小仓库练手，熟悉流程后再审大项目；想省钱可以先跑快速扫描，具体见步骤 2。
三、操作步骤
步骤 1：安装技能——一条命令装进你的编程助手
在你的项目目录打开终端，执行：
npx skills add shadcn/improve
装好之后，技能就能在支持 Agent Skills 格式的助手里使用。计划文件是纯 Markdown，任何助手（甚至人）都能直接拿起来用，不依赖特定的工具。
图 1：在终端执行安装命令，把 Improve 技能装进编程助手。图片为 AI 生成的操作示意图，实际界面以终端输出为准。
步骤 2：跑第一次审计——等一张发现清单，再挑要立项的
在你的编程助手里打开这个项目，运行：
/improve
这是完整审计：先摸清项目结构，再分头审计，最后给出一张按优先级排好的发现清单。想先便宜试一次，可以跑快速扫描：
/improve quick
快速扫描只看热点区域和最重要的发现。只关心某一个方向时，可以指定方向，例如只审安全、只审性能、只审测试：
/improve security
/improve perf
/improve tests
审计完成后，助手会返回一张发现清单，类似这样（官方审计 shadcn/ui 的真实结果）：
| # | 发现 | 类别 | 工作量 | 置信度 |
|---|---|---|---|---|
| 1 | shadow-config 在 search.ts 和 view.ts 里重复，副本已经不一致 | 技术债 | M | HIGH |
| 2 | migrate-icons.ts:168 存在 O(n²) 的图标迁移 | 性能 | S | HIGH |
你只需要回复想立项的编号，比如：
plan 1, 3 and 5
技能会把每一项发现写成一份独立的计划文件。
图 2：在编程助手里运行 /improve，得到按优先级排好的发现清单。图片为 AI 生成的操作示意图，实际界面以助手输出为准。
步骤 3：读计划——plans/ 目录里一份发现一个文件
立项的计划会写进项目里的 plans/ 目录，一份发现一个文件，外加一份索引，按推荐顺序和依赖关系排好：
plans/
001-fix-n-plus-one.md
002-xxx.md
index.md
每份计划都按“最弱的执行者”来写：所有背景都写在文件里，包括确切的文件路径、现状代码摘录、项目规范和一个示例文件、已经验证过的命令，不依赖之前对话里的任何信息。每一步都以一条命令和预期输出收尾，完成标准可以机器检查；还明确列出不做的事情和停止条件——如果实际情况和计划不符，执行者要停下来汇报，而不是自己发挥。每份计划还盖着写计划时的 git commit，执行前会先做一次漂移检查。
这一步建议逐份读一遍：计划就是拿来审的，确认没问题再往下走。
步骤 4：执行计划——交给便宜模型，技能负责复核
有两种执行方式。第一种是直接把计划交给任意助手：
implement plans/001-*.md
第二种是让技能自己调度：
/improve execute 001
技能会派一个便宜模型在隔离的 git worktree 里执行计划，再像技术负责人一样复核结果：重新跑一遍每一条完成标准、检查有没有超出计划范围、对照计划读一遍 diff，最后给出结论：通过（合并还是由你决定）、打回修改（最多两轮）、或者叫停并完善计划。
合并永远由你决定，技能不会替你合并代码。
图 3：把 plans/ 里的计划交给便宜模型执行，技能复核 diff 并给出结论。图片为 AI 生成的操作示意图，实际界面以助手输出为准。
步骤 5：闭环维护——让计划清单一直保持最新
计划不是一次性的，下次打开项目时，运行：
/improve reconcile
技能会刷新整个清单：核实已完成的计划是否仍然成立、调查卡住的计划并绕过障碍重写、刷新已经漂移的计划、清理已经被顺手修掉的发现。
其他常用命令：
/improve branch：提交 PR 之前用，只审计当前分支改动的内容。/improve next：功能建议——这个项目接下来往哪走。/improve plan <描述>：跳过审计，直接为一件事写方案。/improve review-plan <文件>：评审并收紧一份已有的计划。/improve ... --issues：把计划同步发布为 GitHub issues，同样是完整独立的内容，任何助手或同事都能接着做。
四、恢复办法
- 技能装完没反应：先确认你的编程助手支持 Agent Skills 格式；确认安装命令是在项目目录里执行的；重启助手后再试一次。
- 跑完 /improve 没有发现清单：确认助手当前打开的是代码仓库目录；换
/improve quick再试一次；空仓库或刚初始化的项目可能确实没什么可审的。 - 计划里的发现是误报：技能在审计时会逐条复核引用的位置，误报会被直接去掉；被驳回的发现会把理由记下来，下次审计不再重复出现；也可以直接删除对应的计划文件。
- 执行结果和计划对不上：让技能复核 diff，给出结论；最多两轮返工，仍然不通过就按计划手工改，或者放弃这份计划。
- 想撤销：直接删除
plans/目录即可。技能只写plans/，不会改动你的源码。 - 审计费用太高：先用
/improve quick做快速扫描；只把挑中的发现写成计划；执行一律交给便宜模型。
五、注意事项（必读）
- 技能本身不改源码、不合并代码：唯一的写入就是
plans/目录；执行只发生在隔离的 worktree 里，合并永远由你决定。 - 不要把密钥、令牌贴进审计对话：技能只记录密钥的位置和类型，从不复现密钥值，发现疑似泄露会建议轮换。
- 计划按写计划时的提交版本写成：执行前会做漂移检查，代码变了会先提示，不要跳过这一步。
- 审计结果要人工复核：发现清单里的置信度（HIGH / MEDIUM / LOW）和工作量（S / M / L）只是参考，最终是否立项由你判断。
- 费用要搭配好：审计用最强模型、执行用便宜模型，搭配好能省不少；但审计本身也会消耗强模型的额度，先拿小仓库练手。
- 版本会变，以官方仓库为准：本文的命令和流程以 2026 年 11 月 12 日核实的 README 为准，个别命令和选项可能调整，遇到与本教程不一致的地方，以仓库 README 为准。
六、官方资源链接
- GitHub 项目：https://github.com/shadcn/improve
- Agent Skills 格式官网：https://agentskills.io
- 示例项目 shadcn/ui：https://github.com/shadcn/ui
七、常见问题
Improve 是免费的吗？ 技能本身免费开源，采用 MIT 协议。但调用模型要按各家助手的价格计费，审计用强模型、执行用便宜模型，搭配好能省不少。
一定要用 Claude Code 吗？ 不用。任何支持 Agent Skills 格式的助手都行，计划文件是纯 Markdown，换助手也能直接用。
Improve 会直接改我的代码吗？ 不会。技能本身只写 plans/ 目录；执行发生在隔离的 git worktree 里，复核通过后是否合并由你决定。
Improve 和 anthropics/skills 有什么区别？ anthropics/skills 是 Anthropic 官方的技能仓库，讲的是技能这种形式本身；Improve 是基于 Agent Skills 格式的一个具体技能，专注做代码审计和实施计划这一件事。
Improve 和 Cloudflare 的 Security Audit Skill 有什么区别？ 后者专注安全审计一个方向；Improve 覆盖正确性、安全、性能、测试、技术债等 9 类问题，核心是“强模型出计划、便宜模型执行”的分工。
没有代码仓库能用吗？ 需要一个代码库来审计。可以先拿自己的小项目，或者 shadcn/ui 这类开源项目练手。
计划文件是什么格式？ 纯 Markdown，任何助手或人都能接着用；加 --issues 还能发布成 GitHub issues。
