Skillget

neoapi-skill

agent
Guvenlik Denetimi
Basarisiz
Health Uyari
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • rm -rf — Recursive force deletion command in update-skill.sh
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This project is a skill package and instruction bundle designed for AI coding agents (like Codex, Claude, and Gemini). It provides workflows and documentation to help these agents correctly use the Fubon Neo Python SDK for trading and market data operations.

Security Assessment
The tool poses a Medium security risk. Its primary function is to serve as an instructional text bundle for AI agents, and it does not request inherently dangerous permissions or contain hardcoded secrets. However, automated health scans flagged a recursive force deletion command (`rm -rf`) inside the `update-skill.sh` bash script. Because this script downloads files from GitHub and executes shell commands locally to manage the installation directory, a malicious alteration of the repository could potentially lead to unintended file deletion. Furthermore, the tool is designed to interface directly with financial trading APIs, meaning it fundamentally handles highly sensitive authentication and transaction data.

Quality Assessment
The repository is actively maintained, with its last push occurring very recently (0 days ago). Despite this active development, it suffers from low community visibility and trust, evidenced by having only 5 GitHub stars. Additionally, the project completely lacks a license file, which raises legal concerns regarding how the code can be used, modified, or distributed. It remains in an early phase (version 1.0.0-beta.29) and lacks the maturity typically expected for production environments.

Verdict
Use with caution — while the core instruction files are harmless, the undocumented shell commands in the update script and the lack of a formal license make it unsuitable for production use without prior code review.
SUMMARY

富邦新一代（Fubon Neo）Python 技能包：交易與行情工作流、測試環境整合測試、多代理（Codex/Claude/Gemini）適配。

README.md

Fubon NeoAPI Skill 精煉專案

此儲存庫用於測試與持續優化 neoapi-python skill bundle，供 AI 編碼代理（如 Codex、Claude Code、Gemini）正確使用富邦新一代（Fubon Neo）Python SDK，涵蓋交易與行情工作流程。

Repo 結構

  • skills/neoapi-python/ - Skill 主體（SKILL.md、references/、llms*.txt、VERSION、INSTALL.md）
  • update-skill.ps1 - Windows 更新腳本（從 GitHub 下載後安裝到 ~/.codex/skills/public/）
  • update-skill.sh - macOS/Linux 更新腳本

相容性

本 skill 以純檔案形式（入口為 SKILL.md）發佈，方便跨平台與跨代理使用。若非 Codex 平台，請將安裝路徑改為目標代理的 skill/instruction 目錄（可透過更新腳本的 INSTALL_DIR 參數或環境變數調整）。

GitHub Repo

  • https://github.com/phenomenoner/neoapi-skill

安裝

完整安裝方式請見 skills/neoapi-python/INSTALL.md。本 repo 採用 skills/（非 .skills/）目錄。一般使用者建議安裝到：

  • Windows: %USERPROFILE%\.codex\skills\public\neoapi-python
  • macOS/Linux: ~/.codex/skills/public/neoapi-python

版本管理

Skill 版本存放於 skills/neoapi-python/VERSION（semver）。目前版本：1.0.0-beta.29（Beta 1.0.0）。

多代理 Adapter

根目錄提供主要代理平台的 adapter（中文優先、英文補充）：

  • CLAUDE.md
  • GEMINI.md
  • AGENTS.md

以上 adapter 皆以 skills/neoapi-python/ 為單一真實來源（source of truth）。

LLM 文件（線上）

以下官方頁面與 llms*.txt 為優先參考來源：

  • https://www.fbs.com.tw/TradeAPI/docs/welcome/build-with-llm
  • https://www.fbs.com.tw/TradeAPI/en/docs/welcome/build-with-llm/
  • https://www.fbs.com.tw/TradeAPI/llms.txt
  • https://www.fbs.com.tw/TradeAPI/llms-full.txt
  • https://www.fbs.com.tw/TradeAPI/en/llms.txt
  • https://www.fbs.com.tw/TradeAPI/en/llms-full.txt

內建於 skill bundle 的 llms*.txt 為離線快照；當官方端點更新時，應同步刷新 repo 內副本並 bump VERSION，否則更新腳本不會抓到這次變更。

從 GitHub 更新

更新腳本會下載 repo zip，複製 skills/neoapi-python 到本機安裝路徑，並比較 VERSION，若已是最新版則跳過。

範例：

.\update-skill.ps1 -Repo phenomenoner/neoapi-skill

./update-skill.sh phenomenoner/neoapi-skill

本地回歸測試

  • 本地整合測試 runner：.test/test_runner.py（不包含於對外發佈 skill 包）
  • 測試輸出：.test/logs/（文字 log + JSON summary）
  • Suites：
    • smoke：基本登入與交易/行情健檢
    • complex：多標的行情矩陣 + 雙訂單生命週期整合測試
    • all：完整覆蓋（包含 complex）

