Communitygithub.com

AntTheLimey/gm-apprentice

gm-apprenticeのキャンペーンボールトをGitHub PagesまたはCloudflare Pagesで静的サイトとして公開し、プレイ中にプレイヤーがシート編集をリクエストできる変更依頼ループを実行します。キャンペーンサイトの構築、公開、更新、再構築、プレイヤーとの共有、GitHub PagesやCloudflare Pagesのセットアップ、ビルドエラーのトラブルシューティング、新しいボールトスキーマへのサイト移行、セッション中のプレイヤーシート変更リクエストの監視に使用します。

gm-apprentice とは?

このスキルは、gm-apprentice TTRPGキャンペーンボールトをCloudflare Pages(新規推奨)またはGitHub Pagesで公開する静的サイトジェネレーターです。ボールトのコンテンツをプレイヤーと共有可能なサイトに変換し、ビルド、デプロイ、トラブルシューティングを担当します。主な機能には、初回セットアップ(セットアップウィザードに従う)、ルーチン更新(manifest diff/apply、publish-played、deploy --verify)、トラブルシューティング(doctor、explain)、スキーマ移行(folderMap比較)、マルチサイト管理、コンテンツフィルタリング(プレイヤーモード/フルモード)、変更依頼ループ(GURPS 4e、CoC 7eのシート編集)、ライブステータスバーとインボックスのセットアップ(Cloudflare Pagesのみ)があります。Node 22+が必要で、ビルドツールはプラグイン内に同梱され、scaffoldされたサイトからnpmで利用します。非技術者向けに平易な言葉でガイドすることを重視しており、ライセンスコンテンツの取り扱いにも注意を促します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AntTheLimey/gm-apprentice/tree/HEAD/skills/publish-site

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

サイトの公開

gm-apprenticeボールトのコンテンツを、TTRPG GM向けの共有可能な静的サイトに変換します。Cloudflare Pages(新規設定には推奨)またはGitHub Pages(完全サポート)でホストされます。どちらの場合でもビルドされたサイトは同一で、vault.config.jsonのhost(cloudflare-pagesまたはgithub-pages。省略時はgithub-pages)がデプロイ方法を決定します。

GMがセットアップ、ルーチン更新、トラブルシューティングを平易な言葉で行えるようにガイドしてください。ほとんどのGMは技術者ではありません。npm、git、ターミナルコマンドが何をするかを説明し、既知の知識を前提としないでください。

バージョンチェック: 最初の呼び出し時にpython3 "${CLAUDE_PLUGIN_ROOT}/skills/shared/scripts/vault_check.py" <vault> versionを実行します。OK/SETUP → 続行。MISMATCH → その行を報告し、campaign-organizerのreferences/migration-procedure.mdを実行してから再開します。AHEAD → その行を報告し、GMにプラグインの更新を促して停止します。ERROR → その行(プラグインインストールの破損)を報告して停止します。判定行がなく、not a directoryエラーがある場合 → GMに正しいボールトパスを尋ねます。

ビルドツール

すべてのビルドロジックはgm-apprentice-publishツールに含まれており、このプラグインに同梱されています(npmレジストリからインストールしたり、ロジックを複製したりしないでください):

<plugin-cache-path>/gm-apprentice/<plugin-version>/tools/publish

<plugin-version>は.claude-plugin/plugin.json(またはこのスキル自身のキャッシュパス)から取得します。ワンオフコマンドはキャッシュから実行します:

TOOL="<plugin-cache-path>/gm-apprentice/<plugin-version>/tools/publish/bin/gm-publish.js"
node "$TOOL" init <target-dir>   # 新しいサイトをスキャフォールド(自動的にこのバージョンにピン留め)
node "$TOOL" update-pin --site <dir>                       # 古いサイトの再ピン留め + npm install(プラグイン外では --tag publish-vX.Y.Z を追加してリリースtarballをピン留め)
node "$TOOL" manifest diff --config <dir>/vault.config.json    # マニフェストとボールトファイルを比較
node "$TOOL" manifest apply --config <dir>/vault.config.json ...  # マニフェストを編集
node "$TOOL" manifest publish-played --config <dir>/vault.config.json  # プレイ済みセッションを登録
node "$TOOL" deploy --verify --config <dir>/vault.config.json  # ビルド、デプロイ、URLをプローブ
node "$TOOL" doctor --site --config <dir>/vault.config.json    # 公開に関する欠陥をボールトで監査
node "$TOOL" explain "<vault-relative path>" --config <dir>/vault.config.json  # 1ファイルの公開チェーン
node "$TOOL" --version
node "$TOOL" --help

