技能包

用 improve 审计代码库并只产出 plans

适合要用强模型先审计代码库并写出实现计划的人,前提是接受它只写入 plans/、绝不改源码。

官方来源 · shadcn/improve

安装

npx skills add shadcn/improve

适合谁

如果你希望先用更强的模型把代码库看清楚、判断什么值得做、写出规格,再把执行交给更便宜的模型,improve 适合你。官方把它写成:审计任意代码库,并为其它智能体写出实现计划。技能自己不实现任何东西,计划才是产物。

第一次就应该停在计划。它不会改源码,唯一允许的写入是 plans/。若你想让同一个技能直接改业务代码,选错了。执行方只应在可丢弃的 worktree 里改,合并永远由你来做;本页没有给出 worktree 命令,不要自行编造。

公开说明写它能在任何支持 Agent Skills 格式的智能体里工作,计划是普通 markdown,智能体或人都能接着做。没有点名具体客户端,不要补一份产品名单,也不要写成独家支持。

3 分钟完成第一次尝试

只使用下面这一条官方安装命令:

npx skills add shadcn/improve

前置条件:你有一个真实代码库要审计,并且能在该项目运行 npx。安装后准备使用 /improve。不要再发明第二条安装方式。

安装会写入技能文件。执行前先确认当前目录就是要审计的仓库。命令结束后,先做一次不写计划的核对:确认智能体认识 /improve,并能复述「只写 plans/、不改源码」。这是安装可观察的成功信号。

真正跑 /improve 会做完整审计、排出优先级,并往 plans/ 写计划。先确认你可以接受新增 markdown 计划文件,再执行:

/improve

成功信号:源码未被它改动,plans/ 里出现带优先级的发现和实现计划。公开材料没有列出其它斜杠命令,也没有保证计划文件的命名规则。

使用案例

案例一:对当前仓库做一次完整审计并产出计划。在已安装的前提下运行 /improve,让它走完审计 → 优先级发现 → 计划。先看 plans/ 里的 markdown,再决定要不要交给别人执行。这是本技能的主工作流。公开说明没有写审计维度清单,不要假装已经知道它会检查哪些文件。

案例二:把计划交给其它智能体或人执行。官方说计划是普通 markdown,任何智能体或人都可以接手;本技能仍然不实现。执行方只应在可丢弃的 worktree 里改,合并由你完成。先确认计划范围,再交给执行方。本页没有给出执行命令或合并命令,这个案例只覆盖到「交接计划、自己控制合并」。

使用边界

技能自己永不改源码,写入只去 plans/。不要把它当成自动重构或自动修复工具。也不要让它在主工作区直接执行计划。

安装只有 npx skills add shadcn/improve。页面没有具名客户端,只说支持 Agent Skills 格式。不要补 marketplace,也不要复制未给出的 skills 目录。

/improve 会写计划文件,执行前先确认。公开材料没有卸载步骤,也没有把「更强模型 / 更便宜模型」写成必须使用的具体型号。

仓库地址:

https://github.com/shadcn/improve