變更紀錄

  • 2026-04-13: 1.0.0-beta.29 - 補充 WebSocket 訊息 envelope 格式與 on_message 解析指引，明確說明實際交易資料位於 message["data"]，避免直接對 envelope 存取 symbol / price / size 導致取值錯誤。
  • 2026-01-26: 1.0.0-beta.1 - 初始 beta，加入更新腳本、VERSION 與專案基礎檔。
  • 2026-01-26: 1.0.0-beta.1 - 補充安裝路徑與跨平台相容性說明。
  • 2026-01-26: 1.0.0-beta.1 - 初始化 GitHub repo，更新預設更新來源。
  • 2026-01-26: 1.0.0-beta.2 - 新增測試環境說明文件與 sandbox 備註。
  • 2026-01-26: 1.0.0-beta.2 - 新增本地 smoke 測試腳本（.test，不納入發布）。
  • 2026-01-26: 1.0.0-beta.3 - 補充 SDK wheel 下載/安裝與測試包資訊。
  • 2026-01-26: 1.0.0-beta.4 - 紀錄本地測試驗證結果。
  • 2026-01-26: 1.0.0-beta.5 - 新增 SDK 安裝片段與 Python 版本建議。
  • 2026-01-26: 1.0.0-beta.6 - 在 SKILL.md 增加 SDK install 快速提示。
  • 2026-01-26: 1.0.0-beta.7 - 新增 skill 驗證測試案例與投稿格式。
  • 2026-01-26: 1.0.0-beta.8 - 紀錄 skill 測試結果。
  • 2026-01-26: 1.0.0-beta.9 - 補充下單 + callback 測試結果。
  • 2026-01-26: 1.0.0-beta.10 - 新增 examples-guidance 並更新索引/TODO。
  • 2026-01-26: 1.0.0-beta.11 - 標註 .md URL 技巧失效，改以 llms.txt/llms-full.txt 為主。
  • 2026-01-27: 1.0.0-beta.12 - 釐清行情初始化與測試/正式環境價位差異。
  • 2026-01-27: 1.0.0-beta.13 - 釐清 intraday.ticker 用法與訂單狀態判讀。
  • 2026-01-27: 1.0.0-beta.14 - 更新無副檔名路徑寫法，補充整合測試紀錄。
  • 2026-02-03: 1.0.0-beta.15 - SKILL.md 新增快速用法（Quickstart/Enums）與 Shioaji 遷移指南。
  • 2026-02-03: 1.0.0-beta.16 - 新增遷移實作紀錄與代理操作指南。
  • 2026-02-03: 1.0.0-beta.17 - 新增本地化與中英術語對照。
  • 2026-02-09: 1.0.0-beta.18 - 補充 Build-with-LLM 連結並提高線上 llms*.txt 優先序。
  • 2026-02-09: 1.0.0-beta.19 - 更新內建 llms*.txt 並統一路徑為無副檔名。
  • 2026-02-09: 1.0.0-beta.20 - 新增多代理 root adapters（CLAUDE.md/GEMINI.md/AGENTS.md）。
  • 2026-02-09: 1.0.0-beta.21 - 補充本地回歸測試文件與完整跑測紀錄。
  • 2026-02-09: 1.0.0-beta.22 - 新增進階整合測試文件（雙訂單生命週期、多標的行情矩陣、無效代號拒絕）並紀錄 2883/2881 成功結果。
  • 2026-02-18: 1.0.0-beta.23 - 精簡 SKILL.md 結構（TL;DR、常見錯誤表、具體決策樹、版本相容性矩陣）；統一 Order 建構為 keyword 形式；新增回傳格式參考（response-shapes.md）、當沖工作流程、策略模式參考、錯誤與狀態碼表；本地化規則移至各 adapter 檔；標註期貨/選擇權範圍。
  • 2026-03-26: 1.0.0-beta.24 - 同步官方最新 llms.txt / llms-full.txt（中英）內容，讓 skill 內建離線副本與富邦官網的 LLM 文件輸出對齊。
  • 2026-03-31: 1.0.0-beta.25 - 修正 Python SDK 下載連結：將 4 處錯誤的 /docs/sdk/python/download?type=download（回傳 403）替換為正確的 /docs/download/download-sdk。
  • 2026-03-31: 1.0.0-beta.26 - 更新文件存取說明：.md URL 已棄用，改為 .txt URL（/TradeAPI/docs/ 及 /TradeAPI/en/docs/ 下每頁皆可加 .txt 取得純文字版）。
  • 2026-04-09: 1.0.0-beta.27 - 修正 response-shapes.md 欄位名稱錯誤：交易端 OrderResult 商品代號欄位為 stock_no（非 symbol）；補齊 get_order_results 完整欄位清單（30 欄）；驗證 callback on_order/on_order_changed/on_event 欄位並標記 [verified]。驗證環境：SDK 2.2.8 + Python 3.13 + 測試環境。
  • 2026-04-09: 1.0.0-beta.28 - 完成 response-shapes.md 所有欄位驗證（0 個 TODO 殘留）。重大修正：place_order/modify_price/cancel_order 回傳完整 OrderResult；modify_price/modify_quantity API 簽名修正（需先呼叫 make_modify_*_obj）；on_filled 為 FillResult 物件（含 filled_avg_price/filled_no/filled_time）；on_event.code 為 str；login 帳號名稱為 name（非 account_name）；補完 query_symbol_quote 全 25 欄、intraday.quote 全欄位、intraday.ticker 全欄位。補完 implementation-practices.md 錯誤訊息表。

Yorumlar (0)

Sonuc bulunamadi