🔑 インストールガイド

対象: SDKを install する人・CIを組む人向け。 概要: 基本のインストール手順は README.md にあります。本書はそこに 収まらない権限まわりの運用（Organization外への付与、GitHub Actions からの利用）を扱います。 公開後はこのドキュメント自体が不要になります。

---

1. 権限の継承

このパッケージは OmoshiroGamePortal リポジトリから publish されており、デフォルトでそのリポジトリの権限を継承します。

OmoshiroGamePortal に read 権限を持つ milightpartner Organization メンバーは、 README.md の認証設定（PAT と .npmrc）だけで install できます。Package settings 側での追加設定は要りません。

2. Organization外の人・チームに個別に許可する

OmoshiroGamePortal へのアクセス権を持たない人にパッケージだけ使わせたい場合は、 Package settings → Invite teams or people から個別に権限を付与します（要リポジトリ管理者権限）。

リポジトリ側の権限は変わりません。

3. GitHub Actions から install する

同一Organization内のリポジトリであれば、ワークフローの GITHUB_TOKEN を利用できます（packages: read 権限が必要）。

- uses: actions/setup-node@v4
  with:
    node-version: 20
    registry-url: 'https://npm.pkg.github.com'
    scope: '@milightpartner'
- run: npm ci
  env:
    NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

⚠️ OmoshiroGamePortal 以外のリポジトリの Actions からは、§1 の権限継承が効きません。 Package settings → Manage Actions access で対象リポジトリを個別に許可する必要があります （要リポジトリ管理者権限）。