前言¶
做量化研究時，因子從「算出來」到「能下單」往往要串起預處理、IC、迴歸、分層、擁擠度，再到多因子共線性、正交化、加權與打分。這些步驟分散在 notebook 和內部腳本里，換一個人或換一套數據就要重新拼流程。下面介紹中國銀河證券在 SkillHub 發佈的 星耀數智因子分析 skill，把星耀數智因子分析框架封裝成 Agent 可執行的 Skill，並在完成後輸出可視化 HTML 報告。
這是什麼¶
星耀數智因子分析 skill（座標 @org-rwhv0nty/ad-factor-analysis，當前版本 v1.0.9）是中國銀河證券星耀數智團隊提供的因子分析框架 Skill，來源標註爲 enterprise，SkillHub 分類爲 professional。
它面向兩類任務：
- 單因子分析：預處理，以及 IC、迴歸、分層三類檢驗，並包含擁擠度相關分析。
- 多因子合成：共線性檢測、正交化、八種加權方式與打分，並自動生成可視化 HTML 報告。
官方簡介中列出的適用關鍵詞包括：因子檢驗、因子有效性、因子合成、因子加權、因子正交化、因子打分、IC 分析、分層回測、因子擁擠度、多因子選股、因子組合、因子共線性、因子降維等。
核心功能¶
以下能力均來自 SkillHub 頁面與已抓取元數據，不展開未在資料中出現的接口或參數。
單因子分析¶
- 預處理：在檢驗前對因子做框架約定的處理（具體步驟以安裝後的
SKILL.md爲準）。 - 三大檢驗方法：IC、迴歸、分層。
- 擁擠度：單因子鏈路中包含擁擠度相關分析。
多因子合成¶
- 共線性檢測：在多因子組合前識別因子間共線性問題。
- 正交化：對因子做正交化處理。
- 八種加權：官方說明支持 8 種加權方式（具體名稱與公式以 Skill 內文檔爲準）。
- 打分：在加權與合成後輸出因子打分結果。
報告輸出¶
分析完成後 自動生成可視化 HTML 報告，便於在瀏覽器中查看圖表與結果，而不必在對話裏逐段粘貼數值。
平臺與依賴¶
- SkillHub 標籤包含
requires_api_key=true，使用前需按 Skill 說明配置 API Key（密鑰字段與獲取方式以發佈方文檔爲準）。 - 頁面展示評分 100000，下載 8588 次（統計來自 SkillHub 抓取快照，會隨平臺更新變化）。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。安裝時須把技能裝進當前 Agent 能識別的 skills 目錄，否則默認路徑可能不會被加載。
方式一：讓 AI 按官方指引安裝¶
SkillHub 頁面提供的安裝提示詞爲：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@org-rwhv0nty/ad-factor-analysis`。
將上述內容發給 Cursor、Claude Code 等支持 Skills 的客戶端，由 Agent 讀取 SkillHub 安裝文檔 並完成安裝。
方式二：SkillHub CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按官方文檔執行完整安裝（含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 時，必須用 --dir 指向當前環境的 skills 目錄。常用路徑示例（摘自官方安裝文檔）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝命令形式如下（將 <skills 目錄> 替換爲實際路徑）：
skillhub install org-rwhv0nty/ad-factor-analysis --dir <skills 目錄>
座標在文檔中亦寫作 @org-rwhv0nty/ad-factor-analysis，與 skillhub search / skillhub install 使用的包名一致。
安裝完成後，按 Skill 內 SKILL.md 配置 API Key（requires_api_key=true），並重啓或刷新 Agent 的技能列表使技能生效。
典型用法¶
官方頁面未附帶獨立的長示例代碼庫；典型用法是：在已安裝並配置密鑰的前提下，用自然語言描述數據與目標，讓 Agent 調用本 Skill 走完分析鏈路。
可按任務類型組織請求，例如：
- 單因子：說明因子名稱、收益與股票池時間範圍，要求完成預處理，並輸出 IC、迴歸、分層結果及擁擠度，並生成 HTML 報告。
- 多因子：提供多個因子或因子矩陣，要求先做共線性檢測，再正交化，選定八種加權方式之一（或讓 Agent 按 Skill 規則列舉可選加權），最後合成打分並輸出 HTML 報告。
具體輸入字段、數據格式與默認參數以安裝包內 SKILL.md 及星耀數智框架約定爲準；本文不編造未在資料中出現的配置項或樣例數據路徑。
適用場景與注意¶
適合誰
- 已在星耀數智或銀河證券相關環境中做 A 股或多因子選股研究，需要把「檢驗 + 合成 + 報告」固化成可重複對話流程的團隊。
- 希望在 Cursor / Claude Code 等 IDE 裏用 Agent 驅動因子分析，而不是每次手寫一整套 notebook 腳本的開發者。
需要注意
- API Key：標籤標明需要密鑰；未配置時 Skill 可能無法訪問後端能力。
- 合規與數據：來源爲證券公司 enterprise 類 Skill，實際數據接入、合規邊界以機構內部規定爲準。
- 版本：撰寫時覈對到的版本爲 1.0.9；升級後功能以 SkillHub 頁面爲準。
- 安裝路徑：務必使用
--dir指向當前 Agent 的 skills 目錄，避免裝到默認./skills/導致無法識別。
結尾¶
星耀數智因子分析 skill 把單因子（預處理、IC/迴歸/分層、擁擠度）與多因子（共線性、正交化、八種加權、打分）串成一條 Agent 可執行鏈路，並輸出 HTML 可視化報告。若你的工作涉及因子有效性檢驗或多因子組合，可在 SkillHub 查看詳情並安裝。
- SkillHub 頁面：https://www.skillhub.cn/skills/org-rwhv0nty/ad-factor-analysis
- API 座標頁：https://api.skillhub.cn/org-rwhv0nty/ad-factor-analysis
