本文へ移動
← 目次 AIエージェント0→1 DAY 16

第3章|仕事を進める環境を確かめる。

DAY 16 ・ 約15〜20分

Skillsで仕事の型を残す

毎回の説明を、発動条件と検証まで含む再利用可能な手順へ変える。

今日できるようになること

繰り返す仕事を一つ選び、入力・手順・停止条件・成果物・検証を備えたSkillとして設計できる。

01 言葉を知る02 仕組みを理解する03 実例で理解する04 今日の理解度を確認する05 今日の整理をする
01|言葉を知る

言葉を知る

Skill

特定の仕事を繰り返し行うための指示、参考資料、テンプレート、必要に応じたスクリプトをまとめたもの。

SKILL.md

Skillの名前、発動条件となる説明、実行手順を記述する中心ファイル。

発動条件

どの依頼でSkillを使い、どの依頼では使わないかを判断するための条件。

段階的開示

最初は名前と説明だけを見せ、必要になった時だけ詳しい手順や資料を読み込む考え方。

評価ケース

Skillが正しく発動し、期待する手順と成果になるか試す代表的な依頼例。

再利用

毎回の説明を、発動条件と検証まで含む再利用可能な手順へ変える。

適用範囲

必要な入力として安全な経路から受け取り、出力やログへ残す範囲を決めます。

02|仕組みを理解する

仕組みを理解する

Skillは繰り返す仕事を再現可能にする

同じ仕事をAIへ何度も頼むと、毎回「この順で調べる」「この形式で書く」「最後にこの検査をする」と説明することになります。会話へ貼る文章が少しずつ変わると、成果物の抜けや確認方法も変わります。Skillは、その仕事で守る手順、必要な資料、完成形式、止まる条件を一つにまとめ、別の会話でも同じ出発点から進められるようにします。 普通のチャットAIへ長いプロンプトを貼る方法との違いは、発動の仕組みと資源のまとまりです。OpenAIの公式資料では、SkillはSKILL.mdを中心とするフォルダーで、必要に応じてreferences、assets、scriptsなどを持てます。最初から全内容を会話へ詰め込まず、名前とdescriptionで必要性を判断し、使う時に本文を読む段階的開示によって文脈を節約します。 Skillが仕事を自動的に正しくするわけではありません。元の手順が間違っていれば、間違いを安定して繰り返します。対象サービスの仕様変更、組織ルール、権限、入力データの不足も自動では解決しません。毎回判断が変わる創造的な仕事を、無理に固定手順へ押し込む必要もありません。まず人が実際に成功した仕事を分解し、再利用する価値のある部分だけを型にします。

一つのSkillには一つの明確な仕事を持たせる

「マーケティングを全部やる」「サイトを完璧にする」のように範囲が広いSkillは、必要な入力、分岐、完成条件が多すぎて、発動時に何をすべきか曖昧になります。良いSkillは「広告週次レポートを作る」「プルリクエストの失敗した検査を調べる」「指定形式の請求書を確認する」のように、利用者が求める一つの成果で説明できます。 設計時は、開始に必要な入力、実行する順番、判断が必要な分岐、返す成果物、必ず避けること、質問または停止する条件を書き出します。入力が不足している時に推測させず、「期間がなければ確認する」「送信先が曖昧なら止まる」と決めます。成果物も「いい感じの報告」ではなく、見出し、数値、根拠、改善案、未確認事項のように確認できる形へします。 別の目的を一つのSkillへ継ぎ足すと、descriptionが長くなり誤発動が増えます。入力や完成形、危険度が異なる仕事は分けます。たとえば「メールを要約する」と「メールを送信する」は、読む仕事と外部へ送る仕事で権限が違うため、同じ自動手順にまとめない方が安全です。

descriptionは発動の入口、本文は実行の地図