このスキルがビルドまたはデプロイを実行する前に、node "$TOOL" manifest publish-played --config <dir>/vault.config.jsonを自身で実行し、サイトがプレイ済みセッションを欠いて公開されないようにします(#277)。これは、公開されるWrap-Upとリンクされたレビュー済みセッションインデックスのみをチェックし、サイトがハブ本文を保留します。Excludedエントリはスキップし、プレイヤーモードでマニフェストがない場合は何も行いません。チェックされたパスを報告します。他のプレイ済みセッションは、その理由(Wrap-Upなし、Wrap-Up未レビュー、Excludedまたは公開されない、古いサイトのピン留め)とともに「不明」としてリストされます。GMに一度、理由を列挙して1つの質問で尋ねます。公開されるWrap-Upがないものについては、そのインデックス本文がそのまま公開されると伝え、最初にKeeperノートをフェンスで囲むことを提案します。承認された各セッションは、manifest publish-played --config <dir>/vault.config.json --session "<index>"で登録します。Wrap-Upがある場合は--include-unreviewedを追加し(未レビュー、または古いピン留め:レビューチェックのみを免除するため、それでも返される理由があれば中継します)、Wrap-Upがない場合は--publish-bodyを追加します。manifest applyでセッションインデックスをチェックしないでください。サイレントにチェックしないでください。GMが「まだ」と言った場合は、そのまま残し、この実行では再度尋ねないでください。理由がサイトが古いツールにピン留めされていることを示す場合は、最初にupdate-pin --site <dir>を提供します。ビルド自体はボールトに対して読み取り専用であるため、これはスキル内にあり、build/deployにはありません。

スキャフォールドされたサイト内では、npmでビルドします(スキャフォールドのfile:ピンからツールを解決します。レジストリもネットワークも不要です):

npm install      # ピン留めされたビルドツールをリンク(依存関係はベンダー同梱)
npm run build    # ボールトからdocs/を生成
# 1つのPCのシートを表示 — vault.config.jsonが必要なので、ここで実行
npx gm-apprentice-publish sheet show --pc <name> [--player-safe] [--json]

Node 22+が必要です。バージョンエラーの場合は、GMをhttps://nodejs.org(LTS)に誘導します。

サイトディレクトリ: ケイパビリティ2と4は、_meta/vault-config.mdからpublish.site_dirを読み取ります。相対値はボールトからの相対パスです。未設定の場合は、サイトリポジトリの絶対パスを尋ね、そこに保存することを提案します。サイトがまったくない場合は登録するものがないため、publish-playedをスキップします。

9つのケイパビリティ

1. 初回セットアップ

(「キャンペーンを公開」「サイトをセットアップ」「プレイヤーにキャンペーンを見せたい」)

references/setup-wizard.mdの手順に従ってください。これは信頼できる手順です(最初にpreflight doctor、Cloudflareデフォルト、publish.setup_progressから再開)。即興やステップのスキップはしないでください。

2. ルーチン更新

(「サイトを更新」「再ビルド」「ボールトを更新した」)

  1. サイトディレクトリを特定します(上記)。
  2. node "$TOOL" update-pin --site <dir> — 1行の出力を報告します。
  3. node "$TOOL" manifest diff --config <dir>/vault.config.json。New/Removedファイルがリストされている場合は、それらを提示します。GMが確認した後、node "$TOOL" manifest apply --config <dir>/vault.config.json --publish <path>... --exclude "<path>=<reason>"... --pruneを実行します。プレイ済みセッションインデックスは--publishに含めないでください:publish-played(上記)がそれらを登録します。
  4. node "$TOOL" deploy --verify --config <dir>/vault.config.json — 最終行をそのまま中継します。非ゼロ終了の場合は、ケイパビリティ3に進みます。Cloudflare認証情報の欠落はdeployがインラインで説明します。直接設定するには、node "$TOOL" doctor --set-cloudflare-credsを実行します。

3. トラブルシューティング

(エラーメッセージ、「ビルドがクラッシュした」「ポートレートが表示されない」「ページがない」「リンクが壊れている」)

最初にnode "$TOOL" doctor --site --config <dir>/vault.config.jsonを実行します。1ページが欠落している場合は、node "$TOOL" explain "<vault-relative path>"を実行します。次にreferences/troubleshooting.mdを使用します:障害モードを指名し、原因を平易に説明し、修正をステップバイステップでガイドし、適用することを提案します。

4. スキーマ移行

(「新しいエンティティタイプを追加した」「campaign-organizerが更新された」「ボールトに新しいフォルダがある」「更新後にページが欠落している」)

  1. サイトディレクトリを特定し、そのvault.config.jsonを読み取ります。
  2. folderMapをボールトのフォルダと比較し、folderMap / excludeDirsの追加を提案します。
  3. 確認後に適用し、npm run buildで確認します。
  4. 新しいタイプがどのようにレンダリングされるかを簡潔に説明します(専用テンプレートまたはスマートウィキフォールバック — references/schema-reference.md)。

5. マルチサイト管理

(「2つのキャンペーンがある」「すべてのサイトを更新する」)

各サイトリポジトリパスとそのボールトパスを会話内で追跡し、すべてのサイトでルーチン更新をループすることを提案し、プッシュ前に各サイトを確認します。

6. コンテンツフィルタリング

(「プレイヤーコンテンツのみ公開」「GMノートを非表示」「プレイヤーに何が見えるか」「ネタバレなしで公開」)

references/content-filtering.mdの§ コンテンツ可視性モデルと§ マニフェスト形式を読んでください。mode: playerでは、ファイルは## Publishingの下のチェックされたエントリとしてのみ公開されます。## Excludedまたは## Needs Decisionの下でチェックしても公開されません。mode: fullはマニフェストを無視します。

  1. _meta/vault-config.mdを読み取ります。publish:セクションがない場合は、最初にcontent-filtering.mdの§ セットアップ質問フロー(テーマ、画像、404)に従い、初期設定を書き込みます。modeがplayerであることを確認します。fullの場合は停止し、GMにマニフェストをビルドする前に変更するように依頼します。
  2. すべてのボールトファイルを可視性モデルに従って分類し、_meta/publish-manifest.mdを書き込みます。
  3. 要約し、あいまいなアイテムをGMと一緒に確認し、各決定をマニフェストに記録します(## Publishingの下でチェック、または理由とともに## Excludedに移動)。

後の公開では、ケイパビリティ2のmanifest diffを通じて新しいファイルと削除されたファイルを取得します。

7. 変更依頼ループ(テーブル内)

(「チェックループを開始」「変更リクエストを拾う」「受信トレイを開く」「シート変更を監視」)

references/change-request-loop.mdに従います。クリーンなプレイヤーシート編集(GURPS 4eおよびCoC 7e)を適用し、エッジケースをフラグする、無人で自己ループするプロセスです。

8. ライブステータスバーセットアップ(Tier 2a)/ 9. テーブル内受信トレイセットアップ(Tier 2b)

(「ステータスバーをオンにする」「プレイヤーがHP/FPをライブ更新できるようにする」/「受信トレイをセットアップ」「プレイヤーが変更を送信できるようにする」)

Cloudflare Pagesのみ。サイトディレクトリからnode "$TOOL" setup-status-barまたはnode "$TOOL" setup-inbox(./vault.config.jsonでない場合は--config <path>)を実行します。どちらもpreflightゲート付き、べき等であり、KVを自身で処理します。詳細はreferences/cloudflare-pages.mdの§ 高速な方法を参照してください。setup-inboxはインフラのみです。テーブル内セッションはケイパビリティ7です。

参考資料

  • references/configuration.md — すべての設定。_meta/vault-config.md(フィルタリング、テーマ設定)は、両方が何かを設定する場合、vault.config.json(パス、URL、表示)よりも優先されます。
  • references/schema-reference.md — 各エンティティタイプがどのフィールドをレンダリングするか。
  • references/cloudflare-pages.md — Cloudflareトークン、認証情報(doctor --set-cloudflare-creds)、初回デプロイ、カスタムドメイン。
  • references/github-pages.md — 手動GitHub Pages有効化。両方のホストを同じdocs/から並行して実行できます。

コンパニオンスキル

campaign-organizerは、このスキルが読み取るボールト構造を作成します。欠落ページやスキーマの不一致は、通常、これに起因します。新しいコンテンツについては、GMをttrpg-expertに誘導してから再ビルドします。公開前のcampaign-qaパスにより、壊れたリンクがライブサイトに表示されるのを防ぎます。

著作権

公開されたサイトは公開されます。公開前に、ボールト内のライセンスされたTTRPGコンテンツがそのライセンスの範囲内に留まることをGMにリマインドしてください(gm-apprenticeリポジトリのATTRIBUTION.mdを参照)。生成されたページにライセンスされたルールテキストを決して入れないでください。ボールトノートに逐語的なルールテキストが含まれている場合は、GMに言い換えるようフラグを立ててください。

関連スキル