All Skills > SDK Skill Creator

Sentry SDK スキルバンドル作成

完全で、調査に裏付けられた SDK スキルバンドル — メインウィザード SKILL.md とそれが対応するすべての機能柱の深掘り参照ファイルを作成します。

このスキルを実行する場合

• 新しいプラットフォーム向けに「Sentry SDK スキル作成」を依頼された場合
• 「[言語/フレームワーク] のサポート追加」を sentry-agent-skills に依頼された場合
• 新しい sentry-<platform>-sdk スキルバンドルを構築している場合
• SDK スキルパターンを新しい Sentry SDK に移植している場合

${SKILL_ROOT}/references/philosophy.md を最初に読んでください — このスキルが実装するバンドルアーキテクチャ、ウィザードフロー、および設計原則を定義しています。

---

フェーズ 1: SDK を識別する

何用のスキルを構築しているかを決定します:

# どの SDK? パッケージ名は?
# 例: sentry-go, @sentry/sveltekit, sentry-python, sentry-ruby, sentry-cocoa

機能マトリックス を確立します — この SDK はどの Sentry 柱に対応していますか?

柱	ドキュメント確認	注記
エラーモニタリング	常に利用可能	交渉の余地なしのベースライン
トレーシング/パフォーマンス	通常利用可能	Span API をチェック
プロファイリング	異なる	削除または実験的な可能性
ロギング	新しい機能	最小バージョンをチェック
メトリックス	新しい機能	最小バージョンをチェック
Crons	バックエンドのみ	フロントエンド SDK では利用不可
セッションリプレイ	フロントエンドのみ	バックエンド SDK では利用不可
AI モニタリング	一部の SDK	通常は JS + Python のみ

既存の SDK スキルを参照 して、目標品質レベルを理解します:

ls skills/sentry-*-sdk/ 2>/dev/null
# パターン参照のため既存の SDK スキル 1-2 個を読む

---

フェーズ 2: 調査

これが最も重要なフェーズです。 スキルの品質は、正確で最新の API 知識にのみ依存します。メモリから記述しないでください — すべての機能を公式ドキュメントに照らし合わせて調査してください。

調査戦略

並列調査タスク (ファイルに出力する claude ツールを使用) を開始します — 機能領域ごとに 1 つ。各タスクは以下を実行する必要があります:

1. その機能の公式 Sentry ドキュメントページにアクセス
2. ソースレベルの API 検証のため SDK の GitHub リポジトリにアクセス
3. 専用の調査ファイルに詳細な結果を書き込む

${SKILL_ROOT}/references/research-playbook.md を読んで、プロンプトテンプレートとファイル命名規約を含む詳細な調査実行計画を確認してください。

Sentry ウィザードを調査する

機能調査に進む前に、Sentry ウィザード CLI がこのフレームワークをサポートしているかどうかを確認します:

# SDK のドキュメントランディングページでウィザード指示をチェック
# 訪問: https://docs.sentry.io/platforms/<platform>/
# 探す: "npx @sentry/wizard@latest -i <integration>"

ウィザード統合が存在する場合:

1. 正確なウィザードコマンドと -i フラグを文書化
2. ウィザードが何を作成/変更するか (ファイル、設定、ビルドプラグイン) を文書化
3. ウィザードは 認証をインタラクティブに処理する — ログイン、org/プロジェクト選択、および認証トークン作成/ダウンロードはすべて自動的に発生することに注意
4. ウィザードが ソースマップアップロード をセットアップするかどうかに注意 — これはフロントエンド SDK に対して重要です
5. これはフェーズ 3 で生成されるスキルの「オプション 1: ウィザード (推奨)」になります

これが重要な理由: ウィザードはすべての認証フロー (ログイン、org/プロジェクト選択、 認証トークン) とソースマップアップロード設定を自動的に処理します。ソースマップがなければ、 本番スタックトレースはミニ化されたコード — Sentry をフロントエンドデバッグにほぼ役に立たなくします。 認証トークンがなければ、ソースマップをアップロードできません。ウィザードは 1 つのステップで両方を正しく取得する最も信頼できる方法です。

