# validation-enhancement

> Difyインポート時・実行テスト時に発生したシステムエラーを分析し、scripts/dify_validation.pyに新しい検出ルールを追加します。「インポートエラー」「実行時エラー」「バリデーション強化」「検証ルール追加」などの依頼時に使用します。

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

---

---
name: validation-enhancement
description: "Difyインポート時・実行テスト時に発生したシステムエラーを分析し、scripts/dify_validation.pyに新しい検出ルールを追加します。「インポートエラー」「実行時エラー」「バリデーション強化」「検証ルール追加」などの依頼時に使用します。"
---

# バリデーション強化 Workflow

## Instructions

1. Preflight:
   - `./questions/enhancement_questions.md` でエラー状況・再現手順を確認する
   - エラーが発生したYAMLファイルを特定する
   - エラーメッセージ・スタックトレースを収集する
   - docs/errorlog/ から類似エラーパターンを検索する
   - 現在の `scripts/dify_validation.py` の検証ルールを確認する

2. 生成:
   - **エラー分析**
     - エラーメッセージからエラー種別を特定（インポートエラー/実行時エラー/APIエラー）
     - YAMLの問題箇所を特定（構文/構造/値/参照）
     - 根本原因を分析（Dify仕様との不整合、未サポート機能、データ型エラー等）
   - **検出ルール設計**
     - 同様のエラーを事前検出するためのルールを設計
     - 検出パターン（正規表現/構造チェック/値検証）を定義
     - エラーメッセージと修正提案を設計
   - **scripts/dify_validation.py への追加**
     - `./assets/validation_rule_template.py` を参照し、新規ルールを実装
     - 既存の検証クラス構造に準拠
     - テストケースを作成（エラーを含むYAMLサンプル）
   - **エラーログ記録**
     - `./assets/errorlog_template.md` を使用してdocs/errorlog/にエラー記録を作成
     - 再発防止のための知見を文書化
   - **3環境同期（必須）**
     - scripts/dify_validation.py 更新後、必ず以下を実行して全Skillsに反映:
     - コマンド: `python3 scripts/update_agent_master.py --source claude --force`
     - これにより各Skillのscripts/dify_validation.pyが自動上書きされる
   - 元資料にない項目は省略せず「未記載」または「不明」と明記する

3. QC（必須）:
   - 共通QC Subagent（`qa-skill-qc`）に評価・チェックを委譲する
   - Subagentは最初に `./evaluation/evaluation_criteria.md` をReadし、評価指標に基づいてQCを実施する
   - チェック観点:
     - 追加したルールが問題のエラーを正しく検出するか
     - 既存の検証ルールとの整合性
     - 誤検出（false positive）がないか
   - 追加ルールでエラーYAMLを再検証し、検出成功を確認
   - 指摘に対し「修正した/しない」と理由を成果物に残す

4. バックログ反映:
   - ルール追加完了後、ドキュメント更新・テスト追加のタスクを抽出する
   - 反映先・編集制約・差分提示は CLAUDE.md の全体ルールに従う

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

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

## Resources

- questions: ./questions/enhancement_questions.md
- assets:
  - ./assets/validation_rule_template.py
  - ./assets/errorlog_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

- unknown_error_type: エラーメッセージを詳細に分析、Dify公式ドキュメントを参照、Subagentで類似事例を検索
- validation_rule_conflict: 既存ルールとの重複・矛盾を確認、優先度を設定して統合
- false_positive_detected: 検出条件を絞り込み、許容パターンを追加

## エラー種別と対応

| エラー種別 | 発生タイミング | 対応方法 |
|------------|----------------|----------|
| ImportError | YAMLインポート時 | 構文/構造の検証ルール追加 |
| RuntimeError | フロー実行時 | ノード設定/変数参照の検証ルール追加 |
| APIError | 外部API呼び出し時 | 認証/エンドポイント設定の検証ルール追加 |
| ModelError | LLMノード実行時 | モデル名/パラメータの検証ルール追加 |
| NodeConfigError | ノード設定読込時 | 必須フィールド/型の検証ルール追加 |

## ルール追加の流れ

```
1. エラー発生 → エラーログ収集
2. 原因分析 → YAMLの問題箇所特定
3. ルール設計 → 検出パターン定義
4. 実装 → scripts/dify_validation.py に追加
5. テスト → エラーYAMLで検出確認
6. 同期 → python3 scripts/update_agent_master.py --source claude --force
7. 記録 → docs/errorlog/ に知見を保存
```

## 同期コマンド

```bash
# dify_validation.py 更新後、全Skillsに反映（必須）
python3 scripts/update_agent_master.py --source claude --force
```

これにより以下のSkillsのscripts/dify_validation.pyが自動上書きされる:
- dify-validation
- dify-flow-create
- dify-auto-import
- pattern-creation
- flow-docs-templates
- その他scripts/dify_validation.pyを持つ全Skill