mcpField
P
package-architect

package-architect

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

package-architect について

Bun、pnpm、npmのワークスペースで再利用可能なTypeScriptパッケージを構成するスキルです。monorepoのパッケージ境界、公開エクスポート、TypeScript参照、ビルド構成を扱います。

主な機能

  1. 01再利用可能なTypeScriptパッケージの構成
  2. 02安定したパッケージエクスポートの定義
  3. 03TypeScriptプロジェクト参照の設定
  4. 04ビルド成果物とソースの分離
  5. 05依存関係と設定の整合性確認

活用シーン

  1. 01monorepoでのパッケージ作成
  2. 02ワークスペースパッケージの再構成
  3. 03パッケージエクスポートとTypeScript参照の設定

インストール

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

$npx skills add https://github.com/shipshitdev/skills --skill package-architect

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

同梱ファイルplugin.json

詳細

パッケージアーキテクト

モノレポ（Bun、pnpm、または npm ワークスペース）で再利用可能な TypeScript パッケージを設計します。

使用する場面

  • 新しいパッケージの作成、またはモノレポ内のパッケージの再構成
  • package.json のエクスポートの定義
  • tsconfig の参照の設定

基本原則

  • パッケージごとに単一の責務を持たせます。
  • 明確なエクスポートを備えた安定した公開 API を提供します。
  • インラインインターフェースを避け、型を一元管理します。
  • ビルド出力とソースを分離します。

パッケージ構成（例）

packages/
  utils/
    src/
    package.json
    tsconfig.json
  api-client/
    src/
    package.json
    tsconfig.json

エクスポートのパターン（例）

{
  "name": "@scope/utils",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "exports": {
    ".": {
      "import": "./dist/index.js",
      "types": "./dist/index.d.ts"
    }
  }
}

TypeScript の参照

  • パッケージ間の依存関係にはプロジェクト参照を使用します。
  • ローカル開発時のインポートにはパスエイリアスを推奨します。
  • tsconfig のベース設定はパッケージ間で共通にします。

チェックリスト

  • エクスポートマップが意図した公開 API と一致している
  • 型が JavaScript の出力とともにビルドされる
  • 循環依存がない
  • lint と tsconfig の設定が一貫している

コメント

Markdown 対応