調査バッチ

トピック領域別に調査タスクをバッチ処理します。可能な限り並行して実行します:

バッチ	トピック	出力ファイル
1	セットアップ、設定、すべての初期化オプション、フレームワーク検出	research/<sdk>-setup-config.md
2	エラーモニタリング、パニック/例外キャプチャ、スコープ、エンリッチメント	research/<sdk>-error-monitoring.md
3	トレーシング、プロファイリング (サポートされている場合)	research/<sdk>-tracing-profiling.md
4	ロギング、メトリックス、Crons (サポートされている場合)	research/<sdk>-logging-metrics-crons.md
5	セッションリプレイ (フロントエンドのみ)、AI モニタリング (サポートされている場合)	research/<sdk>-replay-ai.md

重要: 各調査タスクに出力をファイルに書き込むように指示します (outputFile パラメーター)。調査結果をインラインで消費しないでください — これらは大きい (各 500–1200 行)。ワーカーは後でディスクからこれらを読みます。

調査品質ゲート

続行する前に、各調査ファイルを確認します:

• 実際のコンテンツがある (Claude のプロセスノートだけではない)
• 実際の API 名を含むコード例がある
• 最小 SDK バージョンが含まれている
• フレームワーク固有の変更をカバーしている

# クイック検証
for f in research/<sdk>-*.md; do
  echo "=== $(basename $f) ==="
  wc -l "$f"
  grep -c "^#" "$f"  # 複数の見出しが必要
done

100 行未満の調査タスクを再実行 — おそらく静かに失敗しました。

---

フェーズ 3: メイン SKILL.md を作成する

メイン SKILL.md は哲学ドキュメントからの 4 フェーズウィザード を実装します。焦点を絞ってください — メインファイルはウィザードフロー、クイックスタート設定、フレームワークテーブル、および参照ディスパッチをカバーする必要があります。個々の機能の深掘り詳細は references/ ファイルに属します。ここではありません。徹底的ですが、冗長ではありません。

最初にコンテキストを集める

書く前に、スカウトを実行するか、既存のスキルを読んで規約を理解します:

• フロントマターパターン (名前、説明、ライセンス)
• 「このスキルを実行する場合」のトリガーフレーズ
• テーブル形式とコード例のスタイル
• トラブルシューティングテーブル規約

SKILL.md 構造

---
name: sentry-<platform>-sdk
description: Full Sentry SDK setup for <Platform>. Use when asked to "add Sentry
  to <platform>", "install <package>", or configure error monitoring, tracing,
  [features] for <Platform> applications. Supports [frameworks].
license: Apache-2.0
---

# Sentry <Platform> SDK

## このスキルを実行する場合
[トリガーフレーズ]

## フェーズ 1: 検出
[bash コマンドでプロジェクトをスキャン — パッケージマネージャー、フレームワーク、既存 Sentry、フロントエンド/バックエンド]

## フェーズ 2: 推奨
[「常に / 検出時 / オプション」ロジックを備えた独断的な機能マトリックス]

## フェーズ 3: ガイド
### オプション 1: ウィザード (推奨)   ← ウィザードがこのフレームワークに存在する場合
[ユーザーにウィザードを自分で実行するよう指示するブロック引用 — インタラクティブブラウザログインが必要。ブロック引用内でコピー貼り付け可能なコードブロックにコマンドを含める。完了したら戻るよう指示。ブロック引用の後に行を追加: 「ユーザーがウィザードをスキップする場合は、以下のオプション 2 (手動セットアップ) に進みます。」]
### オプション 2: 手動セットアップ            ← 常に含める
### インストール
### クイックスタート — 推奨初期化
### ソースマップセットアップ                  ← フロントエンド/モバイル SDK に必須
### フレームワークミドルウェア (該当する場合)
### 各機能ごと
[参照ディスパッチテーブル: 機能 → ${SKILL_ROOT}/references/<feature>.md]

