Obsidian Web Clipper テンプレートクリエイター

このスキルは、Obsidian Web Clipper 用のインポート可能な JSON テンプレートを作成するのに役立ちます。

使用する場合

• Obsidian Web Clipper のインポート可能なテンプレートを作成または改善する必要がある場合。
• サイトの実際の DOM、スキーマデータ、セレクターを有効なクリッピングテンプレートにマッピングしたい場合。
• JSON をユーザーに渡す前に、セレクターの検証とテンプレートロジックのガイダンスが必要な場合。

ワークフロー

1. ユーザーの意図を特定する: 特定のサイト (YouTube)、特定の種類 (レシピ)、または一般的なクリッピング？
2. 既存のベースを確認する: ユーザーは Bases/ に「Base」スキーマを定義している可能性があります。
   • アクション: Bases/*.base を読んで、一致するカテゴリ (例：Recipes.base) を探す。
   • アクション: Base に定義されているプロパティを使用して、Clipper テンプレートのプロパティを構成する。
   • 詳細は references/bases-workflow.md を参照してください。
3. 参照 URL を取得・分析する: 実際のページに対して変数を検証します。
   • アクション: クリップしたいコンテンツのサンプル URL をユーザーに要求する (提供されていない場合)。
   • アクション (必須): WebFetch を使用してページコンテンツを取得する。WebFetch が利用できない場合は、ブラウザ DOM スナップショットを使用する。references/analysis-workflow.md を参照。
   • アクション: Schema.org JSON、Meta タグ、CSS セレクターの HTML を分析する。
   • アクション (必須): 取得したコンテンツに対して各セレクターを検証する。セレクターを推測しないでください。
   • 分析方法は references/analysis-workflow.md を参照してください。
4. JSON ドラフトを作成する: スキーマに従って有効な JSON オブジェクトを作成します。
   • references/json-schema.md を参照。
5. テンプレートロジックを検討する: オプションのブロック (例：栄養情報が存在する場合のみ表示) に条件分岐を使用し、リストデータにはループ、重複する式を避けるために変数割り当て、不足している変数へのフォールバックを使用する。ロジックはテンプレートを改善する場合にのみ使用し、シンプルなテンプレートはシンプルに保つ。references/logic.md を参照。
6. 変数を検証する: 選択した変数 (Preset、Schema、Selector) が分析に存在することを確認します。
   • アクション (必須): 取得したコンテンツからセレクターを検証できない場合は、それを明示的に述べて別の URL を要求する。
   • references/variables.md を参照。

セレクター検証ルール

• 常にセレクターをライブページコンテンツに対して検証する してから応答する。
• セレクターを推測しない。 DOM にアクセスできないか要素が見つからない場合は、別の URL またはスクリーンショットを要求する。
• 安定したセレクター (data 属性、セマンティックロール、一意の ID) を、壊れやすいクラスチェーンより優先する。
• ターゲット要素を説明する (例：「About セクションのパラグラフ」) 不一致を減らすため。

出力フォーマット

常に 最終結果をユーザーがコピーしてインポートできる JSON コードブロックとして出力する。

Clipper テンプレートエディターはテンプレート構文を検証します。 テンプレートロジック (条件分岐、ループ、変数割り当て) を使用する場合は、references/logic.md と公式 Logic ドキュメントの構文に従い、テンプレートが検証に合格するようにしてください。

{
  "schemaVersion": "0.1.0",
  "name": "My Template",
  ...
}

リソース

• references/variables.md - 利用可能なデータ変数。
• references/filters.md - フォーマッティングフィルター。
• references/json-schema.md - JSON 構造ドキュメント。
• references/logic.md - テンプレートロジック。
• references/bases-workflow.md - Base をテンプレートにマッピングする方法。
• references/analysis-workflow.md - ページデータを検証する方法。

公式ドキュメント

• Variables
• Filters
• Logic
• Templates

例

JSON の例は assets/ を参照してください。

制限事項

• このスキルは、タスクが上記で説明されているスコープと明確に一致する場合にのみ使用してください。
• 出力を環境固有の検証、テスト、または専門家のレビューの代替物として扱わないでください。
• 必須入力、権限、安全境界、または成功基準が不足している場合は、停止して明確化を求めてください。