図解知識学習スキル
テーマを指定すると、原理を解説する日本語の知識記事と、生成・埋め込み済みの説明図、および追跡可能な出典とプロンプトを納品し、ユーザーのObsidianに保存します。
実行前提
ホストはスキルをロードするか、またはこの一連の指示を実行でき、ネットワーク接続、ファイルの読み書き、呼び出し可能な画像生成モデルを備えている必要があります。これらの能力を備えたCodex / ChatGPT環境を推奨します。他のエージェントは、設定済みの画像生成ツールを使用できます。ローカルのObsidianに直接書き込むには、ローカルファイルへのアクセスも必要です。エクスポート機能のみがある場合は、記事と画像を納品し、保存のギャップを説明します。まず実際のツールを確認し、製品名だけで能力がすべて揃っていると判断しないでください。
出力形式の選択
- 知識記事: 以下の手順1～6に従い、資料検証、図解解説、Obsidianへの保存を実行します。
- プロジェクト図解README: まずREADMEワークフローを読み、「何ができるか、成果物はどのようなものか、インストール方法、初めての使い方」を中心に図解を構成し、プロジェクト内に保存します。この形式ではObsidianの設定は不要であり、知識記事の長さ、図の数、YAML、要約図の要件も適用されません。検証、執筆、および図の作成に関する原則は引き続き適用されます。
範囲とデフォルト結果
- 完全な記事は通常約3000～6000文字、3～5枚の説明図です。図の数には最後の総合要約図が含まれ、テーマに応じて調整します。
- 冒頭は薄い背景色の概念ガイドで「何か、どのように動作するか、どのような問題を解決するか」を説明し、完全な定義を保持します。その後、必要な背景、動機、由来を紹介します。
- 図はデフォルトでJialeのAI工房スタイルに従います。本文と図注では、理解に影響を与える条件をその場で説明し、図は知識を直接説明します。
- 改訂タスクでは、ユーザーが指定した部分のみを変更します。最初のカードのみを調整する場合は、本文、図、図注、図のスタイルを保持します。ユーザーが明示的に再描画を要求した場合のみ図を変更します。
- 許可された範囲内で、検証、執筆、生成、保存を完了します。結果に影響する設定が不足している場合は、まとめて質問し、通常のレイアウト選択を承認プロセスにしないでください。
1. ノート庫と依存関係の確認
スキルのルートディレクトリにある config.local.json（存在する場合）を読み込みます。今回の指示は設定よりも優先されます。設定に不足がある場合は、ユーザー環境またはナレッジベースのガイドラインを使用します。フィールドはアーカイブルールを参照してください。対象のノート庫が不明で、コンテキストからも判断できない場合は、対象のパスのみを質問し、まず独立した調査と下書き作業を進めます。
対象のノート庫に入ったら、既存の AGENTS.md、使用ガイド、トップページを読み込みます。類似のノートを参考にして、ディレクトリ、メタ情報、リンク方法を決定します。Wikilinkの内容に依存する場合は、実際のファイルを開きます。
この段階で必要な能力を、現在の環境のスキルディレクトリから特定し、インストールパスをハードコードしないようにします。
| 能力 | 優先的に再利用 | 未インストール時 |
|---|---|---|
| プラットフォーム検索と読み取り | agent-reach；まずその説明を読み、実際に利用可能なチャネルを使用 | ホストが利用可能な読み取り専用の検索を使用し、今回使用したチャネルを説明 |
| 一般的なWebページと論文の検証 | ホストのネットワークツール；research-workflow で補完可 | 一次資料を直接読む |
| 執筆と図の計画 | このパッケージのルール；content-research-writer、baoyu-article-illustrator で補完可 | このパッケージのフローに従って完了 |
| ビットマップ画像の生成または編集 | ホストが呼び出せる画像生成ツール；ネイティブのImage / imagegenがある場合は優先 | 完了した下書きと図の計画を保持し、画像のギャップを明確にする |
| ローカル保存 | Python 3.10+、このパッケージのアーカイブスクリプト | 不足環境を明確にし、移行可能な作業ファイルを保持 |
これらの外部スキルはこのパッケージに同梱されません。既に許可でカバーされている手順は実行を継続します。ホストツールの実際の能力と制限に従います。
2. 検証と資料の下書き作成
今回の作業ディレクトリに sources.md を保存します。実際に開いた資料、URL、バージョンまたは日付、裏付けられた結論、未解決の問題を記録します。まず公式ドキュメント、論文、ソースコード、オリジナルの公開を確認します。プラットフォーム上の投稿は、手がかりや実践経験、論争を見つけるために使用します。適切なプラットフォーム資料は、Agent Reachを通じて優先的に取得します。
記事中の重要な数字、年代、アーキテクチャ、パフォーマンスの結論は、実際に読んだ原文に対応している必要があります。検索の要約は手がかりとしてのみ使用します。事実、推論、教育用の例、実測結果を区別します。起源や変遷に関わる場合は、オリジナルのソースを確認します。必要に応じて既存のノートを読み、概念を再利用し、リンク先を確認します。
完了条件：コアメカニズムと背景に裏付けがあり、重要な相違点が説明され、資料が記事中の具体的な例を十分に裏付けていること。
3. 学習の主線を書く
執筆ルールを読み込み、YAMLフロントマターを含むMarkdownの下書きを作成します。完全な定義で始め、「背景と動機 → 全体のプロセス → 主要メカニズム → 具体例 → 工学的トレードオフ → 学習のまとめ」の順で内容を構成し、順序はテーマに応じて調整します。
図解する価値がある箇所には、<!-- figure:01 --> のようなユニークなマーカーを配置します。本文では理由と中間推論を説明し、図は構造、プロセス、または差異を示します。出典リンクは対応する結論の近くに配置します。最後の総合要約図は、主要な解説の後、一次資料リストの前に配置します。
完了条件：読者が因果関係を説明し、例を言い換え、適用条件を判断できること。冒頭の定義、背景、締めくくりの要約がつながっており、重要な結論が資料の下書きと一致していること。
4. 図の計画と生成
ビジュアル仕様を読み込み、illustration-plan.md を保存します。各図の問題、対応する段落、ノード、エッジ、数値、図注を記載します。宝玉の図を再利用する場合は、そのビジュアル仕様を今回のディレクトリの .baoyu-skills/baoyu-article-illustrator/EXTEND.md にコピーします。
各図の完全な最終プロンプトを prompts/01-flow.md などのファイルに保存します。「説明の目的、具体的な対象と関係、レイアウト、ビジュアル、ラベル、フレームサイズ」の順で肯定的な説明を構成します。ホストが呼び出せる画像生成ツールを使用し、ネイティブのImage / imagegenがある場合は優先します。パラメータと呼び出し方法は現在のツールのルールに従い、通常は一度に2枚生成します。
ツールの結果から実際のファイルを特定し、今回の作業ディレクトリにコピーします。各図を開いて、用語、日本語の文字、数字、矢印、比較スケール、可読性を確認します。明確なエラーが見つかった場合は、修正プロンプトを保存し、修正を指示します。使用可能なバージョンを保持し、それでもギャップがある場合は正直に記録します。図が欠けている、または未確認の場合は、完全な図解結果を主張できません。
5. Obsidianに保存
アーカイブルールを読み込み、images.json を保存します。まず、実際の下書き、画像、プロンプト、資料記録に対してアーカイブスクリプトの --dry-run を実行し、結果を確認してから保存します。スキルディレクトリを実際のパスに解決し、scripts/archive_note.py を呼び出し、対象のノート庫、ノートディレクトリ、添付ファイルディレクトリを明示的に渡します。
アーカイブスクリプトは新しいノートのみを追加し、同名の場合はバージョンサフィックスを作成します。既存の記事を変更する場合は、まずバックアップを作成し、今回の許可に従ってその場で変更します。2つ目の記事をアーカイブしてはいけません。また、変更されていない画像を再生成してはいけません。
カードスタイルを定義する必要がある場合は、assets/jiale-knowledge.css を使用します。初回インストール時は、このスニペットのみを追加し、ユーザーの既存の設定とカスタマイズを保持します。ナレッジベースに適切なインデックスが存在する場合は、重複を避けるためにリンクを1つ追加します。
6. 完成確認
最終的な記事、画像、およびファイルが実際に存在するか、figureマーカーがすべて置き換えられているか、埋め込みとWikilinkが解決可能かを確認します。ファイルチェック、図中のテキストレビュー、インターフェースプレビューについて、それぞれ実際の検証範囲を報告します。
納品時には、完了した内容、保存場所、実際のギャップを簡潔に説明し、開くことのできるノートまたはエクスポートファイルを添付します。知識記事は、資料、本文、実際の画像、保存がすべて完了した場合にのみ、完全な納品としてマークします。プロジェクトREADMEは、対応するワークフローの完了条件に従って確認します。