shadcn/improve - 用最强模型审计代码库，让便宜模型执行

shadcn/improve 是一个开源的 Agent Skill，它可以审计任何代码库并编写执行计划，让其他 Agent 按计划执行。核心思路是：用最强模型做最需要智力的事情——理解代码库、判断优先级、写执行规范——然后把执行交给更便宜的模型。

项目简介

shadcn/improve 由 shadcn 开发维护，是一个遵循 Agent Skills 格式的技能包。截至目前，该项目在 GitHub 上已获得 2,560 stars，采用 MIT 开源协议。

它的工作流程可以用一句话概括：你负责思考，它负责写计划，便宜模型负责干活。

你 → /improve（贵模型，出主意）
plans/ → 001-fix-n-plus-one.md（自包含规范）
其他 Agent → 执行、测试、提交（便宜模型，干活）

安装

npx skills add shadcn/improve

适用于任何支持 Agent Skills 格式的 Agent。它编写的计划是纯 Markdown 格式，任何 Agent 或人都可以接手执行。

使用方式

主要命令

典型工作流

首次运行：在仓库中打开 Agent，执行 /improve 或 /improve quick。

它会扫描仓库、执行审计，返回一个发现列表表格。你回复要生成计划的条目编号，计划就会落入 plans/ 目录——每个发现一个文件，附推荐执行顺序。

计划是写给最弱的执行者看的——一个从未参与过会话、甚至可能是小模型的 Agent。因此每个计划都做到三点：

1. 自包含：所有上下文内联在文件中——精确文件路径、当前代码片段、仓库规范、已验证的命令。没有"如上所述"。
2. 验证门：每个步骤结束时都有命令和预期输出。完成标准是机器可判别的，执行者不需要自行判断是否成功。
3. 硬边界：显式的"超出范围"列表和 STOP 条件——"如果 X 则停止并报告"——避免小模型在实际情况与计划不符时自行发挥。

闭环执行：/improve execute 001 在一个隔离的 git worktree 中派遣便宜模型，把结果对照计划和技术负责的标准审查——重跑每个验证门、检查范围合规性、对比 diff 和意图。最终给出 verdict：批准（合并由你决定）、打回修改（最多 2 轮），或阻塞修正。

持续维护：/improve reconcile 处理上次之后的变更：验证已完成的计划是否仍然成立、调查阻塞的计划并重写、刷新漂移的计划、废弃已被独立修复的发现。

核心特性

• 发现驱动：并行派发子 Agent 覆盖九个类别——正确性、安全、性能、测试覆盖率、技术债务、依赖与迁移、开发者体验、文档、产品方向
• 事实核查：每个发现都附带 file:line 证据、影响评估、工作量和置信度。子 Agent 会过度报告，主 Agent 在展示前重新读取每个引用的位置——误报被剔除，错误归属被纠正
• 可执行计划：计划附有 git commit 哈希戳，执行前先做机械漂移检查
• 零突变：/improve 从不修改源代码本身，只写 plans/ 目录。执行者只在 disposable worktrees 中编辑，合并权始终在你手中
• GitHub Issues 集成：--issues 参数可将计划同时发布为 GitHub Issues

设计理念

项目的核心原则是"计划即产出"（The plan is the product）。审计阶段并行派发子 Agent，主 Agent 对每个发现重新核实，按 leverage（impact / effort × confidence）排序后展示给你选择。选择哪些成为计划完全由你决定。

硬规则：永远不修改源代码。只读分析，不写代码。如果被要求执行，它会拒绝并指向计划文件。

项目链接

• GitHub 仓库：shadcn/improve
• 安装方式：npx skills add shadcn/improve
• 协议：MIT License