mcpField
S
stigg

stigg

github.com/stiggioその他2108 回インストール4 週間前に更新
リポジトリ

stigg について

stiggは、Stiggの価格設定、パッケージ、エンタイトルメントに関する作業の入口となるスキルです。最新ドキュメントを先に調べ、連携方法を選び、適切な専門スキルを読み込みます。

主な機能

  1. 01コーディング前のドキュメント検索
  2. 02Stigg専門スキルへのタスク振り分け
  3. 03MCP、SDK、REST、GraphQL、CLI、ウィジェットの選択
  4. 04アカウント、環境、APIキーの前提条件の説明

活用シーン

  1. 01Stigg連携の実装方法の選択
  2. 02価格設定や請求タスクに合うスキルの特定
  3. 03連携作業前のセットアップ要件の確認

MCP 対応

モデリングや調査ではStigg MCPサーバーを優先し、ドキュメント検索や環境操作にも利用するよう案内します。MCPとCLIなど他の連携手段も区別します。

インストール

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

$npx skills add https://github.com/stiggio/skills --skill stigg

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
core-concepts.md
decision-tree.md
search-first.md

詳細

Stigg — 統合スキル

Stigg は、価格設定、パッケージング、エンタイトルメントのプラットフォームです。このスキルは、Stigg に関する作業の最初の窓口です。検索を最優先するルールを徹底し、適切なサブスキルへ案内します。

ステップ 0 — Stigg アカウントが必要です

以降のすべてのステップでは、すでに以下を用意していることを前提とします。

  1. app.stigg.io のアカウント（まだない場合は登録してください）。
  2. そのアカウントの少なくとも 1 つの環境（dev ／ staging ／ prod — Stigg はデフォルトのサンドボックスを自動的に用意します。本番環境は Scale プランで利用できます）。
  3. 操作する環境の Integrations → API keys で発行した API キー。

この 3 つがそろっていないと、サブスキルの「Stigg をセットアップする」手順はすべて 401 Unauthenticated で失敗します。まだ済ませていない場合は、連携の開始時にユーザーへ伝えてください。

プロジェクトで Stripe Projects を使用している場合は、ブラウザーを使わず、stripe projects add stigg/environment を実行してください。アカウントと環境が作成され、キーが .env に書き込まれます。stigg-sp を読み込んでください。

検索を最優先するルール（必須）

Stigg の連携コードを生成する前に、必ず最新のドキュメントを検索してください。 Stigg は頻繁に更新されるため、あらかじめ用意されたコード例は古くなります。「仕組みを覚えている」場合でも、このルールは適用されます。

For every Stigg task → search docs → then (if connected) call the Stigg MCP → only then write code.

検索方法（上から順に推奨）：

  1. Stigg MCP サーバー（mcp.stigg.io） — ユーザーが接続済みの場合、エージェントは search_docs を呼び出し、実際の環境に対して操作も実行できます。stigg-mcp を参照してください。
  2. Mintlify Stigg ドキュメント MCP — エージェントが公式ドキュメント MCP（search_stigg、query_docs_filesystem_stigg）を利用できる場合は、それを使用してください。
  3. https://docs.stigg.io/llms.txt — LLM 向けの URL インデックスです。取得して、該当するページを見つけ、そのページを取得してください。
  4. docs.stigg.io/<path> を直接取得 — 最終手段です。

詳しい理由と例については、references/search-first.md を参照してください。

危険信号 — 作業を止めて検索してください： import Stigg from '@stigg/...' や curl https://api.stigg.io/... の呼び出し、または GraphQL ミューテーションを書こうとしていて、このターン中にドキュメントページを開いていない場合。

適切な連携方法を選ぶ

Stigg には複数の連携方法があります。意図を持って選んでください。ユーザーが CLI を明示的に求めていない限り、MCP をデフォルトにしてください。基本方針の詳細は stigg-mcp/references/cli-vs-mcp.md を参照してください。

目的使用するもの
開発中の価格設定のモデリング、調査、単発の運用（デフォルト）Stigg MCP サーバー（stigg-mcp）
本番環境のホットパス：アクセス制御、使用量の報告、顧客向けページバックエンドまたはフロントエンド SDK（stigg-api → SDK マトリックス）
REST の直接呼び出し（使用言語向けの SDK がない場合、または薄いサーバーサイドプロキシを使う場合）https://api.stigg.io/api/v1 の REST API（stigg-api）
GraphQL（レガシー、または特定の高度なクエリ）https://api.stigg.io/graphql の GraphQL API（stigg-api）
スクリプト、CI/CD、ターミナルでの管理 — ユーザーが CLI を明示的に求めた場合のみStigg CLI（Go バイナリ、brew install stiggio/tools/stigg。リポジトリ：https://github.com/stiggio/stigg-cli）
組み込み型の UI（ペイウォール、顧客ポータル、チェックアウト）ウィジェット — widgets.stigg.io の Storybook を参照してください

