Skip to content
Benjamin-TengPublic

About

claude code + xs helper skill,幫助你寫XQ策略事半功倍

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

xs_helper

一個同時支援 Claude Code 與 Codex 的 plugin,依 XQ全球贏家 的 XScript(XS) 語言規範,協助你撰寫自動化腳本、回答 XS 用法問題。

這是什麼

xs_helper 是一個 Claude Code 與 Codex plugin。在 Claude Code 輸入 /xs,或在 Codex 使用 $xs,即可載入「XS 專家模式」後再作答,協助你:

  1. 撰寫 / 修改 XS 腳本 —— 自動交易、函數、指標、選股、警示五大類型;
  2. 回答規範性問題 —— 某個 XS 函數 / 欄位 / 關鍵字怎麼用。

為什麼需要它

XS 是 XQ全球贏家專屬、繁體中文、小眾的 DSL,沒有公開的編譯器或 LSP,通用模型本身不具備完整 XS 知識。本 plugin 把 XS 的語法、內建函數、欄位、各腳本類型慣例,以蒸餾後的 reference 形式內建進 skill,讓 AI agent 被呼叫時載入正確知識再回答,避免幻覺出不存在的函數。

功能

功能 說明
XS Skill(/xs / $xs) 判定腳本類型 → 載入對應 reference → 產出 XS 程式碼或規範解說
內建 XS Reference 語法、內建函數、系統函數、欄位、腳本類型慣例,皆內建為 markdown
官方文件 Fallback 冷門函數 / 欄位以環境可用的網頁查詢工具查 XS 線上說明 後作答

設計邊界(Out of Scope)

本 plugin 只生成與解說,不執行。明確不做:

  • XS 腳本的實際執行 / 回測(不含 XS runtime)
  • 完整語法分析 / LSP / grammar(不重建編譯器級驗證)
  • 即時同步官方文件全量(reference 為人工蒸餾快照)
  • XQ 平台帳號 / API 整合(不連帳號、不下單、不取報價)

安裝

本 plugin 透過 marketplace xs-tools 散佈;Claude Code 與 Codex 共用同一份 XS skill 與 reference。

Claude Code

在 Claude Code 中執行:

/plugin marketplace add Benjamin-Teng/xs_helper
/plugin install xs-helper@xs-tools
/reload-plugins

/reload-plugins 讓剛裝好的 plugin 立即生效,不必重開 Claude Code。安裝後以 /xs <需求> 明確觸發。

Codex

VS Code/Codex IDE(推薦)

Codex IDE extension 目前不支援完整 plugin,但支援獨立 skill。xs-helper 現階段沒有 MCP、connector 或 hook,因此用這條路可取得目前全部功能。在 Codex 對話框貼上:

$skill-installer 請從 https://github.com/Benjamin-Teng/xs_helper/tree/main/skills/xs 安裝 xs skill

同意下載後開啟新對話,以 $xs Average 怎麼用? 驗證;若 $xs 未出現,重新載入 VS Code。

Codex CLI 對話介面

先在終端機註冊一次 marketplace:

codex plugin marketplace add Benjamin-Teng/xs_helper

接著啟動 codex,在對話介面輸入 /plugins,切換到 xs-tools marketplace、開啟 xs-helper 並選擇安裝。安裝後開始新 session。

終端機進階安裝

若偏好完全使用命令列,執行:

codex plugin marketplace add Benjamin-Teng/xs_helper
codex plugin add xs-helper@xs-tools

安裝後開啟新的 Codex session,輸入 $xs <需求> 明確觸發。完整 plugin 流程適用於 Codex CLI 與支援 Plugins Directory 的桌面介面,不會把 plugin 安裝進 VS Code IDE extension。

使用方式(兩條路徑)

  • 自動觸發(主要):不必打任何指令——只要對話講到 XS / 選股條件 / 某個函數怎麼用,Claude Code 或 Codex 會依 skill 的 description 自動載入 XS 知識再作答。
  • Claude Code 手動觸發:輸入 /xs <需求>(依環境亦可能顯示為命名空間形式 /xs-helper:xs)。
  • Codex 手動觸發:輸入 $xs <需求>。

⚠️ /xs 與 $xs 都是把 XS 規範載入目前請求或對話脈絡,不是另一個 XS runtime;要徹底脫離 XS 脈絡,請開新對話或使用所在環境的清除對話功能。

狀態

