ni

fohte 的头像作者 fohte

使用ni (@antfu/ni)进行包管理器操作。在JavaScript/TypeScript项目中安装依赖项、运行脚本或执行包时使用此技能。

📖 中文导读:使用ni (@antfu/ni)进行包管理器操作。在JavaScript/TypeScript项目中安装依赖项、运行脚本或执行包时使用此技能。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: ni description: Use ni (@antfu/ni) for package manager operations. Use this skill when installing dependencies, running scripts, or executing packages in JavaScript/TypeScript projects.

ni - Package Manager Agnostic Commands

JavaScript/TypeScript プロジェクトでパッケージマネージャー操作を行う際は、npm, yarn, pnpm, bun などを直接使用せず、@antfu/ni のコマンドを使用すること。

ni はプロジェクトの lockfile を自動検出し、適切なパッケージマネージャーコマンドに変換する。

コマンド対応表

ni コマンド 用途 npm 相当
ni 依存関係のインストール npm install
ni <pkg> パッケージ追加 npm install <pkg>
ni -D <pkg> devDependencies に追加 npm install -D <pkg>
nr <script> スクリプト実行 npm run <script>
nlx <pkg> パッケージ実行 npx <pkg>
nu 依存関係の更新 npm update
nun <pkg> パッケージ削除 npm uninstall <pkg>
nci クリーンインストール npm ci

使用例

# 依存関係をインストール
ni

# パッケージを追加
ni axios

# devDependencies に追加
ni -D typescript @types/node

# スクリプト実行
nr build
nr test
nr lint

# npx 相当
nlx eslint --fix .
nlx prettier --write .

# パッケージ削除
nun lodash

# クリーンインストール
nci

注意事項

  • ni は mise でグローバルインストール済み (config/mise/home-config.toml)
  • lockfile が存在しないプロジェクトでは、ni はデフォルトで npm を使用する
  • nr でスクリプトを実行する際、引数は -- なしでそのまま渡せる