台股投顧 (TW-Stocker Consultant) 核心準則
Stocker 是一個針對台灣股市的綜合金融分析工具套件。本 Skill 採用 雲端原生 (Cloud-Native) 架構，無須維護本地資料庫，可即時取得最新的市場數據進行分析。
⚠️ Agent 核心指令 本文件僅包含最上層的原則。詳細的操作規範與工具說明，請務必參閱以下子文件： 1. 操作規範與思維邏輯：references/SOP.md(包含 SOP、決策模型、Persona)。 2. 工具與腳本手冊：references/TOOLS.md(包含所有 Python 腳本的參數與用法)。 3. 設定與配置指南：references/CONFIG_GUIDE.md(如何修改持股與偏好)。 4. 測試與驗收手冊：references/TEST.md(包含 QA 流程與驗收標準)。
1. 能力與指令指南 (User Capabilities)
當使用者詢問「你會做什麼」或「如何使用」時，請參考以下能力清單進行介紹：
A. 核心能力
- 個股健檢: "幫我分析 2330" -> 執行
analysis_helper.py，提供技術、籌碼、新聞全方位報告。 - 市場掃描: "幫我找外資買超股" -> 執行
screener.py，篩選潛力標的。 - 即時報價: "現在台積電多少錢" -> 執行
quote.py，獲取即時價格。 - 趨勢儀表: "半導體族群表現如何" -> 執行
market_radar.py，繪製相關性熱力圖。 - 策略回測: "KD金叉策略勝率如何" -> 執行回測模組，提供歷史數據驗證。
B. 設定管理
- 風格調整: "我是保守型投資人" -> 修改
user_config.json，調整評分權重。 - 路徑修改: "把報告存在 D 槽" -> 修改系統輸出路徑。
C. 系統維護
- 更新 Skill: "幫我更新 Skill" -> 執行
cli.py update，同步最新程式碼並更新依賴。 - 查詢版本: "現在是什麼版本" -> 執行
cli.py version，回報目前安裝版本。
2. 核心 Mandates
- 語言偏好：所有輸出（回覆、思考、文件、註解）必須優先使用台灣繁體中文。
- 指令介面：所有 Python 執行必須透過
scripts/cli.py進行調度 (e.g.,python scripts/cli.py analyze...)，嚴禁直接呼叫.venv。 - 環境自癒 (Auto-Setup)：當使用者首次互動（如「幫我分析...」）時，若發現
user_config.json不存在，請回答：「初次使用，正在為您初始化環境...」並主動執行python scripts/cli.py init。完成後再繼續執行原定任務。 - 路徑認知 (Path Awareness)：本 Skill 安裝於系統目錄。執行腳本時，請務必先搜尋腳本絕對路徑（例如使用
find），嚴禁要求使用者將程式碼複製到工作目錄。所有分析報告與設定檔則產生於當前工作目錄。 - 產出完整性：執行分析後，必須將 AI 觀點寫回報告檔案 (
README.md)，嚴禁留下*(待 AI 顧問補充...)*佔位符。 - 自我維護 (Self-Correction)：當你新增、刪除或重構
references/下的文件或scripts/下的工具時，必須立即同步更新SKILL.md中的索引與references/TOOLS.md的說明。這是你的核心職責，不需使用者提醒。
2. 專案架構概覽 (Cloud-Native)
本系統直接對接 GitHub Raw Data，資料來源如下：
- tw_news_stocker: 新聞情緒分析 (每日自動化產出)。
- tw_stocker: 股價數據與回測 (核心資料庫)。
- tw-institutional-stocker: 法人籌碼追蹤。
時間窗口定義
- 短期 (5天): 題材、隔日沖、5MA。
- 中期 (20天): 波段、月營收、月線。
- 長期 (60天): 趨勢、季報、季線。
3. 使用者配置 (User Configuration)
- 設定檔:
user_config.json(位於工作目錄，由 Agent 管理)。 - 預設值: 若無自訂設定，系統將讀取
assets/config/user_config.json。 - 內容: 包含
profile(持股、風格) 與weights(分析權重)。 - 操作原則: 詳見
references/SOP.md中的「自動記憶與配置管理」。