前言¶
做 A 股相關的腳本或問答時，常見做法是自己在項目裏裝 AkShare、查文檔、寫拉數邏輯，再在對話裏貼結果。數據接口多、字段不統一，網絡偶發失敗還要自己加重試。若希望 Agent 在對話裏直接查個股、看行情、做簡單財務與選股相關問答，需要一套已封裝好的取數路徑，而不是每次從零寫代碼。
下面介紹 SkillHub 上的社區 Skill「A股量化數據分析」：基於 AkShare 封裝可執行 CLI，並內置重試與錯誤處理，便於在 Cursor、Claude Code、Codex 等環境裏安裝後由 Agent 調用。
這是什麼¶
「A股量化數據分析」是 SkillHub 座標 @user_9e3b7930/akshare-stock-cn 上的社區（community）技能，當前版本 1.1.0，分類爲 data-analysis，發佈者爲 user_9e3b7930。標籤標明 requires_api_key=false，安裝使用不需要單獨配置 API Key。
官方簡介將其定位爲：基於 AkShare 獲取 A 股行情、財務數據、板塊信息等；提供可執行 CLI 腳本，內置重試機制和錯誤處理；用於回答 A 股股票查詢、行情數據、財務分析、選股等問題。
SkillHub 頁面：https://www.skillhub.cn/skills/user_9e3b7930/akshare-stock-cn
技能 API 入口：https://api.skillhub.cn/user_9e3b7930/akshare-stock-cn
核心功能¶
以下能力均來自官方頁面與抓取資料，未單獨列出的接口或數據類型不在本文承諾範圍內。
- 行情與板塊：通過 AkShare 拉取 A 股行情、板塊相關信息，供查詢與對比使用。
- 財務數據：支持財務類數據的獲取，服務於財務分析類提問。
- CLI 封裝：技能包內提供可執行 CLI 腳本，Agent 可按 SKILL 約定調用，而不是在對話裏臨時拼湊未驗證的代碼。
- 穩定性：內置重試與錯誤處理，減輕公網數據源偶發失敗對單次查詢的影響。
- 對話場景：面向「查某隻股票」「看行情」「財務指標」「選股思路」等自然語言任務，由 Agent 選擇合適腳本與參數。
安裝與啓用¶
安裝前需本機已具備 SkillHub CLI。若未安裝，可先按官方安裝文檔檢查版本或執行安裝腳本（完整安裝或僅 CLI，以文檔爲準）：
command -v skillhub && skillhub --version
# 完整安裝（CLI + 默認 Skill，推薦）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 僅安裝 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
SkillHub 頁面給出的安裝提示爲：讓 AI 根據安裝文檔安裝本技能，座標如下。
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_9e3b7930/akshare-stock-cn`。
使用 CLI 時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。常用路徑如下（以 SkillHub 安裝文檔爲準）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
安裝命令示例（將 <skills 目錄> 換成上表對應路徑）：
skillhub install @user_9e3b7930/akshare-stock-cn --dir <skills 目錄>
安裝完成後，按你所用客戶端的要求重啓或刷新 Agent，使技能被加載。本技能無需 API Key 配置項。
典型用法¶
官方說明強調「用於回答」類任務，典型方式是在已啓用該 Skill 的對話裏直接提問，由 Agent 按包內 CLI 與 AkShare 取數。下列爲與官方描述一致的提問方向，具體腳本名與參數以安裝包內 SKILL.md 爲準。
- 股票查詢：例如詢問某隻 A 股的基本信息與代碼對應關係。
- 行情數據：例如查看個股或相關板塊的行情摘要（以 AkShare 當前可用接口爲準）。
- 財務分析：例如請求主要財務指標或報表相關數據，用於對比與解讀。
- 選股相關：例如按條件篩選或列舉候選標的，再結合行情、財務結果做說明。
若需確認本機是否裝好，可在終端執行 skillhub 相關命令搜索或查看已安裝技能列表（參見 https://skillhub.cn/install/skillhub.md 第三節）。
適用場景與注意¶
適合誰
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的環境，希望在對話裏查 A 股數據、少寫重複拉數代碼的開發者或分析人員。
- 接受以 AkShare 爲數據源、通過社區 Skill 維護封裝邏輯的團隊。
使用注意
- 數據範圍與字段以 AkShare 及數據源當日可用性爲準；社區 Skill 不保證覆蓋某一類未在官方簡介中寫明的能力。
- 取數依賴網絡；重試機制可緩解偶發失敗，不能替代對數據時效性與合規使用的自行判斷。
- SkillHub 抓取資料顯示：評分 100000，下載 2684 次（統計隨 SkillHub 更新可能變化）；來源爲 community，升級與問題反饋需關注 SkillHub 上該座標頁面的版本說明。
- 投資與交易決策應獨立覈實數據，本文僅介紹技能能力，不構成投資建議。
結尾¶
「A股量化數據分析」把 AkShare 常見的行情、財務、板塊查詢收成帶 CLI 與重試的 Agent Skill，免 API Key，適合在 Skill 生態裏做 A 股問答與輕量分析。需要安裝或查看版本時，以 SkillHub 官方頁面爲準：
https://www.skillhub.cn/skills/user_9e3b7930/akshare-stock-cn