SKILL.mdの先頭には、名前とdescriptionなどのメタデータを書き、その後に手順を置きます。OpenAIのSkillではnameとdescriptionが基本で、descriptionは「何をするか」と「いつ使うか」を簡潔に示します。Codexは依頼が説明と合う時にSkillを選べますし、利用者が明示的に指定することもできます。つまりdescriptionは紹介文ではなく、正しい仕事へ案内する入口です。 「便利なSkill」「文章を助ける」のような説明では、使う場面も使わない場面も分かりません。「広告管理画面から渡された週次数値を比較し、クライアント向け報告と次週施策を作る。広告の週次分析を依頼された時に使う」のように対象と成果を先に書きます。似ているが対象外の依頼も想定し、必要なら本文に境界を書きます。 本文は命令形で、実行順と確認点を短く明確にします。背景説明を延々と書くより、「入力を確認する」「前週比を計算する」「原因を事実と推測へ分ける」「数値を変えない」「未確認を明記する」のように行動へします。長い規約や例は別ファイルへ移し、どの段階で読むかをSKILL.mdから案内します。

AGENTS.md、MCP、Hook、Pluginと役割を分ける

Skillと周辺の仕組みは役割が違います。AGENTS.mdは、そのリポジトリで常に守る命名、テストコマンド、変更禁止範囲などの継続ルールに向きます。Skillは、特定の依頼が来た時だけ読み込む仕事の手順です。一回だけの条件は現在の依頼へ書きます。毎回使わない長い手順をAGENTS.mdへ詰め込むと、すべての仕事で文脈を消費します。 MCPやコネクタは、外部サービスの現在データを読み、許可された操作を行う道具です。Skillは、その道具をいつ、どの順で使い、結果が不足したらどうするかを教えます。Skillに「顧客一覧を想像する」と書いてもデータ接続にはなりません。逆にMCPツールが存在しても、正しい業務手順や完成形式までは決まりません。 Hookは特定の出来事で機械的な検査や禁止を働かせ、PluginはSkillsやMCPなどを配布可能な一つの束にします。Skillの文章だけで重要な削除を完全に止めようとせず、権限やHookでも守ります。手順だけで完結するならSkill、ライブデータが必要ならMCP、強制したい検査ならHook、他人へまとめて配るならPluginというように、必要な層だけ選びます。

参考資料、テンプレート、スクリプトを必要な時だけ使う

SkillのフォルダーにはSKILL.md以外の資料を置けます。referencesには規約、用語、詳しい背景、判断基準を置き、assetsには成果物へ使うテンプレートや画像などを置きます。scriptsは文字数計算、形式検査、変換など、同じ入力なら同じ結果にしたい処理へ使います。すべてをSKILL.md本文へ入れず、必要な時だけ読むことで、中心手順を見失いにくくします。 ただし、ファイルを増やすことが品質ではありません。短いチェックリストなら本文だけで十分です。AIが既存の道具で確実にできる処理へ新しいスクリプトを足すと、依存関係と保守対象が増えます。反対に、厳密な文字数、JSON構文、ファイル名規則の確認を自然言語だけへ任せると揺れるため、小さな検査スクリプトが役立ちます。 SKILL.mdから「どの条件で、どの資料を読み、どのスクリプトを実行するか」を明記します。テンプレートをコピーするのか直接編集するのか、元ファイルを壊さないかも決めます。外部から受け取ったスクリプトは命令を含む実行物です。中身、書き込み先、通信、必要権限を確認せず動かしません。

実務手順は入力から検証まで一続きにする

良いSkillは、作業開始だけでなく完了判定まで含みます。最初に正式な対象と入力を確かめ、次に調査、作成、検証、引き渡しへ進みます。各段階で使う資料と道具を示し、重要な判断は人へ戻します。「文章を作る」で終わらず、数値が原資料と一致するか、出典リンクが有効か、禁止表現がないか、指定形式で表示されるかを確認します。 たとえば講座制作Skillなら、次の未完成DAYを確認し、公式一次情報を調べ、本文を4,000〜5,000字で作り、5問と全選択肢解説を用意し、表示とビルドを検査し、合格時だけ公開する流れにします。未完成のものを公開しない、同じDAYを重複制作しない、公開範囲を変えないという停止条件も手順の一部です。 実行途中に予想外の状態が出た時の扱いも必要です。正式なファイルが二つ見つかった、外部サービスへ接続できない、検査が失敗した、公開先が曖昧といった場合は、勝手に補完せず停止または未完了として報告します。成功の文章ではなく、成果物、検査結果、外部状態を証拠に完了させます。

正しく発動するかと正しく働くかを別々に試す

