スキルとマーケットプレイス

スキルは、汎用的な AI 会話と Treasure AI 環境を熟知した会話を区別するものです。スキルは AI に特定のタスクの実行方法を教えます。たとえば、パーティションプルーニングを使用した Trino SQL の記述、YAML による CDP ジャーニーの構築、dbt モデルの生成などです。これにより、プロンプトを自分で記述することなく、専門家レベルの出力が得られます。

スキルとは何か、AI の応答をより正確にする仕組み、そして Web、Desktop、Mobile でスキルを有効化、呼び出し、管理する方法を理解します。

• Treasure AI Studio にサインイン済みであること（はじめに）
• チャットインターフェースに慣れていること（AI チャットインターフェース）

スキルがない場合、AI は一般的なトレーニングに頼ります。SQL を記述できますが、td_interval() やパーティションプルーニングについては知りません。セグメント定義の草案を作成できますが、CDP が期待する正確な YAML スキーマには従いません。スキルはそのギャップを埋めます。

マーケターやビジネスユーザーの方へ： スキルを使用すると、「過去 30 日間に購入したユーザーのセグメントを構築する」と質問するだけで、汎用テンプレートではなく、有効ですぐにプッシュできる YAML 定義が得られます。

データアナリストやエンジニアの方へ： スキルを使用すると、AI が Treasure AI の Trino および Hive エンジン固有の関数とパターンを使用して、初回から実際に動作するクエリを記述します。

スキルは、AI がセッション開始時にコンテキストに読み込む構造化されたインストラクションを含む Markdown ファイル（SKILL.md）です。スキルが有効な場合、そのセッションのすべての応答がそのガイダンスの恩恵を受けます。

ライフサイクルは以下のとおりです：

1. 発見 — マーケットプレイスで利用可能なスキルを参照するか、名前で検索する
2. 有効化 — 現在のセッション用にスキルを選択するか、プロジェクトで事前設定する
3. 呼び出し — AI がリクエストに関連する場合、有効なスキルを自動的に適用する
4. 応答 — AI が回答を生成する際に、スキルのルール、例、ツールパターンに従う

Studio には td-skills がプリインストールされています。これはプラットフォームチームが管理する Treasure AI スキルのキュレーションセットです。常に利用可能で、削除することはできません。

説明、機能、ペルソナマッピングを含むすべてのスキルの完全なカタログについては、サポートされているスキルカタログを参照してください。

各会話でどのスキルを有効にするかを制御できます。セッション選択（チャットごとにスキルを選択）とプロジェクトデフォルト（自動有効化するスキルを事前設定）の 2 つのアプローチがあります。

1. チャット入力ツールバーのスキルボタン（パズルアイコン）をクリックすると、プラグインごとにグループ化されたすべての利用可能なスキルを示すドロップダウンが表示されます
2. 有効にしたいスキルの横のチェックボックスをオンにします
3. 上部の検索フィールドを使用して、名前や説明でフィルタリングします
4. スキルボタンのバッジに選択されているスキルの数が表示されます
5. 最初のメッセージを送信すると、選択したスキルがこのセッションに固定されます

Mobile では、スキルはセッションごとの選択ではなく、プロジェクト設定を通じて管理されます。AI は現在のプロジェクトに関連付けられたスキルを自動的に有効化します。

• プロジェクトで事前設定されたスキルは、そのプロジェクト内のすべてのチャットで有効になります
• プロジェクトを切り替えると、有効なスキルが変わります（コアコンセプトを参照）
• AI はすべての応答に有効なスキルのドメイン専門知識を適用します

プロジェクトレベルでスキルを事前設定して、そのプロジェクトのすべての新しいチャットが適切な専門知識で開始されるようにします：

1. プロジェクト設定を開きます
2. スキルセクションで、常に有効にするスキルを選択します
3. このプロジェクトのすべての新しいチャットで、これらのスキルが自動的に読み込まれます

設定例：

スキルが有効な場合、リクエストがスキルのドメインに該当するとき、AI は自動的にそのガイダンスを適用します。スキルを明示的に呼び出す必要はありません。やりたいことを説明するだけです。

