Диагностические сообщения компилятора HashQL

engineering

writing-hashql-diagnostics is a Claude Code skill that provides patterns for authoring high-quality diagnostics in HashQL using the hashql-diagnostics crate. It covers the core types — Diagnostic, Label, Message, Severity, Patch, and Suggestions — and demonstrates how to set severity levels (Bug, Fatal, Error, Warning, Note), attach primary and secondary labels with spans, and chain actionable help via add_message and with_suggestions. Style rules are explicit: messages start lowercase, code elements use backticks, wording stays imperative, and apologetic or vague language is forbidden. The skill is aimed at HashQL compiler contributors who need to write clear, consistent error and warning messages or improve existing diagnostics, with a reference to the full guidelines checklist in references/guidelines.md.