# dify-batch-export

> DifyからURL抽出・対話選択・一括エクスポートを実行します。単一アプリのエクスポートは08_dify_auto_import.mdのdify_exportを使用し、バッチ処理・URL抽出・フィルタ・対話選択が必要な場合はこのルールを使用します。dify_batch_export.pyでURL入力からapp_id抽出、全アプリ一括エクスポート、名前フィルタ、対話形式での複数選択が可能です。

- Author: ryuseisuda
- Repository: ryuseisuda/clawd2
- Version: 20260123002259
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/ryuseisuda/clawd2
- Web: https://mule.run/skillshub/@@ryuseisuda/clawd2~dify-batch-export:20260123002259

---

---
name: dify-batch-export
description: "DifyからURL抽出・対話選択・一括エクスポートを実行します。単一アプリのエクスポートは08_dify_auto_import.mdのdify_exportを使用し、バッチ処理・URL抽出・フィルタ・対話選択が必要な場合はこのルールを使用します。dify_batch_export.pyでURL入力からapp_id抽出、全アプリ一括エクスポート、名前フィルタ、対話形式での複数選択が可能です。"
---

# Difyバッチエクスポート Workflow

## Instructions

1. Preflight:
   - `./questions/batch_export_questions.md` でエクスポート方法・対象を確認する
   - エクスポートモード（URL抽出・全件・フィルタ・対話選択）を決定する
   - 出力先ディレクトリを確認する
   - 認証Cookieの有効性を確認する

2. 生成:
   - **URL抽出エクスポート**
     - コマンド: `source .venv/bin/activate && python scripts/dify_batch_export.py --url '{{url}}' -o {{output_path}}`
     - URLからapp_id（UUID形式）を自動検出
     - 複数のURLを含むテキストからも抽出可能
   - **アプリ一覧表示**
     - コマンド: `source .venv/bin/activate && python scripts/dify_batch_export.py --list`
   - **対話形式選択エクスポート**
     - コマンド: `source .venv/bin/activate && python scripts/dify_batch_export.py --select -o {{output_dir}}`
     - 番号指定: 1,3,5（カンマ区切り）、1-5（範囲）、all（全件）、q（キャンセル）
   - **全アプリ一括エクスポート**
     - コマンド: `source .venv/bin/activate && python scripts/dify_batch_export.py --all -o {{output_dir}}`
   - **名前フィルタエクスポート**
     - コマンド: `source .venv/bin/activate && python scripts/dify_batch_export.py --filter '{{pattern}}' -o {{output_dir}}`
     - 部分一致（大文字小文字区別なし）
   - **機密情報込みエクスポート**
     - コマンド: `source .venv/bin/activate && python scripts/dify_batch_export.py --all -o {{output_dir}} --include-secret`
   - 単一エクスポートは `dify-auto-import` の dify_export を使用
   - ファイル名は自動でサニタイズ（使用できない文字は_に置換）

3. QC（必須）:
   - 共通QC Subagent（`qa-skill-qc`）に評価・チェックを委譲する
   - Subagentは最初に `./evaluation/evaluation_criteria.md` をReadし、評価指標に基づいてQCを実施する
   - チェック観点:
     - エクスポート結果の完全性
     - ファイル命名の正確性
     - 機密情報の取り扱い確認
   - 指摘を最小差分で反映する
   - 指摘に対し「修正した/しない」と理由を成果物に残す

4. バックログ反映:
   - エクスポート完了後、バックアップ保存・移行・検証のタスクを抽出する
   - 反映先・編集制約・差分提示は CLAUDE.md の全体ルールに従う

subagent_policy:
  - 品質ループ（QC/チェック/フィードバック）は必要に応じてサブエージェントへ委譲する
  - サブエージェントの指摘を反映し、反映結果（修正有無/理由）を成果物に残す
  - 大量エクスポート時の並列処理はSubagentで実行可能

recommended_subagents:
  - qa-skill-qc: 共通QC。対象Skillの ./evaluation/evaluation_criteria.md を先にReadしてからQCを開始

## Resources

- questions: ./questions/batch_export_questions.md
- assets: ./assets/batch_export_report_template.md
- evaluation: ./evaluation/evaluation_criteria.md
- triggers: ./triggers/next_action_triggers.md
- scripts:
  - ./scripts/dify_export_api.py
  - ./scripts/dify_batch_export.py

## Next Action
- triggers: ./triggers/next_action_triggers.md

起動条件に従い、条件を満たすSkillを自動実行する。

## Error Handling

- auth_cookie_expired: --refresh オプションを追加して再実行、ブラウザでDifyにログイン
- url_parse_error: URLの形式を確認（https://cloud.dify.ai/app/{app_id}/...）、app_idを直接指定して dify-auto-import を使用
- partial_export_failure: 失敗したアプリを確認し個別にエクスポート、アプリの権限・アクセス状態を確認
- output_directory_error: 出力先パスの権限を確認、ディスク容量を確認

## エクスポートコマンド

```bash
# URL入力からapp_id抽出してエクスポート
source .venv/bin/activate && python scripts/dify_batch_export.py --url '{{url}}' -o {{output_path}}

# アプリ一覧表示
source .venv/bin/activate && python scripts/dify_batch_export.py --list

# 対話形式で選択してエクスポート
source .venv/bin/activate && python scripts/dify_batch_export.py --select -o {{output_dir}}

# 全アプリ一括エクスポート
source .venv/bin/activate && python scripts/dify_batch_export.py --all -o {{output_dir}}

# 名前フィルタでエクスポート
source .venv/bin/activate && python scripts/dify_batch_export.py --filter '{{pattern}}' -o {{output_dir}}

# 機密情報込みエクスポート
source .venv/bin/activate && python scripts/dify_batch_export.py --all -o {{output_dir}} --include-secret
```

## 単一エクスポートとの使い分け

| 用途 | 使用するSkill |
|------|---------------|
| 特定のapp_idが分かっている | `dify-auto-import` (dify_export) |
| 1つのフローだけエクスポート | `dify-auto-import` (dify_export) |
| flow_log/.app_idから自動検出 | `dify-auto-import` (dify_export) |
| URLからapp_idを抽出したい | `dify-batch-export` |
| 複数のフローを一括エクスポート | `dify-batch-export` |
| 対話形式で選択したい | `dify-batch-export` |
| 名前パターンでフィルタしたい | `dify-batch-export` |

## ユースケース

### バックアップ
```bash
# 本番環境の全フローをバックアップ
source .venv/bin/activate && python scripts/dify_batch_export.py --all -o ./backup/dify_$(date +%Y%m%d)
```

### 移行
```bash
# 特定プロジェクトのフローを移行
source .venv/bin/activate && python scripts/dify_batch_export.py --filter 'プロジェクト名' -o ./migration
```

### URL共有
```bash
# 共有されたURLからフローを取得
source .venv/bin/activate && python scripts/dify_batch_export.py --url 'https://cloud.dify.ai/app/xxx' -o ./shared.yml
```

### 選択エクスポート
```bash
# 必要なフローだけ選んでエクスポート
source .venv/bin/activate && python scripts/dify_batch_export.py --select -o ./selected
```