Claude Academy
読み込み中

「社内に聞く」エージェントを構築する

ウィキ、コード、データウェアハウスについて、平易な言葉で回答します。

10 分エンジニアリングClaude Cowork
読み込み中

セットアップ

プラグインを試す

Engineeringプラグインには、出発点として/documentationが同梱されており、接続されたソース全体に展開し、見つけた内容を引用し、確信が持てない場合は担当者を明示するようにすでに構成されています。管理者がプラグインを管理していてまだ利用できない場合は、この手順をスキップしてください。以下の内容はこれを必須としません。

EngineeringStreamline engineering workflows — standups, code review, architecture decisions, incident response, and technical documentation. Works with your existing tools or standalone.
追加
/documentationWrite and maintain technical documentation.
Cowork で開く
/architectureCreate or evaluate an architecture decision record (ADR).
Cowork で開く

ツールを接続する

Claude Cowork は、お使いのシステムと直接連携することで、より強力になります。権限とアクセスはお客様が管理します。ツールアクセスについて学ぶ。

Cowork で カスタマイズ → コネクタ に移動して設定します。

Confluence
まずウィキとランブックを検索して、文書化された回答を確認します。Confluenceへのアクセスは、Atlassian Rovoコネクタ（JiraとConfluence）経由で行われます。
接続
GitHub
コード、README、CODEOWNERSを読み取り、「Xはどのように動作するか」「Xの所有者は誰か」に回答します。
接続
Snowflake任意
「いくつあるか」「なぜメトリクスが変動したか」といった質問について、データウェアハウスに問い合わせます。
接続
Coworkでコネクタを見る

作業フォルダを設定する

エージェントの基盤となるファイル（サービスカタログのエクスポート、チームディレクトリ、用語集、「どこで何が見つかるか」のオンボーディング資料）を1つのフォルダにドラッグし、Cowork にそのフォルダを指定します。これらは、エージェントが他の場所を検索する前に参照するルーティングテーブルになります。そのフォルダからCowork プロジェクトを作成すると、エージェントが進化していく中でもカタログと基本ルールが紐づいたままになります。

Platform / ask-company
service-catalog.yamlApr 18, 202694 KB
glossary.mdMar 2, 202611 KB
team-directory.mdApr 1, 20266 KB
Cowork のチャットバーで：Platform / ask-company

プロンプト

これを Claude Cowork にコピーする

エンジニア向けに、社内の「何でも聞ける」エージェントを構築してください。誰かが「ステージング用のAPIキーはどうやって取得するか」「ordersテーブルの所有者は誰か」「先月デプロイが遅くなったのはなぜか」と尋ねたら、私たちのシステム全体から回答を見つけ、出典を引用し、確信が持てない場合は誰に聞けばよいかを伝えてください。まず1つの良い回答を得てから、それを共有スキルに変換してください。

Platform / ask-company

これがうまくいく理由

プロンプト

質問タイプごとに例を示す。 手順の質問、所有者の確認、メトリクスの理由：エンジニアが実際に尋ねる質問タイプをカバーします。

プロンプト

毎回、出典を引用する。 エンジニアは文章ではなくリンクを信頼します。引用によって回答が検証可能になります。

プロンプト

確信が持てない場合は担当者を明示する。 「所有チームまたはチャンネル」を求めることで、Claude が確信を持てないときに頼れるものが得られます。推測を検証する代わりに、フォローアップ先の手がかりが得られます。

ソース

参照資料を作業フォルダに入れる。 サービスカタログとチームディレクトリが、Cowork にどこを見るべきか、誰を示すべきかを伝えます。

より良いドラフトを得る

練習

見本となる例を追加する。 気に入った例をフォルダに入れておくと、Cowork がその構成とトーンに合わせます。

練習

不確実な点にフラグを立てるよう依頼する。 「確信が持てない点にはフラグを立ててください」と追加しておくと、ドラフトを確認する際に最初に見るべき箇所がわかります。

Cowork を自分用に調整する

プラグインの/documentationは汎用的な出発点です。ステップ2で3つの質問にうまく回答できるようになったら、Cowork にあなた独自のバージョンのスキルを書くよう指示してください。最初に検索すべきスペースやリポジトリ、「確信が持てない」と判断する閾値、トーン、そして立ち入り禁止のシステムを重ねて指定します。数分の対話で、スキルはそれ以降あなたのスタックの言葉で話すようになります。

このタスクでこれまで行ったことをスキルにしてください。あるいは、私のフィードバックをもとに /documentation スキルを編集してください。

Platform / ask-company

繰り返し使えるようにする

アーティファクトとして共有する

エージェントがテスト用の質問にうまく回答できるようになったら、アーティファクトとして公開し、組織内の誰もが1つのリンクで質問できるようにします。アーティファクトは裏側で共有スキルを実行し、プラットフォームチームがそのスキルを所有し、継続的に調整します。

回答できなかった質問をすべて記録する

エージェントは、どこで不足しているかがわかると改善されます。/scheduleと入力するか、Cowork のサイドバーでスケジュール済みを開くと、週次実行によって未回答の質問がフォルダに書き込まれ、プラットフォームチームがギャップを埋められるようになります。

/schedule 毎週金曜日の午後4時に、今週 /documentation が確信を持って回答できなかった質問を一覧にし、トピックごとにグループ化して、それぞれに推奨担当者を付けて Platform/ask-company/gaps-<week>.md に書き込んでください。

Platform / ask-company
スケジュールタスクアクティブ
Ask-companyギャップレポート

毎週、エージェントが回答できなかった質問を一覧にし、トピックごとにグループ化して、推奨担当者付きのギャップレポートを作成します。

金曜日午後4時Cowork で開く

チームメイトと共有する

カスタマイズされた/documentationには、あなたのソース、ルーティングテーブル、確信度のルールが組み込まれています。ワークスペース全体で共有することで、すべてのエンジニアが同じ方法で社内に質問できるようになり、「どうやって…」という質問への答えが、チャンネルに誰がいるかに依存しなくなります。

組織にとって何が変わるか