目次
Skillは、書式を整えるだけでは力を発揮しない。用途に合った設計パターンを選び、知識の読み込み方や作業の進め方まで決めると、ADKエージェントの動きが安定する。
要点#
- 特定ライブラリの知識を必要なときだけ読み込むなら、Tool Wrapperを使う。
- 決まった形式の文書を作るなら、Generatorでテンプレートと手順を分ける。
- コードを基準に沿って点検するなら、Reviewerでチェック項目と評価方法を分離する。
- 要件の聞き取りが欠かせない作業にはInversion、順序を守る必要がある作業にはPipelineが向く。
- 5つの型は組み合わせられるため、作業に必要なものだけを選ぶ。
1. Tool Wrapperで知識を必要なときに読む#
Tool Wrapperは、FastAPIなど特定の技術に関するルールをSkillにまとめる型だ。規約をシステムプロンプトへ詰め込まず、対象の作業が始まったときに参照ファイルを読む。
たとえばSKILL.mdに、FastAPIの開発・レビュー・デバッグで使うSkillだと記載する。作業を始めたらreferences/conventions.mdを読み、コードを書くときは規約に従い、レビューでは違反箇所と修正案を示すよう指示する。
この形なら、規約の更新先は参照ファイルにまとまる。チーム独自のルールや、特定ライブラリの使い方をエージェントに適用したいときに使いやすい。対象が曖昧な依頼では、いつ読み込むかをSkillの説明に書いておこう。
2. Generatorで出力をそろえる#
毎回違う構成のレポートができて困るなら、Generatorを使う。出力テンプレートと文体ガイドを分け、Skillにはそれらを読み込んで埋める手順を記す。
たとえばassets/report-template.mdに章立てを、references/style-guide.mdに文体を置く。生成手順は、ガイドを読む、テンプレートを読む、不足情報を確認する、全項目を埋める、の順にする。APIドキュメントやコミットメッセージのように、形式の揺れを抑えたい出力にも応用できる。
不足情報を聞く工程を省くと、空欄をエージェントが推測で埋めることがある。必要な入力項目を具体的に列挙し、情報がない場合の扱いも決めておく。
3. Reviewerで基準と判定を分ける#
Reviewerは、何を確認するかをチェックリストに、どう報告するかをSkillに分ける型だ。コードを受け取ったら基準を読み、違反を重要度ごとに整理して返す。
たとえばPython向けのreferences/review-checklist.mdを用意し、各指摘に場所、重要度、問題の理由、修正案を含める。重要度はerror、warning、infoのように定義できる。同じ手順のまま、チェックリストを差し替えれば、Pythonの品質確認からOWASP基準の確認へ切り替えられる。
基準が曖昧だと、判定の一貫性も落ちる。「読みやすくする」のような抽象的な項目だけで済ませず、問題になる条件と期待する修正を記述しよう。
4. Inversionで先に質問する#
情報が足りないまま作業を始めると、要件を外した成果物になりやすい。Inversionでは、エージェントが先に質問し、回答がそろってから計画や文書を作る。
プロジェクト計画なら、まず解決する課題、利用者、規模を聞く。次に、実行環境、技術の希望、性能や予算などの条件を確認し、最後にテンプレートへまとめる。質問の順番と、回答を待つ条件をSkillに明記するのがポイントだ。
質問を増やしすぎると、始めるまでに時間がかかる。成果物の内容を変える質問に絞り、必須の回答がそろう条件を先に決めておく。
5. Pipelineで工程を守る#
複数の作業を順番どおりに完了させたいなら、Pipelineが合う。各工程と次へ進む条件を定め、前の段階が終わるまで先へ進まないようにする。
APIドキュメント作成なら、公開APIの一覧を作り、利用者に確認する。次にスタイルガイドに沿ってdocstringを用意し、承認を得てからテンプレートに組み込む。最後にチェックリストで不足を確認する。途中の承認が必要なら、「確認されるまで次の工程へ進まない」と明記する。
工程が増えるほど、待ち時間も増える。承認が必要な段階だけにゲートを置き、各ステップで読み込む資料を指定すると進行がわかりやすい。
次の一歩#
まず自動化したい作業をひとつ選び、「知識を適用する」「定型の出力を作る」「基準で確認する」「先に質問する」「順番を守る」のどれが中心か決めよう。複数が必要なら、たとえばGeneratorの最後にReviewerを組み合わせ、最小のSkillから試す。
出典: https://x.com/GoogleCloudTech/article/2033953579824758855
目次
