スキル

improve でコードベースを監査し、plans だけを出す

強いモデルで先にコードベースを監査し実装計画を書いてほしい人向け。ただし書き込みは plans/ のみで、ソースは決して変えない前提です。

公式ソース · shadcn/improve

インストール

npx skills add shadcn/improve

向いている人

より強いモデルでコードベースを把握し、何がやる価値があるかを判断し、仕様を書いたうえで、実行をより安いモデルに渡したいなら improve が向きます。公式の書き方は:任意のコードベースを監査し、他のエージェント向けに実装計画を書く。スキル自身は何も実装せず、計画が成果物です。

初回は計画で止めてください。ソースは変えません。許される書き込みは plans/ だけです。同じスキルに業務コードを直接変えさせたいなら、選び間違いです。実行側は捨てられる worktree の中だけで変え、マージは常にあなたが行います。本ページは worktree コマンドを出していません。自分で作らないでください。

公開説明は、Agent Skills 形式を支える任意のエージェントで動くと書いています。計画は普通の markdown で、エージェントでも人でも続けられます。具体的なクライアントは名指しされていません。製品名簿を足さず、独占対応とも書かないでください。

3分で初回トライ

公式のインストールコマンドは次の1本だけです:

npx skills add shadcn/improve

前提:監査したい実在のコードベースがあり、そのプロジェクトで npx を実行できること。入れたあと /improve を使う準備をします。2本目の入れ方を発明しないでください。

インストールはスキルファイルを書き込みます。実行前に、今のディレクトリが監査したいリポジトリであることを確認してください。コマンドのあと、計画を書かない確認を先にします:エージェントが /improve を認識し、「plans/ だけを書き、ソースは変えない」と言い直せることを確認。それがインストールの観察できる成功合図です。

本番の /improve は完全な監査、優先度付け、plans/ への計画書き込みをします。新しい markdown 計画ファイルを受け入れられると確認してから実行:

/improve

成功の合図:ソースはそれによって変わっておらず、plans/ に優先度付きの所見と実装計画があること。公開資料は他のスラッシュコマンドを列挙しておらず、計画ファイルの命名規則も保証していません。

利用ケース

ケース 1:今のリポジトリを完全監査し、計画を出す。導入済みなら /improve を実行し、監査 → 優先度の所見 → 計画まで通します。先に plans/ の markdown を見てから、他者に実行を渡すか決めます。これが本スキルの主ワークフローです。公開説明は監査観点の一覧を書いていません。どのファイルを見るか既に知っているふりをしないでください。

ケース 2:計画を他のエージェントまたは人に渡して実行させる。公式は計画が普通の markdown で誰でも引き継げると言い、本スキルは依然として実装しません。実行側は捨てられる worktree の中だけで変え、マージはあなたが完了します。先に計画範囲を確認してから渡します。本ページは実行コマンドもマージコマンドも出していません。このケースは「計画を引き渡し、マージは自分で握る」までです。

利用上の境界

スキル自身はソースを決して変えず、書き込みは plans/ だけです。自動リファクタや自動修復ツールとして使わないでください。主作業領域で計画を直接実行させないでください。

インストールは npx skills add shadcn/improve だけです。ページはクライアントを名指しせず、Agent Skills 形式の対応だけを言います。marketplace を足さず、示されていない skills ディレクトリをコピーしないでください。

/improve は計画ファイルを書きます。実行前に確認してください。公開資料にアンインストール手順はなく、「より強いモデル / より安いモデル」を必須の具体型番にもしていません。

リポジトリURL:

https://github.com/shadcn/improve