# dify-validation

> YAMLファイルの構文・スキーマ検証、Dify DSL仕様準拠チェックをオフライン環境で即座実行します。エスケープシーケンス検出、ノード参照チェック、命名規則検証を行い、Difyインポート前に問題を検出します。「検証」「バリデーション」「構文チェック」「DSLチェック」などの依頼時に使用します。

- 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-validation:20260123002259

---

---
name: dify-validation
description: "YAMLファイルの構文・スキーマ検証、Dify DSL仕様準拠チェックをオフライン環境で即座実行します。エスケープシーケンス検出、ノード参照チェック、命名規則検証を行い、Difyインポート前に問題を検出します。「検証」「バリデーション」「構文チェック」「DSLチェック」などの依頼時に使用します。"
---

# Dify検証 Workflow

## Instructions

1. Preflight:
   - `./questions/validation_questions.md` で検証対象・レベルを確認する
   - 対象YAMLファイルのパスを確認する
   - docs/errorlog/ から類似エラーパターンを検索する（解決済み知見の参照）
   - graph.nodesの一覧を確認し、存在するノードIDを把握する

2. 生成:
   - **構文検証実行**
     - コマンド: `source .venv/bin/activate && python scripts/dify_validation.py <YAMLファイル名>`
     - YAML構文エラー、スキーマ違反を検出
   - **Dify DSL仕様準拠チェック**
     - ファイル拡張子: `.yml` 以外はエラー検出
     - ノードID: ハイフン(-)使用時はエラー検出 → アンダースコア(_)への変更を提案
     - エッジID: ハイフン(-)使用時はエラー検出
     - 変数参照: `{{#node-id.variable#}}` 形式のハイフン使用時はエラー検出
   - **ノード参照チェック**
     - graph.nodesに存在するノードIDのみがsource/targetに使用されていること
     - 存在しないノード参照を検出し、修正を提案
   - **エスケープシーケンス検出**
     - Difyインポート時に問題となる文字列を検出
   - **エラーナレッジ参照**
     - docs/errorlog/ の解決済みエラー知見を自動参照
     - 同様のエラーパターンがあれば解決策を提示
   - エラー発生時は自動修正を試み、ユーザーに確認

3. QC（必須）:
   - 共通QC Subagent（`qa-skill-qc`）に評価・チェックを委譲する
   - Subagentは最初に `./evaluation/evaluation_criteria.md` をReadし、評価指標に基づいてQCを実施する
   - チェック観点:
     - 検証結果の網羅性
     - 修正提案の適切性
     - 構文チェック・DSL準拠・ノード参照の各観点
   - エラー0必須（エラー残存はQC失敗）
   - 指摘に対し「修正した/しない」と理由を成果物に残す

4. バックログ反映:
   - 検証完了後、次アクション（インポート・修正等）を抽出する
   - 反映先・編集制約・差分提示は CLAUDE.md の全体ルールに従う

subagent_policy:
  - 品質ループ（QC/チェック/フィードバック）は必ずサブエージェントへ委譲する
  - サブエージェントの指摘を反映し、反映結果（修正有無/理由）を成果物に残す
  - エラーナレッジ検索（既知のエラーパターン照合）はSubagentに委譲する

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

## Resources

- questions: ./questions/validation_questions.md
- assets: ./assets/validation_template.md
- evaluation: ./evaluation/evaluation_criteria.md
- triggers: ./triggers/next_action_triggers.md
- scripts: ./scripts/dify_validation.py

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

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

## Error Handling

- yaml_syntax_error: インデント・コロン・ハイフンの構文を確認、YAMLリンターで詳細エラー箇所を特定
- missing_required_section: テンプレートと比較して不足セクションを追加、Dify DSL仕様に準拠した構造に修正
- node_reference_error: graph.nodesの一覧を確認、source/targetを正しいノードIDに修正
- naming_convention_violation: ノードIDのハイフンをアンダースコアに変更、変数参照の形式を `{{#node_id.variable#}}` に修正

## 検証コマンド

```bash
# 基本構文チェック
source .venv/bin/activate && python scripts/dify_validation.py <YAMLファイル名>
```

## Subagent Execution
このSkillはサブエージェントとして独立実行可能。
- サブエージェント: `agents/dify-validator.md`
- 用途: YAMLの構文・スキーマ検証、並列での複数ファイル検証
- 入力: 対象YAMLファイルパス
- 出力: 検証結果サマリー（エラー数、警告数、修正提案）