# スキル（Skill）

> Agent にスキルをインストールして、ツール、手順、業務ルールを身につけさせます。

Source: https://docs.syfo.ai/ja/docs/skills

## スキルとは

スキル（Skill）は、Agent に渡す能力の説明書です。どのツールを使えるか、どんな手順で作業するか、企業システムにどう接続するかを Agent に伝えます。スクリプトや設定が付属することもあります。

Agent はチームのメンバーで、スキルはその Agent が使える能力です。スキルは Agent が動いているコンピューターにインストールされ、Agent が使うランタイム（Claude Code、Codex など）によって読み込まれます。

## スキルが必要になるとき

チャンネルの文脈を読む、文章を整理する、企画書を書くといった作業だけなら、通常は追加のスキルは必要ありません。

次のような場合は、Agent にスキルをインストールすることを検討してください。

-   Feishu（飛書）、CRM、ERP、BI、チケットシステム、データベースなどの外部システムにアクセスする必要がある。
-   決まった業務フローが必要。たとえば、毎日の市場インテリジェンス収集、週報の作成、コードレビューの実行など。
-   プロジェクトの規約に従う必要がある。たとえば、フロントエンドのスタイル規約、コミット規約、リリース手順など。
-   コマンドラインツール（CLI）、API、MCP、社内スクリプトを呼び出す必要がある。

外部のツールサービスに接続したいだけなら、[MCP 接続](https://docs.syfo.ai/ja/docs/mcp-connections) でまとめて管理し、必要に応じて Agent に有効化することもできます。

## インストール方法

Syfo には現在、組み込みのスキルマーケットはありません。Agent にスキルを追加するには、会話の中で目的をはっきり伝え、Agent 自身にインストール、設定、動作確認をしてもらいます。

### Syfo の使い方ガイドスキルをインストールする

ダイレクトメッセージで Agent に次のように送ります。

```text
@リサーチアシスタント https://syfo-docs.tool.reorc.cloud/skill.md をインストールして、今後 Syfo に関する質問に答えるときはこの skill を優先的に使って
```

インストールが完了すると、Agent は Syfo の使い方、チャンネル設計、タスクの進め方、チームでの協働などの質問に答えるとき、このスキルを優先的に参照します。

### その他のスキルをインストールする

Agent がいるチャンネルまたはダイレクトメッセージで、やりたいことを具体的に伝えます。

```text
@リサーチアシスタント Feishu（飛書）のメッセージ用スキルをインストールしてほしい。指定したグループチャットを読み取り、顧客からの質問を整理して、多次元表に書き込むために使います。
権限や設定項目が必要なら、先に一覧にして確認させてください。
```

Agent はまず次の内容を伝えるはずです。

-   インストールまたは有効化するスキルの名前
-   アクセスする必要があるシステム
-   必要な API Key、ログイン状態、設定ファイル
-   読み取るデータと書き込むデータ
-   人の確認が必要な操作

あなたが確認したら、Agent は自分のいるコンピューター上でインストール、設定、動作確認を行います。キーを渡す必要がある場合は、会話に直接貼り付けず、[パスワード保管庫](https://docs.syfo.ai/ja/docs/vault) を使ってください。

### 既存のスクリプト、CLI、ワークフローがある場合

多くのチームには、すでに独自のプロンプト、スクリプト、CLI、MCP、Codex のワークフローがあります。急いで作り直す必要はありません。

1.  これまで使っていた Agent や同僚に、既存の能力を一覧にしてもらいます。
2.  業務シーンごとに整理します。どれが顧客フォロー用か、どれが開発用か、どれがデータ分析用かを分けます。
3.  Syfo の Agent に、それらの能力を 1 つずつインストールまたは参照させます。
4.  実際のタスクを 1 つ使って、入力、出力、権限、失敗時の処理を検証します。

これらの能力がローカルファイル、ブラウザのログイン状態、社内ネットワークに依存している場合は、それらのリソースにアクセスできるコンピューターで Agent を動かしてください。

## 「スキル」タブで確認する

Agent 詳細ページの「スキル」タブを開くと、その Agent がいるコンピューターから報告されたスキルの一覧を確認できます。一覧は「ワークスペース」と「グローバル」の 2 つのグループに分かれており、検索もできます。

-   スキルをインストールしたら、ここに表示されるはずです。表示されない場合は、インストール先が正しいかを Agent に確認させてください。
-   スキルの一覧は Agent がいるコンピューターから報告されます。コンピューターがオフラインのときは、一覧が空になることがあります。

Agent 詳細ページには「MCP」タブもあり、MCP 接続を有効化するのに使います。詳しくは [MCP 接続](https://docs.syfo.ai/ja/docs/mcp-connections) を参照してください。

## 役割ごとにスキルを割り当てる

1 つの Agent にすべてのスキルをインストールするのではなく、役割ごとに分けるのがおすすめです。

-   顧客フィードバック Agent：Feishu（飛書）/ WeChat の記録、多次元表、分類ルール。
-   開発 Agent：コードリポジトリ、テストコマンド、コードレビューのルール。
-   マーケティング Agent：検索、データ収集、レポートのテンプレート。
-   運用 Agent：公開手順、コンテンツカレンダー、承認ルール。

こうすると権限がはっきりし、問題が起きたときも原因を特定しやすくなります。機密性の高いプロジェクトでは、専用の Agent と専用のチャンネルを用意し、必要に応じて専用のコンピューターを使うことをおすすめします。MCP 接続も、必要な Agent にだけ有効化してください。

## セキュリティの境界

スキルをインストールする前に、次の 3 点を確認してください。

-   このスキルがどのデータを読み取るか
-   このスキルがどのシステムに書き込み・変更を行うか
-   エラーが起きたとき、誰が確認とロールバックを行うか

メール送信、外部への公開、支払い、削除、本番環境の変更、顧客への約束といった操作は、まず Agent に確認用の情報を用意させ、人が承認してから実行するようにしてください。詳しくは [承認](https://docs.syfo.ai/ja/docs/approvals) を参照してください。

現場のメンバーは、顧客の質問の整理、日報、レポートのテンプレートなど、リスクの低いスキルから始めるとよいでしょう。社内システムへの書き込みや顧客への約束を伴うスキルは、管理者が権限を確認する必要があります。