| name | dql |
| author | tanbiao |
| description | Generate, fix, explain, and review DQL; final executable DQL must pass dqlcheck item by item. |
DQL Skill
Use this skill to generate, repair, explain, or review Guance DQL.
Modes
- Explanation or review mode: explain semantics, risks, and suggestions without inventing a new final DQL.
- Generation or repair mode: return only DQL that has passed validation.
Mandatory Validation
Any final executable DQL must pass dqlcheck before delivery. Validate each query separately.
./bin/dqlcheck -q '<DQL>'
./bin/dqlcheck --file /tmp/query.dql
./bin/dqlcheck -q '<DQL>' --out=build
For complex quoting, prefer writing the query to a temporary .dql file and validating with --file.
Batch Validation Practice
When extracting DQL from Dashboard JSON, validate each extracted query independently. If a query is wrapped by a chart helper such as series_sum("M::..."), extract the inner DQL before validation.
Failure Handling
- Apply the smallest repair that addresses the parser error.
- Retry validation after each repair.
- Do not deliver entries that still fail after repeated repair attempts.
