Repomix Unmixer

概要

このスキルはrepomixでパックされたリポジトリからファイルを抽出し、元のディレクトリ構造を復元します。Repomixはリポジトリ全体をAIフレンドリーな単一ファイル(XML、Markdown、またはJSON)にパックし、このスキルはそのプロセスを逆転させて個別ファイルを復元します。

このスキルを使用する場合

このスキルは以下の場合に起動します:

• repomix出力ファイル(*.xml, *.md, *.json)の逆混合
• パックされたリポジトリからのファイル抽出
• repomix形式から元のディレクトリ構造を復元
• repomixでパックされたコンテンツのレビューや検証
• repomix出力を使用可能なファイルに変換

コアワークフロー

標準的な逆混合プロセス

bundledされたunmix_repomix.pyスクリプトを使用してrepomixファイルからすべてのファイルを抽出し、元のディレクトリ構造を復元します:

python3 scripts/unmix_repomix.py \
  "<path_to_repomix_file>" \
  "<output_directory>"

パラメータ:

• <path_to_repomix_file>: repomix出力ファイル(XML、Markdown、またはJSON)へのパス
• <output_directory>: ファイルが抽出されるディレクトリ(存在しない場合は作成されます)

例:

python3 scripts/unmix_repomix.py \
  "/path/to/repomix-output.xml" \
  "/tmp/extracted-files"

スクリプトの処理内容

1. 解析 - repomix形式(XML、Markdown、またはJSON)を解析
2. 抽出 - 各ファイルパスとコンテンツを抽出
3. 作成 - 元のディレクトリ構造を作成
4. 書き込み - 各ファイルを元の場所に書き込み
5. 報告 - 抽出の進行状況と統計情報を報告

出力

スクリプトは以下を実行します:

• 必要なすべての親ディレクトリを作成
• すべてのファイルをパスを保持したまま抽出
• 各ファイルの抽出進行状況を出力
• 抽出されたファイルの総数を表示

出力例:

Unmixing /path/to/skill.xml...
Output directory: /tmp/extracted-files

✓ Extracted: github-ops/SKILL.md
✓ Extracted: github-ops/references/api_reference.md
✓ Extracted: markdown-tools/SKILL.md
...

✅ Successfully extracted 20 files!

Extracted files are in: /tmp/extracted-files

サポートされている形式

XML形式(デフォルト)

Repomix XML形式の構造:

<file path="relative/path/to/file.ext">
file content here
</file>

スクリプトは正規表現を使用して<file path="...">content</file>ブロックをマッチングします。

Markdown形式

ファイルマーカー付きのMarkdown形式repomix出力:

## File: relative/path/to/file.ext

file content

詳細な形式仕様についてはreferences/repomix-format.mdを参照してください。

JSON形式

JSON形式repomix出力:

{
  "files": [
    {
      "path": "relative/path/to/file.ext",
      "content": "file content here"
    }
  ]
}

よくあるユースケース

ユースケース1: Claude Skillsの逆混合

repomixファイルとして共有されたスキルを抽出します:

python3 scripts/unmix_repomix.py \
  "/path/to/skills.xml" \
  "/tmp/unmixed-skills"

その後、抽出されたスキルをレビュー、検証、またはインストールします。

ユースケース2: レビュー用にリポジトリを抽出

パックされたリポジトリを抽出してその構造とコンテンツをレビューします:

python3 scripts/unmix_repomix.py \
  "/path/to/repo-output.xml" \
  "/tmp/review-repo"

# 構造をレビュー
tree /tmp/review-repo

ユースケース3: ワーキングファイルを復元

repomixバックアップからワーキングディレクトリにファイルを復元します:

python3 scripts/unmix_repomix.py \
  "/path/to/backup.xml" \
  "~/workspace/restored-project"

検証ワークフロー

逆混合後、抽出されたファイルが正しいか検証します:

1. ファイル数を確認: 抽出されたファイル数が予想と一致するか確認
2. 構造をレビュー: treeまたはls -Rを使用してディレクトリレイアウトを検査
3. コンテンツをスポットチェック: 重要なファイルをいくつか読んでコンテンツの完全性を確認
4. 検証を実行: スキルの場合、スキル作成者の検証ツールを使用

Claude Skillsの逆混合の詳細な検証手順については、references/validation-workflow.mdを参照してください。

重要な原則

常に出力ディレクトリを指定

現在の作業ディレクトリを散らかさないため、常に出力ディレクトリを指定します:

# 良い例: 明示的な出力ディレクトリ
python3 scripts/unmix_repomix.py \
  "input.xml" "/tmp/output"