例外を含む判断フローチャート：references/decision-tree.md。CLI と MCP の詳細：stigg-mcp/references/cli-vs-mcp.md。

ルーティング — 必要なサブスキル

サブスキルは自動的に呼び出されます。 ユーザーのリクエストが、以下の表および各サブスキルの frontmatter の説明にあるトリガーに一致したら、すぐに Skill ツールでそのサブスキルを呼び出してください。この親スキルと同時に読み込みます。両者は連携して動作します。ユーザーに /stigg-<name> を実行するよう求めないでください。「言及されたから」という理由だけでルーティングしないでください。ユーザーが自然な英語で目的を入力すると、このスキルが適切な柱を選び、読み込みます。

タスクスキル
初回の MCP セットアップ、Claude Code／Cursor などを Stigg に接続するstigg-mcp
SDK と REST と GraphQL の選択、API キーの種類、レート制限、認証stigg-api
カタログでの機能／プラン／アドオン／製品／クレジットのモデル化stigg-pricing-modeling
機能のゲーティング、利用状況の報告、フォールバック戦略stigg-entitlements
サブスクリプションの作成／更新／キャンセル／移行、トライアルstigg-subscriptions
クレジット付与、消費、自動チャージ、シートプールstigg-credits
エンティティごとの予算 — エンティティ階層、利用制限の割り当て、ガバナンスツリーstigg-governance
ペイウォール、顧客ポータル、チェックアウト、クレジットウィジェットstigg-widgets
Stigg からの Webhook イベントの受信 — 署名検証、ペイロード、再試行、ハンドラーのひな形stigg-webhooks
適切な価格設定／マネタイズモデルの選択stigg-pricing-expert
複数ステップのレシピ（フリーミアム、ハイブリッド、AI クレジット、トライアル）stigg-recipes
Stripe Projects を通じた Stigg 環境のプロビジョニング（stripe projects add stigg/environment）stigg-sp

サブスキル（stigg-mcp、stigg-governance など）は stigg/ の下にネストされているのではなく、同階層のディレクトリです。skills/stigg/ と skills/stigg-governance/ は並列に配置されています。名前で呼び出してください。stigg/ の中を探さないでください。

タスクに対応するサブスキルがある場合は、Skill ツールで呼び出してください。このリポジトリの外部の情報から内容を即興で作成せず、ユーザーがスラッシュコマンドを入力するのを待って処理を止めないでください。

60 秒でわかる Stigg

構築を始める前に必要な最低限の用語です。用語集の全文は references/core-concepts.md を参照してください。

  • 顧客は、製品のもとでプランに加入したサブスクリプションを保有します。サブスクリプションにはアドオンを含めることができます。
  • 機能（ブール値／構成／従量制）は、ゲーティングできる対象を定義します。エンタイトルメント＝機能＋設定値（例：Pro で「月あたり 10k API 呼び出し」）。
  • プロモーションエンタイトルメントは、サブスクリプション外で顧客ごとに設定するオーバーライドです。クレジットプール／付与／台帳は、クレジットベースの価格設定を支えます。クレジット通貨ごとにプールが 1 つあります。stigg-credits を参照してください。
  • ガバナンスは、機能やクレジットに加えて、エンティティごとの予算（部門／チーム／エージェント）を追加します。アカウントでの有効化が必要です。stigg-governance を参照してください。
  • 環境（sandbox／staging／production）は、隔離されたワークスペースです。それぞれに専用の API キーがあります。

このスキルを読み込まない場合

  • Stigg に関係のないタスク（価格設定／請求／エンタイトルメント）。

よくある間違い

間違い修正方法
ドキュメントを先に検索せず、記憶を頼りに REST／SDK コードを生成するまず検索してください。API の仕様は更新されます。references/search-first.md を参照してください。
CLI と MCP サーバーを混同する（別のツールです）CLI＝決定的なシェル、MCP＝エージェント駆動です。上の表を参照してください。
events.report と usage.report を混同する対象ユーザーの違いではなく、スケーリングモデルの違いです。stigg-entitlements で説明しています。
開発中に本番環境へアクセスする必ず sandbox から始めてください。API キーは環境に紐づいています。
フルアクセス（サーバー）キーをクライアント側のコードに埋め込む絶対に避けてください。フロントエンド SDK にはパブリッシャブル（クライアント）キーを使用してください。stigg-api を参照してください。

コメント

Markdown 対応