writing-hashql-jexpr

writing-hashql-jexpr 技能为使用 HashQL J-Expr（一种专为 HASH 数据库设计的 JSON 基础表达式语法）的开发人员提供完整的说明与指导。此技能适用于需要构建、除错或重构 HashQL 查询文件（.jsonc）的工程师与数据分析师。它涵盖了基本的资料结构，包括用于路径识别符的字符串、用于函数调用的数组，以及利用特殊 # 前缀键进行型别化资料构建的对象。使用者可以找到关于如何处理原始型别、结构（struct）、列表（list）、元组（tuple）与字典（dict）的详细说明，以及 let 绑定、函数定义与条件逻辑的关键模式。无论您是在编写过滤器表达式、定义自订图形函数，或是为代理程式构建资料，此技能都能提供必要的语法标准，确保您的查询既有效又具高效能。

• 详尽的 J-Expr 原始型别语法，包括 #literal、#struct、#list、#tuple、#dict 与 #type。

• 关于使用字符串识别符与点号表示法或命名空间根路径（::）进行路径解析的指南。

• 支持 J-Expr 内的函数式程式设计模式，例如数组中的函数调用以及使用 : 前缀惯例的标签化参数。

• 将 #type 注释与资料构建子结合以维持结构完整性的最佳实践。

• 关于结构约束的明确指导，防止 # 键嵌套错误等常见问题。

• 务必将数字、布林值与 null 等原始值封装在 #literal 构建子中，以确保解析正确。

• 所有命名空间路径均使用 :: 前缀，以维持对 HASH 图形的准确引用。

• 清楚区分 #list（可变大小集合）与 #tuple（固定大小、异质集合），以避免结构不匹配。

• 定义逻辑时，利用 HASH 生态系统提供的 if、let 与 fn 等标准形式，构建动态且响应式的查询组件。

• 此技能的输入通常为原始 JSONC 或预计转换为 J-Expr 的虚拟码，而输出则是准备好整合至 HASH 执行阶段环境中的优化、型别安全 J-Expr 语法。