キヨさん続編11_スキル編

Transcript

1. キヨさん続編11_スキル編 ｜ AIの手順書 SKILL.md キヨさん、 AIの虎の巻を のぞく 巻 AIに渡す手順書「SKILL.md」と、それを自分で書き足していくHermes Agent。 昭和のSEキヨさんが、作業標準書と赤ペンにたとえて読み解く話 SKILL.md 段階的な読み込み オープン標準 Hermes Agent 学習ループ ※この物語はフィクションです。登場人物は架空です。技術の説明は、公開された資料に基づきます。 「エルメスも AIに参戦か？」
2. 人 登場人物 3人と、AIの相棒 清 ハ ミ 相 山田 清之（67） キヨさん 孫・ハルト（21） 助手 南 ミナミ（29） Webエンジニア AI「相棒」 手順書を読む側 元メインフレームSE。現役時代 情報系の大学生。最近はClaude 社内チャットボットの担当。毎 キヨさんのおしゃべりLLM。手 は、手順書の改訂担当も長かっ Codeで、研究室のスキルを書い 回同じ説明をAIにするのに疲れ 順書があると、急に仕事が早く た ている ている なる 「手順書を見せろ」 「それ、スキルにしとこう」 「また最初から説明？」 「手順書、拝読します」 ※登場人物はすべて架空です キヨさん続編11_スキル編 2
3. 序 相棒が手順書を読んでいた キヨさんの理解度 5% プロローグ｜木曜の午後、キヨさんの書斎 相棒の作業画面に出た一行 清 相棒、今「スキルを読み込みます」と出たな。何を読んだ 相 川柳の添削の手順書です。ハルトさんが書いてくれました 清 お前ほどの物知りが、手順書を読むのか ハ 物知りでも、じいちゃんの添削の好みは知らないからね。それを書いたのが 清 作業標準書か。それなら、わしの本業だ Skill を読み込みます： senryu-review （川柳の添削） キヨさんの疑問 AIは何でも知っているはずなのに、なぜ「手順 書」をわざわざ読むのか ハルトの答え SKILL.md AIは物知りだけど、うちのやり方は知らない。 だから手順書を渡す。それがSKILL.md ※登場人物と会話は物語の例です キヨさん続編11_スキル編 3
4. 1 表紙と本文でできた手順書 キヨさんの理解度 12% 第1章｜SKILL.mdの中身 SKILL.md（ハルトが書いた例） 表紙（フロントマター） --- 先頭の --- で囲んだ部分。name（名前）とdescription（いつ使う か）が必須 name: senryu-review description: 川柳の添削を頼まれたら使う。 季語と字数を確かめ、直す理由を添える --# 川柳の添削 1. 五・七・五の音数を数える 本文 その仕事の手順やコツを、ふつうの文章（Markdown）で書く 2. 直す所は三つまでにする 付録（任意） 3. お世辞は書かない 同じフォルダに、補足資料や小さなプログラムを置いてもいい 4. 直した句と、理由を一行で返す 清 件名と適用範囲が表紙で、手順が本文。作業標準書その ものだ ※例は物語のための架空のスキル キヨさん続編11_スキル編 4
5. 2 腕前のスキル、紙のスキル キヨさんの理解度 16% 第2章｜一般的な「スキル」とSKILL.mdの違い ふつうの「スキル」（人の技能） SKILL.md（AIのスキル） 練習で体に染みこんだ腕前。本人の中にあって、紙に書いて渡すことは できない。例：キヨさんのCOBOLの腕 手順書というファイル。AIの頭の中（前々作のつまみ＝重み）は変わら ず、仕事のときに読むだけ。コピーして配れるし、消せば元どおり ITで「スキル」と呼ばれるもの 中身 キヨさんのたとえ Alexaスキル Amazonの音声アシスタントに足す、追加の機能 後付けの部品 ツール・MCP AIが使う道具そのもの（検索、ファイル操作など） 工具 SKILL.md 道具の使い方や仕事の段取りを書いた手順書 作業標準書 清 わしのCOBOLの腕は、紙一枚にはできんぞ 相 私も読んで腕が上がるわけではありません。読んでいる間だ け上手になります ※Hermes Agentが学習ループで書き換えるのも手順書や記憶のファイルで、モデルの重みは変わらない キヨさん続編11_スキル編 5
6. 3 背表紙だけ並べておく キヨさんの理解度 20% 第3章｜必要になったら開く「段階的な読み込み」 キヨさんのたとえ：カタログ式プロシージャ 大型機では、よく使うJCLを手順ライブラリに登録しておき、名前で呼び出し た。中身は呼ばれたときに展開される 川 柳 表 計 算 議 事 録 翻 訳 図 面 請 求 なぜ背表紙だけか 本文を全部最初に読ませると、前々々作で見た「机」（文脈窓）がすぐ埋ま る。背表紙だけなら、何十冊あっても場所をとらない 1 最初：全スキルの名前と説明（背表紙）だけ読む。1つ100トーク ンほど 2 仕事が来たら：合うスキルの本文を開いて読む 3 さらに必要なら：付録の資料やプログラムを使う 清 PROCLIBと同じ発想だな。名前で呼べば、中身が出てくる ※この仕組みを、Anthropicは「段階的な開示（progressive disclosure）」と呼んでいる キヨさん続編11_スキル編 6
7. 4 優秀な派遣さんにも手順書 キヨさんの理解度 27% 第4章｜SKILL.mdがあると何がうれしいか 毎回の説明が要らない うちのやり方を守れる みんなで使い回せる これまでは、毎回プロンプトに長い説明を書 いていた。手順書にしておけば、AIが必要な ときに自分で読む 社内の書式、用語、確認の順番など、AIが知 りようのない決まりを伝えられる ファイルなので、配る、直す、履歴を残す、 ができる。一人の名人芸がチームの財産にな る キヨさんのたとえ：派遣の技術者 腕のいい派遣さんでも、初日はうちの工場の決まりを知らない。作業標準書 を渡せば、その日から戦力になる キヨさん続編11_スキル編 ミ 毎回「社内用語はこれで、書式はこれで」と説明していま 清 それを手順書にして棚に置いとけ。説明は一回で済む した…… 7
8. 5 Claude Code以外でも読める キヨさんの理解度 34% 第5章｜SKILL.mdはオープンな標準になった 2025年10月16日 AnthropicがAgent Skillsを発表。ClaudeのアプリやClaude Code、 APIで使えるように キヨさんのたとえ：規格の統一 ビデオがVHSとベータに分かれて、テープの貸し借り に苦労した。手順書の形がそろえば、どのAIにも同じ 2025年12月18日 仕様をオープンな標準として公開（agentskills.io） 手順書を渡せる その後 清 VHS・ベータ戦争にならずに済んだわけか ハ 一度書いたスキルを、別のAIツールでもそ OpenAIのCodex、GitHub Copilot、Cursor、 VS Code、Gemini CLIなど、20を超えるツールが対応 のまま使えるんだ ※対応ツールの数は資料により異なる。各ツールの対応範囲は、それぞれの説明書を参照 キヨさん続編11_スキル編 8
9. 6 手順書は誰が改訂するのか キヨさんの理解度 40% 第6章｜更新のタイミングはアプリしだい 型1 型2 型3 人が書いて、人が直す 人に頼まれて、AIが直す AIが自分で気づいて直す 多くのツールの基本。人がファイルを編集 し、次に読み込まれたときから効く 「今の手順をスキルにして」「ここを直して」 と頼むと、AIが書く。決めるのは人 仕事の合間に、AIが自分の判断で手順書を書 いたり直したりする。Hermes Agentがこの型 昭和なら：品質管理課が改訂して配布 昭和なら：課長の指示で、担当が清書 昭和なら：職人が自分で赤ペンを入れる 清 手順書の形は同じでも、改訂の決まりは会社ごとに違う、と いうことだな キヨさん続編11_スキル編 ハ そう。SKILL.mdの規格は「書き方」の決まり。いつ誰が直す かは、アプリの作り方しだい 9
10. 7 ハ エルメスもAIに参戦か？ キヨさんの理解度 44% 第7章｜Hermes Agent、登場 型3の代表が、Hermes Agentっていうエージェント Hermes Agentとは 清 エルメス？ なのか？ AI研究団体のNous Researchが作った、オープンソー スのAIエージェント（MITライセンス）。自分のパソ コンやサーバーで動かせる ミ ふふっ。キヨさん、鞄は売ってません 売りは「自分で育つ」こと 相 （笑）失礼しました。綴りは似ていますが、別物です 仕事の中で覚えたコツを、自分でSKILL.mdに書き残 し、使いながら直していく。スキルの形式は agentskills.ioの標準に合わせている ハ じいちゃん、それは高級ブランド。こっちはNous ResearchっていうAIの研究 清 あのスカーフや鞄の店か。最近はブランド・メーカーもAIに参戦 団体のエージェント ブランドのほうは なんだ。ケリーバッグの割引でもあるかと思った フランスのエルメス（Hermès）。今回の話とは関係 ない ※会話は物語の例 キヨさん続編11_スキル編 10
11. 8 仕事のたびに赤ペンを入れる キヨさんの理解度 53% 第8章｜Hermes Agentの学習ループ ① 仕事を頼まれる ↓ 書くきっかけ（説明書より） くり返す価値のある、何段階もの仕事をやり遂げたとき／失敗や行き止まりから正 しい道を見つけたとき／利用者にやり方を直されたとき ② 考えて、道具を使い、結果を見る（くり返す） ↓ ③ 仕事が終わったら振り返る ↓ ④ 残す価値があればSKILL.mdを書く・直す 次の仕事では、④の手順書を読んでから始める 書き方 専用の道具で、新しく作る（create）、一部を直す（patch）、消す（delete）、 補足ファイルを足す・消す。直すときは一部だけ直すのが基本 キヨさんのたとえ：職人の赤ペン 仕事を終えるたびに、手順書の余白に「ここで詰まった」「こうすると早い」と書 き込む職人。次の現場では、その手順書を持っていく 清 賢いな。わしの現役時代に欲しかった部下だ ※Hermes Agentの説明書による。細かい動きは版によって変わることがある キヨさん続編11_スキル編 11
12. 9 胸ポケットの手帳と棚の手順書 キヨさんの理解度 60% 第9章｜Hermes Agentの「記憶」と「スキル」の違い 種類 中身 いつ読むか キヨさんのたとえ MEMORY.md 環境の事実や学んだこと。約2,200字まで 毎回、最初に全部 胸ポケットの手帳 USER.md 利用者の好み、話し方、期待。約1,375字まで 毎回、最初に全部 お得意様カード スキル（SKILL.md） 仕事の手順やコツ 必要なときだけ 棚の手順書 書き足した記憶が効くのは次から 記憶ファイルは仕事の始めに写しを読み込むので、途中で書き足した分は、 次の回から効く 清 手帳に何でも書くと、ポケットが破れる。手順は棚に置 相 手帳は短く、手順書は必要なときだけ。私も見習います いとけ、か 使い分け 手帳は小さいので、くり返しの仕事で毎回要る情報は、手帳よりスキルに書 くほうがよい場合が多い、と説明書は書いている ※字数の上限はHermes Agentの説明書による既定値 キヨさん続編11_スキル編 12
13. 10 手順書棚の5S キヨさんの理解度 66% 第10章｜使われない手順書を片づける整理係 整理係（キュレーター） 30日使わない 90日使わない バックグラウンドで、約7日ごと、2時間以上 手が空いたときに棚を点検する AIが作ったスキルに「古くなった」印を付け る 倉庫（アーカイブ）に移す。自動で消すこと はない 手を出さないもの キヨさんのたとえ：工場の5S 配布元（ハブ）から入れたスキル、人が手で書いたスキル、固定（ピン留め） したスキル 整理・整頓・清掃・清潔・しつけ。使わない治具は棚から下ろ し、倉庫へ。棚には今使うものだけ 記録を残す 清 点検のたびに、何をしたかの報告書（REPORT.md）を残す 赤札作戦だな。使わんものに赤札を貼って、期限が来た ら倉庫行きだ ※数値はHermes Agentの説明書にある既定値。設定で変えられる キヨさん続編11_スキル編 13
14. 11 自己流が標準になる怖さ キヨさんの理解度 71% 第11章｜手順書をAIに書かせるときの注意 まちがったコツを覚える 悪い指示が紛れ込む いつの間にか変わる たまたまうまくいった回り道を、正しい手順 として書き残してしまうことがある 読んだWebページや資料に仕込まれた指示 を、手順書に書き写してしまうおそれがある 誰がいつ何を変えたか分からないと、問題が 起きたときに戻せない 対策（一般的な心得） ときどき人が中身を読む／変更の履歴を残し、元に戻せるようにする／大事な 手順書は、人が承認してから使う 清 現場の自己流が、いつの間にか標準になる。事故はたい ハ だから、賢い部下にも、ときどき上司の目が要るんだね ていそこからだ ※ここに挙げたのは、AIに手順を書かせる仕組み全般に当てはまる一般的な注意 キヨさん続編11_スキル編 14
15. 12 キヨさん、手順書を書く キヨさんの理解度 76% 第12章｜はじめてのSKILL.md キヨさんの初めてのSKILL.md 清 これでどうだ。名句です、は禁止にした 相 拝読しました。では評価します。「変圧器 清 ……低いな。description に「多少甘く」と足すか ハ じいちゃん、それ、自分で忖度を注文してるよ ミ 手順書を書く人の好みも、そのまま出るんですね --name: kiyo-senryu-judge description: キヨさんの川柳の 開けてみたなら 会 議室」は6点です 評価を頼まれたら使う --# キヨ流・川柳の評価 1. まず欠点を一つ挙げる 2. 「名句です」は禁句 3. 点数は10点満点。甘くしない 4. 最後に、季語の有無を確かめる ※スキルと会話は物語の例 キヨさん続編11_スキル編 ※スキルと会話は物語の例 15
16. 結 キヨさんの手順書台帳 キヨさんの理解度 80% まとめ｜SKILL.mdの役割と、育て方 項目 中身 キヨさんのたとえ SKILL.md 名前と説明の表紙に、手順の本文が付いた手順書 作業標準書 読み方 最初は背表紙だけ。必要なときに本文を開く カタログ式プロシージャ 広がり 2025年12月にオープン標準に。多くのAIツールが対応 VHSに統一 改訂の仕方 人が直す／頼まれてAIが直す／AIが自分で直す。アプリしだい 改訂の社内規程 Hermes Agent 仕事のたびに振り返り、手順書を書き足して次に生かす 職人の赤ペン 注意 自己流の混入に気をつけ、人がときどき見直す 上司の目 SKILL.mdは、AIに「うちのやり方」を渡す手順書。いつ誰が書き直すかで、AIの育ち方が変わる キヨさん続編11_スキル編 16
17. 終 赤ペンを持つAI キヨさんの理解度 83% エピローグ｜金曜の夜、キヨさんの書斎 清 手順書を渡すだけでなく、自分で赤ペンを入れるAIか。賢いな ミ うちのボットにも、社内用語のスキルを作りました。もう毎回説明しなくていいです ハ じいちゃん、今日の理解度は何割くらい？ 清 八割だな。残りの二割は、エルメスで笑われた分だ ミ あれはもう、うちの部署で語り草です 相 スキルにして残しておきましょうか。「エルメスの件」 清 ……それは手順書にせんでいい キヨさんの覚え書き SKILL.md 表紙（名前と説明）と本文の手順書。背表紙だ け先に読む 改訂 誰がいつ直すかは、アプリしだい Hermes Agent 仕事のたびに手順書へ赤ペン。ただし上司の目 も忘れずに ※登場人物と会話は物語の例です キヨさん続編11_スキル編 17
18. 完 手順書は、使う者が育てるもんだ。 赤ペンは、AIにも持たせてやれ。 ―― キヨさん ラストカット：キヨさんの新作「赤ペンを 持たせた部下が 先に出世」。 相棒「6点です」。キヨさん「……手順書、どこまで甘くしてよかったかな」。 おしまい
19. 付 付録：スキルの言葉 キヨさんの用語集｜令和の言葉と、昭和のSEの言葉 言葉 意味 キヨさんの言葉 スキル（一般） 人が練習で身につけた技能や腕前 職人の腕 SKILL.md AIに渡す手順書のファイル。読んでもモデルの重みは変わらない 作業標準書 フロントマター ファイル先頭の --- で囲んだ部分。nameとdescriptionを書く 表紙と適用範囲 段階的な開示 最初は名前と説明だけ読み、必要なときに本文を読む仕組み 背表紙だけの棚 Agent Skills Anthropicが2025年10月に発表したスキルの仕組み。12月にオープン標準 に 手順書の規格 agentskills.io SKILL.mdのオープン標準をまとめたサイト 規格書 エージェントループ 考える、道具を使う、結果を見る、をくり返す仕事の進め方 段取りと手直し Hermes Agent Nous Researchのオープンソースのエージェント。手順書を自分で書き足 す 赤ペンを持つ職人 MEMORY.md・USER.md Hermes Agentが毎回最初に読む、短い記憶のファイル 手帳とお得意様カード キュレーター 使われないスキルに印を付け、倉庫へ移す整理係 5Sの赤札作戦 プロンプトインジェクション 読ませた文書に指示を仕込み、AIを操ろうとする手口 紛れ込んだ怪文書 キヨさん続編11_スキル編 19