COURSE 01 · Harness Engineering
スキルと段階的開示
ツールが「何ができるか」なら、スキルは「どうやるか」を必要なときに渡す仕組み。SKILL.mdと、コンテキストを軽く保つ段階的開示(progressive disclosure)の3段を見る。
これは詳細編「詳しく学ぶ(トピック別)」のレッスンです。ツールとMCPの続きで、手順を必要なときに渡すスキルを扱います。
手順を、必要なときに渡す
ツールが「何ができるか」を与えるなら、スキルは「どうやるか」を与えます。たとえば、ある形式の書類を埋める手順、社内のやり方、特定ライブラリの使いどころ。こうしたまとまった知識を、必要なときにモデルへ渡す仕組みがスキルです。
公式の説明では、スキルはひとつのフォルダです。中心に SKILL.md があり、スクリプトや資料を一緒に置けます。SKILL.md の先頭には、名前(name)と説明(description)を書いたメタデータが要ります。
肝は、段階的開示(progressive disclosure)
全部をいつもコンテキストに入れたら、窓はすぐ埋まります。そこでスキルは、情報を段階的に開きます。公式が説明する3段です(調査時点:2026年11月)。
- メタデータだけ先読み:起動時には、各スキルの名前と説明だけを読み込む。いつ使うべきかの見当がつく最小限です。
- 本文を読む:いまの作業に関係しそうなら、その
SKILL.mdの全文をコンテキストへ読み込む。 - 追加ファイルを読む:さらに詳細が要るときだけ、フォルダに束ねた別ファイルを読む。
目次を見て、必要な章を開き、必要なら付録まで見る。本の読み方に似ています。たとえばPDFを扱うスキルなら、書類を埋める段になって初めて、書類用の手順ファイルを読みます。普段は中核を軽いまま保てます。
コンテキスト設計との直結
段階的開示は、前のコンテキストの設計で見た「必要なときだけ渡す」を、スキルという形で実現したものです。能力を足しても、窓を無駄に重くしない。ここがスキルの効きどころです。
次に読む
次は会話履歴の保存・Clear・Resumeの内部構造で、セッションの保存と再開(State)を見ます。