> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stockwork.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# エージェントスキル

エージェントスキルは、[Stockwork Agent](/guide/agent/) が実行できる定型ワークフローです。営業活動で繰り返し発生する成果物作成を、対話しながら AI に任せられます。

## 始める前に

* Stockwork Agent(スキルを含む)の利用は **分析者** 以上のロールが必要です。
* スキルは Stockwork Agent のチャットに自然な日本語で依頼するだけで、AI が自動的に呼び出します。取引詳細ページなどから起動した場合は、開いている画面の情報がコンテキストとして渡され、対象取引が自動的に特定されます。
* 提案書やスライドの生成結果は、チャット横のサイドパネル(ノート・生成物)に出力されます。

## 提供中のスキル

| スキル    | 用途                                     |
| ------ | -------------------------------------- |
| 提案書作成  | 取引情報と商談ログから、提案書の骨子を対話で作成               |
| スライド作成 | 対話で確定した提案骨子(ノート)から、PPTX 形式のスライドを非同期で生成 |

<h2 id="proposal">
  提案書作成
</h2>

取引に関連する商談ログや分析結果をもとに、提案書の骨子を Markdown で作成するスキルです。生成結果はサイドパネルの **ノート** に出力されます。

### 呼び出し方

Stockwork Agent のチャットに、次のように依頼します。

* 「この取引の提案書を作って」
* 「◯◯案件の提案骨子を作成して」
* 「先ほどの商談内容をもとに提案書を書いて」

取引詳細ページからチャットを開いた場合は、対象の取引が自動的に特定されます。それ以外の場合は、対象取引名をチャットで指定してください。

### 対話の進め方

1. **状況確認**: AI が取引の基本情報と商談ログを取得し、現状を把握します。
2. **方針提案**: 課題(顧客が抱えている課題の要点)・ゴール(提案で実現したい状態)・メッセージ(訴求の軸)を AI が案として提示します。「この方向性でよいか」と確認されるので、同意するか修正点を伝えます。
3. **生成**: 合意後、AI が提案書の骨子を生成し、サイドパネルのノートに出力します。
4. **修正**: 生成後も対話で修正を依頼できます(例: 「2 章の内容をもっと具体的に」「競合との差別化ポイントを強調して」)。

<Tip>
  提案書の精度は、参照できる商談ログの充実度に大きく依存します。事前に商談ログを保存し、AI 要約が完了してから依頼すると、より具体的な骨子が生成されます。
</Tip>

## スライド作成

提案書作成で確定した **ノート** を入力として、PPTX(PowerPoint)ファイルを非同期で生成するスキルです。ノートの内容(Markdown アウトライン)をもとに構成が決まります。

### 呼び出し方

提案書作成で骨子ノートを作成した後、同じチャットで次のように依頼します。

* 「このノートからスライドを作って」
* 「先ほどの提案書をスライドにして」

<Warning>
  アウトラインを作成した直後に、ユーザーが確認する前は生成できません。ノートの内容を確認してから、スライド生成を明示的に依頼してください(HITL 承認)。
</Warning>

### 生成の流れ

1. AI が対象のノートを読み取り、内容が空でないかを確認します。
2. スライドの生成タスクが非同期で開始され、チャットに「スライド(.pptx)の生成を開始しました。生成が完了すると通知されますのでしばらくお待ちください。」と表示されます。
3. 生成が完了すると通知が届き、サイドパネルからダウンロードできます。

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

| 症状             | 原因と対処                                                                   |
| -------------- | ----------------------------------------------------------------------- |
| スキルが動かない       | Stockwork Agent の利用権限がありません。ロールが分析者以上か管理者に確認してください。                     |
| 提案書に必要な情報が入らない | 対象取引に紐づく商談ログや AI 要約が不足しています。商談ログを追加し、AI 要約が完了してから再度依頼してください。            |
| スライド生成でエラーになる  | ノート ID が指定されていない、またはノート内容が空です。先に提案書作成でノートを生成し、内容を確認してからスライド生成を依頼してください。 |

## 関連ページ

* [Stockwork Agent 概要](/guide/agent/)
* [ツール](/guide/agent/tools)
* [商談ログ AI 要約](/guide/ai/meeting-summary)
* [取引分析](/guide/ai/deal-analysis)