# 避けるべき例: デフォルト出力(現在のディレクトリを散らかす可能性)
python3 scripts/unmix_repomix.py "input.xml"

レビュー用に一時ディレクトリを使用

最初に一時ディレクトリに抽出してレビューします:

# /tmpにレビュー用に抽出
python3 scripts/unmix_repomix.py \
  "skills.xml" "/tmp/review-skills"

# コンテンツをレビュー
tree /tmp/review-skills

# 満足したら最終的な宛先にコピー
cp -r /tmp/review-skills ~/.claude/skills/

上書き前に検証

重要なディレクトリにレビューなしで直接抽出しないでください:

# 悪い例: 既存ファイルを上書きする可能性
python3 scripts/unmix_repomix.py \
  "repo.xml" "~/workspace/my-project"

# 良い例: 一時ディレクトリに抽出、レビュー、その後移動
python3 scripts/unmix_repomix.py \
  "repo.xml" "/tmp/extracted"
# レビューしてから:
mv /tmp/extracted ~/workspace/my-project

トラブルシューティング

ファイルが抽出されない

問題: スクリプトは完了しますがファイルが抽出されません。

考えられる原因:

• 誤ったファイル形式(repomixファイルではない)
• サポートされていないrepomixバージョン
• ファイルパターンがマッチしない

解決策:

1. 入力ファイルがrepomix出力ファイルであることを確認
2. 形式(XML/Markdown/JSON)を確認
3. ファイル構造を手動で確認
4. 形式の詳細についてはreferences/repomix-format.mdを参照

パーミッションエラー

問題: 出力ディレクトリに書き込みできません。

解決策:

# 出力ディレクトリが書き込み可能であることを確認
mkdir -p /tmp/output
chmod 755 /tmp/output

# または、自分が所有するディレクトリを使用
python3 scripts/unmix_repomix.py \
  "input.xml" "$HOME/extracted"

エンコーディングの問題

問題: 抽出されたファイルで特殊文字が文字化けしています。

解決策: スクリプトはデフォルトでUTF-8エンコーディングを使用します。問題が続く場合:

• 元のrepomixファイルのエンコーディングを確認
• ファイルが正しく作成されたことを確認
• 具体的な文字例を添えて問題を報告

パスがすでに存在

問題: 抽出先パスにファイルが存在します。

解決策:

# オプション1: 新しい出力ディレクトリを使用
python3 scripts/unmix_repomix.py \
  "input.xml" "/tmp/output-$(date +%s)"

# オプション2: 最初にディレクトリをクリア
rm -rf /tmp/output && mkdir /tmp/output
python3 scripts/unmix_repomix.py \
  "input.xml" "/tmp/output"

ベストプラクティス

1. 一時ディレクトリに抽出 - 初回レビュー用に常に/tmpまたは同様のディレクトリに抽出
2. ファイル数を確認 - 抽出されたファイル数が予想と一致するか確認
3. 構造をレビュー - 使用前にtreeを使用してディレクトリレイアウトを検査
4. コンテンツをチェック - コンテンツが完全であることを確認するため数ファイルをスポットチェック
5. 検証ツールを使用 - スキルの場合、逆混合後にスキル作成者の検証ツールを使用
6. 元のファイルを保存 - バックアップとして元のrepomixファイルを保持

リソース

scripts/unmix_repomix.py

以下を行うメインの逆混合スクリプト:

• repomix XML/Markdown/JSON形式を解析
• 正規表現を使用してファイルパスとコンテンツを抽出
• ディレクトリ構造を自動的に作成
• ファイルを元の場所に書き込み
• 抽出の進行状況と統計情報を報告

スクリプトは自己完結しており、Python 3標準ライブラリのみが必要です。

references/repomix-format.md

以下を含むrepomixファイル形式の包括的なドキュメント:

• XML形式の構造と例
• Markdown形式のパターン
• JSONスキーマ
• ファイルパスエンコーディングルール
• コンテンツ抽出パターン
• 形式バージョンの違い

形式固有の問題を扱う場合や新しいrepomixバージョンをサポートする場合にこのリファレンスを読み込んでください。

references/validation-workflow.md

抽出されたコンテンツの検証手順を詳細に説明:

• ファイル数検証ステップ
• ディレクトリ構造検証
• コンテンツ完全性チェック
• スキル作成者ツールを使用したスキル固有の検証
• 品質保証チェックリスト

ユーザーが逆混合スキルを検証するか抽出品質を確認する必要がある場合にこのリファレンスを読み込んでください。