mcpField
G
guide

guide

github.com/toss開発11.4k523 回インストール2 日前に更新
リポジトリ

guide について

さまざまなランタイムでの es-toolkit のインストール、インポート、利用に関する質問に答えるスキルです。プロジェクトのパッケージマネージャーと導入済みパッケージ情報を確認し、環境に合わせて案内します。

主な機能

  1. 01ロックファイルからパッケージマネージャーを判定
  2. 02導入済みバージョンとエクスポートの確認
  3. 03ランタイム別のインストール案内
  4. 04インポート方法と tree-shaking の説明
  5. 05公式利用ドキュメントへのリンク

活用シーン

  1. 01プロジェクトのランタイムに es-toolkit を導入
  2. 02適切なインポートパスの選択
  3. 03ワークスペースパッケージのエクスポート確認
  4. 04tree-shaking を妨げるインポートの回避

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/toss/es-toolkit --skill guide

インストール後、Claude Code で/guideを入力して読み込まれたか確認します。

詳細

es-toolkit の使用ガイド

さまざまなランタイムで es-toolkit をインストール、インポート、使用する方法をご案内します。

入力

$ARGUMENTS — es-toolkit の使用に関するトピックまたは質問です。

信頼できる情報源が重要な理由

インストールコマンドやインポートパスは、バージョンによって変わります。es-toolkit がすでにインストールされている場合は、インストール済みパッケージからバージョンとエクスポートを確認してください。このスキルは単独のディレクトリとしてインストールされている場合があるため、es-toolkit リポジトリや隣接する docs ディレクトリが利用できると決めつけないでください。

ワークフロー

1. ユーザーのプロジェクトを調べる

ロックファイルからパッケージマネージャーを判定します。

  • package-lock.json → npm
  • yarn.lock → Yarn
  • pnpm-lock.yaml → pnpm
  • bun.lock または bun.lockb → Bun

es-toolkit がインストールされている場合は、依存しているパッケージからパッケージのメタデータを解決します。

node -e "console.log(require.resolve('es-toolkit/package.json'))"

コマンドはモノレポのルートから自動的に実行するのではなく、該当するワークスペースパッケージから実行してください。プロジェクトが Yarn Plug'n'Play を使用している場合は、node の代わりに yarn node を使用します。解決された package.json を読み込み、インストール済みのバージョンと exports を確認してください。

es-toolkit がまだインストールされていないためにコマンドが失敗した場合は、以下のインストール手順に進んでください。リポジトリ相対のファイルは検索しないでください。

2. ユーザーの環境に合わせて回答する

ランタイム（Node.js、Bun、Deno、ブラウザー）を特定し、その環境に応じた情報を提供します。

安定しているセットアップ情報：

  • Deno：deno add jsr:@es-toolkit/es-toolkit（jsr: プレフィックスに注意してください）
  • Deno のインポートパス：'@es-toolkit/es-toolkit'（npm よりスコープが追加されています）
  • npm/yarn/pnpm/bun：検出したパッケージマネージャーに対応するコマンドを提示します。ロックファイルがない場合は、ユーザーの希望するパッケージマネージャーを尋ねるか、利用可能なコマンドを提示します。
  • インポートパス：strict には 'es-toolkit'、lodash 互換には 'es-toolkit/compat' を使用します。
  • ブラウザー/CDN：jsdelivr と unpkg は UMD ビルド（_ グローバル）を提供し、esm.sh は ES モジュールを提供します。最新のスニペットについては、以下の公式使用ガイドにリンクしてください。
3. 該当するトピックを取り上げる
  • インストール：ランタイムごとのコマンド
  • インポートパターン：名前付きインポート（ツリーシェイキングに推奨）、カテゴリ別インポート、compat インポート。パッケージがインストールされている場合は、記憶に頼った一覧ではなく、解決されたパッケージの exports から利用可能なサブパスインポートを示してください。
  • 避けるべきアンチパターン：名前空間インポート（import * as _ from 'es-toolkit'）はツリーシェイキングを妨げるため、避けるよう注意してください。常に名前付きインポート（import { chunk, debounce } from 'es-toolkit'）を優先してください。
  • バンドルサイズとパフォーマンス：以下の公式ページにリンクしてください。正確な数値を引用するのは、ユーザーが提示した場合、または現在のリポジトリのチェックアウトにベンチマークデータがある場合に限ってください。スキル内に古い数値を残さないでください。
  • 型安全性：組み込みの TypeScript 宣言がパッケージに含まれています。
4. リポジトリのドキュメントは存在する場合のみ使用する

現在のプロジェクトが es-toolkit のソースリポジトリであれば、docs/ と src/ 内のローカルファイルが信頼できる情報源であり、検索できます。そうでない場合は、インストール済みパッケージのメタデータと宣言を使用してください。このスキルの隣に docs ディレクトリがあると想定しないでください。

5. 常にドキュメントへのリンクを含める

回答の最後に、関連するリンクを記載してください。

## Learn More
- Documentation: https://es-toolkit.dev/intro.html
- Usage: https://es-toolkit.dev/usage.html
- Bundle size: https://es-toolkit.dev/bundle-size.html
- Performance: https://es-toolkit.dev/performance.html
- GitHub: https://github.com/toss/es-toolkit

コメント

Markdown 対応