# dify-flow-brushup-customize

> 既存の完成済みDifyフローを対象に、特定ノードや一部要素のみを改善します。会話変数・プロンプト・ノード名・説明・UI要素・レイアウトを最適化し、元ファイルを直接編集して上書きインポートします。「フロー改善」「ブラッシュアップ」「カスタマイズ」「調整」などの依頼時に使用します。

- 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-flow-brushup-customize:20260123002259

---

---
name: dify-flow-brushup-customize
description: "既存の完成済みDifyフローを対象に、特定ノードや一部要素のみを改善します。会話変数・プロンプト・ノード名・説明・UI要素・レイアウトを最適化し、元ファイルを直接編集して上書きインポートします。「フロー改善」「ブラッシュアップ」「カスタマイズ」「調整」などの依頼時に使用します。"
---

# Difyフローブラッシュアップ Workflow

## Instructions

1. Preflight:
   - `./questions/brushup_questions.md` で改善対象・範囲を確認する
   - 対象YMLファイルを読み込み、現在の構造を把握する
   - `source .venv/bin/activate && python scripts/dify_env_vars.py --extract <YMLパス>` で使用変数を抽出する
   - graph.nodesの一覧を確認し、存在するノードIDを把握する
   - 改善パターン・既存フロー構造の参考事例を検索する
   - 確認できなかった資料は「未参照一覧」として記録する

2. 生成:
   - **フロー分析**
     - 対象YMLの概要・目的を確認
     - 改善箇所を特定（変数・プロンプト・ノード名・説明・UI要素・レイアウト）
   - **会話変数最適化**
     - 変数名リネーム（before→after形式で記録）
     - 説明文の更新
   - **プロンプト品質向上**
     - LLMノードのプロンプト改善
     - 明確性・具体性の向上
   - **ノード名・説明最適化**
     - ノードIDごとの名称/説明更新
     - 意味のある命名への変更
   - **UI要素追加**
     - 開始メッセージ/推奨質問の追加・更新
   - **レイアウト整理**
     - グルーピング/整列の最適化
   - **上書きインポートルール（必須）**
     - 元のYMLファイルを直接編集（別ファイル名で作成禁止）
     - インポート時は `--new` オプションを使用しない（既存app_idに上書き）
     - app_idファイル（flow_log/.{ファイル名}.app_id）存在時は自動で上書きモード
   - ブラッシュアップ時もgraph.nodesに存在するノードIDのみをsource/targetに使用（存在しないノード参照禁止）
   - 元のフロー構造を大きく変更しない

3. QC（必須）:
   - 共通QC Subagent（`qa-skill-qc`）に評価・チェックを委譲する
   - Subagentは最初に `./evaluation/evaluation_criteria.md` をReadし、評価指標に基づいてQCを実施する
   - **構文検証（必須）**: `source .venv/bin/activate && python scripts/dify_validation.py <YML>` を実行
   - チェック観点:
     - ブラッシュアップ内容が適切であること
     - 影響範囲が最小限に抑えられていること
     - graph.nodesに存在しないノードIDを参照していないこと
     - 変数最適化・プロンプト品質・ノード設定の各観点
   - エラー/警告対応後、再検証
   - 指摘に対し「修正した/しない」と理由を成果物に残す

4. バックログ反映:
   - ブラッシュアップ完了後、上書きインポート・テストのタスクを抽出する
   - 反映先・編集制約・差分提示は CLAUDE.md の全体ルールに従う

subagent_policy:
  - 品質ループ（QC/チェック/フィードバック）は必ずサブエージェントへ委譲する
  - サブエージェントの指摘を反映し、反映結果（修正有無/理由）を成果物に残す
  - 検索を伴う情報収集（改善パターン・既存フロー構造の検索）はSubagentに委譲する
  - 独立した評価観点は並列Subagentで同時実行可能

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

## Resources

- questions: ./questions/brushup_questions.md
- assets: ./assets/brushup_log_template.md
- evaluation: ./evaluation/evaluation_criteria.md
- triggers: ./triggers/next_action_triggers.md
- scripts:
  - ./scripts/dify_import_api.py
  - ./scripts/dify_env_vars.py
  - ./scripts/dify_test_runner.py

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

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

## Error Handling

- node_reference_error: graph.nodesの一覧を確認、source/targetを正しいノードIDに修正
- validation_failed: エラー内容を確認し修正、dify_validation.py を再実行
- overwrite_failed: app_idファイルの存在を確認、--refresh オプションでCookie再取得

## ブラッシュアップ後のインポートコマンド

```bash
# 上書きインポート（--newを使用しない）
source .venv/bin/activate && python scripts/dify_import_api.py -f <YMLパス>

# ワークフローテスト
source .venv/bin/activate && python scripts/dify_test_runner.py -f <YMLパス>

# カスタム入力でテスト
source .venv/bin/activate && python scripts/dify_test_runner.py -f <YMLパス> --input key=value
```