Veblin invest-skills（A股投研技能集入口）
本包是 6 个投研技能的 bundle：共用一个 Python 数据引擎，子技能是流程指令 + 引擎命令。
子技能路由表
| 用户意图（触发词） | 先 Read 的文件 | 说明 |
|---|---|---|
| 个股投研 / 估值 / 财报 | skills/invest-a-stock/SKILL.md |
九模块研究备忘录 |
| ETF / 指数基金 | skills/invest-a-etf/SKILL.md |
指数估值/折溢价/跟踪质量 |
| 交易日志 / 买入评估 / 卖出评估 | skills/invest-a-journal/SKILL.md |
四维评估 + 落库 |
| 市场情绪 / 大盘 / 市场脉搏 | skills/invest-a-pulse/SKILL.md |
五维情绪 + 环境标签 |
| 缺口扫描 / 跳空扫描 | skills/invest-a-gap-scan/SKILL.md |
成分股池缺口扫描 |
| 双底 / 形态扫描 / 三角形底 / 底部形态 | skills/invest-a-pattern-scan/SKILL.md |
LMW 双底/三角形底 |
执行约定：识别意图后，先 Read 对应子技能 SKILL.md 并完整遵循其 SOP；子技能引用的 references/ 在其各自目录或 skills/lib/references/ 下。
环境约定（重要）
本包内子技能命令统一形如：
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/<子技能>/scripts/xxx.py ...
执行时把 ${INVEST_SKILLS_ROOT:-.} 解析为包根（含 skills/ 与 pyproject.toml 的目录），按优先级：
- 环境变量
INVEST_SKILLS_ROOT已设置 → 用它； - 否则
~/.config/investment/install_root存在 → 用其文件内容（bootstrap 会写入）； - 否则当前目录下直接可见
skills/与pyproject.toml（已在包根）→ 用.。
三种都不满足时：先运行 step 0 自检，或询问用户包根位置。
Step 0 — 首次使用：环境自检（每个新会话先跑一次）
运行（install_root 不存在而你已定位包根时，用包根绝对路径替换 $(...) 部分）：
bash "$(cat ~/.config/investment/install_root 2>/dev/null || echo .)/scripts/bootstrap.sh"
- 缺 uv（Python 包管理器）→ bootstrap 给出 1 条安装命令；macOS 加
--install参数可代装 - 缺 token → 不阻塞：akshare 免费数据源可用；进阶 token（TUSHARE/FRED 等）见 README-安装.md，用户可在对话中直接提供 token，由你代写
~/.config/investment/.env（权限 600，9 个 key 清单见docs/workbuddy/env-template.md的仓库版） - 自检通过后按路由表执行子技能
输出位置
- 个股/ETF 报告：包根
reports/{symbol}-{name}/（时间戳命名） - 交易日志 / 情绪 / 扫描报告：
reports/journal/、reports/pulse/、reports/gap-scan/ - 采集数据缓存：
~/.local/share/investment/（引擎自动管理，勿手动改）
边界
研究工具，非决策工具：不提供买卖/仓位建议；所有数字带来源标注；多情景估值仅供学习参考，不构成投资建议。