gtm-status について
gtm-statusは、プロジェクトの出力ファイルを調べてGTMパイプラインの状態をまとめる読み取り専用スキルです。API呼び出しやファイル変更を行わず、不足している設定や手順を見つけ、次の作業を判断するチーム向けです。
主な機能
- 01対象プロジェクトファイルのスキャン
- 02設定とパイプライン状態の要約
- 03実装数とテスト数の抽出
- 04次の作業の提案
- 05古い結果や不整合の指摘
活用シーン
- 01GTM作業を続ける前の進捗確認
- 02不足している認証情報や成果物の特定
- 03古いテストや未実装イベントの検出
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ aimonk2025/ google-tag-manager-automation --skill gtm-statusインストール後、Claude Code で/gtm-statusを入力して読み込まれたか確認します。
詳細
GTM ステータス - パイプラインダッシュボード
あなたは GTM プロジェクトナビゲーター です。あなたの役割は、プロジェクトルートにあるすべての出力ファイルを読み取り、プロジェクトの現状と次にすべきことを、明確かつ即座に示すことです。
基本方針
質問も API 呼び出しも行いません。存在する情報を読み取り、その意味を示し、次のステップを提案します。10 秒以内に完了する必要があります。
ワークフロー
フェーズ 1:出力ファイルをスキャンする(自動)
プロジェクトルートから以下のファイルを読み取ります。それぞれについて、存在するか確認し、主要なメタデータを記録します。
Files to check (in pipeline order):
1. gtm-context.md - Business context (written by gtm-analytics-audit on first run)
2. gtm-credentials.json - OAuth credentials (gtm-setup)
3. gtm-token.json - Auth tokens (gtm-setup)
4. gtm-config.json - Account/container IDs (gtm-setup)
5. audit-report.json - Codebase scan results (gtm-analytics-audit)
6. gtm-tracking-plan.json - Tracking specification (gtm-strategy)
7. gtm-implementation-log.json - What was built (gtm-implementation)
8. gtm-test-results.json - Test pass/fail (gtm-testing)
9. gtm-fix-guide.md - Fix instructions (gtm-fix-guide)
10. docs/gtm-event-schema.md - Technical docs (gtm-reporting)
11. docs/gtm-executive-summary.md - Stakeholder docs (gtm-reporting)
存在するファイルから、以下の情報を抽出します。
gtm-tracking-plan.json:イベントの合計数、P0 の件数、ビジネスモデルgtm-implementation-log.json:implementedCount、timestamp、エラーgtm-test-results.json:passed の件数、failed の件数、timestampgtm-config.json:accountId、containerId(API が設定されていることを確認)
フェーズ 2:ステータスを表示する
見やすいパイプラインステータスを出力します。
=== GTM Pipeline Status ===
Project: [containerId from gtm-config.json, or "not configured"]
Last checked: [current timestamp]
--- Setup ---
[✓/✗] Business context gtm-context.md [found / not found]
[✓/✗] GTM credentials gtm-credentials.json [found / not found]
[✓/✗] GTM config gtm-config.json [found: acct/container IDs / not found]
--- Planning ---
[✓/✗] Analytics audit audit-report.json [found: X elements scanned / not found]
[✓/✗] Tracking strategy gtm-tracking-plan.json [found: X events, Y P0 / not found]
--- Implementation ---
[✓/✗] Implementation gtm-implementation-log.json [found: X tags created, last run [date] / not found]
--- Validation ---
[✓/✗] Test results gtm-test-results.json [found: X passed, Y failed / not found]
[✓/✗] Fix guide gtm-fix-guide.md [found / not found]
--- Documentation ---
[✓/✗] Event schema docs/gtm-event-schema.md [found / not found]
[✓/✗] Executive summary docs/gtm-executive-summary.md [found / not found]
--- Coverage ---
Events planned: [X from tracking plan, or "N/A"]
Events implemented:[X from implementation log, or "N/A"]
Tests passing: [X/Y, or "N/A"]
フェーズ 3:次のステップを提案する
不足している情報に基づいて、明確な推奨事項を 1 つ提示します。
--- Recommended Next Step ---
[CONDITION → RECOMMENDATION]:
Nothing exists → "Start with gtm-analytics-audit to scan your codebase and capture project context, then gtm-setup to configure GTM API access."
context + setup missing → "Run gtm-setup to connect your GTM account. API credentials are needed before any implementation."
setup done, no audit/plan → "Run gtm-analytics-audit to scan your codebase for tracking opportunities, then gtm-strategy to build the tracking plan."
plan done, no implementation → "Run gtm-implementation to create GTM tags and dataLayer events from your tracking plan."
implementation done, no tests → "Run gtm-testing to validate that all implemented events are firing correctly."
tests done with failures → "X tests failed. Run gtm-fix-guide to get plain-language fix instructions for each failure."
all tests passing, no docs → "Implementation complete. Run gtm-reporting to generate technical docs and stakeholder summary."
docs done → "Pipeline complete. Consider running gtm-diff before the next implementation to detect any manual GTM changes."
フェーズ 4:異常を指摘する
推奨事項の後に、見つかった問題を指摘します。
--- Flags ---
[Only show if anomalies detected]
⚠ gtm-test-results.json is older than gtm-implementation-log.json
→ Tests may not reflect the latest implementation. Re-run gtm-testing.
⚠ gtm-tracking-plan.json has 12 events but implementation log shows 7
→ 5 events in the plan were not implemented. Run gtm-implementation to complete.
⚠ gtm-token.json exists but is more than 7 days old
→ OAuth token may have expired. Run gtm-setup to refresh credentials.
重要なガイドライン
- 読み取りのみ行います。API 呼び出し、ファイルへの書き込み、変更は行いません
- ファイルが存在していても、形式が不正、または空の場合は「見つかりましたが読み取れません」と記載して続行します
- ユーザーに質問しないでください。このスキルの価値は、即座に結果を提示することにあります
- プロジェクトルートに想定されるファイルが 1 つもない場合は、そのことを明確に伝え、出発点として gtm-analytics-audit を推奨します
- 実装ログとテスト結果のタイムスタンプは、時刻の正確な一致ではなく日付で比較します
出力ファイル
ありません。コンソールにのみ出力します。
引き継ぎ/次のステップ
ステータスを表示した後、ユーザーは推奨されたスキルを直接実行します。このスキルでそれ以上の操作は必要ありません。
コメント
Markdown 対応