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

engineering

writing-hashql-diagnostics — это скилл для Claude Code, который описывает паттерны написания диагностических сообщений в HashQL с использованием крейта hashql-diagnostics. Скилл охватывает работу с ключевыми типами: Diagnostic, Label, Message, Severity, Patch и Suggestions — и показывает, как правильно задавать уровни серьёзности (Bug, Fatal, Error, Warning, Note), формировать primary-метки и добавлять actionable-подсказки через add_message. Стилистические принципы фиксируют конкретные правила: сообщения начинаются со строчной буквы, код оборачивается в обратные кавычки, формулировки imperative, без «sorry» и расплывчатых фраз вроде «something went wrong». Подойдёт разработчикам компилятора HashQL, которым нужно создавать качественные сообщения об ошибках и предупреждениях, улучшать существующие диагностики или проходить ревью по чеклисту из guidelines.md.