## 設定リファレンス
[重要な初期化オプションテーブル、環境変数]

## 検証
[テストスニペット]

## フェーズ 4: クロスリンク
[コンパニオンフロントエンド/バックエンドを検出、一致する SDK スキルを提案]

## トラブルシューティング
[一般的な問題テーブル]

メイン SKILL.md の主要原則

1. リーンに保つ — 深いディテールは参照に属し、ここではない
2. フレームワーク SDK に対してウィザーファーストを実装 — Sentry ウィザードがこのフレームワークをサポートしている場合、これを手動セットアップの前に「オプション 1: ウィザード (推奨)」として提示します。 ウィザードはインタラクティブなブラウザログインが必要で、エージェントでは実行できません — ユーザーがコマンドを自分のターミナルにコピー貼り付けし、完了したら戻るよう指示するブロック引用で提示します。ユーザーがウィザードをスキップした場合、エージェントは完全な手動セットアップに進みます。${SKILL_ROOT}/references/philosophy.md で完全なパターンを参照してください。
3. ソースマップはフロントエンド/モバイルに対して交渉の余地がない — 手動セットアップパスは、ソースマップアップロード設定 (ビルドツールプラグイン + 環境変数) を含める必要があります。ソースマップがなければ、本番スタックトレースは読み取り不可能なミニ化されたコードです。
4. 検出コマンドは実物でなければならない — 実際のプロジェクトに対してテスト
5. 推奨ロジックは独断的でなければならない — 「常に」、「X 検出時」であり、「多分検討する」ではない
6. クイックスタート設定は最も多くの機能を有効にする 合理的なデフォルトで
7. フレームワークミドルウェアテーブル — 正確なインポートパス、ミドルウェア呼び出し、および癖
8. 積極的にクロスリンク — Go バックエンド の場合、フロントエンドを提案。Svelte フロントエンドの場合、バックエンドを提案。

---

フェーズ 4: 参照ファイルを作成する

SDK がサポートする機能柱ごとに 1 つの参照ファイル。これらは深掘りです — メイン SKILL.md より長くなる可能性があります。

参照ファイル構造

# <機能> — Sentry <Platform> SDK

> 最小 SDK: `<package>` vX.Y.Z+

## 設定

## コード例
### 基本的な使用法
### 高度なパターン
### フレームワーク固有の注記 (該当する場合)

## ベストプラクティス

## トラブルシューティング
| 問題 | 解決策 |
|-------|----------|

良い参照の特徴

${SKILL_ROOT}/references/quality-checklist.md で完全な品質ルーブリックを読んでください。

主要ポイント:

• 機能しているコード例 — 疑似コードではなく、切り詰められたスニペットではない
• 設定オプション用テーブル — タイプ、デフォルト、最小バージョン
• パターンごとに 1 つの完全な例 — 同じもののバリエーションを 5 つ表示しない
• フレームワーク固有の注記 — フレームワーク間で動作が異なる場合はコールアウト
• 先頭に最小 SDK バージョン — 常に
• 制限に関して正直 — 機能が削除された場合 (Go プロファイリングなど)、そう言う

機能固有ガイダンス

機能	カバーするべき主要事項
エラーモニタリング	キャプチャ API、パニック/例外回復、スコープ、エンリッチメント (タグ/ユーザー/ブレッドクラム)、エラーチェーン、BeforeSend、フィンガープリント
トレーシング	サンプリングレート、カスタムスパン、分散トレーシング、フレームワークミドルウェア、操作タイプ
プロファイリング	サンプリングレート設定、それがトレースにどのようにアタッチするか、または正直「削除/利用不可」
ロギング	有効フラグ、ロガー API、人気のあるロギングライブラリとの統合、フィルタリング
メトリックス	カウンター/ゲージ/配布 API、単位、属性、カーディナリティに関するベストプラクティス
Crons	チェックイン API、モニター設定、スケジュール種別、ハートビートパターン
セッションリプレイ	リプレイ統合、サンプリングレート、プライバシーマスキング、キャンバス/ネットワークレコーディング

