私たちは何世紀も前からスキルを書いてきました。それを本と呼んでいただけです。

ブログ · 5 分で読めます

誰かに AI エージェント用の「スキルを書いて」と頼むと、まるで誰も一度もやったことのない種類の執筆であるかのように、奇妙な物怖じが顔を出すのを目にすることになります。でも、そんなことはありません。レシピはスキルです。フィールドマニュアルはスキルです。飛行機の座席の後ろにあるラミネート加工の安全カード、運用チームのバインダーに挟まった障害対応ランブック、最初の編集者に二度読まされたスタイルガイド——これらはすべて、今まさにエージェントに渡そうとしているものと同じです。つまり、物事のやり方を書き留めておき、あなたがその場にいなくても他の誰かがそれをできるようにする、というものです。

本当に新しいのは、書くことそのものではありません。読み手です。料理本は、一度パラパラめくって夕食に何を作るか決め、ついでに前置きの小話を楽しむような人のために書かれています。エージェントはその小話を求めていません。オーブンの温度、生地を休ませる時間、「生地が二倍に膨らんでいなければ、あと二十分待つこと。勘で判断しないこと」が欲しいのです。良い説明書には昔からこの部分がどこかに含まれていました。ただ、人間の読み手が求める他のあらゆるものの下に埋もれていただけで、エージェントにはそれを掘り出してやる必要があるのです。

ずっと下手だった部分

しばらくの間、「スキルを書く」というのは私にとって翻訳に近い作業で、そしてそれが下手でした。一章を読み、重要な部分を頭にとどめておき、それをテキストボックスに打ち直す。もっともらしく聞こえる一文は覚えているのに、二段落後の正確な数字は落としてしまう。その頃にはもうメモを取るのをやめてしまっているからです。出来上がるのは原文の雰囲気であって、原文そのものではありません——自信ありげに聞こえるのに、どこかひっそりと間違っていて、それに気づくのはたいてい、エージェントが思いもよらない場所までそれに従って進んでしまった後でした。

次に試した方法はもっとひどいものでした。章をまるごと貼り付けて、エージェントがプレッシャーの中で正しい段落を見つけてくれることを願う——四十ページのマニュアルをそのまま渡して「どこかに書いてあるはず」と言うようなものです。どちらも、本当の意味でスキルを書くことにはなっていません。一方は元の資料を捨ててしまい、もう一方はそれをスキルへと作り変える作業そのものを放棄しています。

変わったこと

Skilnu の「ドキュメントから下書きを作る」機能は、私が下手だったまさにその作業をやってくれます。実際のドキュメント——PDF、Word ファイル、Markdown のエクスポート——を読み込み、雰囲気ではなく具体的な内容を保ったスキルの下書き、SKILL.md を返してくれます。何かが公開されるわけではありません。編集フォームに置かれた最初の下書きにすぎず、誰か下流の人の目に触れる前に、間違っている部分を私が直すのを待っているだけです。

変わった習慣は、思ったより小さなものです。「これをエージェントにどう説明しよう」と考えるのをやめて、「これ、もうどこかに書いてあるんじゃないか」と考えるようになりました。そして、実際にそうであることがどんどん増えています。以前の同僚が書いてそれ以来誰も開いていないオンボーディング資料、最初の一ページ以上は誰も読まなかった PDF のスタイルガイド、渡す代わりについ口頭ですすめてしまう本の一章。そのどれもが、二十分と一回の編集さえあれば、エージェントが実際に従えるものになる——記憶を頼りに下手に引用するしかなかったものではなく——ということがわかったのです。

だからといって、下書きに編集が要らなくなるわけではありません。あなたのドキュメントを一度読んだだけのモデルは、その読み方のままに書きます。ルールが必要な箇所に要約を差し込み、元の文章が曖昧だった箇所ではそのまま曖昧なままにする。その部分は、新しい読み手のためにマニュアルを書き直す人が昔からそうしてきたのと同じように、今もあなたの仕事です。なくなったのは、白紙の状態から始めて、第四章に本当は何が書いてあったかを思い出そうとする、あの部分です。

本棚にはもう、こういうものがあふれています

スキルをゼロから書こうとする衝動は、エージェント向けの指示をすべてまったく新しい種類のドキュメントであるかのように扱ってしまいます。そんなことはありません。チームの wiki のどこか、運用チームの棚のバインダーの中、あるいは本当の本棚の上に、エージェントに知っておいてほしいことのほとんどは、最初からきちんとやろうと気にかけた誰かによって、すでに書き留められています。やるべきことは、書くことではありませんでした。そのマニュアルにも意味があると、ようやく認めることだったのです。