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

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

注意
スキルはコードプラグインではなく、インストラクションパッケージです。お使いのマシン上で実行されたり、データに直接アクセスしたりすることはありません。代わりに、AI に構造化されたプレイブック（ルール、例、ツール使用パターン）を提供し、そのドメインで質問されたときに AI がそれに従います。すべてのデータアクセスは、チャットストリームに表示される同じセキュアなツール呼び出し（クエリ、API リクエスト）を通じて行われます。

## 目的

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

## 前提条件

- Treasure AI Studio にサインイン済みであること（[はじめに](/ja/products/ai-studio/getting-started)）
- チャットインターフェースに慣れていること（[AI チャットインターフェース](/ja/products/ai-studio/chat/chat)）


## スキルが重要な理由

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

| スキルなし | スキル有効時 |
|  --- | --- |
| TD 関数を使用しない可能性がある汎用 SQL | `td_interval()`、`td_time_range()`、パーティションプルーニングを使用した Trino SQL |
| おおよそのセグメント構造 | 正しいオペレーターとフィールド名を持つ検証済み CDP セグメント YAML |
| 一般的なワークフローアドバイス | `td>` オペレーター、`_retry`、`_error` ハンドリングを含む本番対応の `.dig` ファイル |
| 基本的なデータ探索 | セッションコンテキストを使用したデフォルトデータベースにスコープされたクエリ |


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

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

## スキルの仕組み

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

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

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


技術的な注意
スキルはセッション開始時に AI のシステムプロンプトに読み込まれます。会話の途中でスキルの選択を変更した場合、変更を有効にするには新しいチャットを開始する必要があります。

## プリインストール済みスキル

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

| カテゴリ | スキル | 機能 |
|  --- | --- | --- |
| **SQL** | trino、hive、trino-optimizer、time-filtering | TD 固有の関数を使用した TD クエリの記述、最適化、移行 |
| **ワークフロー** | digdag、workflow-management、dbt | Treasure ワークフロー の作成、デバッグ、デプロイ |
| **CDP** | parent-segment、segment、journey、connector-config | セグメント、ジャーニー、アクティベーションの構築と検証 |
| **AI エージェント** | agent、agent-prompt、agent-test | TD AI エージェントの開発、テスト、ドキュメント化 |
| **TDX CLI** | tdx-basic、engage、workflow | コア CLI 操作、メールキャンペーン、ワークフロー管理 |


説明、機能、ペルソナマッピングを含むすべてのスキルの完全なカタログについては、[サポートされているスキルカタログ](/ja/products/ai-studio/skills/skills-catalog)を参照してください。

## セッションのスキルを有効化する

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

### セッション選択

#### Web と Desktop

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


プロのヒント
選択したスキルはドロップダウンの上部に表示されるため、何が有効になっているかをすぐに確認できます。スキルはプラグインごとにグループ化されており、すべての SQL スキルが一緒に表示され、すべての CDP スキルが一緒に表示されます。

#### Mobile（iOS）

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

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


### プロジェクトデフォルト

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

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


**設定例：**

| プロジェクト | 事前選択スキル | 理由 |
|  --- | --- | --- |
| CDP オペレーション | parent-segment、segment、journey、connector-config | すべての会話がオーディエンスまたはアクティベーション作業に関係するため |
| データエンジニアリング | trino、trino-optimizer、digdag、workflow-management | クエリとパイプラインが日常的なワークフローであるため |
| エージェント開発 | agent、agent-prompt、agent-test | AI エージェントの構築とテストには 3 つすべてが必要なため |


## スキルの適用方法

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

**例：**

`trino` スキルが有効な場合：


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

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

### 組み込みコマンド

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

| コマンド | 機能 |
|  --- | --- |
| `/compact` | 会話を要約・圧縮してコンテキストを解放する |
| `/context` | AI のコンテキストウィンドウに現在含まれているものを表示する |
| `/clear` | 会話をクリアして最初からやり直す |


### Mobile（iOS）

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

## マーケットプレイス

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

注意
GA リリース時点では、ユーザーは利用可能なリポジトリからスキルを参照してインストールできます。カスタムスキルの作成とカスタムリポジトリへの公開は、後続のリリースで利用可能になる予定です。

### Web と Desktop

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

| タブ | 表示内容 |
|  --- | --- |
| **プラグイン** | インストール済みプラグイン（有効/無効トグル付き）とインストール可能な利用可能プラグイン |
| **組み込み** | Studio に同梱されているコア td-skills プラグインの読み取り専用ビュー |
| **リポジトリ** | マーケットプレイスのソース — git リポジトリの追加、削除、更新 |


#### スキルプラグインのインストール

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


#### プラグインの有効化と無効化

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

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


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

#### 利用可能なリポジトリ

| リポジトリ | 内容 |
|  --- | --- |
| [td-skills](https://github.com/treasure-data/td-skills) | SQL、CDP、ワークフロー、AI エージェント、CLI 操作向けの Treasure AI スキル（プリインストール済み） |
| [anthropic-skills](https://github.com/anthropics/skills) | Anthropic の汎用スキル — ドキュメント生成、アーティファクト出力など |


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

### Mobile（iOS）

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

## スキルが AI の動作を形成する仕組み

スキルが有効な場合、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）
- [ ] インストール済みプラグインをアンインストールせずに有効化または無効化できる


## トラブルシューティング

| 問題 | 解決策 |
|  --- | --- |
| スキルの変更が反映されない | 新しいチャットを開始してください。スキルの選択はセッション開始時に固定されます |
| スキルが適用されない | プラグインがスキルパネルでインストール**かつ**有効になっていること、および現在のセッションでスキルが選択されていることを確認してください |
| スキルドロップダウンが空 | スキルパネルを開いて、少なくとも 1 つのプラグインがインストールされて有効になっていることを確認してください |
| Mobile にスキル選択が表示されない | プロジェクトデフォルトを使用してください。セッションごとのスキル選択は Web と Desktop のみです |


## 次のステップ

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