@v587d/capital-generation 2.7.0 → 2.7.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +77 -1
- package/LICENSE +1 -1
- package/README.md +10 -9
- package/THIRD_PARTY_NOTICES.md +14 -4
- package/capital-config/client.js +50 -10
- package/capital-config/client.src.cjs +376 -62
- package/capital-config/index.js +168 -5
- package/capital-config/package.json +1 -1
- package/capital-watchlist/package.json +1 -1
- package/chart-ui/package.json +1 -1
- package/lib/agents/selected-skills-provider.js +5 -5
- package/lib/index.d.ts +4 -28
- package/lib/index.js +8 -18
- package/lib/web-retriever/local-fetch.d.ts +1 -1
- package/lib/web-retriever/local-fetch.js +1 -1
- package/lib/web-retriever/wind-client.d.ts +1 -1
- package/lib/web-retriever/wind-client.js +1 -1
- package/package.json +3 -1
- package/selected-skills/InvestSkill/ADDING-NEW-SKILLS.md +546 -0
- package/selected-skills/InvestSkill/CHANGELOG.md +373 -0
- package/selected-skills/InvestSkill/CI-CD-GUIDE.md +432 -0
- package/selected-skills/InvestSkill/CLAUDE.md +148 -0
- package/selected-skills/InvestSkill/CONTRIBUTING.md +291 -0
- package/selected-skills/InvestSkill/DEPLOYMENTS.md +321 -0
- package/selected-skills/InvestSkill/FAQ.md +509 -0
- package/selected-skills/InvestSkill/GEMINI.md +419 -0
- package/selected-skills/InvestSkill/LICENSE +21 -0
- package/selected-skills/InvestSkill/PLATFORM-COMPATIBILITY.md +529 -0
- package/selected-skills/InvestSkill/README-claude-code.md +435 -0
- package/selected-skills/InvestSkill/README-cursor.md +475 -0
- package/selected-skills/InvestSkill/README-gemini.md +532 -0
- package/selected-skills/InvestSkill/README-ollama.md +106 -0
- package/selected-skills/InvestSkill/README-zh-TW.md +461 -0
- package/selected-skills/InvestSkill/README.md +311 -0
- package/selected-skills/InvestSkill/RELEASE-QUICK-REFERENCE.md +230 -0
- package/selected-skills/InvestSkill/RELEASE_NOTES.md +121 -0
- package/selected-skills/InvestSkill/SECURITY.md +232 -0
- package/selected-skills/InvestSkill/TODO.md +28 -0
- package/selected-skills/InvestSkill/UPSTREAM.md +62 -0
- package/selected-skills/InvestSkill/install.sh +212 -0
- package/selected-skills/InvestSkill/package.json +64 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/README.md +119 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/SKILL.md +338 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/bear-case/SKILL.md +233 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/SKILL.md +327 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/chart-master/SKILL.md +648 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/SKILL.md +478 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dcf-valuation/SKILL.md +109 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/SKILL.md +684 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/SKILL.md +456 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/SKILL.md +277 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md +349 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/SKILL.md +279 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/SKILL.md +288 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md +544 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/full-report/SKILL.md +301 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fundamental-analysis/SKILL.md +67 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/SKILL.md +336 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/SKILL.md +502 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/SKILL.md +548 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/SKILL.md +311 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/SKILL.md +495 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/SKILL.md +465 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/SKILL.md +429 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/report-generator/SKILL.md +857 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/research-bundle/SKILL.md +94 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/result-validator/SKILL.md +174 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/SKILL.md +293 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/SKILL.md +426 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/SKILL.md +397 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/SKILL.md +645 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-screener/SKILL.md +244 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/SKILL.md +640 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/SKILL.md +351 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/SKILL.md +654 -0
- package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/SKILL.md +317 -0
- package/selected-skills/README.md +15 -5
- package/selected-skills/catalog.js +589 -14
- package/selected-skills/investment-skills/UPSTREAM.md +1 -1
- package/selected-skills/investment-skills/skills/buffett-investment-framework/SKILL.md +1 -1
- package/selected-skills/peter-lynch-skill/LICENSE +21 -0
- package/selected-skills/peter-lynch-skill/README.md +305 -0
- package/selected-skills/peter-lynch-skill/UPSTREAM.md +71 -0
- package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/SKILL.md +142 -0
- package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/methodology.md +587 -0
- package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/system-prompt.md +102 -0
- package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/web-research.md +471 -0
- package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/disclaimer.md +2 -0
- package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/filing-rules.md +64 -0
- package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/methodology.md +195 -0
- package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/system-prompt.md +72 -0
- package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/web-research.md +379 -0
|
@@ -0,0 +1,461 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# 📊 InvestSkill
|
|
4
|
+
|
|
5
|
+
### 美股市場專業投資分析工具
|
|
6
|
+
|
|
7
|
+
**30 個 AI 驅動分析框架 · 全平台支援 · 完全開源**
|
|
8
|
+
|
|
9
|
+
**無需 API 金鑰 · 無需訂閱 · 完全免費**
|
|
10
|
+
|
|
11
|
+
[](#-無需-api-金鑰完全免費)
|
|
12
|
+
[](LICENSE)
|
|
13
|
+
[](https://github.com/yennanliu/InvestSkill/stargazers)
|
|
14
|
+
[](https://github.com/yennanliu/InvestSkill/releases)
|
|
15
|
+
[](https://github.com/yennanliu/InvestSkill/actions)
|
|
16
|
+
|
|
17
|
+
[🌐 線上文件](https://yennanliu.github.io/InvestSkill/) • [🎓 投資學習](https://yennanliu.github.io/InvestSkill/learning-zh-tw.html) • [📚 操作手冊](https://yennanliu.github.io/InvestSkill/cookbook.html) • [🐛 回報問題](https://github.com/yennanliu/InvestSkill/issues) • [💬 社群討論](https://github.com/yennanliu/InvestSkill/discussions) • [🇺🇸 English](README.md)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 🎯 什麼是 InvestSkill?
|
|
24
|
+
|
|
25
|
+
InvestSkill 是企業級投資分析工具包,為各 AI 平台帶來機構級分析框架。透過 30 個完整框架進行專業股票分析——無需金融執照,無需 API 費用。
|
|
26
|
+
|
|
27
|
+
**不用註冊,也不用付費。** 沒有 API 金鑰、沒有資料商訂閱、不必設定帳單——你只要用手上已有的 AI 助理(免費方案或本機模型都可以),InvestSkill 本身就只是 markdown 提示詞。詳見 [無需 API 金鑰,完全免費](#-無需-api-金鑰完全免費)。
|
|
28
|
+
|
|
29
|
+
> **適合用於**:投資研究 · 盡職調查 · 投資組合管理 · 金融教育 · 股票評估
|
|
30
|
+
|
|
31
|
+
<div class="home-card">
|
|
32
|
+
<span class="home-card-icon">🎓</span>
|
|
33
|
+
<div class="home-card-body">
|
|
34
|
+
<div class="home-card-title">投資新手?從學習指南開始</div>
|
|
35
|
+
<p>十三堂課的實戰指南,提供繁體中文與英文:第一部用白話講清楚每一項技能背後的概念——讀懂資產負債表、為一門生意估值、持有一個投資組合;第二部是實務基礎——帳戶與下單、ETF 核心、稅(含非美國投資人)、財報季,以及保護計畫的心理學。不需財金背景。</p>
|
|
36
|
+
<p><a class="home-card-cta" href="https://yennanliu.github.io/InvestSkill/learning-zh-tw.html">開始學習 →</a></p>
|
|
37
|
+
</div>
|
|
38
|
+
</div>
|
|
39
|
+
|
|
40
|
+
<table>
|
|
41
|
+
<tr>
|
|
42
|
+
<td width="50%">
|
|
43
|
+
|
|
44
|
+
### ✨ 30 個專業框架
|
|
45
|
+
- 4 個核心分析框架
|
|
46
|
+
- 3 個財務報告分析
|
|
47
|
+
- 4 個市場監控工具
|
|
48
|
+
- 14 個進階研究工具
|
|
49
|
+
- 5 個自動化元技能,加上 report-generator 輸出工具
|
|
50
|
+
- 另有 3 個別名(轉址至吸收它們的技能,不計入框架數)
|
|
51
|
+
|
|
52
|
+
</td>
|
|
53
|
+
<td width="50%">
|
|
54
|
+
|
|
55
|
+
### 🔌 全平台支援
|
|
56
|
+
- Claude Code 插件
|
|
57
|
+
- Cursor IDE 規則
|
|
58
|
+
- Gemini CLI 提示詞
|
|
59
|
+
- GitHub Copilot
|
|
60
|
+
- ChatGPT & Claude.ai
|
|
61
|
+
- 任何大型語言模型
|
|
62
|
+
|
|
63
|
+
</td>
|
|
64
|
+
</tr>
|
|
65
|
+
</table>
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## 🚀 快速開始(30 秒)
|
|
70
|
+
|
|
71
|
+
### 一行指令安裝(推薦)
|
|
72
|
+
|
|
73
|
+
在[官網選擇你的 AI 工具](https://yennj12.js.org/InvestSkill/#install),或直接執行:
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
# Claude Code
|
|
77
|
+
curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a claude
|
|
78
|
+
|
|
79
|
+
# 換成你的工具:cursor · copilot · gemini · codex · opencode · any
|
|
80
|
+
curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a cursor
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
安裝腳本會把所有框架複製到 `.investskill/prompts/`,並接上該工具自己的入口設定:
|
|
84
|
+
|
|
85
|
+
| `-a` | 工具 | 安裝位置 |
|
|
86
|
+
|------|------|----------|
|
|
87
|
+
| `claude` | Claude Code | `.claude/skills/<skill>/SKILL.md`(斜線指令) |
|
|
88
|
+
| `cursor` | Cursor | `.cursor/rules/investskill.mdc` |
|
|
89
|
+
| `copilot` | GitHub Copilot | `.github/copilot-instructions.md` |
|
|
90
|
+
| `gemini` | Gemini CLI | `GEMINI.md` |
|
|
91
|
+
| `codex` | Codex | `AGENTS.md` |
|
|
92
|
+
| `opencode` | OpenCode | `AGENTS.md` |
|
|
93
|
+
| `any` | ChatGPT、Claude.ai、Ollama… | 只安裝 `.investskill/prompts/`,複製貼上即用 |
|
|
94
|
+
|
|
95
|
+
加上 `-g` 可安裝到使用者層級(而非單一專案)、`-d DIR` 指定目錄、`-h` 查看所有選項。既有的指令檔只會**附加**、不會覆蓋,重複執行不會產生重複內容。不想直接 pipe 到 `bash`?先看過腳本:[install.sh](install.sh)。
|
|
96
|
+
|
|
97
|
+
### Claude Code(外掛市集)
|
|
98
|
+
```bash
|
|
99
|
+
claude
|
|
100
|
+
/plugin marketplace add yennanliu/InvestSkill
|
|
101
|
+
/plugin install us-stock-analysis
|
|
102
|
+
/us-stock-analysis:stock-eval AAPL
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### Cursor 或 GitHub Copilot
|
|
106
|
+
```bash
|
|
107
|
+
git clone https://github.com/yennanliu/InvestSkill.git
|
|
108
|
+
cd InvestSkill
|
|
109
|
+
cursor . # 或使用 GitHub Copilot
|
|
110
|
+
@prompts/stock-eval.md 評估蘋果公司
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### Gemini CLI
|
|
114
|
+
```bash
|
|
115
|
+
cd /path/to/InvestSkill
|
|
116
|
+
gemini
|
|
117
|
+
> @prompts/stock-eval.md 評估蘋果公司
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## 💸 無需 API 金鑰,完全免費
|
|
123
|
+
|
|
124
|
+
使用 InvestSkill **完全免費**——沒有任何東西要購買、註冊或設定。
|
|
125
|
+
|
|
126
|
+
| | |
|
|
127
|
+
|---|---|
|
|
128
|
+
| **API 金鑰** | **不需要。** 不用 OpenAI / Anthropic / Alpha Vantage / Polygon 金鑰。這個外掛從不呼叫任何 API——因為它根本沒有可執行的程式碼。 |
|
|
129
|
+
| **訂閱費用** | **不需要。** 沒有付費方案、沒有席次授權、沒有用量計費、不用開帳號。 |
|
|
130
|
+
| **行情資料費** | **不需要。** 不用 Bloomberg、不用付費資料源。AI 讀取公開申報文件與免費來源——或由你自己把數字貼進去。 |
|
|
131
|
+
| **安裝與執行環境** | **不需要。** 每個技能都只是純 markdown 提示詞。本機沒有任何程式在跑,也就不會回傳任何資料。 |
|
|
132
|
+
| **授權** | **MIT。** 可自由使用、分支修改,個人或商業用途皆可。 |
|
|
133
|
+
|
|
134
|
+
**你唯一需要的,是手上已經在用的 AI 助理。** 可以是付費方案(Claude Code、Cursor、Copilot)、免費方案(ChatGPT、Gemini、Claude.ai),也可以是透過 [Ollama](README-ollama.md) 完全離線的本機模型——用後者跑完所有框架,總成本就是 0。
|
|
135
|
+
|
|
136
|
+
> 因為沒有 API,也就沒有任何遙測:InvestSkill 不會看到你的股票代號、你的持股,或你的分析內容。數字實際從何而來,請見[資料與準確性](site/content/DATA-AND-ACCURACY-zh-TW.md)。
|
|
137
|
+
|
|
138
|
+
**自備資料。** 申報文件類技能(`10k-digest`、`financial-report-analyst`、`fact-check`)內建一份無金鑰的 SEC EDGAR 取檔步驟,具工具能力的助理可自行照做。若你的助理無法上網,倉庫另附兩支可選、零相依的腳本替你抓取第一手來源供貼上——`node scripts/fetch-edgar.js AAPL --form 10-K` 把文件存成純文字,`node scripts/fetch-fundamentals.js AAPL` 從 SEC 的 XBRL 數據產生已對帳的財報資料包。兩者都不屬於外掛本體。詳見[資料與準確性](site/content/DATA-AND-ACCURACY-zh-TW.md#自備資料無金鑰的-edgar-路徑)頁。
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
## 🏆 核心功能
|
|
143
|
+
|
|
144
|
+
<table>
|
|
145
|
+
<tr>
|
|
146
|
+
<td width="50%">
|
|
147
|
+
|
|
148
|
+
### 📊 估值與分析
|
|
149
|
+
- **股票估值** — DCF + 比較公司法 + EV 倍數
|
|
150
|
+
- **基本面分析** — 深入財務報表分析
|
|
151
|
+
- **技術分析** — MA均線圖 (30/60/90/200/365日) + 具體進場/目標/停損建議,圖表形態、RSI/MACD、多時框對齊
|
|
152
|
+
- **DCF 建模** — 情境式內在價值估算
|
|
153
|
+
- **競爭護城河** — 波特五力分析
|
|
154
|
+
|
|
155
|
+
</td>
|
|
156
|
+
<td width="50%">
|
|
157
|
+
|
|
158
|
+
### 💰 專項分析
|
|
159
|
+
- **股息分析** — 安全評分與殖利率陷阱識別
|
|
160
|
+
- **選擇權分析** — Greeks、隱含波動率與策略
|
|
161
|
+
- **放空興趣** — 軋空潛力評估
|
|
162
|
+
- **內部人交易** — SEC Form 4 追蹤
|
|
163
|
+
- **財報電話會議** — 情緒與語調分析
|
|
164
|
+
|
|
165
|
+
</td>
|
|
166
|
+
</tr>
|
|
167
|
+
<tr>
|
|
168
|
+
<td width="50%">
|
|
169
|
+
|
|
170
|
+
### 📈 市場情報
|
|
171
|
+
- **機構持股** — 13F 申報追蹤
|
|
172
|
+
- **產業輪動** — 市場定位分析
|
|
173
|
+
- **經濟分析** — 總體經濟指標
|
|
174
|
+
- **投資組合檢視** — 配置優化建議
|
|
175
|
+
- **報告生成** — 專業 HTML/PDF 報告
|
|
176
|
+
|
|
177
|
+
</td>
|
|
178
|
+
<td width="50%">
|
|
179
|
+
|
|
180
|
+
### 🔗 進階功能
|
|
181
|
+
- **研究套組** — 串接所有框架
|
|
182
|
+
- **財務報告** — 10-K/10-Q 分析
|
|
183
|
+
- **多股比較** — 並排分析
|
|
184
|
+
- **批次分析** — 處理整個投資組合
|
|
185
|
+
- **情境測試** — 多頭/基本/空頭情境
|
|
186
|
+
|
|
187
|
+
</td>
|
|
188
|
+
</tr>
|
|
189
|
+
</table>
|
|
190
|
+
|
|
191
|
+
---
|
|
192
|
+
|
|
193
|
+
## 📋 30 個框架總覽
|
|
194
|
+
|
|
195
|
+
| 類別 | 框架 | 用途 |
|
|
196
|
+
|------|------|------|
|
|
197
|
+
| **核心分析** (4) | stock-eval · technical-analysis · economics-analysis · stock-valuation | 全方位股票評估 |
|
|
198
|
+
| **財務報告** (3) | financial-report-analyst · 10k-digest · earnings-call-analysis | 深度文件分析 |
|
|
199
|
+
| **市場監控** (4) | insider-trading · institutional-ownership · dividend-analysis · short-interest | 活動與情緒追蹤 |
|
|
200
|
+
| **進階分析** (14) | competitor-analysis · **industry-map** · options-analysis · portfolio-review · sector-analysis · **stock-screener** · **catalyst-calendar** · **bear-case** · **position-ladder** · **thesis-tracker** · **etf-analysis** · **earnings-preview** · **tax-lens** · **risk-stress-test** | 專項研究角度 |
|
|
201
|
+
| **元技能與輸出** (5 + 1 輸出工具) | full-report · chart-master · result-validator · **fact-check** · **learning-coach** · report-generator(輸出工具,不計入框架) | 自動化與綜合輸出 |
|
|
202
|
+
| **別名** (3,不計入框架) | fundamental-analysis → stock-eval · dcf-valuation → stock-valuation · research-bundle → full-report | 舊名稱仍可用,會轉址到吸收它的技能 |
|
|
203
|
+
|
|
204
|
+
> **v1.12.0 新功能:**
|
|
205
|
+
> - **無金鑰的 SEC EDGAR 取檔路徑** — `10k-digest`、`financial-report-analyst`、`fact-check` 內建具工具能力的助理可自行照做的取檔步驟(代號 → CIK → 申報索引 → 文件本體 → XBRL 數據);助理無法上網時,兩支可選、零相依的腳本 `scripts/fetch-edgar.js`(申報文件存成純文字)與 `scripts/fetch-fundamentals.js`(由 XBRL 產生已對帳的財報資料包)替你抓第一手來源供貼上。不屬於外掛本體、離線測試涵蓋
|
|
206
|
+
> - `install.sh` — 一行 `curl` 指令把全部框架安裝到任何 AI 代理(Claude Code、Cursor、Copilot、Gemini CLI、Codex、OpenCode 或任何 LLM);文件網站全面改版;學習專區新增第二部(第 9–13 課與「答案是不」案例)
|
|
207
|
+
> - `fact-check`(事實查核)— 對任何報告做**逐條陳述層級**的查核:抽出每個數字與事實陳述、逐一對照第一手來源(SEC 申報、IR 新聞稿、FRED、發行商資料或你貼上的文件)、重算衍生數字,標示 ✅ 已查核/⚠️ 不符/❓ 無法查核/🕒 過時,並重新產出**附行內引用與參考文獻章節**的修正版報告;查核分數 0–10 供 `result-validator` 的資料品質維度使用。絕不捏造來源
|
|
208
|
+
> - `etf-analysis`(ETF 分析)— ETF/指數基金盡職調查:費用率 vs. 同類、追蹤差異、流動性、持股集中度與傾斜、與你其他持股的重疊 %、配息與資本利得分配紀錄、結構警示(槓桿/反向/合成/ETN),以及「買 ETF vs. 直接買前五大成分股」比較;產出 ETF 適配分數 0–10
|
|
209
|
+
> - `earnings-preview`(財報前瞻)— 財報**前**的技能:共識 vs. 耳語、過去 8 季超預期比率與財報後漲跌、選擇權隱含波動 vs. 實際波動、目前股價已反映什麼、要看的 KPI,以及三情境矩陣(超預期且上修/超預期但下修/未達預期)與每個情境的部位規則
|
|
210
|
+
> - `tax-lens`(稅務視角)— 美國稅務機制:短期 vs. 長期、洗售窗口檢查、合格股息持有期間測試、批次選擇、稅損收割配對、帳戶配置、年度稅務拖累估計;`--non-us` 模組涵蓋 W-8BEN、30% 預扣稅(或協定稅率;台灣無協定)、非居民資本利得的一般處理、6 萬美元以上美國境內資產的遺產稅曝險、愛爾蘭 UCITS 替代方案。僅供教育,非稅務建議
|
|
211
|
+
> - `risk-stress-test`(風險壓力測試)— 貝他加權曝險、歷史情境重演(2008、2020 年 3 月、2022 升息、2025 關稅)、95/99% VaR 與 CVaR、最大回撤估計、相關性飆升情境、利率/美元/油價敏感度、流動性(以 20% 日均量出清所需天數);風險預算分數 0–10
|
|
212
|
+
> - `learning-coach`(學習教練)— 把任何 InvestSkill 輸出當成教材:每個指標的白話意義、為何重要、好壞區間、對應課程,接著 3–5 個蘇格拉底式問題與「什麼會改變你的看法?」;`--level`、`--lang zh-TW`、`--quiz <課程>` 模式
|
|
213
|
+
> - `thesis-tracker`(論點追蹤)— 把一份分析變成「與未來自己的契約」:一段可被證偽的論點、3–5 個附門檻的 KPI、失效觸發條件(從各技能的「論點失效條件」與 `bear-case` 的論點反證匯入)、催化劑日期、事前驗屍與決策日誌,存成 `output/thesis/<TICKER>.md`;`--update` 以新資料重新檢查並回傳 **INTACT / WEAKENED / BROKEN** 與具體改變的那一行
|
|
214
|
+
> - `fundamental-analysis`、`dcf-valuation`、`research-bundle` 重新歸類為**別名**(轉址存根):仍可安裝與使用,但不再計入框架數(當時的組成:24 框架 + 3 別名 + 1 輸出工具)
|
|
215
|
+
> - 每個分析技能都必須輸出 `Data & Sources` 表頭、資料驗證關卡與論點失效條件,由 `scripts/check-skill-contract.js` 在 `npm test` 中強制執行
|
|
216
|
+
>
|
|
217
|
+
> **v1.11.0 新功能:**
|
|
218
|
+
> - `position-ladder`(分批建倉與降成本)— 單一持股的執行計畫:先控倉(設定持股下限/上限與集中度上限),再分批布局(依 ATR/百分比/支撐位設定加碼階梯),並在股價高於平均成本時賣出成本最高的批次、低於平均成本時再買回,於區間內循環降低整體成本。內含稅務批次選擇(FIFO vs. 指定批次)、洗售規則(wash sale)警示、總報酬 vs. 買進持有的誠實對照,以及「論點破損就停止加碼」的出場閘門
|
|
219
|
+
>
|
|
220
|
+
> **v1.10.0 新功能:**
|
|
221
|
+
> - `industry-map`(產業地圖)— 以有向圖繪製產業供應/價值鏈(上游→下游):定位公司所處環節、找出瓶頸卡位(收費站)與利潤池、預判價值移轉方向,並產出各層級的二階投資點子
|
|
222
|
+
>
|
|
223
|
+
> **v1.9.0 新功能:**
|
|
224
|
+
> - `bear-case`(空頭觀點)— 刻意單邊的放空者紅隊分析:建構最強空頭論點、會計紅旗、下檔目標價與「論點反證」,為任何多頭論點提供反面證據
|
|
225
|
+
>
|
|
226
|
+
> **v1.8.1 新功能:**
|
|
227
|
+
> - `10k-digest`(10-K 摘要)— 深度解析年報並輸出結構化 Markdown 文件,包含摘要、各節重點、關鍵指標表與來源引用,支援英文 / 繁體中文輸出
|
|
228
|
+
>
|
|
229
|
+
> **v1.8.0 新功能:**
|
|
230
|
+
> - `stock-screener`(股票篩選器)— 跨估值、品質、動能、情緒、成長五個維度對多支股票進行排名篩選,輸出排行榜、精選名單與迴避名單
|
|
231
|
+
> - `catalyst-calendar`(催化劑日曆)— 未來 90 天事件日曆:財報、總經事件、公司特定催化劑、影響力評分、事件驅動策略建議
|
|
232
|
+
>
|
|
233
|
+
> **v1.8.0 合併整合(減少重複):**
|
|
234
|
+
> - `dcf-valuation` 合併至 `stock-valuation` — stock-valuation 現為包含完整 DCF 的超集版本;dcf-valuation 轉為精簡導引
|
|
235
|
+
> - `fundamental-analysis` 合併至 `stock-eval` — stock-eval 吸收深度財務報表分析;fundamental-analysis 轉為精簡導引
|
|
236
|
+
> - `research-bundle` 統一至 `full-report` — full-report 新增 --depth quick/standard/comprehensive 旗標
|
|
237
|
+
|
|
238
|
+
---
|
|
239
|
+
|
|
240
|
+
## 💡 實際應用場景
|
|
241
|
+
|
|
242
|
+
<details open>
|
|
243
|
+
<summary><b>📍 收購目標盡職調查</b></summary>
|
|
244
|
+
|
|
245
|
+
```bash
|
|
246
|
+
/us-stock-analysis:stock-eval TARGET
|
|
247
|
+
/us-stock-analysis:financial-report-analyst TARGET 10-K
|
|
248
|
+
/us-stock-analysis:competitor-analysis TARGET --peers COMPETITORS
|
|
249
|
+
/us-stock-analysis:stock-valuation TARGET --methods all
|
|
250
|
+
→ 數分鐘內完成機構級估值報告
|
|
251
|
+
```
|
|
252
|
+
</details>
|
|
253
|
+
|
|
254
|
+
<details>
|
|
255
|
+
<summary><b>💼 投資組合再平衡決策</b></summary>
|
|
256
|
+
|
|
257
|
+
```bash
|
|
258
|
+
/us-stock-analysis:portfolio-review
|
|
259
|
+
[貼上您的持股]
|
|
260
|
+
→ 配置分析與優化建議
|
|
261
|
+
```
|
|
262
|
+
</details>
|
|
263
|
+
|
|
264
|
+
<details>
|
|
265
|
+
<summary><b>🔍 深度財報分析</b></summary>
|
|
266
|
+
|
|
267
|
+
```bash
|
|
268
|
+
/us-stock-analysis:stock-eval TICKER --visual
|
|
269
|
+
/us-stock-analysis:earnings-call-analysis TICKER
|
|
270
|
+
[貼上電話會議記錄]
|
|
271
|
+
→ 管理層語調、業績指引、風險與機會
|
|
272
|
+
```
|
|
273
|
+
</details>
|
|
274
|
+
|
|
275
|
+
<details>
|
|
276
|
+
<summary><b>📈 選擇權進場規劃</b></summary>
|
|
277
|
+
|
|
278
|
+
```bash
|
|
279
|
+
/us-stock-analysis:technical-analysis TICKER --chart
|
|
280
|
+
/us-stock-analysis:options-analysis TICKER --earnings
|
|
281
|
+
→ 技術面設置 + 波動率預期 → 策略選擇
|
|
282
|
+
```
|
|
283
|
+
</details>
|
|
284
|
+
|
|
285
|
+
---
|
|
286
|
+
|
|
287
|
+
## 🎓 學習這些框架
|
|
288
|
+
|
|
289
|
+
投資新手,或不確定該用哪個技能?從這裡開始:
|
|
290
|
+
|
|
291
|
+
| 指南 | 提供什麼 |
|
|
292
|
+
|------|---------|
|
|
293
|
+
| [概念](site/content/CONCEPTS-zh-TW.md) | 指標背後的思維模型——品質 vs. 價值 vs. 成長、內在價值、護城河、風險與訊號區塊 |
|
|
294
|
+
| [術語表](site/content/GLOSSARY-zh-TW.md) | 各技能所產出每個指標的白話定義、公式與好/壞區間 |
|
|
295
|
+
| [選擇技能](site/content/CHOOSE-A-SKILL-zh-TW.md) | 把你的目標對應到合適的框架,並比較功能重疊的技能 |
|
|
296
|
+
| [使用情境](site/content/USE-CASES-zh-TW.md) | 依投資人類型的端到端旅程——收息、新手、財報、總經、懷疑者 |
|
|
297
|
+
| [資料與準確性](site/content/DATA-AND-ACCURACY-zh-TW.md) | 數字從何而來、如何辨識幻覺,以及如何驗證產出 |
|
|
298
|
+
|
|
299
|
+
---
|
|
300
|
+
|
|
301
|
+
## 🛠️ 安裝方式
|
|
302
|
+
|
|
303
|
+
### curl 一行安裝(所有工具通用)
|
|
304
|
+
|
|
305
|
+
```bash
|
|
306
|
+
curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a AGENT
|
|
307
|
+
# AGENT = claude | cursor | copilot | gemini | codex | opencode | any
|
|
308
|
+
curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -l # 查看各工具安裝位置
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
詳細對照表見上方[快速開始](#-快速開始30-秒)。
|
|
312
|
+
|
|
313
|
+
### Claude Code(一般使用者推薦)
|
|
314
|
+
|
|
315
|
+
```bash
|
|
316
|
+
claude
|
|
317
|
+
/plugin marketplace add yennanliu/InvestSkill
|
|
318
|
+
/plugin install us-stock-analysis
|
|
319
|
+
/plugin list # 確認安裝
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
**驗證安裝:**
|
|
323
|
+
```bash
|
|
324
|
+
node scripts/setup-verify.js
|
|
325
|
+
```
|
|
326
|
+
|
|
327
|
+
### Cursor IDE(自動載入)
|
|
328
|
+
|
|
329
|
+
```bash
|
|
330
|
+
git clone https://github.com/yennanliu/InvestSkill.git
|
|
331
|
+
cd InvestSkill
|
|
332
|
+
cursor .
|
|
333
|
+
# 在 AI Chat(Cmd+K)中規則會自動載入
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
### Gemini CLI(自動載入)
|
|
337
|
+
|
|
338
|
+
```bash
|
|
339
|
+
cd /path/to/InvestSkill
|
|
340
|
+
gemini
|
|
341
|
+
# GEMINI.md 自動載入
|
|
342
|
+
# 所有提示詞可透過 @prompts/ 使用
|
|
343
|
+
```
|
|
344
|
+
|
|
345
|
+
### GitHub Copilot(自動載入)
|
|
346
|
+
|
|
347
|
+
在 **VS Code** 或 **JetBrains IDE** 中開啟儲存庫
|
|
348
|
+
Copilot 會自動載入 `.github/copilot-instructions.md`
|
|
349
|
+
|
|
350
|
+
### 通用存取(任何 AI)
|
|
351
|
+
|
|
352
|
+
1. 複製提示詞:`cat prompts/stock-valuation.md | pbcopy`
|
|
353
|
+
2. 貼入 ChatGPT、Claude.ai 或任何大型語言模型
|
|
354
|
+
3. 提問分析
|
|
355
|
+
|
|
356
|
+
---
|
|
357
|
+
|
|
358
|
+
## 🎓 範例工作流程
|
|
359
|
+
|
|
360
|
+
### 工作流程 1:快速股票篩選
|
|
361
|
+
```bash
|
|
362
|
+
# 5 分鐘評估
|
|
363
|
+
/stock-eval NVDA
|
|
364
|
+
/stock-eval AMD
|
|
365
|
+
/stock-eval QCOM
|
|
366
|
+
→ Piotroski 評分、ROIC、風險矩陣,快速決策
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
### 工作流程 2:完整盡職調查
|
|
370
|
+
```bash
|
|
371
|
+
# 完整機構級分析
|
|
372
|
+
/stock-eval AAPL --visual
|
|
373
|
+
/technical-analysis AAPL --chart
|
|
374
|
+
/stock-valuation AAPL --methods all
|
|
375
|
+
/competitor-analysis AAPL --moat
|
|
376
|
+
/financial-report-analyst AAPL 10-K
|
|
377
|
+
→ 相當於完整 50 頁分析報告
|
|
378
|
+
```
|
|
379
|
+
|
|
380
|
+
### 工作流程 3:財報季研究
|
|
381
|
+
```bash
|
|
382
|
+
# 30 分鐘財報研究流程
|
|
383
|
+
/stock-eval TICKER --visual # 財報前基準線
|
|
384
|
+
/earnings-call-analysis TICKER [貼上電話會議記錄] # 財報後分析
|
|
385
|
+
/technical-analysis TICKER --chart # 技術面設置
|
|
386
|
+
/options-analysis TICKER --earnings # 波動率預期
|
|
387
|
+
→ 完整財報投資論點
|
|
388
|
+
```
|
|
389
|
+
|
|
390
|
+
### 工作流程 4:投資組合優化
|
|
391
|
+
```bash
|
|
392
|
+
/portfolio-review [貼上您的持股]
|
|
393
|
+
→ 配置分析 + 再平衡建議
|
|
394
|
+
```
|
|
395
|
+
|
|
396
|
+
---
|
|
397
|
+
|
|
398
|
+
## ✨ InvestSkill 的差異化優勢
|
|
399
|
+
|
|
400
|
+
| 功能 | InvestSkill | 通用 AI |
|
|
401
|
+
|------|------------|---------|
|
|
402
|
+
| **30 個精選框架** | ✅ 內建 | ❌ 需手動設定 |
|
|
403
|
+
| **信號區塊** | ✅ 標準化格式 | ❌ 格式不一致 |
|
|
404
|
+
| **全平台支援** | ✅ 原生支援 | ❌ 需要變通方案 |
|
|
405
|
+
| **零 API 費用** | ✅ 免費 | ❌ 需付費 API |
|
|
406
|
+
| **離線提示詞** | ✅ 全部內建 | ❌ 依賴外部連結 |
|
|
407
|
+
| **專業品質** | ✅ 機構級 | ⚠️ 品質不穩定 |
|
|
408
|
+
| **教育性** | ✅ 教授分析框架 | ❌ 只給答案 |
|
|
409
|
+
|
|
410
|
+
---
|
|
411
|
+
|
|
412
|
+
## 📊 專案狀態
|
|
413
|
+
|
|
414
|
+
**目前版本:** 1.12.0
|
|
415
|
+
**技能框架:** 30 個(另有 3 個別名、1 個輸出工具)
|
|
416
|
+
**通用提示詞:** 34 個
|
|
417
|
+
**支援平台:** 6 個
|
|
418
|
+
**測試:** 全數通過 ✅(結構、提示詞同步、技能契約、數量一致性、安裝腳本)
|
|
419
|
+
|
|
420
|
+
---
|
|
421
|
+
|
|
422
|
+
## 🤝 貢獻
|
|
423
|
+
|
|
424
|
+
### 添加新技能
|
|
425
|
+
|
|
426
|
+
詳見 [**ADDING-NEW-SKILLS.md**](ADDING-NEW-SKILLS.md) 完整指南:
|
|
427
|
+
- 12 步驟說明
|
|
428
|
+
- 檔案結構範本
|
|
429
|
+
- 平台同步檢查清單
|
|
430
|
+
- 測試程序
|
|
431
|
+
|
|
432
|
+
### 回報問題
|
|
433
|
+
|
|
434
|
+
發現錯誤?請[開啟 Issue](https://github.com/yennanliu/InvestSkill/issues) 並附上:
|
|
435
|
+
- 平台與版本
|
|
436
|
+
- 重現步驟
|
|
437
|
+
- 預期與實際行為
|
|
438
|
+
|
|
439
|
+
---
|
|
440
|
+
|
|
441
|
+
## ⚖️ 法律聲明
|
|
442
|
+
|
|
443
|
+
**僅供教育用途。** InvestSkill 提供分析框架,用於學習與研究目的。
|
|
444
|
+
|
|
445
|
+
> 本工具包**不構成**財務建議。請務必:
|
|
446
|
+
> - 諮詢合格的財務顧問
|
|
447
|
+
> - 自行研究(DYOR)
|
|
448
|
+
> - 獨立驗證分析結果
|
|
449
|
+
> - 考量個人風險承受度
|
|
450
|
+
|
|
451
|
+
**過去績效不代表未來結果**
|
|
452
|
+
|
|
453
|
+
---
|
|
454
|
+
|
|
455
|
+
<div align="center">
|
|
456
|
+
|
|
457
|
+
### 為投資研究社群用心製作
|
|
458
|
+
|
|
459
|
+
**[GitHub](https://github.com/yennanliu/InvestSkill)** • **[網站](https://yennanliu.github.io/InvestSkill/)** • **[回報問題](https://github.com/yennanliu/InvestSkill/issues)** • **[社群討論](https://github.com/yennanliu/InvestSkill/discussions)**
|
|
460
|
+
|
|
461
|
+
</div>
|