gtm-persona について
gtm-persona は、GTM ワークスペースでターゲット人物像を管理するスキルです。作成・更新・削除・点検に対応し、指定のない条件は Unknown のままにして、関連ワークフローへの変更も案内します。
主な機能
- 01人物像の作成・更新・削除
- 02人物像の構成と完全性の点検
- 03未指定の条件を Unknown のまま保持
- 04ワークスペース変更のコミットと検証
活用シーン
- 01GTM ワークフロー向けの人物条件の定義
- 02人物像のシグナルや除外条件の更新
- 03人物像ファイルの構造上の問題の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ eliasstravik/ gtm-skills --skill gtm-personaインストール後、Claude Code で/gtm-personaを入力して読み込まれたか確認します。
同梱ファイルreferences/interactions.mdtemplates/PERSONA.md
詳細
GTM ペルソナ
トリガー
GTM ワークスペース内のペルソナを作成、変更、削除、または確認するリクエストで、このスキルを適用します。
範囲
このスキルが管理するのは、契約で見つかるワークスペース内の personas/<slug>/PERSONA.md です。ペルソナには、人物データの11項目におけるターゲット人物の望ましい、または受け入れ可能な基準を記録し、組織やそのメンバーに関する事実は記録しません。
入力
ユーザー、またはユーザーが提供する情報源からの基準。類似しすぎたペルソナを確認するための既存ペルソナ。このペルソナを読み込むワークフロー(workflows/workflows/*.ts 内の readPersona("<slug>"))と、ワークフローに関する通知。
役割
ユーザーはホストの書き込み権限を通じてすべての変更を承認し、エージェントは提案、編集、コミット、報告を行います。
手順
会話で最初に使用される gtm スキルは、更新の説明に従い、新しいリリースがないか一度確認します。やり取りにある6つのルールに従って会話し、対話例を再現します。
| 作業 | 実施内容 |
|---|---|
| 作成 | 既存のペルソナがリクエストと重複する場合は、まず更新を提案します。ペルソナを定義する肩書きが明示されていない場合は、選択肢を提示して質問します。templates/PERSONA.md を personas/<slug>/PERSONA.md にコピーし、ユーザーが提示した基準のみを記入します。残りは Unknown のままにし、基準は組織の記録やメンバーから借用しないため、残りが Unknown のままであることを伝えます。空の場合は ## Person signals と ## Disqualifiers を省略します。 |
| 更新 | 指定された基準、シグナル、または除外条件を変更します。ワークフローがこのペルソナを読み込む場合、次回の実行では変更が反映されること(デプロイ済みのコピーはこのプッシュがデプロイされた後)、すでにスコア付けされた行は再スコア付けされるまでスコアが維持されることを伝えます。 |
| 削除 | 指定された名前のペルソナがない場合は、最も近い候補を選択肢として提示します。ワークフローがそのペルソナを読み込むかどうかを伝えます。読み込む場合、そのワークフローは別のペルソナを指定するまで実行に失敗します。personas/<slug>/ を削除し、最後に削除されたものと、ワークスペースの履歴には残ることを伝えます。 |
| Doctor | 人物に照合可能な基準がないペルソナ(すべてのフィールドが Unknown)、プレースホルダーだけの殻、H1 の欠落、またはフォルダー名がスラッグと一致しない場合を指摘し、修正案を選択肢として提示します。ユーザーが承認した内容を書き換えます。 |
保存するたびに、何を変更するかを一文で伝えます。origin/main が存在する場合は先にプルし、ホストの書き込み経路を通じて編集し、平易なメッセージで main にコミットし、リモートが存在する場合はプッシュして、コミットを検証します(リモートが存在する場合は origin/main に到達したことも確認します)。最後に、作成、変更、または削除した内容を伝えます。
出力
テンプレートの形式に沿った personas/<slug>/PERSONA.md。各変更は main 上のコミットとします。
例外
このスキルと一緒に gtm-workspace スキルをインストールする必要があります。../gtm-workspace/SKILL.md が見つからない場合は、「このスキルと同じ方法で npx skills add eliasstravik/gtm-skills -s gtm-workspace -y を実行してインストールしてください(このスキルがグローバルスキルディレクトリにある場合は -g を追加してください)。その後、再試行してください」と伝えます。ユーザーが明示していない基準は Unknown のままにします。ORG.md や MEMBER.md から情報を導き出してはいけません。
QC
- 11項目が順番どおりに、それぞれ1行で記載されています。
- H1 があり、フォルダー名がスラッグと一致しています。空の任意セクションはありません。
- 変更内容を締めくくる文は、検証済みのコミットの後に記載されています。
参考資料
interactions の対話例、templates/PERSONA.md、gtm-workspace の資料:interaction、contract、person data。