例：

trino スキルが有効な場合：

ユーザー: pageviews テーブルから過去 7 日間のアクティブユーザー数をカウントするクエリを記述してください

AI は Trino スキルのパターンを使用して、td_interval()、適切なパーティションプルーニング、TD 固有の関数を含む最適化された SQL を記述します。スキルについて言及する必要はありません。

3 つの組み込みコマンドがチャット入力で常に利用可能です：

スキルはプロジェクト設定を通じて有効化されます（上記のプロジェクトデフォルトを参照）。メッセージ内でスキルのドメインを自然に参照してください。たとえば、「...の Trino クエリを記述して」のように入力すると、AI が関連する有効なスキルを適用します。

マーケットプレイスは、プリインストールされたセット以外の追加スキルプラグインを発見してインストールする場所です。

サイドバーからスキルパネルを開いて、完全なマーケットプレイス体験にアクセスします：

1. サイドバーからスキルパネルを開きます
2. プラグインタブに移動します
3. 利用可能セクションまでスクロールするか、検索フィールドを使用します
4. 必要なプラグインのインストールをクリックします
5. インストールが確認通知で確認されます。新しいスキルを使用するには新しいチャットを開始してください

インストール済みプラグインはアンインストールせずにオン/オフを切り替えられます：

• 有効 — プラグインのスキルがセッション選択のスキルドロップダウンに表示されます
• 無効 — プラグインはインストールされたままですが、スキルが選択から非表示になります

インストール済みプラグインの横のスイッチをトグルして状態を変更します。

追加の推奨リポジトリは、リポジトリタブの折りたたみ可能な推奨セクションで利用可能です。

完全なマーケットプレイスインターフェースは Mobile では利用できません。Web または Desktop でインストールおよび設定されたスキルプラグインは、Mobile のプロジェクトで利用可能です。Web または Desktop でスキルを管理すると、自動的に同期されます。

スキルが有効な場合、AI の動作は測定可能な方法で変化します：

有効なスキルは Treasure AI 固有の知識を AI の推論に注入します。たとえば、trino スキルが有効な場合：

• AI は汎用的な WHERE 句の代わりに時間フィルタリングに td_interval() を使用します
• クエリにはパフォーマンス向上のためのパーティションプルーニングヒントが含まれます
• td_time_range() や td_sessionize() などの TD 固有の関数が正しく使用されます

設定（セグメント、ジャーニー、ワークフロー）を生成するスキルには検証ルールが含まれます。AI は：

• CDP API が必要とする正確な YAML スキーマに従います
• 正しいオペレータータイプ（Equal、In、Between、TimeWithinPast）を使用します
• 出力を提示する前にフィールド名と時間単位を検証します

スキルは AI が適切なツール呼び出しのシーケンスを選択するよう導きます。たとえば、workflow-management スキルは AI に以下を教えます：

1. デバッグ前に tdx wf sessions で最近の実行を確認する
2. tdx wf attempt logs を使用して失敗を調査する
3. 一時的なエラーに対して _retry ブロックを提案する

このガイドを読んだ後、以下のことができるようになります：

• スキルとは何か、AI の応答をどのように改善するかを説明できる
• スキルドロップダウンを使用してセッションのスキルを有効化できる（Web と Desktop）
• AI がリクエストに有効なスキルを自動的に適用する仕組みを理解できる
• すべてのプラットフォームに適用されるプロジェクトレベルのスキルデフォルトを設定できる
• マーケットプレイスから追加スキルを見つけてインストールできる（Web と Desktop）
• インストール済みプラグインをアンインストールせずに有効化または無効化できる

• サポートされているスキルカタログ — 説明とペルソナマッピングを含むすべての利用可能なスキルの完全なリファレンス
• コアコンセプト — 事前選択されたスキルでプロジェクトを設定する
• TDX コマンド — スキルが生成することが多い CLI コマンドを実行する
• クエリ実行 — SQL スキルが実行可能なクエリを生成する仕組みを確認する