---
title: Skill
order: 3
description: エージェントが調査に用いる、事前に整備された能力バンドル。
---

# Skill

**スキル（skill）** は、エージェントが呼び出す事前定義済みの能力バンドルです。スキルは
ドメイン知識をエンコードしています ——「TiKV のスロー書き込みインシデントをどう
トリアージするか」「Clinic でスローログをどう取るか」など —— 毎回手順を説明し直す
必要はありません。

## スキルに含まれるもの

- そのスキルを **いつ** 使うべきかをエージェントに伝える短い説明。
- ステップごとの手順と参考資料。
- 任意の補助スクリプトとプロンプト。
- 必要なツール / コネクタ依存関係。

## ビルトインスキル

Investibook は、よくある TiDB Cloud 調査経路向けの診断スキルを同梱しています。例：

- **tikv-slow-diagnosis** —— TiKV レイテンシトリアージ。
- **tikv-fast-tune** —— パフォーマンスボトルネック決定木。
- **transaction-oncall-handbook** —— トランザクション固有のインシデント。
- **pd-oncall-handbook** —— PD スケジューリング、配置ルール、TSO。
- **clinic-api** —— Clinic 経由で指標、ログ、プロファイルを取得。
- **tidb-perf-diagnosis** —— TiDB のエンドツーエンドパフォーマンス分析。

完全なリストは **Skill Hub**（Settings → Skill Hub）または各ワークスペースの sources
パネルで参照できます。

## エージェントはどうスキルを選ぶか

エージェントは以下を考慮します。

1. アクティブなソース（クラスタ種別、チケットの分類）。
2. 質問のキーワード。
3. スキル自身の説明とトリガーフレーズ。

明示的に **ヒント** を与えることもできます ——
[How-to → Investibook を CLI から使う](/docs/how-to/use-cli) の例を参照：

```text
Use skill tidb-perf-diagnosis and skill clinic-api to help me understand
the hotspot issue in cluster xxxx
```

## カスタムスキル

独自のスキルを作成し、Skill Hub からアップロードできます。スコープはワークスペース
レベルです。チーム全体に共有するには、
[tidbcloud/nutshell-skills](https://github.com/tidbcloud/nutshell-skills) に PR を
送ってください。詳細は
[How-to → スキルを書いて共有する](/docs/how-to/author-skill) を参照。