XScript(XS)是 XQ 全球贏家的券商專屬語言,繁中、小眾、無公開編譯器。
同一份 XS skill 可在 Claude Code 用 /xs、在 Codex 用 $xs。
下方以 Claude Opus 4.8 跑 8 個真實任務,量化載入 skill 帶來的差距。
{@type:}怎麼測的? 每個任務跑兩組獨立 agent:一組載入 /xs skill(含蒸餾後的 XS reference + F3 線上查證),
一組完全不載、純憑模型自身知識(並明令禁止讀取本專案任何檔案)。兩組產出依客觀 assertion 評分——
包含「腳本類型標記是否正確」「邏輯是否符合需求」,以及用專案自帶的 xs_lint
(內建 604 個已知 XS token)程式化掃描是否出現幻覺/不存在的函數。共 8 案例、38 條 assertion,分兩輪(基本題 + 刁鑽題)。
baseline 多次把 EasyLanguage / MultiCharts 的詞搬進 XS:MarketPosition、EntryPrice(自動交易題)、
InIndex("SPX")(美股選股題)——這些在 XS 都不存在。載 skill 的版本一律用對 XS 的
Position、FilledAvgPrice,並查證欄位真實存在。這是通用知識補不上的硬差距。
{@type:}skill 6/6 · baseline 0/6XS 腳本開頭要用 {@type:filter} / {@type:autotrade} 等標記決定它是哪一類。
baseline 在 6 個生成類案例全部漏掉;載 skill 的版本全部帶對。少了它,腳本會被 XQ 歸錯類型。
美股選股題,baseline 用幻覺函數 InIndex("SPX") 假裝能在程式碼裡篩出 S&P 500 成分股;
載 skill 的版本走 F3 線上查證後老實指出:XS 選股欄位沒有成分股欄位,「限定 S&P 500」只能在 XQ 股票池設定裡做、程式碼做不到,
並用查證過的欄位(股東權益報酬率 / 本益比)寫出可用條件。知道「做不到什麼」與知道「怎麼做」同等重要。
「回傳布林的函數」題,載 skill 的版本正確選用 {@type:function_bool} 子型別、以「對函數名賦值」回傳;
baseline 漏標記且用 ret(在 XS 屬選股/警示的機制)。
註:有兩個刻意設計的「陷阱」——警示誤用 Alert()、一目均衡表幻覺、逐筆洗價的
intraBarPersist——baseline 其實也答對了。可見模型「知道要小心」並非問題;skill 的價值在於知道確切的 XS token 與慣例。
{@type:autotrade}
if Position = 0 and Average(Close,20)
Cross Above Average(Close,60)
then SetPosition(1, MARKET);
... Close <= FilledAvgPrice*(1-0.05)// (缺 {@type:autotrade})
If MarketPosition = 0 And
maFast Cross Over maSlow Then
SetPosition(1);
... Close <= EntryPrice*(1-StopPct/100)MarketPosition、EntryPrice,且漏了類型標記。{@type:filter}
Value1 = GetField("股東權益報酬率", "Q");
Value2 = GetField("本益比");
if Value1 > 15 and Value2 > 0
and Value2 < 20 then ret = 1;
// S&P500 成分股 → 須在 XQ 股票池設定// (缺 {@type:filter})
inSP500 = InIndex("SPX");
roe = GetField("ROE", "Q");
pe = GetField("PER");
if inSP500 and roe>15 and pe>0
and pe<20 then ret = 1;InIndex 假裝能在程式碼篩成分股(XS 做不到);
skill 查證後誠實把「成分股限定」交還給 XQ 股票池設定。ROE/PER 兩邊皆可——官方 GetField 中英文名都接受,非錯誤。)兩組都答對核心(兩個 Series、回傳布林、僅穿越那根為真)。但 baseline 多宣稱「第二參數可為常數門檻」—— 經 XS 使用者確認為錯誤,CrossOver 兩個參數都必須是序列。載 skill 的版本主張「傳純量不對」才正確。
兩者語意相同(A 向上穿越 B,黃金交叉),但屬不同語言層級:Cross Over(中間有空格)是中綴關係運算子,CrossOver(連寫)是系統函數。寫法不能混——運算子要分兩個字、函數要連寫加括號,寫錯邊會被當成未知 token。
if Average(Close,5)
Cross Over Average(Close,20)
then ...if CrossOver(
Average(Close,5),
Average(Close,20))
then ...MarketPosition 出現兩次)與漏 {@type:} 標記(0/6)。統計資料:effort-stats.json(每個數字都附出處;查不到根據的項目不估算、不列入)。
不需 git clone。選擇你使用的平台,依序複製指令即可。
在 Claude Code 依序貼上三個指令;若被詢問是否信任或啟用,請確認同意。
/plugin marketplace add Benjamin-Teng/xs_helper
/plugin install xs-helper@xs-tools
/reload-plugins
/xs Average 怎麼用?
依你使用的 Codex 介面選擇安裝方式;VS Code 使用者可直接從對話框開始。
IDE extension 目前不支援完整 plugin;但本專案目前只有 skill,沒有 MCP、connector 或 hook,因此功能相同。
$skill-installer 請從 https://github.com/Benjamin-Teng/xs_helper/tree/main/skills/xs 安裝 xs skill
同意下載後開新對話。若 $xs 沒出現,請重新載入 VS Code。
自訂 marketplace 需先在終端機註冊一次:
codex plugin marketplace add Benjamin-Teng/xs_helper
接著啟動 codex,在對話介面輸入:
/plugins
切換到 xs-tools,開啟 xs-helper 並選擇安裝,再開始新 session。
偏好完全使用命令列時,依序執行:
codex plugin marketplace add Benjamin-Teng/xs_helper
codex plugin add xs-helper@xs-tools
上方 plugin 或 skill 安裝完成後,開啟新對話並輸入:
$xs Average 怎麼用?
在 AI Agent 面板的技能區貼上 repo 名稱,然後按安裝即可。
Benjamin-Teng/xs_helper
安裝後技能會列出 11 份參考文件(語法、函數、欄位、腳本類型、五類範例與 xshelp 名稱索引);若顯示「可用參考文件:無」,請移除後重新安裝,取得 v0.4.0(含)以上的版本。