Skillのテストには二種類あります。一つは、使うべき依頼で発動し、似ているが対象外の依頼では発動しないかという選択のテストです。もう一つは、発動後に正しい順番で進み、必要な成果物と検証結果を返すかという実行のテストです。descriptionを直すべき問題と、本文を直すべき問題を分けて考えます。 評価ケースには、明示的な依頼、言い換えた依頼、入力不足、対象外、危険な例を入れます。広告週次レポートなら「今週分をまとめて」のほか、比較期間がない例、SNS分析を求める例、数値を推測するよう求める例も試します。正しい例だけでは誤発動や停止漏れを見つけられません。 一度成功しても終わりではありません。対象サービスの画面、社内ルール、出力テンプレートが変われば更新します。変更後は以前の評価ケースを再実行し、新しい失敗を追加します。実行記録から頻繁な手直しや未確認を探し、手順、資料、検査へ戻します。Skillは完成品というより、現場で改善する小さな業務手順書です。

安全な範囲と配布先を決めてから共有する

Skillは読み込んだエージェントの行動へ影響します。インターネットや他人から入手したSkillには、不要なファイル読取、秘密の送信、破壊的コマンド、権限確認の回避が書かれている可能性があります。提供元、SKILL.md、参照ファイル、scripts、必要なMCPや権限を確認し、理解できない操作を含むものは有効にしません。 秘密情報、個人情報、顧客固有の値をSkill本文やテンプレートへ固定しません。必要な入力として安全な経路から受け取り、出力やログへ残す範囲を決めます。「メールを作る」Skillへ送信権限まで無条件に与えず、下書きと送信を分けます。外部公開、削除、支払い、権限変更は、Skillが選ばれたことを承認の代わりにしません。 読者演習では、毎月または毎週繰り返す小さな仕事を一つ選びます。開始入力、五つ前後の手順、成果物、禁止事項、質問・停止条件、検証を一枚へ書きます。直接依頼、言い換え、入力不足、対象外、危険な依頼の五ケースで試し、発動と成果を記録します。別の人が同じSkillを使って、同じ基準で完了を判断できるか確かめてください。

03|実例で理解する

実例で理解する

具体例で考える

広告週次レポートSkillなら、期間、前週と今週の数値、目標値を入力とし、数値固定、増減計算、事実と推測の分離、良かった点・悪かった点・次週施策の順を定めます。比較期間がない時は質問し、元資料にない原因を断定しません。完成後は全数値を原資料と照合し、未確認事項を残します。メール送信は別の承認付き工程に分けます。

手を動かして理解する

  1. 繰り返している仕事を一つ選び、開始入力と完成成果物を書く
  2. 使う依頼と使わない依頼が分かるdescriptionを一文で作る
  3. 五つ前後の手順、禁止事項、質問・停止条件、検証方法を書く
  4. 長い規約、テンプレート、決定的な検査をreferences・assets・scriptsへ分ける
  5. 直接依頼、言い換え、入力不足、対象外、危険な依頼で発動と成果を試す

04|今日の理解度を確認する

DAY 16の理解度を確認する

1 / 5
QUESTION 01

毎週の広告レポート作成をSkillにする時、最初に決める内容として最も適切なのはどれですか。

QUESTION 02

Skillのdescriptionとして最も適切なのはどれですか。

QUESTION 03

プロジェクト全体で常に守るテストコマンドと、特定の週次レポート手順を置く場所の組合せとして最も適切なのはどれですか。

QUESTION 04

作成したSkillの発動と品質を確かめる評価ケースとして最も適切なのはどれですか。

QUESTION 05

インターネットで入手したSkillにスクリプトと外部接続設定が含まれる場合の対応として最も適切なのはどれですか。

05|今日の整理をする

今日の整理をする

ここまで分かれば次へ

  • ✓ Skillは繰り返す仕事の入力・手順・停止条件・成果物・検証を再利用可能な形へまとめる
  • ✓ descriptionで発動範囲を明確にし、長い資料や決定的処理は必要に応じて別ファイルへ分ける
  • ✓ 発動と実行を別々の評価ケースで試し、権限や外部操作はSkillの指示だけに任せない

講義本文 4,009字

参考資料

公式の一次情報で確かめる

NEXT LESSONDAY 17「大きな仕事を小さく分ける」へ次のDAYに進む →CHAPTER 03 / REVIEW第3章の定着テストへ15問を解く →