Harness Atlas

COURSE 01 · Harness Engineering

スキルと段階的開示

ツールが「何ができるか」なら、スキルは「どうやるか」を必要なときに渡す仕組み。SKILL.mdと、コンテキストを軽く保つ段階的開示(progressive disclosure)の3段を見る。

これは詳細編「詳しく学ぶ(トピック別)」のレッスンです。ツールとMCPの続きで、手順を必要なときに渡すスキルを扱います。

手順を、必要なときに渡す

ツールが「何ができるか」を与えるなら、スキルは「どうやるか」を与えます。たとえば、ある形式の書類を埋める手順、社内のやり方、特定ライブラリの使いどころ。こうしたまとまった知識を、必要なときにモデルへ渡す仕組みがスキルです。

公式の説明では、スキルはひとつのフォルダです。中心に SKILL.md があり、スクリプトや資料を一緒に置けます。SKILL.md の先頭には、名前(name)と説明(description)を書いたメタデータが要ります。

肝は、段階的開示(progressive disclosure)

全部をいつもコンテキストに入れたら、窓はすぐ埋まります。そこでスキルは、情報を段階的に開きます。公式が説明する3段です(調査時点:2026年11月)。

  1. メタデータだけ先読み:起動時には、各スキルの名前と説明だけを読み込む。いつ使うべきかの見当がつく最小限です。
  2. 本文を読む:いまの作業に関係しそうなら、その SKILL.md の全文をコンテキストへ読み込む。
  3. 追加ファイルを読む:さらに詳細が要るときだけ、フォルダに束ねた別ファイルを読む。
① メタデータ name・description|起動時に先読み ② SKILL.md 本文 関係しそうなら読み込む ③ 追加ファイル 必要なときだけ読む
起動時はメタデータだけを先読み。関係すれば本文、必要なら追加ファイル、と必要に応じて深く開く。

目次を見て、必要な章を開き、必要なら付録まで見る。本の読み方に似ています。たとえばPDFを扱うスキルなら、書類を埋める段になって初めて、書類用の手順ファイルを読みます。普段は中核を軽いまま保てます。

コンテキスト設計との直結

段階的開示は、前のコンテキストの設計で見た「必要なときだけ渡す」を、スキルという形で実現したものです。能力を足しても、窓を無駄に重くしない。ここがスキルの効きどころです。

次に読む

次は会話履歴の保存・Clear・Resumeの内部構造で、セッションの保存と再開(State)を見ます。

前のレッスンコースへ戻る次のレッスン