yao-meta-skill/docs/README.ja-JP.md

Yao Meta Skill 日本語紹介

yao-meta-skill は「スキルを作るためのスキル」です。

目的は、長いプロンプトを書くことではなく、散在したワークフロー、会話ログ、運用ノウハウ、手順書を、再利用可能で評価可能かつ配布可能なスキルパッケージに変換することです。

基本ロジック

処理の流れは次の 6 段階です。

1. ユーザーが本当に繰り返している仕事を特定する
2. スキルの境界を明確にし、1 つのパッケージで役割を混在させない
3. 本文を長くする前に、トリガー用 description を最適化する
4. SKILL.md を小さく保ち、詳細は references/ や scripts/ に分離する
5. 必要な場合にだけ評価や品質ゲートを追加する
6. 必要なクライアント向けにだけ互換アダプタを生成する

使い方

次のようなケースに向いています。

• 新しい skill を作る
• 既存 skill を改善する
• workflow を skill 化する
• skill に eval を追加する
• チーム向けに skill を共有または公開する

一般的な流れ:

1. 対象となる workflow や能力を説明する
2. トリガー条件と期待出力を整理する
3. Scaffold、Production、Library モードを選ぶ
4. skill パッケージを生成する
5. トリガー評価とコンテキストサイズチェックを実行する
6. 必要なクライアント向け互換パッケージを出力する

強み

• 中立的な設計: ソースツリーは単一ベンダーのパスに依存しない
• コンテキスト効率: メインファイルを小さく保つ前提で設計されている
• 評価可能: トリガー評価とサイズ計測の仕組みを含む
• 再利用しやすい: 出力が単発プロンプトではなく skill パッケージになる
• 互換性重視: 複数クライアント対応をソース複製ではなくパッケージ生成で実現する

リポジトリ構成

• SKILL.md: メインエントリ
• agents/interface.yaml: 中立的なメタデータ源
• references/: 長い説明や設計ルール
• scripts/: 評価、サイズ計測、互換パッケージ生成
• templates/: 基本テンプレートと複雑テンプレート

想定ユーザー

• agent 用の能力ライブラリを構築する人
• 内部自動化や知識資産化を進めるチーム
• prompt engineering から skill engineering に進みたい個人や組織