コンテンツにスキップ

スキル(Skill)

Markdown を表示

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

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

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

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

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

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

外部のツールサービスに接続したいだけなら、MCP 接続 でまとめて管理し、必要に応じて Agent に有効化することもできます。

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

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

Section titled “Syfo の使い方ガイドスキルをインストールする”

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

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

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

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

Section titled “その他のスキルをインストールする”

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

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

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

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

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

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

Section titled “既存のスクリプト、CLI、ワークフローがある場合”

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

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

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

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

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

Agent 詳細ページには「MCP」タブもあり、MCP 接続を有効化するのに使います。詳しくは MCP 接続 を参照してください。

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

Section titled “役割ごとにスキルを割り当てる”

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

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

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

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

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

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

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