yifanfeng97 YAML Validator
Validation Workflow
- Syntax check: YAML is valid
- Required fields: All required fields present
- Type check: Valid AutoType value
- Identifiers check: Proper configuration for type
- Field validation: Types and descriptions present
Quick Validation Checklist
All Types
- [ ] language: zh/en
- [ ] name: PascalCase
- [ ] type: valid AutoType
- [ ] tags: lowercase array
- [ ] description: non-empty
- [ ] output: exists
- [ ] guideline: exists
Graph Types
- [ ] output.entities: exists
- [ ] output.relations: exists
- [ ] identifiers.entity_id: exists
- [ ] identifiers.relation_id: exists
- [ ] identifiers.relation_members: configured
Hypergraph
- [ ] relation_members is string OR list
- [ ] If list: all fields are type: list
Temporal/Spatial
- [ ] identifiers.time_field: configured (temporal)
- [ ] identifiers.location_field: configured (spatial)
Validation Levels
| Level | Meaning | Action |
|---|---|---|
| ERROR | Must fix | Won't work without fix |
| WARNING | Should fix | May affect quality |
| INFO | Reference | Recommended to follow |
Reference Files
Important: Check these files only when needed during validation process.
| Topic | When to Check |
|---|---|
| references/rules-syntax.md | Always (first step) |
| references/rules-types.md | Type-specific validation |
| references/rules-identifiers.md | Identifier configuration check |
| references/rules-errors.md | When errors are found |
Validation Order
Recommended order: Follow this sequence for efficient validation:
- Syntax → rules-syntax.md - Check YAML validity first
- Structure → rules-types.md - Validate based on type
- Identifiers → rules-identifiers.md - Check identifier config
- Errors → rules-errors.md - Look up fixes if needed
Error Message Format
## Validation Results
### Syntax Validation
✅ PASSED
### Structure Validation
✅ PASSED
- language: ✅
- name: ✅
- type: ✅
- tags: ✅
- description: ✅
- output: ✅
### Semantic Validation
⚠️ 2 warnings
- WARNING: [message]
- WARNING: [message]
### Overall Assessment
✅ Configuration valid