台股投顧 (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 中的「自動記憶與配置管理」。