mcpField
G
gtm-workspace

gtm-workspace

github.com/eliasstravikマーケティング・グロース22335 回インストール2 週間前に更新
リポジトリ

gtm-workspace について

組織の GTM ワークスペースを作成・管理するスキルです。会社情報、メンバー情報、共通基準を Markdown ファイルとして保持し、構成と状態を確認します。事実の検証と、承認された変更の Git 管理を前提とします。

主な機能

  1. 01ワークスペースの作成とインポート
  2. 02組織情報とメンバー情報の管理
  3. 03構成とファイルのチェック
  4. 04承認に基づく差異の修正
  5. 05Git へのコミットと同期

活用シーン

  1. 01組織の GTM ワークスペースのセットアップ
  2. 02会社情報やメンバー情報の更新
  3. 03ワークスペース構成の確認と修正

インストール

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

$npx skills add https://github.com/eliasstravik/gtm-skills --skill gtm-workspace

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

同梱ファイル

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

references/
company-data.md
contract.md
interaction.md
interactions.md
person-data.md
updates.md
scripts/
check-update.mjs
templates/
AGENTS.md
CLAUDE.md
gitignore
MEMBER.md
ORG.md
tests/
check-update.test.mjs
interaction.test.mjs

詳細

GTM ワークスペース

トリガー

GTM ワークスペース全体、その組織に関する情報、またはメンバーについてのリクエストには、このスキルを適用します。

対象範囲

1 つのワークスペースには、1 つの組織の GTM コンテキストを Markdown 形式で ~/.gtm/<org-slug>/ に保持し、git をメモリとして使用します。このスキルはワークスペースのルート、ORG.md、members/、ワークスペースの健全性を担当し、references/ で共有標準を提供します。ICP、ペルソナ、適合性チェック、workflows/ は他の gtm スキルの対象です。Doctor は workflows/ の内部を調査しません。

ワークフローのホスティングとプロバイダー接続は gtm-workflow の対象です。単独の Local または Vercel のセットアップは、共有の scripts/setup.mjs に案内してください。GTM Agent や Slack は必要ありません。Workspace Doctor は接続の健全性チェックを、そのスキルの Doctor に委任します。

入力

リクエスト、契約に記載された検出順序で見つかったワークスペース、ユーザー、会社自身の公開サイト、その他の安全な公開情報から得た事実(決して創作しないこと)、ユーザーまたは情報源から得たメンバーのメールアドレス(決して推測しないこと)。

役割

ユーザーはホストの書き込み権限を通じてすべての変更を承認します。エージェントは変更を提案、編集、コミットし、報告します。

手順

会話で最初に使用する gtm スキルは、更新に従って新しいリリースがあるか一度確認します。対話にある 6 つのルールに沿って会話し、対話例を再現します。

作業実施内容
作成~/.gtm/ にリモートを持つ空のクローンがすでにある場合(空、または共有の gtm-workflow セットアップがワークスペースを稼働状態にするときに公開する workflows/、.gitignore、.github/ のみを含む場合)、その中にスキャフォールドし、ディレクトリ名をスラッグとして使用します。保存場所は尋ねず、コミット後に git push -u origin main を実行します。空でもワークスペースでもないクローン(例:GitHub によって初期化された README があるもの)は、ビジネス上の問題として報告し、上書きしてスキャフォールドしてはいけません。それ以外の場合は、保存場所を尋ねます。このコンピューターのみ(推奨)、または gtm-<slug> という名前のプライベート GitHub リポジトリにも保存するかを確認し、main で git init を実行します。templates/AGENTS.md、CLAUDE.md、ORG.md、gitignore(.gitignore として)を ~/.gtm/<slug>/ にコピーし、ユーザーと公開情報に基づいて ORG.md を記入し、コミットします。共有する場合は gh repo create gtm-<slug> --private --source . --push を実行します。空のリポジトリへの初回プッシュは git push -u origin main です。インポートは、スキャフォールドの代わりに既存のワークスペースを ~/.gtm/<slug>/ にコピーまたはクローンする「作成」です。
更新ORG.md の情報を変更するか、テンプレートから members/<slug>/MEMBER.md を追加、変更、削除します。メールアドレスは必須です。
Doctorルート構成とすべてのファイルを templates/ および契約と比較し、逸脱をビジネス上の表現で報告します。修正案を選択肢として提示し、ユーザーが承認した内容を書き換えます。レガシー構成(ルートの README、suborgs/、フィールドの欠落や順序違いを含む)も対象です。.github/ は gtm-workflow の Doctor の対象です。ワークスペースのスラッグはディレクトリ名であり、H1 から導出してはいけません。

保存のたびに、変更内容を 1 文で伝え、origin/main が存在する場合は先にプルし、ホストの書き込み経路を通じて編集し、平易なメッセージで main にコミットし、リモートがある場合はプッシュし、コミット(リモートがある場合は origin/main に反映されたことも)を確認して、作成、変更、削除した内容を最後に伝えます。

出力

契約にあるルート構成を備え、すべての変更が main にコミットされ、共有する場合はプライベート GitHub リポジトリ gtm-<slug> があるワークスペース。

例外

複数のワークスペースが一致し、どれも指定されていない場合は尋ねます。設定を保存してはいけません。事実を確認できない場合は Unknown と記載します。メールアドレスのないメンバーは作成しません。ワークスペース全体の削除を依頼された場合、エージェントは決して削除しません。その旨を伝え、ユーザー自身でフォルダーを削除するよう案内します。共有している場合は、GitHub リポジトリもユーザーが削除します。レガシーの suborgs/ 単位は、ORG.md の ## Notes の下に文章としてまとめるか、ユーザーが個別の GTM コンテキストを希望する場合は、それぞれ独自のワークスペースにします。

品質チェック

  • ORG.md には、会社データの13項目が順番どおりに1行ずつ記載されています。ネストした箇条書きを使うのは、Location、Products and services、Tech stack のみです。
  • ルートには契約に記載されたものだけが含まれています。ポインターファイルと .gitignore は、それぞれのテンプレートとバイト単位で一致しています。
  • すべてのスラッグが契約のルールに従っています。すべてのメンバーにメールアドレスが設定されています。
  • 変更内容を締めくくる文は、検証済みのコミットに基づいています。

参考資料

interactionのルール、interactionsの対話例、スラッグ、検出、ルートの構成、情報源、共有方法についてのcontract、会社データと人物データの語彙、AGENTS.md、CLAUDE.md、ORG.md、gitignore、MEMBER.mdのテンプレートを含むtemplates/。

コメント