フロントエンド/モバイル SDK への注記: ソースマップアップロード設定はメイン SKILL.md (フェーズ 3: ガイド) に属し、参照ファイルには属しません。これはコアセットアップフローの一部です — すべてのフロントエンド本番展開でそれが必要です。ビルドツールプラグイン、必要な環境変数 (SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT)、および .env を .gitignore に追加してカバーしてください。

---

フェーズ 5: すべてを検証する

このフェーズをスキップしないでください。 SDK API は頻繁に変わります。調査は幻覚を見ることができます。ワーカーは設定キーを捏造できます。

API 検証

SDK の実際のソースコードに対して専用の検証パスを実行します:

調査プロンプト: "これらの特定の API 名とシグネチャを
<SDK> GitHub リポジトリソースコードに照らし合わせて検証: [スキルファイルからのすべての API をリスト]"

一般的に間違うもの:

• 間違ったケーシングの設定オプション名 (SendDefaultPii vs SendDefaultPII)
• 存在しない捏造設定キー (experimental.tracing — それが実物であることを検証)
• 最新の置き換えの代わりに使用される非推奨 API (configureScope → getIsolationScope)
• 削除されたときに利用可能としてリストされた機能 (Go SDK のプロファイリング)
• 間違った最小バージョン番号

レビュー パス

完全なスキルバンドルで レビュアーを実行:

• コード例の技術的正確性
• メイン SKILL.md と参照ファイル間の一貫性
• リポジトリ内の既存 SDK スキルとの一貫性
• エージェント スキル仕様コンプライアンス (フロントマター、命名)

レビュー結果を修正する

優先度別に分類:

• P0: 誤解を招く主張 (削除された機能を広告) — すぐに修正
• P1: 正しくない API、非推奨メソッド — マージ前に修正
• P2: スタイル不一貫性、バージョン細部 — クイックなら修正
• P3: スキップ

---

フェーズ 6: 登録してドキュメントを更新する

スキルがレビューに合格した後:

1. README.md を更新 — SDK スキルテーブルに追加
2. AGENTS.md を更新 — 哲学ドキュメントまたはスキルカテゴリセクションが必要な場合
3. 使用例を追加 — 使用セクションでフレーズをトリガー
4. バンドルパターンを文書化 — これが新しい SDK の場合、参照/ 構造をメモしてください

コミット戦略

各主要部分は独自のコミットを取得:

1. feat(<platform>-sdk): add sentry-<platform>-sdk main SKILL.md wizard
2. feat(<platform>-sdk): add reference deep-dives for all feature pillars
3. docs(readme): add sentry-<platform>-sdk to available skills
4. fix(skills): address review findings (ある場合)

---

チェックリスト

スキルを完了と宣言する前に:

• 哲学ドキュメント読了と実装
• すべての機能柱が公式ドキュメントから調査済み (メモリからではない)
• 調査ファイルが検証済み (実際のコンテンツ、正しい API、各 100 行以上)
• メイン SKILL.md が焦点を絞ったもの — ウィザードフロー + クイックスタート + 参照ディスパッチ。参照の深掘り
• メイン SKILL.md がすべての 4 つのウィザードフェーズを実装
• ウィザード CLI チェック済み — サポートされている場合、認証フロー + ソースマップの利点について説明されたものとして「オプション 1: ウィザード (推奨)」として提示
• ソースマップ/デバッグシンボルアップロードが手動セットアップパスでカバーされている (フロントエンド/モバイル SDK)
• サポートされた各機能柱の参照ファイル
• API が SDK ソースコードに対して検証済み
• レビュー パス完了、結果に対応
• プロファイリング/削除機能が正直に文書化 (広告ではない)
• コンパニオンフロントエンド/バックエンドスキルへのクロスリンク
• README.md 更新済み
• すべてのコミット打磨き、説明的なメッセージ