<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>AI on KnightLiブログ</title>
        <link>https://knightli.com/ja/tags/ai/</link>
        <description>Recent content in AI on KnightLiブログ</description>
        <generator>Hugo -- gohugo.io</generator>
        <language>ja</language>
        <lastBuildDate>Thu, 23 Apr 2026 15:08:19 +0800</lastBuildDate><atom:link href="https://knightli.com/ja/tags/ai/index.xml" rel="self" type="application/rss+xml" /><item>
        <title>画像ベクトル化とは何か: ピクセル画像を検索・分析可能なベクトル表現に変える</title>
        <link>https://knightli.com/ja/2026/04/23/what-is-image-vectorization-vector-search-vision-workflow/</link>
        <pubDate>Thu, 23 Apr 2026 15:08:19 +0800</pubDate>
        
        <guid>https://knightli.com/ja/2026/04/23/what-is-image-vectorization-vector-search-vision-workflow/</guid>
        <description>&lt;p&gt;画像そのものは昔から大量にありますが、画像がそのままシステムに理解され、活用されるわけではありません。&lt;/p&gt;
&lt;p&gt;人間であれば、画像の中に猫がいるか、同じ商品か、ある種の異常欠陥かといったことを比較的すぐ見分けられます。しかしシステムにとって、生の画像はまずピクセルの並びです。追加の処理がなければ、それは検索、クラスタリング、推薦、認識に直接使えるデータというより、色の点の集まりに近いものです。&lt;/p&gt;
&lt;p&gt;この一歩を解決するのが画像ベクトル化です。画像をピクセルベースのファイルから、機械が効率よく比較・計算できるベクトル表現へ変換します。画像検索、類似画像推薦、視覚検索、画像クラスタリング、マルチモーダル理解といった機能の多くは、実際にはこの層の上に成り立っています。&lt;/p&gt;
&lt;h2 id=&#34;1-画像ベクトル化とは何か&#34;&gt;1. 画像ベクトル化とは何か
&lt;/h2&gt;&lt;p&gt;最短で言えば、こうなります。&lt;/p&gt;
&lt;p&gt;画像ベクトル化とは、画像をその特徴を表す数値ベクトルへ変換することです。&lt;/p&gt;
&lt;p&gt;このベクトルは人間が読むためのものではなく、モデルや検索システムが使うためのものです。価値があるのは、画像が単なるファイルではなく、類似度比較、順位付け、計算の対象になるデータオブジェクトへ変わることにあります。&lt;/p&gt;
&lt;p&gt;たとえば猫の画像を考えると、元のファイルにはピクセル情報が保存されています。ベクトル化のあと、システムが受け取るのは固定長の数値ベクトルです。このベクトルに「これは猫」と直接書かれているわけではありませんが、輪郭、質感、色分布、局所構造、意味的な特徴などが符号化されています。だから他の画像との距離計算を行い、どれがより似ているかを判断できるようになります。&lt;/p&gt;
&lt;p&gt;つまり画像ベクトル化が変えるのは、画像そのものよりも、画像をシステムがどう扱えるかです。&lt;/p&gt;
&lt;h2 id=&#34;2-なぜ生のピクセルだけでは足りないのか&#34;&gt;2. なぜ生のピクセルだけでは足りないのか
&lt;/h2&gt;&lt;p&gt;生のピクセルでも計算はできますが、効果と効率の両方に限界があります。&lt;/p&gt;
&lt;p&gt;主な問題は次の 3 つです。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;次元数が高く、直接比較のコストが大きい&lt;/li&gt;
&lt;li&gt;ピクセルの近さは意味の近さと一致しない&lt;/li&gt;
&lt;li&gt;照明、トリミング、背景、解像度の違いで結果がぶれやすい&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;典型例は商品画像検索です。人間から見れば、撮影角度や背景やサイズが違っても同じ種類の商品だと分かることがあります。しかしピクセルをそのまま比較すると、システムは別物だと判断しやすくなります。&lt;/p&gt;
&lt;p&gt;ベクトル化の意味は、「似ているか」をピクセル比較から、より意味や特徴に近い比較へ移すことにあります。&lt;/p&gt;
&lt;h2 id=&#34;3-画像ベクトル化は通常どう進むのか&#34;&gt;3. 画像ベクトル化は通常どう進むのか
&lt;/h2&gt;&lt;p&gt;実際の画像ベクトル化は、単一の処理ではなく、次のようなパイプラインで行われることが多いです。&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;前処理を行う&lt;/li&gt;
&lt;li&gt;画像特徴を抽出する&lt;/li&gt;
&lt;li&gt;特徴を固定長ベクトルへ圧縮する&lt;/li&gt;
&lt;li&gt;ベクトル DB や検索システムに保存する&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;それぞれの段階が最終品質に影響します。&lt;/p&gt;
&lt;h3 id=&#34;1-前処理&#34;&gt;1. 前処理
&lt;/h3&gt;&lt;p&gt;前処理には一般に次のようなものがあります。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;画像サイズのリサイズ&lt;/li&gt;
&lt;li&gt;入力の正規化&lt;/li&gt;
&lt;li&gt;一部ノイズの除去&lt;/li&gt;
&lt;li&gt;色形式や入力形式の統一&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;目的は見た目をきれいにすることではなく、後段のモデル入力を安定させることです。&lt;/p&gt;
&lt;h3 id=&#34;2-特徴抽出&#34;&gt;2. 特徴抽出
&lt;/h3&gt;&lt;p&gt;ここが画像ベクトル化の中心です。&lt;/p&gt;
&lt;p&gt;初期の方法では &lt;code&gt;SIFT&lt;/code&gt;、&lt;code&gt;SURF&lt;/code&gt;、&lt;code&gt;HOG&lt;/code&gt; のような手設計特徴がよく使われ、エッジ、コーナー、局所構造の抽出に強みがありました。現在は深層学習モデルがこの役割を担うことが多く、代表例としては次のようなものがあります。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;ResNet&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;VGG&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Inception&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;ViT&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;CLIP&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;これらは画像をより高次で抽象的な視覚特徴へ変換します。従来の特徴工学と比べると、意味表現に強く、類似検索、マルチモーダル理解、大規模クラスタリングに向いています。&lt;/p&gt;
&lt;h3 id=&#34;3-ベクトル生成&#34;&gt;3. ベクトル生成
&lt;/h3&gt;&lt;p&gt;特徴抽出のあと、内部表現を &lt;code&gt;512&lt;/code&gt; 次元、&lt;code&gt;768&lt;/code&gt; 次元、&lt;code&gt;1024&lt;/code&gt; 次元のような固定長ベクトルへ圧縮することが一般的です。&lt;/p&gt;
&lt;p&gt;ここで大事なのは、次元数が高いほどよいという話ではないことです。表現力、保存コスト、検索速度のバランスを取る必要があります。&lt;/p&gt;
&lt;h3 id=&#34;4-保存と検索&#34;&gt;4. 保存と検索
&lt;/h3&gt;&lt;p&gt;生成されたベクトルは、通常の画像ファイルとして管理されるのではなく、ベクトル検索に対応した仕組みに入ります。たとえば:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;Faiss&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Milvus&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;ベクトル機能を持つ検索システム&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;この段階で、画像は近似最近傍検索、クラスタリング、類似度ランキングの対象になります。&lt;/p&gt;
&lt;h2 id=&#34;4-技術的な流れはどう進化してきたか&#34;&gt;4. 技術的な流れはどう進化してきたか
&lt;/h2&gt;&lt;p&gt;画像ベクトル化自体は新しい概念ではありません。ここ数年で大きく変わったのは、性能と応用範囲です。&lt;/p&gt;
&lt;p&gt;大まかには次の 3 段階で見られます。&lt;/p&gt;
&lt;h3 id=&#34;1-従来型の特徴工学&#34;&gt;1. 従来型の特徴工学
&lt;/h3&gt;&lt;p&gt;この段階では、エッジ、テクスチャ、コーナー、局所記述子など、人間が設計した特徴が中心でした。成熟していて解釈しやすい反面、複雑な場面や意味理解には限界がありました。&lt;/p&gt;
&lt;h3 id=&#34;2-cnn-主導の段階&#34;&gt;2. CNN 主導の段階
&lt;/h3&gt;&lt;p&gt;畳み込みニューラルネットワークによって、画像ベクトル化は特徴を自動学習する段階に入りました。手設計特徴よりも複雑で安定した視覚表現を学べるようになり、分類、認識、類似検索に強くなりました。&lt;/p&gt;
&lt;h3 id=&#34;3-transformer-とマルチモーダルの段階&#34;&gt;3. Transformer とマルチモーダルの段階
&lt;/h3&gt;&lt;p&gt;ここでは画像ベクトル化が単なる視覚特徴から、画像とテキストの意味整合へ進みました。&lt;code&gt;ViT&lt;/code&gt; や &lt;code&gt;CLIP&lt;/code&gt; は画像認識だけのためではなく、画像をテキスト、ラベル、知識ベースと一緒に扱う大きなマルチモーダル系に接続します。&lt;/p&gt;
&lt;p&gt;そのため、現代の画像検索は画像から画像を探すだけでなく、テキストから画像を探したり、画像とテキストを混在させた検索を行ったりできます。&lt;/p&gt;
&lt;h2 id=&#34;5-よくある応用シーン&#34;&gt;5. よくある応用シーン
&lt;/h2&gt;&lt;p&gt;画像ベクトル化は研究用に限られません。実務でもかなり使いどころがあります。&lt;/p&gt;
&lt;h3 id=&#34;1-類似画像検索&#34;&gt;1. 類似画像検索
&lt;/h3&gt;&lt;p&gt;もっとも分かりやすい用途です。&lt;/p&gt;
&lt;p&gt;画像をベクトルに変えることで、次のようなことができます。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;画像から画像を探す&lt;/li&gt;
&lt;li&gt;重複画像を検出する&lt;/li&gt;
&lt;li&gt;類似商品を対応付ける&lt;/li&gt;
&lt;li&gt;視覚的な重複排除を行う&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;EC、コンテンツプラットフォーム、メディア資産管理などでよく使われます。&lt;/p&gt;
&lt;h3 id=&#34;2-推薦システム&#34;&gt;2. 推薦システム
&lt;/h3&gt;&lt;p&gt;多くの推薦問題は、ある画像がユーザーの直前の閲覧内容に似ているかどうかに関係しています。&lt;/p&gt;
&lt;p&gt;ベクトル化により、画像内容そのものを推薦ロジックに組み込めるようになります。テキストラベルや手動カテゴリだけに頼らずに済むため、商品推薦、コンテンツ推薦、広告マッチングで有効です。&lt;/p&gt;
&lt;h3 id=&#34;3-画像クラスタリングと自動分類&#34;&gt;3. 画像クラスタリングと自動分類
&lt;/h3&gt;&lt;p&gt;画像数が大きくなると、人手で整理するのは非常に遅くなります。&lt;/p&gt;
&lt;p&gt;ベクトル化しておけば、まず類似度でまとめたうえで次のようなことができます。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;画像アーカイブ&lt;/li&gt;
&lt;li&gt;シーンごとのグルーピング&lt;/li&gt;
&lt;li&gt;素材整理&lt;/li&gt;
&lt;li&gt;自動タグ候補の提示&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;製造、医療、教育、メディアコンテンツ管理などでよく見られます。&lt;/p&gt;
&lt;h3 id=&#34;4-異常検知と品質検査&#34;&gt;4. 異常検知と品質検査
&lt;/h3&gt;&lt;p&gt;正常サンプルが安定してベクトル表現できていれば、通常分布から外れた画像を見つけやすくなります。&lt;/p&gt;
&lt;p&gt;典型例は次の通りです。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;工業的な欠陥検出&lt;/li&gt;
&lt;li&gt;監視映像の異常認識&lt;/li&gt;
&lt;li&gt;帳票や画像診断データの異常スクリーニング&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;ここでのベクトル化は最終判定そのものではなく、比較やモデリングに適した入力へ画像を変える役割を果たします。&lt;/p&gt;
&lt;h3 id=&#34;5-マルチモーダル検索と画像テキスト理解&#34;&gt;5. マルチモーダル検索と画像・テキスト理解
&lt;/h3&gt;&lt;p&gt;これは現在とくに重要な領域です。&lt;/p&gt;
&lt;p&gt;画像とテキストの両方が近いベクトル空間に写像されれば、次のようなことが可能になります。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;テキストから画像を探す&lt;/li&gt;
&lt;li&gt;画像とテキストを対応付ける&lt;/li&gt;
&lt;li&gt;画像内容ベースの検索を行う&lt;/li&gt;
&lt;li&gt;マルチモーダル知識検索を行う&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;これは生成 AI、視覚質問応答、企業向けの検索拡張システムとも自然に接続できます。&lt;/p&gt;
&lt;h2 id=&#34;6-企業導入で実際にぶつかる論点&#34;&gt;6. 企業導入で実際にぶつかる論点
&lt;/h2&gt;&lt;p&gt;画像ベクトル化は概念としては分かりやすくても、実装や運用では別の難しさがあります。&lt;/p&gt;
&lt;h3 id=&#34;1-ベクトル次元とコストのバランス&#34;&gt;1. ベクトル次元とコストのバランス
&lt;/h3&gt;&lt;p&gt;次元が低すぎると表現力が不足し、高すぎると保存コストや検索コストが増えます。これは一律の正解がある問題ではなく、データ量、応答速度、精度要件と合わせて決める必要があります。&lt;/p&gt;
&lt;h3 id=&#34;2-モデルが場面をまたいで一般化するか&#34;&gt;2. モデルが場面をまたいで一般化するか
&lt;/h3&gt;&lt;p&gt;公開データセットで良い性能が出たモデルでも、自社の画像で同じように効くとは限りません。商品画像、工業画像、医用画像、監視画像では分布がかなり違うため、個別評価が必要になることが多いです。&lt;/p&gt;
&lt;h3 id=&#34;3-検索基盤がスケールに耐えられるか&#34;&gt;3. 検索基盤がスケールに耐えられるか
&lt;/h3&gt;&lt;p&gt;画像数が数万から数百万、数千万へ増えると、ベクトル生成は前半にすぎません。インデックス設計、リコール戦略、更新方法、オンライン問い合わせ性能が、実際の体験を左右します。&lt;/p&gt;
&lt;h3 id=&#34;4-ベクトル化だけでは業務閉ループにならない&#34;&gt;4. ベクトル化だけでは業務閉ループにならない
&lt;/h3&gt;&lt;p&gt;ここは見落とされやすい点です。&lt;/p&gt;
&lt;p&gt;ベクトル化が解決するのは、画像を計算可能な対象へ変えることです。しかしそれだけで完成ではありません。実際には次のようなものも必要です。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;検索ロジック&lt;/li&gt;
&lt;li&gt;ラベル体系&lt;/li&gt;
&lt;li&gt;評価基準&lt;/li&gt;
&lt;li&gt;人手レビューの流れ&lt;/li&gt;
&lt;li&gt;業務システムとの接続方法&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;こうした部分がつながっていなければ、ベクトルそのものは自動的に価値を生みません。&lt;/p&gt;
&lt;h2 id=&#34;7-どう価値を見るべきか&#34;&gt;7. どう価値を見るべきか
&lt;/h2&gt;&lt;p&gt;技術用語として見ると、画像ベクトル化は土台の言葉に見えます。しかし業務の観点から見ると、その価値はかなり具体的です。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;画像に検索可能性を与える&lt;/li&gt;
&lt;li&gt;類似度比較をピクセル層から意味層へ移す&lt;/li&gt;
&lt;li&gt;画像を推薦、検索、クラスタリング、認識の流れへ入れる&lt;/li&gt;
&lt;li&gt;視覚データを分析や自動化の対象に変える&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;これは、視覚データを AI システムに入れるための標準的な入口だと考えると分かりやすいです。この一歩がなければ、多くの画像関連機能はファイル管理の延長にとどまります。この一歩があるからこそ、画像は意思決定や自動処理に使えるデータ資産になります。&lt;/p&gt;
&lt;h2 id=&#34;まとめ&#34;&gt;まとめ
&lt;/h2&gt;&lt;p&gt;画像ベクトル化は、単独の小技ではなく、現代の視覚システムにおける基礎層です。&lt;/p&gt;
&lt;p&gt;やっていること自体は難解ではありません。画像を「ピクセルの集まり」から「検索・比較・分析できるベクトル表現」へ変えることです。しかし、その一歩があるかどうかで、画像が AI、検索、推薦、マルチモーダル活用の流れに本当に入れるかどうかが決まります。&lt;/p&gt;
&lt;p&gt;ひと言で覚えるなら、こうです。&lt;/p&gt;
&lt;p&gt;画像ベクトル化の本質は、画像圧縮ではなく、画像を機械が本当に使える表現へ変えることです。&lt;/p&gt;
</description>
        </item>
        <item>
        <title>スキルの作成方法と使用方法: SKILL.md の仕様と実践原理</title>
        <link>https://knightli.com/ja/2026/03/28/%E5%A6%82%E4%BD%95%E5%88%9B%E5%BB%BA%E5%92%8C%E4%BD%BF%E7%94%A8-skills/</link>
        <pubDate>Sat, 28 Mar 2026 16:30:00 +0800</pubDate>
        
        <guid>https://knightli.com/ja/2026/03/28/%E5%A6%82%E4%BD%95%E5%88%9B%E5%BB%BA%E5%92%8C%E4%BD%BF%E7%94%A8-skills/</guid>
        <description>&lt;p&gt;この記事では、次の 2 つの問題に焦点を当てます。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;SKILL.md&lt;/code&gt;の書き方と構造の設計方法。&lt;/li&gt;
