tomevault-io DeepWiki コンテンツ転載スキル
DeepWikiのドキュメントをリポジトリ内のディレクトリに1ページ1ファイルのMarkdownとして転載し、PRを作成する。
必要な入力
- 対象リポジトリ:
owner/repo形式（例:facebook/react） - 出力先ディレクトリ: リポジトリ内のパス（例:
deepWiki/） - 出力言語: ファイル名および内容の出力言語（デフォルト: 日本語）
- ベースブランチ: PRのマージ先（デフォルト:
main）
スクリプトのパス
本スキルのスクリプトは $CLAUDE_PLUGIN_ROOT/skills/deepwiki-transfer/scripts/ に配置されている。
# スクリプトディレクトリの確認
SCRIPT_DIR="$CLAUDE_PLUGIN_ROOT/skills/deepwiki-transfer/scripts"
ls "$SCRIPT_DIR"
処理手順
Phase A: DeepWikiコンテンツの取得とファイル化
scripts/fetch_wiki.py を使って MCP サーバーに直接HTTPリクエストを送信し、全コンテンツを一時ファイルに保存する。LLMコンテキストを経由しないため、130万文字超のレスポンスも完全に保存できる。
# 公開リポジトリ（認証不要）
python "$SCRIPT_DIR/fetch_wiki.py" \
--repo owner/repo \
--output /tmp/deepwiki_raw.md \
--public
# プライベートリポジトリ（Devin APIキー必要）
python "$SCRIPT_DIR/fetch_wiki.py" \
--repo owner/repo \
--output /tmp/deepwiki_raw.md
# Wiki構造も取得（セクション順序の決定に使用）
python "$SCRIPT_DIR/fetch_wiki.py" \
--repo owner/repo \
--output /tmp/deepwiki_structure.md \
--tool read_wiki_structure \
--public
プライベートリポジトリの場合、環境変数 DEVIN_API_KEY にDevin APIキーを設定しておくこと。
Phase B: 機械的ファイル分割＆リネーム
scripts/split_pages.py を使い、一時ファイルを # Page: マーカーで分割し、セクション番号prefix付きファイル名で出力する。
# まず dry-run で確認
python "$SCRIPT_DIR/split_pages.py" \
/tmp/deepwiki_raw.md ./deepWiki/ \
--structure /tmp/deepwiki_structure.md \
--dry-run
# 問題なければ実行
python "$SCRIPT_DIR/split_pages.py" \
/tmp/deepwiki_raw.md ./deepWiki/ \
--structure /tmp/deepwiki_structure.md
ファイル名の命名規則:
- トップレベル:
XX_Title.md（例:01_Overview.md） - サブセクション:
XX_Y_Title.md（例:01_1_System_Architecture.md） - ソート順がセクション順と一致すること
この時点では内容を一切変更しない。
Phase C: 1ページずつGFM形式変換
scripts/validate_gfm.py で自動修正した後、各ファイルを1ページずつ確認・修正する。
# 自動修正
python "$SCRIPT_DIR/validate_gfm.py" ./deepWiki/ --verbose
# 検証のみ
python "$SCRIPT_DIR/validate_gfm.py" ./deepWiki/ --check-only
自動修正の範囲:
- コードブロックの言語指定（
→mermaid,php,sql 等） - 見出し前後の空行挿入
- 末尾改行の統一
自動修正後、各ファイルを1ページずつ開いて以下を確認:
- コードブロックの言語指定が正しいか（自動推定が誤っている場合は手動修正）
- テーブルのパイプ区切りやアライメント行が正しいか
- リンクや画像参照の構文が正しいか
- 見出しの階層が適切か
内容の意味を変えず、GFM上の記法修正のみ行う。言語変換はこのフェーズでは行わない。
Phase D: 1ページずつ言語変換（出力言語が原文と異なる場合のみ）
ユーザー指定の出力言語が原文の言語と異なる場合、各ファイルを1ページずつ処理する:
- ファイル名: タイトル部分を指定言語に翻訳してリネーム（prefixの
XX_/XX_Y_は変更しない） - ファイル内容: 本文を指定言語に翻訳する。コードブロック内のコード、コマンド、変数名等は翻訳しない
Phase E: バリデーションとPR作成
- 出力ディレクトリの
lsでファイル一覧を表示し、ファイル数とセクション番号の整合性を確認 - 数件をランダムに選び、DeepWiki原文と照合して内容が一致していることを確認
- 変更をコミットしてプッシュ
- PRを作成する。
.github/pull_request_template.mdがある場合はそのテンプレートに沿ってPR説明を作成
前提条件
requestsライブラリ（pip install requests）- 公開リポジトリ: 認証不要
- プライベートリポジトリ: 環境変数
DEVIN_API_KEYにDevin APIキーを設定
禁止事項
- Phase B完了時点では原文を一字一句そのまま保持すること。要約・省略・改変してはならない
- Phase B・Cの時点では翻訳してはならない。言語変換はPhase Dでのみ行う
- 原文の内容を「理解して書き直す」のではなく、スクリプトで機械的に処理すること
- 出力先ディレクトリ以外のファイルを変更してはならない
注意事項
- DeepWikiのコンテンツは通常英語で生成される。日本語出力が指定されている場合、Phase Dで翻訳する
- セクション番号が10以上でも0埋め2桁にすることでソート順を維持（
01_,02_, ...,10_） fetch_wiki.pyは MCP サーバーに直接HTTPリクエストを送信するため、requestsライブラリが必要- 既存ファイルがある場合は内容を比較し、差分がある部分のみ更新する
Converted and distributed by TomeVault — claim your Tome and manage your conversions.