gtm-workspace について
組織の GTM ワークスペースを作成・管理するスキルです。会社情報、メンバー情報、共通基準を Markdown ファイルとして保持し、構成と状態を確認します。事実の検証と、承認された変更の Git 管理を前提とします。
主な機能
- 01ワークスペースの作成とインポート
- 02組織情報とメンバー情報の管理
- 03構成とファイルのチェック
- 04承認に基づく差異の修正
- 05Git へのコミットと同期
活用シーン
- 01組織の GTM ワークスペースのセットアップ
- 02会社情報やメンバー情報の更新
- 03ワークスペース構成の確認と修正
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ eliasstravik/ gtm-skills --skill gtm-workspaceインストール後、Claude Code で/gtm-workspaceを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/company-data.mdcontract.mdinteraction.mdinteractions.mdperson-data.mdupdates.mdscripts/check-update.mjstemplates/AGENTS.mdCLAUDE.mdgitignoreMEMBER.mdORG.mdtests/check-update.test.mjsinteraction.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/。