mcpField
M
mastergo

mastergo

github.com/jeasonstudioデザイン・UI14226 回インストール38 週間前に更新
リポジトリ

mastergo について

PythonスクリプトでMasterGoファイルのデザインデータを取得・分析するスキルです。ページ構造、DSLの詳細、コンポーネント文書、デザインメタデータを扱うワークフローに向いています。

主な機能

  1. 01ページのノードツリー分析
  2. 02DSL全体をJSONで取得
  3. 03リンクされたコンポーネント文書の取得
  4. 04トークンとインタラクションの確認
  5. 05標準出力でスクリプトを実行

活用シーン

  1. 01MasterGoページ構造の確認
  2. 02コード生成用デザインデータの抽出
  3. 03コンポーネント文書リンクの確認
  4. 04ナビゲーションと操作内容の確認

インストール

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

$npx skills add https://github.com/jeasonstudio/mastergo-skills --skill mastergo

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

同梱ファイル

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

LICENSE
.gitignore
README.md
README.zh-CN.md
.cursor/skills/skill-creator/
LICENSE.txt
.cursor/skills/skill-creator/references/
output-patterns.md
workflows.md
.cursor/skills/skill-creator/scripts/
package_skill.py
quick_validate.py
init_skill.py
references/
multi-page-workflow.md
dsl-types.md
dsl-structure.md
scripts/
mastergo_analyze.py
mastergo_get_dsl.py
mastergo_utils.py
mastergo_fetch_docs.py

詳細

MasterGo スキル

自己完結型の Python スクリプトを使用して、MasterGo ファイルからデザインデータを取得・分析します。

前提条件

必須の環境変数：

export MASTERGO_TOKEN="mg_your_token_here"

トークンの取得先：MasterGo Settings > Security > Personal Access Token

要件：Team Edition アカウント、および Team Projects 内のファイル（Drafts は不可）。

重要：トークンの安全な取り扱い

次の操作は絶対にしないでください：

  • echo $MASTERGO_TOKEN - 出力にシークレットが露出します
  • echo "Token: $MASTERGO_TOKEN" - シークレットが露出します
  • printenv MASTERGO_TOKEN - シークレットが露出します
  • トークンの値を出力するあらゆるコマンド

安全な確認方法：

test -n "$MASTERGO_TOKEN" && echo "Token is set" || echo "Token is NOT set"

この方法ではトークンの値は出力されず、トークンが存在するかどうかのみが出力されます。

スクリプトの場所

スクリプトは、この SKILL.md ファイルを基準とした scripts/ にあります。実行時は絶対パスを使用してください：

{this_skill_directory}/scripts/mastergo_*.py

ワークフロー

ステップ 1：DSL 構造を分析する

ページ構造を把握するため、必ず最初に分析してください：

python scripts/mastergo_analyze.py "https://mastergo.com/goto/xxx"

出力には次の内容が含まれます：

  • ノードツリー（タイプ、名前、サイズ）
  • テキストの内容
  • コンポーネントのドキュメントリンク
  • ナビゲーション先
ステップ 2：完全な DSL を取得する（必要な場合）

詳細な DSL データを取得するには：

python scripts/mastergo_get_dsl.py "https://mastergo.com/goto/xxx"

出力：{ dsl, componentDocumentLinks, rules } を含む JSON

ステップ 3：コンポーネントのドキュメントを取得する

componentDocumentLinks が空でない場合は、関連するドキュメントを取得します：

python scripts/mastergo_get_dsl.py URL | python scripts/mastergo_fetch_docs.py --from-dsl

または、個別に取得します：

python scripts/mastergo_fetch_docs.py "https://example.com/button.mdx"

スクリプト一覧

スクリプト目的出力
mastergo_analyze.py構造の概要人が読めるツリーを標準出力に出力
mastergo_get_dsl.py完全な DSL データJSON を標準出力に出力
mastergo_fetch_docs.pyコンポーネントのドキュメントドキュメントの内容を標準出力に出力
mastergo_utils.pyユーティリティ関数モジュールとしてインポート

DSL の重要な概念

  • token フィールド：色、シャドウ、フォントのデザイントークンです（コード生成時に CSS 変数へ変換してください）
  • componentInfo：ドキュメントリンクを含むコンポーネントのメタデータです
  • interactive フィールド：ページのナビゲーション先を含むユーザー操作です
  • rules 配列：DSL レスポンスとともに返されるガイドラインです

重要：ユーザープロジェクトを汚染しないでください

禁止されている操作：

  • ユーザープロジェクト内に .temp_dsl.json や DSL キャッシュファイルを作成すること
  • ユーザープロジェクト内に analyze_dsl.py や分析スクリプトを作成すること
  • ユーザープロジェクトのディレクトリ内に一時ファイルを作成すること
  • スキル関連のファイルをスキルディレクトリの外に書き込むこと

許可されている操作：

  • スクリプトを実行し、標準出力を取得すること
  • 出力をメモリ上で直接使用すること
  • コンテキストを把握するため、ユーザーが既に所有しているプロジェクトファイルを読み取ること

スクリプトの出力はすべて標準出力のみに出力されます。出力をそのまま使用し、中間ファイルをユーザープロジェクトに保存しないでください。

参考資料

コメント

Markdown 対応