mcpField
Y
yuque-lakebook-export

yuque-lakebook-export

github.com/yangsonhungドキュメント1850 回インストール12 週間前に更新
リポジトリ

yuque-lakebook-export について

Yuque のナレッジベース、ドキュメント、`.lakebook` ファイルを、Obsidian 向けのローカル Markdown フォルダーに変換するスキルです。単体・一括エクスポートに対応し、画像、リンク、階層、表の移行時の問題を扱います。

主な機能

  1. 01Yuque コンテンツを Markdown に出力
  2. 02単体または複数の `.lakebook` を処理
  3. 03Obsidian 向けのフォルダーを作成
  4. 04画像と内部リンクの問題に対応
  5. 05階層と表の表示問題に対応

活用シーン

  1. 01Yuque のナレッジベースを Obsidian に移行
  2. 021 件または複数の `.lakebook` を変換
  3. 03画像やリンクの一般的な出力問題を修正
  4. 04出力した Markdown とアセットフォルダーを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yangsonhung/awesome-agent-skills --skill yuque-lakebook-export

インストール後、Claude Code で/yuque-lakebook-exportを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

pyproject.toml
uv.lock
references/
usage.md
scripts/
cli.py
scripts/yuque_lakebook_export/
__init__.py
lake_handle.py
lake_reader.py
lake_setup.py

詳細

Yuque Lakebook エクスポート

概要

Yuque のナレッジベース、Yuque ドキュメント、または .lakebook ファイルを、Obsidian 向けに準備されたローカルの Markdown フォルダーに変換します。このワークフローは、単一または一括のエクスポートに対応しており、画像の欠落、トリミングされた画像の不一致、内部リンクの破損、フォルダー階層の誤り、Markdown の表の表示問題など、一般的な移行時の問題を修正します。

使用するタイミング

次のような依頼があった場合に、このスキルを使用します。

  • 1 つ以上の Yuque .lakebook ファイルをエクスポートする
  • Yuque のナレッジベースを Markdown に変換する
  • Yuque のコンテンツを Obsidian に移行する
  • 画像、トリミングされた画像、内部リンク、階層、表に関する Yuque のエクスポート問題を修正する

使用しないケース

次のような場合は、このスキルを使用しないでください。

  • Yuque や .lakebook に関係しない一般的な Markdown の編集
  • ウェブサイトのスクレイピング作業
  • Yuque 以外の形式を対象とするエクスポート作業

手順

  1. エージェントが確定的に実行できるよう、非インタラクティブな実行を優先します。
  2. 非インタラクティブなエクスポートを行う前に、出力ルートディレクトリをユーザーに確認する必要があります。ユーザーに代わって出力ディレクトリを選択しないでください。
  3. ユーザーが出力ディレクトリを指定していない場合は、簡潔に質問し、エクスポートコマンドを実行する前にユーザーの回答を待ちます。
  4. 一貫して uv を優先します。作業ディレクトリに一時的な .venv などのタスク専用環境を作成しないでください。
  5. uv コマンドを実行する前に、環境で uv を利用できるか確認します。
  6. uv がインストールされていない、または PATH から利用できない場合は、インストールする前にユーザーの確認を求める必要があります。無断でインストールしないでください。
  7. uv sync または uv run python scripts/cli.py ... を実行する前に、インストール済みのスキルツールディレクトリ、つまり SKILL.md、pyproject.toml、uv.lock、scripts/ を含むディレクトリに移動する必要があります。これらのコマンドを .lakebook のソースディレクトリ、出力ディレクトリ、またはユーザーの現在のワークスペースのルートから直接実行しないでください。
  8. エージェント実行には、次のエントリーポイントを使用します。
uv run python scripts/cli.py
  1. 初回使用前に依存関係を同期します。
uv sync
  1. 推奨されるコマンドの実行順序：
cd /path/to/installed-skill-root
uv sync
uv run python scripts/cli.py ...
  1. 標準的な単一ファイルの実行：
uv run python scripts/cli.py -l "/path/to/your_file.lakebook" -o "/target/root"
  1. 標準的な一括実行：
uv run python scripts/cli.py -l "/path/to/your_file_1.lakebook" "/path/to/your_file_2.lakebook" -o "/target/root"
  1. scripts/cli.py は手動での人間の使用を目的としたインタラクティブなターミナル選択にも引き続き対応していますが、エージェントはターミナルの操作状態を確実に取得できないため、インタラクティブモードに依存してはいけません。必ず -l と -o の引数を明示して渡してください。
  2. 現在の作業ディレクトリ、ユーザーのダウンロードディレクトリ、またはタスクディレクトリに、一時的な仮想環境を手動で作成しないでください。依存関係は、スキルツールディレクトリから uv を使用して管理してください。
  3. Yuque のエクスポートの中には、ドキュメント本文の先頭に <!doctype lake> が含まれるものがあります。以前の実装では、これが Markdown 内で余分な lake## プレフィックスとして表示されることがありました。現在のスキル実装では、このケースにすでに対応しています。
  4. エクスポート後、次の項目を確認します。
  • .md ファイルが存在する
  • 対応する .assets フォルダーが存在する
  • 内部リンクが相対 Markdown パスである
  • 画像が Obsidian で表示される
  • エクスポートされたドキュメントの先頭に誤った lake## プレフィックスがない
  1. エクスポートに失敗した場合は、入力の .lakebook ファイルの隣に書き込まれたバッチログを確認します。

詳細な動作、トラブルシューティング、出力ルールについては、references/usage.md を参照してください。

コメント

Markdown 対応