前言¶
做 A 股量化研究時，常見路徑是自建腳本拉數據、寫回測、再單獨維護選股邏輯。數據源切換、接口封裝和文檔分散，往往佔掉大量時間。若你希望在 Cursor、Claude Code 等支持 Skills 的環境裏，用對話驅動一套已封裝好的量化能力，而不是每次從零拼 requests 和腳本，可以看一下 SkillHub 上的 A股多因子量化選股（座標 @user_a9caeb3c/a-stock-multi-factor-screener，當前版本 4.0.3）。
下面介紹它是什麼、能做什麼、如何安裝，以及使用時需要留意的邊界。
這是什麼¶
A股多因子量化選股 是 SkillHub community 分類下的 professional 技能，由發佈者 user_a9caeb3c 維護。SkillHub 頁面將其定位爲「專業級量化交易系統」，並標明支持 米筐 / 聚寬 / AkShare 三類數據源，以及 102 個 REST API 端點；標籤 requires_api_key=false 表示安裝該 Skill 本身不要求配置 SkillHub API Key（具體數據源若需賬號，以 Skill 內文檔爲準）。
官方入口：
- Skill 包地址：
https://api.skillhub.cn/user_a9caeb3c/a-stock-multi-factor-screener - SkillHub 展示頁：
https://www.skillhub.cn/skills/user_a9caeb3c/a-stock-multi-factor-screener
截至 SkillHub 頁面與抓取信息，該 Skill 評分 100000，下載 8400 次，安裝 26 次。
核心功能¶
以下能力均來自 SkillHub 簡介與已抓取資料，不做超出原文的展開。
- 多源行情與數據：支持米筐、聚寬、AkShare，便於在同一套接口下切換數據源（熱切換能力以 Skill 文檔爲準）。
- REST API 面：提供 102 個 REST API 端點，適合用 Python
requests或 Agent 生成的腳本做程序化調用。 - 文檔與上手：簡介提到 14 個新增文檔章節，並強調「新手 5 分鐘上手」；具體章節名與示例以安裝後的
SKILL.md及附帶文檔爲準。 - 質量與合規表述（發佈方聲明）：頁面寫明「七角色全鏈路測試通過」「TRACE 評測衝刺 5.0 滿分」「零崩潰架構」，以及「科恩 + 雲鼎安全合規認證」。這些是發佈方在 SkillHub 上的說明，使用前仍建議在本機環境自行驗證。
技能名稱中的「多因子量化選股」指向其核心場景：在 A 股市場側，用多因子思路做篩選與研究，而不是替代券商實盤通道。
安裝與啓用¶
SkillHub 推薦的安裝方式，是讓當前 AI 按官方安裝說明拉取指定座標技能。
1、用對話安裝（官方提示詞）¶
將下面意圖發給 Agent（與 SkillHub 頁面一致）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_a9caeb3c/a-stock-multi-factor-screener`。
這一步是讓 Agent 讀取 SkillHub 的安裝文檔，並按其中的 CLI 流程把技能裝到當前環境能識別的 skills 目錄。
2、用 skillhub CLI 安裝（可選）¶
若本機已有 skillhub，可先檢查版本：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本技能時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別：
skillhub install @user_a9caeb3c/a-stock-multi-factor-screener --dir <skills 目錄>
常見客戶端 skills 路徑（摘自 SkillHub 安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
不同客戶端路徑不同，以你當前使用的 Agent 爲準。安裝完成後，按各客戶端說明刷新或重啓，使新 Skill 生效。
典型用法¶
經過上面的步驟，Agent 會加載該 Skill 的 SKILL.md 及附帶文檔。典型工作流可以概括爲：
- 確認環境：本機或 Docker 中已具備該量化系統運行所需依賴（具體命令與端口見 Skill 文檔）。
- 選數據源：在 AkShare、聚寬、米筐之間按賬號與數據權限選擇；切換方式以 102 個 API 與文檔說明爲準。
- 對話驅動任務：用自然語言描述 A 股側需求，例如多因子篩選、查看策略或風險相關接口返回、導出研究用數據等，由 Agent 按 Skill 約定調用 REST API 或文檔中的 CLI/Web 入口。
SkillHub 頁面未給出可複製的一行 curl 示例；可復現的第一步仍是上述安裝命令與座標。具體請求路徑、參數和返回字段，請以安裝包內 14 個文檔章節 爲準逐項對照。
適用場景與注意¶
更適合：
- 需要在 A 股 場景做策略驗證、量化入門練習或批量研究的數據分析流程；
- 希望統一走 REST API，減少自寫膠水代碼；
- 已在使用 Cursor / Claude Code 等，想把量化操作收斂到 Skills 工作流裏。
需要留意：
- 來源爲 community 技能，功能與穩定性以本機實測爲準；發佈方宣傳用語不構成投資建議。
- requires_api_key=false 僅指 SkillHub 安裝側；聚寬、米筐等第三方數據仍可能要求各自賬號與合規使用。
- 頁面信息未承諾券商實盤自動下單、高頻交易或期貨期權全覆蓋；若你的目標是低延遲 HFT 或全自動實盤，需自行對接券商並評估延遲與合規，不能默認本 Skill 已覆蓋。
- 港美股等若僅有「有限支持」，應以 Skill 內數據源與 API 列表爲準，避免誤用在非 A 股深度場景。
結尾¶
A股多因子量化選股（v4.0.3）把三源數據、102 個 REST API 和較完整的文檔章節打包成 SkillHub 上的 professional 技能，適合想在 Agent 裏系統化做 A 股量化選股與相關研究的人。安裝從 SkillHub 座標與 skillhub.cn/install/skillhub.md 開始即可。
- Skill 包：
https://api.skillhub.cn/user_a9caeb3c/a-stock-multi-factor-screener - 展示頁：
https://www.skillhub.cn/skills/user_a9caeb3c/a-stock-multi-factor-screener
