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 語法。