安裝
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;先確認這是你允許寫入的倉庫再執行。不要在這一步跑修復技能。
若介面索要材料未出現的金鑰,或要把所有套件管理器安裝命令一起跑,立刻停。
使用案例
案例一:聲明並校驗結構約定。對應 konsistent-config 技能與 konsistent validate。適合還沒有穩定 konsistent.json、只想先把模式寫對的人。材料沒有寫設定欄位清單;能確認的是先有設定,再用 validate。不要把案例一寫成已經全倉庫通過。
案例二:按約定檢查或逐條看違規。對應 konsistent / konsistent check(Check structural conventions),以及第二條技能 npx skills add vercel-labs/konsistent --skill konsistent-fix-violations。適合設定已通過校驗、只想看哪些檔案不合模式的人。check 相對可逆;fix-violations 會 walks violations,有改檔案風險,執行前先確認目前分支允許修改。材料沒有寫自動修復一定安全。
使用邊界
它不替代 ESLint、Biome 或 oxlint 的檔案內規則,只補專案級結構。材料同時給出 NPM、PNPM、Bun 三種開發依賴裝法,第一次嘗試只選你正在用的一種,不要當三條都要執行。konsistent 是 konsistent check 的縮寫,兩者都需要可用的 konsistent.json。沒有出現發布、格式化或非 TypeScript 倉庫的承諾。沒有出現的安裝方式一律不要補。