Timmy
6b63e539b3
涵蓋功能說明、依賴需求、快速上手步驟、執行流程圖解、 雙版本差異對照，以及 PDF 轉換的已知限制（禁止 emoji）。 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
65 lines
2.5 KiB
Markdown
65 lines
2.5 KiB
Markdown
# stocks-report
|
||
|
||
台股個股完整分析報告產生器，自動整合即時行情、法人籌碼、技術指標與本地持股紀錄，輸出排版完整的 Markdown 與 PDF。
|
||
|
||
## 功能特色
|
||
|
||
- **雙版本輸出**：專業版（給有經驗的投資人）＋白話解讀版（給入門者）
|
||
- **四檔輸出**：每次產出 `.md` + `.pdf` 各兩份
|
||
- **自動整合持股**：若本地有 `<代號>-TW.md` 紀錄，自動計算平均成本、含息報酬
|
||
- **ETF／個股判別**：`00` 開頭自動走 ETF 流程（持股分析），否則走個股流程（月營收、本益比）
|
||
|
||
## 報告涵蓋範圍
|
||
|
||
| 區段 | 內容 |
|
||
|------|------|
|
||
| 大盤同步 | 加權指數、漲跌、成交金額 |
|
||
| 報價 | 現價、開高低收、成交量、均價、最佳五檔 |
|
||
| 三大法人 | 外資／投信／自營商買賣超 |
|
||
| 主力券商 | 買超／賣超前 5 大券商明細 |
|
||
| 融資融券 | 融資融券餘額、券資比 |
|
||
| 當沖統計 | 當沖成交量與佔比 |
|
||
| 外資持股 | 持有股數與持股比例 |
|
||
| 技術面 | RSI14、ATR14、KD、布林通道、近 5 日 K 線 |
|
||
| 股利殖利率 | 歷年配息、殖利率、除息日 |
|
||
| ETF 持股 | 前十大持股、行業比重、資產分佈（僅 ETF） |
|
||
| 月營收 | 當月營收、MoM、YoY、累計（僅個股） |
|
||
| 本益比 | PE ratio、股價淨值比（僅個股） |
|
||
| 白話判斷 | 綜合技術面＋籌碼面＋配息面的多空結論 |
|
||
| 個人持股 | 成本、損益、配息資格（若有本地紀錄） |
|
||
|
||
## 依賴
|
||
|
||
- **stocks-query skill**（`../stocks-query/`）：所有資料擷取腳本皆在此
|
||
- **Python 套件**：`markdown`、`weasyprint`（PDF 轉換）
|
||
- **CJK 字型**：系統需安裝 PingFang TC、Heiti TC 或 Noto Sans CJK TC
|
||
|
||
## 輸出路徑
|
||
|
||
```
|
||
stocks/
|
||
├── <代號>-report-YYYYMMDD.md 專業版 Markdown
|
||
├── <代號>-report-YYYYMMDD.pdf 專業版 PDF
|
||
├── <代號>-report-YYYYMMDD-beginner.md 白話解讀版 Markdown
|
||
└── <代號>-report-YYYYMMDD-beginner.pdf 白話解讀版 PDF
|
||
```
|
||
|
||
## 透過 Claude Code 使用
|
||
|
||
本工具已註冊為 Claude Code skill。在對話中使用 `/stocks-report` 加上股票代號即可觸發：
|
||
|
||
```
|
||
/stocks-report 2330
|
||
/stocks-report 00922
|
||
```
|
||
|
||
## 注意事項
|
||
|
||
- 報告內容禁止使用 emoji，以避免 weasyprint 嵌入 Apple Color Emoji 字型導致 PDF 開啟錯誤
|
||
- 白話版使用純文字標記：`[+]` 正面、`[!]` 留意、`[-]` 負面
|
||
- 所有內容皆為繁體中文（台灣），日期使用西元格式，金額使用千分位
|
||
|
||
## 授權
|
||
|
||
內部工具，僅供個人使用。
|