インストール
npx skills add vercel-labs/konsistent --skill konsistent-config誰向けか
TypeScript リポジトリにすでに(またはこれから書く)プロジェクト級の構造取り決めがあり、CLI でファイルとディレクトリがそれらのパターンに合うか調べたい人向けです。公式リポジトリは https://github.com/vercel-labs/konsistent です。files and directories が match declared structural patterns かを調べ、ESLint、Biome、oxlint がファイル内スタイルだけを覆い、プロジェクト級構造を検証しない欠けを補う、と説明します。例は every provider package must export the same shape、または every adapter must extend the base class。別のコードスタイラーではありません。
先に konsistent.json を書き、それから validate / check する人により向きます。リポジトリに構造取り決めがまだないなら、最初の試行を全ファイル自動改変と読まないでください。材料は必須の代理製品を書いていません。
3 分で最初の試行まで
スキルの主経路は先に設定スキルを入れます。
npx skills add vercel-labs/konsistent --skill konsistent-config
前提: 今の環境で npx を実行でき、TypeScript リポジトリで konsistent.json を書くか調べる準備があること。材料に Node 版はありません。ディレクトリが設定を書いてよいか先に確認してから実行してください。副作用は konsistent-config スキルが入ることです。入れたあと、先にスキルに設定の照合または下書きをさせ、業務コードを一括で変えないでください。
低リスクな作業: このスキルをすでに使える代理で、konsistent.json の生成または確認だけをし、公式検査を実行します。
konsistent validate
成功の合図は設定ファイルが Validate the konsistent.json configuration file を通ることであり、ソースがすでに大量に直されたことではありません。まだ CLI がなければ、材料の開発依存の例は npm install konsistent --save-dev です。書き込みを許したリポジトリだと確認してから実行してください。この段階では修復スキルを走らせないでください。
インターフェースが材料にない鍵を求める、または全パッケージマネージャ導入コマンドを同時に走らせたがったら、直ちに止めてください。
利用ケース
ケース 1: 構造取り決めを宣言し検査する。konsistent-config スキルと konsistent validate に対応します。まだ安定した konsistent.json がなく、先にパターンを正しく書きたい人向けです。設定フィールド一覧はありません。確認できるのは、先に設定、それから validate です。ケース 1 を全リポジトリ通過済みと書かないでください。
ケース 2: 取り決めに沿って調べる、または違反を一条ずつ見る。konsistent / konsistent check(Check structural conventions)、および 2 本目のスキル npx skills add vercel-labs/konsistent --skill konsistent-fix-violations に対応します。設定検査が済み、どのファイルがパターンに合わないかだけ見たい人向けです。check は比較的可逆です。fix-violations は walks violations し、ファイル変更のリスクがあります。実行前に今のブランチが変更を許すか確認してください。自動修復が常に安全だとは書いていません。
利用上の境界
ESLint、Biome、oxlint のファイル内規則の代わりにはならず、プロジェクト級構造だけを補います。材料は NPM、PNPM、Bun の 3 通りの開発依存導入を同時に出します。最初の試行では今使っている 1 つだけ選び、3 本すべて実行が必要だと思わないでください。konsistent は konsistent check の短縮であり、どちらも使える konsistent.json が必要です。公開、整形、非 TypeScript リポジトリの約束はありません。出ていない導入方法は補わないでください。