✅ v0.7.1 —— 本版重點(修正版):

  • xshelp 名稱索引補收官方別名:索引檔末新增「別名對照」(1120 組:英文名、中文短名、舊名與報價欄位 q_ 變數名)。GetField("Close")、GetField("最新股本") 這類寫法不再被當成查無;F3 改為依出現位置查找(函數呼叫只認名稱段、欄位名字串才查別名),名稱與別名都查不到才算查無。
  • 依 xshelp 原文更正:StandardDev 樣本參數是 2;xf_* 也支援 AD/AW/AM(xfMin_* 的 2、3 分鐘兩份官方來源不一致,已標註以實機為準);SetTotalBar 是資料讀取範圍,回看深度由 SetBackBar 設定;資料欄位用於指標/警示/交易腳本,選股腳本用選股欄位。
  • xshelp_mirror.py fetch 的防縮水檢查改以「名稱+分組」比對,不再因官方重編 id 而誤擋。
  • XQ 編譯器相容性實編回饋(#3):LinearReg 用完整七參數呼叫、輸出變數避用獨立的 slope/angle 名稱;明確標示非 xshelp 官方定義。

v0.7.0 重點(節錄):新增 xshelp 名稱索引與本機鏡像腳本 scripts/xshelp_mirror.py、F3 fallback 改走索引 API、fields.md 完整名稱清單改由索引提供、xs_lint.py 補齊 15 個漏收的系統函數名稱。v0.6.0 重點(節錄):Plot/OutputField 命名參數與多載、流程控制官方寫法、Rank/inputkind 補齊、補收 42 個漏收函數與第 9 分類 SDTFUNC。v0.5.1/v0.5.0 重點(節錄):xs_lint.py 不再誤報宣告名稱(#2)、GitHub Pages 新增投入功夫統計、新增 AGENTS.md、關鍵字與保留字總表、xs_lint.py 白名單校正。

沿用先前版本:skill 目錄採 Agent Skills 規範的 references/(扁平、單層,v0.4.0 起),Shioaji Pro 等只索引固定目錄名的技能安裝器也讀得到;Claude Code 與 Codex 各有原生 manifest / marketplace,兩端共用同一份 skill。v0.2.0 移除的 .xs 編輯驗證 Hook 維持不掛載,xs_lint.py 保留為獨立腳本。功能仍在迭代。

📊 成效:skill 助益量化報表 —— 8 個真實 XS 任務「載 skill vs 未載」對照,通過率 100% vs 75%、零幻覺 token。

reference 進度(共 11 份:5 份規範 + 1 份 xshelp 名稱索引 + 5 份範例):

reference 狀態
language.md(語法基礎) ✅ 已蒸餾(grammar token × Preset 真實語法校對)
xs_lint.py 已知 token 清單 ✅ 內建(644 個 token:grammar 2023 快照 ∪ Preset 215 sysfnc ∪ xshelp 9 群組 bif);供 benchmark 幻覺掃描與手動檢查的獨立腳本
system-functions.md(sysfnc) ✅ 已蒸餾(Preset 224 函數 × 14 分類)
builtin-functions.md(bif) ✅ 已蒸餾(xshelp 9 分類,v0.6.0 起新增 SDTFUNC)
fields.md(三類欄位) ✅ 已蒸餾(xshelp Q*/T*/F* × XQStrategy GetField 交叉驗證)
xshelp-index.md(名稱索引) ✅ 已產生(1621 個名稱、10 大類 54 分組,另收 1120 組別名對照;只含名稱、別名與分組;scripts/xshelp_mirror.py 決定性產出)
script-types.md + example-*.md ×5 ✅ 已蒸餾(5 類 {@type:} 結構/邊界 + 各一份精選範例)

完整規格與交接見 docs/SPEC.md,版本變動見 CHANGELOG.md。

知識來源

reference 蒸餾自 XQ 官方範例庫與說明站:XScript_Preset、XQStrategy、vscode-xs、xshelp 官方站。

開發

測試與 lint 指令、內容以 xshelp 為準等貢獻規則見 AGENTS.md。送 PR 前至少跑過 python -B -m unittest discover -s tests。重生 xshelp 名稱索引用 python -B scripts/xshelp_mirror.py fetch 再 index(fetch 需網路)。

License

MIT。本 plugin 只散佈自己撰寫的程式碼與「蒸餾後的 DSL 事實」,不含任何來源庫的原始 .xs(XScript_Preset / XQStrategy 無授權檔,故未 bundle;見 docs/SPEC.md Open Q5)。

About

claude code + xs helper skill,幫助你寫XQ策略事半功倍

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages