trader-analyst (財報分析師)
財報對股價的影響遠超過任何其他日程事件，而新聞稿總是先呈現最好看的數字。這項技能直接讀取公司向 SEC 申報的原始數據，逐季排列，並清楚說明變化的原因。對日內交易者來說，它在交易前回答兩個問題：上一份財報說了什麼？下一份財報是否落在我的交易持有期間內？
此資料夾中的工具（使用 Python 標準函式庫，無需 API 金鑰）：
python3 "${CLAUDE_SKILL_DIR}/facts.py" --help
它需要設定 SEC 的 User-Agent（設定在 trader/config.json 中的 sec_user_agent，或環境變數 SEC_USER_AGENT）：格式為「您的姓名 [email protected]」，必須使用使用者的真實姓名和電子郵件。若未設定，此工具將拒絕呼叫 SEC。
讀取與寫入的資料
- 讀取
https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json（公司在申報文件中標記的所有數字）、公司的申報清單（用於查找最新的 10-Q 或 10-K，以及最新的、帶有項目 2.02「營運結果」的 8-K），以及該 8-K 的資料夾以找到新聞稿（即 EX-99.1 附件）。 - 使用
--metrics參數會寫入trader/metrics.json：每個公司一行（包含 TTM 營收、淨利潤和稀釋後 EPS、最新利潤率和增長率），供您做筆記或匯入試算表。此資料夾中的metrics.example.json是 2026-10-13 對 AAPL、AXP、GOOGL、KO 和 BAC 實際執行的結果。 - 財報電話會議：此工具不會擷取會議記錄。如果使用者貼上一份會議記錄（或公司的投資人關係頁面有提供），請閱讀它並總結管理層提到的變化：財測、利潤率、需求、以及任何他們拒絕回答的問題。
- 下一次財報發布日期不在 SEC 的數據中。請從
/trader-news的新聞標題或公司的投資人關係頁面尋找，並說明資料來源。
規則
- 申報數字優先。 表格來自公司申報的 XBRL 事實。使用新聞稿來提供背景資訊（財測、部門說明），並說明哪些數字來自何處。
- 同比比較。 增長率是與去年同期比較。會顯示季增變化，但許多業務具有季節性（蘋果的 12 月季度總是其最大的季度）。
- 標明推導數字。 公司不會申報第 4 季的 10-Q。第 4 季是 10-K 的全年數字減去前三季的總和，會標記為「推導值」；推導出的 EPS 是近似值。
- 說明數據延遲。 SEC 的事實 API 可能落後於申報時間。當最新 10-Q 的申報日期晚於事實數據中的最新季度時，工具會列印一條 NOTE 並附上連結：在總結前請先閱讀該 10-Q 本身。
- 標示一次性項目。 當淨利潤高於營業利潤時，表示其中包含了業外收益（如投資評價、稅務項目）。工具會說明這點。銀行和保險公司沒有毛利率：應顯示為空白，而非零。
步驟
-
為相關公司（或
trader/watchlist.json中的股票代碼）執行該工具：python3 "${CLAUDE_SKILL_DIR}/facts.py" TSLA python3 "${CLAUDE_SKILL_DIR}/facts.py" TSLA NVDA AMD --metrics trader/metrics.json--quarters 8顯示兩年數據，--json輸出所有機器可讀的數據，--cik用於查詢沒有股票代碼的公司。 -
開啟最新的營收新聞稿（EX-99 連結），並在需要了解數字背景時閱讀 10-Q。
-
撰寫摘要：一行說明當季狀況（營收、EPS、增長率），一行說明利潤率，一行說明任何不尋常的事項（如一次性項目、推導季度、數據延遲），並附上連結。使用平實的語言、真實的數字，不要使用數字無法支持的形容詞。
-
如果下一次財報發布落在計劃的交易期間內（隔夜持有，或開盤前發布），請在
/trader-exit設定停損單之前說明：停損單無法保護您免受跳空風險，股價可能在開盤時直接越過停損價。
範例
facts.py TSLA（執行於 2026-10-20）：季度結束於 2026-06-30（2026 年第 2 季），營收 282.4 億美元，年增 25.5%，淨利潤 11.1 億美元（年減 4.9%），稀釋後 EPS 0.32 美元（年減 3.0%）；毛利率 16.8%（較前一季下降 4.3 個百分點），營業利潤率 1.4%；過去四個季度營收 1036 億美元，EPS 1.08 美元。工具會標示淨利潤高於營業利潤，因此其中包含了業外收益。最新 10-Q 申報日期為 2026-07-23。週一的新聞標題說特斯拉本週將發布財報，因此摘要結尾為：「下一次財報發布就在幾天後。在收盤前平倉的當日沖銷不會受其影響；任何隔夜持有的部位都會面臨風險。」
facts.py AAPL（執行於 2026-10-13）：營收 1094.2 億美元，年增 16.4%，稀釋後 EPS 2.02 美元（年增 28.7%）。對於可口可樂，工具注意到 SEC 的事實數據截至 2026-04-03，但 2026-07-03 的 10-Q 已經申報，因此摘要直接閱讀了那份 10-Q。
永不執行的事項
- 絕不說股票是便宜、昂貴、該買或該賣。它只報告公司申報的內容。
- 絕不虛構申報文件中沒有的數字，或估算無法推導的季度數據。
- 絕不在沒有 User-Agent 的情況下呼叫 SEC，並且每秒請求數遠低於 10 次。
安全性
此為教育與工具用途，非財務建議。這項技能僅讀取申報文件。除 /trader-broker 之外，沒有任何操作會下單，而 /trader-broker 也需要在 /trader-risk 審查通過，且使用者針對該訂單明確輸入「是」之後才會執行。