&lt;li&gt;高品質で保守可能、再利用可能なスキルを作成する方法。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&#34;1-skillmd仕様の詳細説明&#34;&gt;1. SKILL.md仕様の詳細説明
&lt;/h2&gt;&lt;p&gt;&lt;code&gt;SKILL.md&lt;/code&gt; は、スキルのコア記述ファイルです。通常、次の 2 つの部分で構成されます。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;YAML Frontmatter: スキルのメタ情報を定義します。&lt;/li&gt;
&lt;li&gt;マークダウン テキスト: 実行命令と実践的なメソッドを定義します。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&#34;11-前付の例&#34;&gt;1.1 前付の例
&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;
&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;12
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;13
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;14
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;15
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;16
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;17
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;18
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;19
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;20
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nn&#34;&gt;---&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;c&#34;&gt;# === 必需字段 ===&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;name&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;l&#34;&gt;skill-name&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;c&#34;&gt;# 技能的唯一标识符，建议使用 kebab-case 命名&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;description&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;p&#34;&gt;&amp;gt;&lt;/span&gt;&lt;span class=&#34;sd&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;sd&#34;&gt;  简洁但精确地说明：
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;sd&#34;&gt;  1) 这个技能做什么
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;sd&#34;&gt;  2) 什么时候应该使用它
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;sd&#34;&gt;  3) 核心价值是什么&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;c&#34;&gt;# 注意：description 通常是智能体选择技能的关键依据，必须写清楚&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;c&#34;&gt;# === 可选字段 ===&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;version&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;m&#34;&gt;1.0.0&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;allowed_tools&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;p&#34;&gt;[&lt;/span&gt;&lt;span class=&#34;l&#34;&gt;tool1, tool2]&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;required_context&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;p&#34;&gt;[&lt;/span&gt;&lt;span class=&#34;l&#34;&gt;context_item1]&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;license&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;l&#34;&gt;MIT&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;author&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;l&#34;&gt;Your Name &amp;lt;email@example.com&amp;gt;&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;tags&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;p&#34;&gt;[&lt;/span&gt;&lt;span class=&#34;l&#34;&gt;database, analysis, sql]&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nn&#34;&gt;---&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;h3 id=&#34;12-推奨されるテキストの構成&#34;&gt;1.2 推奨されるテキストの構成
&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;
&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;12
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;13
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;14
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;15
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;16
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;17
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;18
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;19
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gh&#34;&gt;# 技能标题
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 概述
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;（技能介绍、适用场景、技术背景）
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 前置条件
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;（运行环境、依赖项、权限要求）
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 工作流程
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;（分步骤说明：输入、处理、输出）
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 最佳实践
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;（经验总结、注意事项、常见陷阱）
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 示例
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;（典型任务示例，便于快速上手）
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 故障排查
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;（常见问题与解决方案）
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;h2 id=&#34;2-高品質のスキルを書くための原則&#34;&gt;2. 高品質のスキルを書くための原則
&lt;/h2&gt;&lt;p&gt;公式文書とコミュニティの実践を組み合わせて、次の 4 つの原則に従うことが推奨されます。&lt;/p&gt;
&lt;h3 id=&#34;21-説明は正確でなければなりません&#34;&gt;2.1 説明は正確でなければなりません
&lt;/h3&gt;&lt;p&gt;&lt;code&gt;description&lt;/code&gt; は、スキル マッチングへの重要な入り口です。次のことを行うことをお勧めします。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;適用範囲を明確にし、「データの処理を支援する」などの一般的な説明は避けてください。&lt;/li&gt;
&lt;li&gt;ユーザーの意図の一致を容易にするトリガー キーワードが含まれています。&lt;/li&gt;
&lt;li&gt;独自の価値を説明し、他のスキルとの境界線を形成します。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;悪い例:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;
&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;description&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;l&#34;&gt;处理数据库查询&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;p&gt;推奨される例:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;
&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;description&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;p&#34;&gt;&amp;gt;&lt;/span&gt;&lt;span class=&#34;sd&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;sd&#34;&gt;  将中文业务问题转换为 SQL 查询，并分析 MySQL employees 示例数据库。
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;sd&#34;&gt;  适用于员工信息查询、薪资统计、部门分析、职位变动历史等场景。
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;sd&#34;&gt;  当用户询问员工、薪资、部门相关数据时使用此技能。&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;&lt;h3 id=&#34;22-モジュール性と単一責任&#34;&gt;2.2 モジュール性と単一責任
&lt;/h3&gt;&lt;p&gt;スキルは明確なタスク領域に焦点を当てる必要があります。スキルがあまりにも多くの機能をカバーしようとすると、通常は次のような結果になります。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;記述範囲が広くなり、マッチング精度が低下します。&lt;/li&gt;
&lt;li&gt;命令が長くなり、コンテキストの負荷が増加します。&lt;/li&gt;
&lt;li&gt;メンテナンスと反復コストが増加します。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;「一般的なスキル」を次のような複数の特殊なスキルに分割することをお勧めします。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;mysql-employees-analysis&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;sales-data-analysis&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;user-behavior-analysis&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&#34;23-確実性を優先する&#34;&gt;2.3 確実性を優先する
&lt;/h3&gt;&lt;p&gt;複雑で正確なタスクの場合は、LLM テキスト生成のみに依存せず、「スクリプトの実行」を優先してください。&lt;/p&gt;
&lt;p&gt;たとえば、データ エクスポートのシナリオでは、LLM に Excel バイナリ コンテンツを直接生成させるのではなく、専用のスクリプトを使用して処理する方が良いでしょう。 &lt;code&gt;SKILL.md&lt;/code&gt; はトリガー条件と呼び出し方法を記述するだけです。&lt;/p&gt;
&lt;h3 id=&#34;24-段階的な開示&#34;&gt;2.4 段階的な開示
&lt;/h3&gt;&lt;p&gt;非効率なコンテキストを避けるために、重要性と頻度によって情報を階層化します。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;SKILL.md&lt;/code&gt; 本体: コアワークフローとコモンモード&lt;/li&gt;
&lt;li&gt;追加ドキュメント (&lt;code&gt;advanced.md&lt;/code&gt; など): 高度な使用法とエッジ シナリオ&lt;/li&gt;
&lt;li&gt;データ ファイル: 大規模な参照データ、スクリプト経由でオンデマンドで読み取る&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&#34;要約する&#34;&gt;要約する
&lt;/h2&gt;&lt;p&gt;高品質のスキルの目標は、「より多く書く」ことではなく、「明確な境界、正確なトリガー、安定した実行、持続可能なメンテナンス」を持つことです。&lt;/p&gt;
&lt;p&gt;標準化された &lt;code&gt;SKILL.md&lt;/code&gt; から始めて、単一の責任と段階的な開示を組み合わせることで、より効率的なスキルセットを構築できます。&lt;/p&gt;
</description>
        </item>
        
    </channel>
</rss>
