Files

Timmy 3e93a2dcb3 feat: 初始提交 stocks-report skill，含 emoji 禁用規則

白話解讀版禁止使用 emoji（🟢🟡🔴），改用純文字標記 [+]/[!]/[-]，
避免 weasyprint 嵌入 Apple Color Emoji 字型導致 PDF 開啟時報錯。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-10 10:46:35 +08:00

5.7 KiB

Raw Blame History

name, description

name	description
stocks-report	產生台股個股完整分析報告（Markdown + PDF）。輸入股票代號（例如 2330、00922），自動執行所有查詢腳本、整合本地持股紀錄，輸出排版完整的 .md 與 .pdf 到 stocks/ 目錄。

stocks-report

產生台股個股完整分析報告，輸出 Markdown 與 PDF。

執行流程

1) 先執行 stocks-query skill 取得所有資料

依序執行（盡量平行呼叫以加快速度）：

python3 skills/stocks-query/scripts/yahoo-institutional-browserless.py <代號>
python3 skills/stocks-query/scripts/yahoo-quote-browserless.py <代號>
python3 skills/stocks-query/scripts/yahoo-technical-browserless.py <代號>
python3 skills/stocks-query/scripts/twse-margin-trading.py <代號>
python3 skills/stocks-query/scripts/yahoo-dividend-browserless.py <代號>
python3 skills/stocks-query/scripts/yahoo-market-brief.py
python3 skills/stocks-query/scripts/yahoo-broker-trading-browserless.py <代號>
python3 skills/stocks-query/scripts/twse-day-trading.py <代號>
python3 skills/stocks-query/scripts/twse-foreign-holdings.py <代號>

若標的不是 ETF（非 00 開頭），額外執行：

python3 skills/stocks-query/scripts/twse-monthly-revenue.py <代號>
python3 skills/stocks-query/scripts/twse-pe-pbr.py <代號>

若標的是 ETF（00 開頭），改為額外執行：

python3 skills/stocks-query/scripts/yahoo-etf-holdings.py <代號>

同時檢查本地是否有該代號的持股紀錄（stocks/<代號>-TW.md）。

2) 組裝 Markdown 報告

將所有腳本輸出整合為一份結構化 Markdown，存為 stocks/<代號>-report-YYYYMMDD.md。

報告結構（依序）：

# <代號> <名稱>｜完整分析報告
> 報告日期：YYYY-MM-DD
---
## 大盤同步
## 報價
## 三大法人
## 主力券商進出
  ### 買超前 5 大券商（表格）
  ### 賣超前 5 大券商（表格）
## 融資融券
## 當沖統計
## 外資持股
## 技術面
  ### 近 5 日 K 線（表格）
## 股利殖利率
  ### 近期配息明細（表格）
## ETF 持股與配置（僅 ETF）
  ### 前十大持股
  ### 行業比重
  ### 資產分佈
## 月營收（僅非 ETF）
## 本益比／股價淨值比（僅非 ETF）
## 白話判斷
## 個人持股紀錄（若有本地紀錄）

規則：

所有表格使用 Markdown table 語法
若某腳本失敗或無資料，該區段標註「無資料」，不要省略區段
白話判斷要綜合技術面、籌碼面、配息面給出偏多／偏空／震盪的結論
個人持股需正確計算平均成本、含息報酬、哪幾張可領配息（對照除息日）

3) 轉換為 PDF

用以下 Python 程式將 Markdown 轉為 PDF：

import markdown
from weasyprint import HTML

with open('<md_path>', 'r') as f:
    md_text = f.read()

html_body = markdown.markdown(md_text, extensions=['tables', 'fenced_code'])

full_html = '''<!DOCTYPE html>
<html><head><meta charset="utf-8">
<style>
  body {
    font-family: "PingFang TC", "Heiti TC", "Microsoft JhengHei", "Noto Sans CJK TC", sans-serif;
    font-size: 13px;
    line-height: 1.6;
    color: #1a1a1a;
    max-width: 750px;
    margin: 0 auto;
    padding: 30px 40px;
  }
  h1 { font-size: 22px; border-bottom: 2px solid #333; padding-bottom: 8px; }
  h2 { font-size: 17px; color: #2c3e50; border-bottom: 1px solid #ddd; padding-bottom: 5px; margin-top: 24px; }
  h3 { font-size: 14px; color: #34495e; margin-top: 16px; }
  table { border-collapse: collapse; width: 100%; margin: 10px 0; font-size: 12px; }
  th, td { border: 1px solid #ddd; padding: 6px 10px; text-align: left; }
  th { background: #f5f6fa; font-weight: 600; }
  tr:nth-child(even) { background: #fafbfc; }
  blockquote { background: #f0f4ff; border-left: 4px solid #4a90d9; padding: 8px 14px; margin: 12px 0; font-size: 13px; }
  strong { color: #c0392b; }
  hr { border: none; border-top: 1px solid #eee; margin: 20px 0; }
  ul, ol { padding-left: 20px; }
  li { margin-bottom: 3px; }
  p { margin: 6px 0; }
</style>
</head><body>''' + html_body + '</body></html>'

HTML(string=full_html).write_pdf('<pdf_path>')

輸出：stocks/<代號>-report-YYYYMMDD.pdf

4) 產生白話解讀版

除了專業版之外，額外產生一份「白話解讀版」，讓不熟悉股市的人也能看懂。

存為 stocks/<代號>-report-YYYYMMDD-beginner.md 及對應 .pdf。

白話解讀版規則：

標題格式：# <代號> <名稱>｜白話解讀版
每個區段用問句當標題（例如「現在多少錢？」「大咖們在幹嘛？」「散戶有沒有在瘋搶？」）
所有術語第一次出現時，用括號或「像是在說...」欄位附上白話翻譯
表格多加一欄「白話意思」，用日常語言解釋數字的含義
技術指標用生活化比喻（例如 RSI 像溫度計、布林通道像天花板和地板）
最後總結用簡單評分表呈現結論
禁止使用 emoji（如 🟢🟡🔴），改用純文字標記（如 [+] 正面、[!] 留意、[-] 負面），避免 weasyprint 嵌入 Apple Color Emoji 字型導致 PDF 開啟時出現字型錯誤
個人持股區段用「什麼時候買的／買多少／能不能領紅包」等直白欄位
字體稍大（font-size: 14px）、行距較寬（line-height: 1.8）方便閱讀

轉 PDF 時使用與專業版相同的程式，但 CSS 調整為：

font-size: 14px（body）
line-height: 1.8
font-size: 13px（table）

5) 回覆使用者

告知四個檔案路徑（專業版 .md/.pdf + 白話解讀版 .md/.pdf）和檔案大小。

回覆風格

使用繁體中文（台灣）
報告內容全部繁體中文
日期使用西元格式 YYYY-MM-DD
金額使用千分位格式
標題和內容要自行措辭，不要直接引用使用者的指令用語

5.7 KiB Raw Blame History Unescape Escape