improveとは?
improve は、shadcn/ui の作者である shadcn によるエージェントスキルです。リポジトリで `/improve` を実行すると、スキルは技術スタックとビルド、テスト、lint のコマンドを把握し、9 つの分類(正確さ、セキュリティ、性能、テスト、技術的負債、依存関係、開発者体験、ドキュメント、プロダクトの方向性)でコードを監査し、指摘の表を返します。各指摘はファイルと行を示し、影響、工数、確信度が付きます。どれを計画にするかは利用者が選びます。
計画こそが成果物です。それぞれ `plans/` 内の Markdown ファイルで、監査を一度も見ていないモデル向けに書かれています。現在のコードの貼り付け、正確な手順、各手順の後に実行するコマンドと期待される結果、対象外の一覧、そしてコードが想定と違うときの STOP 条件です。スキル自身はソースを一切編集しません。`/improve execute` は計画を git worktree 内の別の実行役に渡し、その差分をレビューします。リポジトリはスター 12,083、MIT ライセンス、コミット 23 件で、タグ付きのリリースはなく、最後のコミットは 2026年9月12日です。
improveは使う価値があるか?
improve の背後にある考えは経済 的なものです。強いモデルは判断に、安いモデルは手を動かす作業に使います。スキルを読んだ限り、これを成り立たせる規律は計画のテンプレートにあります。各手順は検証コマンドとその期待出力で終わり、計画は書かれた時点の git コミットを記録するので、実行役はずれを確認できます。STOP 条件は、小さなモデルに即興せず止まって報告するよう指示します。
監査は、AI によるコードレビューにありがちな失敗、つまり自信満々の誤りに耐えるよう作られています。スキルによればサブエージェントは過剰に報告するため、アドバイザーは指摘を見せる前に引用された箇所をすべて自分で開き直し、誤検知を捨て、誤った帰属を直し、却下した理由を記録して次回に再び出ないようにします。README にある shadcn/ui での実行例は両面を示しています。特定の行の O(n²) のループは残り、プロキシ変数による「SSRF」とされたものは仕様どおりとして除外されました。
深さはコストのつまみです。`quick` はサブエージェントを最大 1 つ使い、確信度の高い指摘を約 6 件返します。既定では同時に最大 4 つ、`deep` では分類ごとに 1 つ、最大 8 つのサブエージェントが全パッケージを調べます。`execute` では、別のモデルを指定しない限り実行役は既定で Sonnet を使い、計画は最大 2 回の差し戻しを経ても通らなければブロックされます。
注意点:トークン数や節約額は公表されておらず、安い実行が高い監査の元を取るという主張はリポジトリ内で検証されていません。大きなコードベースで deep を実行すれば、最も強いモデルで長いサブエージェントのセッションが何本も走ります。`--issues` は計画を GitHub の issue として投稿します。スキルは公開範囲を確認し、公開リポジトリでセキュリティの指摘を投稿する前に確認を求めますが、確認のプロンプトだけでは、認証情報の場所を世界に公開してしまうことへの備えとしては心もとないものです。リリースはなく、9 月以降コミットもありません。
結論:improve は一度きりより習慣として使うほうが役に立ちます。毎月の `/improve quick` と、プルリクエストの前の `/improve branch` です。どのモデルが動く前にも、計画は人が読むべきです。
真価を発揮する場面
中規模の TypeScript サービスを引き継いだテックリード
根拠付きで、最初にやるべき少数の修正を見つける
`/improve` を実行し、計画にしたい指摘を「plan 1, 3 and 5」のように返信します。計画は索引と順序付きで `plans/` に置かれ、ソースのツリーには手が加わりません。
オープンソースのライブラリを一人で保守する人
監査結果をコントリビューターが拾えるタスクにする
計画はそれだけで完結した Markdown なので、そのままコントリビューターやエージェントに渡せます。公開リポジトリではセキュリティの計画も公開されるため、`--issues` で issue にするのは一つずつ読んでからにしてください。
モデルの予算が決まっている開発者
レビューには高いモデル、編集には安いモデルを使う
`/improve execute 001` は隔離された worktree で Sonnet の実行役を起動し(より小さいモデルなら `execute 001 haiku`)、計画のチェックを再実行して、承認、差し戻し、ブロックのいずれかを報告します。マージは引き続き手作業です。
導入前に確認すること
- 導入
- `npx skills add shadcn/improve` の後、リポジトリ内で `/improve`(安く済ませる最初の一回なら `/improve quick`)。リポジトリには Claude Code のプラグインマニフェストも含まれています。
- 連携
- Agent Skills 形式に対応する任意のエージェント。サブエージェントへの振り分けと worktree での実行は Claude Code 向けに書かれています。`--issues` には `gh` を使います。ADR、PRD、CONTEXT.md、DESIGN.md があれば読み、決定済みのトレードオフを指摘しないようにします。
- データとプライバシー
- ソースには読み取り専用です。書き込みは `plans/` だけで、監査で見つかった秘密情報は場所と種類で示し、値はコピーしません。ただしエージェントはコードを自分のモデルプロバイダーに送ります。MIT ライセンスです。
- 大規模利用時のコスト
- 有料プランはありません。コストはモデルの利用で、既定では同時に最大 4 つ、`deep` では最大 8 つのサブエージェントに加え、実行役の分がかかります。トークンや価格の数字は公表されていません。
- 制限
- 自分で実装することは断ります。新しい worktree には `node_modules` がないため、実行役はまず依存関係を入れる必要があります。リリースなし、コミット 23 件で、最新は 2026年9月12日です。
良い点
- 各指摘はファイルと行を示し、表示前に再確認される
- 計画には貼り付けたコード、検証コマンド、STOP 条件が入る
- ソースは一切編集せず、実行役は使い捨ての worktree で作業
- quick、standard、deep の段階でコストを調整できる
気になる点
- トークン数や節約額の公表がない
- deep では最も強いモデルでサブエージェントが最大 8 つ動く
- --issues で公開リポジトリに指摘が公開されうる
- タグ付きリリースなし、最後のコミットは 2026年9月
おすすめの人
Claude Code などスキル対応のエージェントを使い、強力なモデルのコードレビューを、自分たちや安いモデルが実行できる小さく検証可能なタスクに変えたいチーム。
improveの代替
improve:よくある質問
- improveは使う価値があるか?
- improve は高価なモデルを、コードではなく作業指示書を書く注意深いレビュアーに変えます。この分担は正しいのですが、それでどれだけ節約できるかは誰も公表していません。 評価は5点満点中3.9点です。
- improveの料金は?
- 無料のオープンソース(MIT)です。モデルの利用料はコーディングエージェントのプロバイダーが請求します。
- improveの欠点は?
- トークン数や節約額の公表がない; deep では最も強いモデルでサブエージェントが最大 8 つ動く; --issues で公開リポジトリに指摘が公開されうる; タグ付きリリースなし、最後のコミットは 2026年9月.
- improveは誰に向いているか?
- Claude Code などスキル対応のエージェントを使い、強力なモデルのコードレビューを、自分たちや安いモデルが実行できる小さく検証可能なタスクに変えたいチーム。
- チームや本番環境でimproveを使うと費用はいくらか?
- 有料プランはありません。コストはモデルの利用で、既定では同時に最大 4 つ、`deep` では最大 8 つのサブエージェントに加え、実行役の分がかかります。トークンや 価格の数字は公表されていません。
- improveは企業データを扱っても安全か?
- ソースには読み取り専用です。書き込みは `plans/` だけで、監査で見つかった秘密情報は場所と種類で示し、値はコピーしません。ただしエージェントはコードを自分のモデルプロバイダーに送ります。MIT ライセンスです。
- improveの代わりになるものは?
- 当サイトでレビューした中で最も近い代替はSuperpowers, BMAD Method 、 Open Code Reviewです。
回答確認日:2026年11月20日