docs: rewrite roadmap — drop skill/workflow stacking, pivot to demo-driven + MCP ecosystem

- Remove Phase 2 (workflow engine, skill dependency graph, context-aware selection)
- New Phase 2: experience-driven — killer demos, frontend polish, zero onboarding friction
- New Phase 3: MCP ecosystem — become the best finance plugin for Claude/Cursor
- Phase 4 (academic) demoted to optional, data-dependent
- Update community-growth-plan timeline to align
- Delete obsolete Phase 1 planning docs (data-source-expansion, backtest-upgrade)

Author: warren618

docs/community-growth-plan.md

@@ -200,11 +200,11 @@
 
 | 时间 | 行动 |
 |------|------|
-| 本周 | ~~CONTRIBUTING.md + Issue/PR 模板 + 10 个 good first issues~~ ✅ done (5 hard issues, 待补入门级) |
-| 第 2 周 | Twitter 账号开始运营 + Reddit/HN 首发帖 |
-| 第 3-4 周 | 发布 v0.2.0 + 配套 Twitter thread + 教程文章 #1 |
-| 第 2 个月 | 稳定每周 3 条 Twitter + 处理社区 PR + 教程 #2-3 |
-| 第 3 个月 | 评估数据 + 调整策略 + 开始培养 Active Contributor |
+| 本周 | ✅ done — GitHub 基建（CONTRIBUTING + Issue/PR 模板 + 13 个分层 issue） |
+| 4 月下旬 | 杀手 demo 素材制作 + `vibe-trading init` + README 重写 |
+| 5 月上旬 | 前端报告页面打磨 + Twitter/Reddit/HN 首发 |
+| 5 月 | 稳定每周 3 条 Twitter + 教程 #1-2 + 处理社区 PR |
+| 6 月 | MCP server 打磨 + 多客户端适配 + 评估数据 |
 
 ---
 

docs/roadmap.md

@@ -0,0 +1,168 @@
+# Vibe-Trading Roadmap
+
+> 最后更新: 2026-04-11
+
+## 当前状态
+
+### 做到了什么
+- 68 skills / 21 tools / 29 swarm presets / 5 data sources with fallback
+- 自然语言 → 策略代码 → 回测 → 报告全链路
+- CLI + Web UI + MCP 三端覆盖
+- 跨市场（A股/美股/港股/加密/期货/外汇）零配置取数
+- 236 单元测试 + CI
+- 社区基建完成（CONTRIBUTING.md / Issue 模板 / PR 模板 / 13 个分层 issue）
+
+### 核心差异化（别人没有的）
+
+1. **自然语言 → 可执行策略的全自动链路** — FinRL/OpenBB/QuantConnect 都没有
+2. **跨市场统一接口** — 一句话切换 A股/美股/加密，不用换 API
+3. **29 种 swarm 团队组织形式** — 竞品最多 3-5 种
+
+### 诚实评估：什么不 work
+
+- 68 个 skill 本质是 prompt 模板堆砌，数量 ≠ 价值
+- 更多 skill / 更多 workflow 编排不会让产品变好
+- 用户不在乎你有多少 skill，在乎"问了一个问题，得到有用的结果"
+- 纯 agent + skills 堆砌很难在开源社区引起关注
+
+---
+
+## Phase 1: 地基加固 — ✅ DONE
+
+| 任务 | 状态 |
+|------|------|
+| 数据源 fallback chain（5 源 + 自动降级） | ✅ |
+| Skill 分类（7 类 + data-routing 元技能） | ✅ |
+| Web search tool（DuckDuckGo） | ✅ |
+| 补齐测试（236 单元测试 + CI pytest） | ✅ |
+| 社区基建（CONTRIBUTING + Issue/PR 模板 + 13 issues） | ✅ |
+| Backtest Wave 2: 多资产引擎 | ✅ |
+| Backtest Wave 3: 统计验证（Monte Carlo / Bootstrap / Walk-Forward） | ✅ |
+| 社区反馈 P0 修复（性能/ML bug/多 provider） | ✅ |
+
+---
+
+## Phase 2: 体验驱动 — 做"金融 bolt.new"
+
+> 不加新功能，把现有能力包装成极致的用户体验和传播素材。
+
+核心逻辑：**一句话进去，一份完整研究报告出来**——带图表、带回测曲线、带风险分析。
+
+### 2.1 前端体验打磨
+
+- [ ] 研究报告页面重设计：策略摘要 + 收益曲线 + 风险指标 + benchmark 对比，一页看完
+- [ ] 图表交互升级：收益曲线可 hover、回撤区间高亮、持仓变化时间轴
+- [ ] 一键导出：PDF 研究报告 / PNG 图表 / Pine Script
+- [ ] Swarm dashboard 实时动效：agent 通信可视化，不是干等
+
+### 2.2 上手门槛降到零
+
+- [ ] `vibe-trading init` 交互式 .env 引导（Issue #14）
+- [ ] 在线 demo 页面（无需安装，直接体验核心功能）
+- [ ] README 重写：3 步跑通 + 1 个震撼 GIF，不是功能清单
+
+### 2.3 杀手级 Demo 素材
+
+产出 3-5 个高传播力 demo（Twitter/Reddit/HN 首发素材）：
+
+1. **"I asked AI to backtest Buffett's strategy"** — 经典策略自然语言回测
+2. **"Investment committee of 5 AI agents debating Tesla"** — swarm 实时对话可视化
+3. **"One prompt, six markets"** — 同一句话在 A股/美股/加密跑出对比结果
+4. **"Vibe-Trading vs 200 lines of Python"** — 自然语言 vs 手写代码效率对比
+5. **"MCP: Use Vibe-Trading inside Claude Desktop"** — MCP 集成演示
+
+### 2.4 社区传播（配合 community-growth-plan.md）
+
+- [ ] Twitter/X 首发 + Reddit r/algotrading + HN Show HN
+- [ ] 教程系列：5 分钟入门 / Swarm 投资委员会 / MCP 接入 Claude Desktop
+
+---
+
+## Phase 3: MCP 生态入口 — 做金融 Copilot
+
+> 不做独立产品竞争，做 Claude Desktop / Cursor 的最佳金融插件。
+
+核心逻辑：用户在现有 AI 工具里 `@vibe-trading` 就能查行情、跑回测、做分析。借 MCP 生态的势获客。
+
+### 3.1 MCP Server 打磨
+
+- [ ] 安装体验：一行命令（`npx vibe-trading-mcp` 或 `uvx vibe-trading-mcp`）
+- [ ] 17 个 tool 精简为高频 10 个，去掉用户不会直接调的内部 tool
+- [ ] 每个 tool 的 description 优化：让 Claude/Cursor 能准确匹配用户意图
+- [ ] 错误处理：返回有用的错误信息，不是 stack trace
+
+### 3.2 多客户端适配
+
+- [ ] Claude Desktop（已有，打磨体验）
+- [ ] Cursor / Windsurf / Cline 测试 + 配置文档
+- [ ] VS Code MCP 插件配置
+
+### 3.3 分发
+
+- [ ] MCP server 注册到 MCP 官方目录
+- [ ] Claude Desktop 推荐列表申请
+- [ ] 独立 npm/PyPI 包发布（`vibe-trading-mcp`）
+
+---
+
+## Phase 4: 学术路线（独立线，按需启动）
+
+> 前提：Phase 2/3 跑出用户数据和社区关注后，再决定是否投入论文。
+
+### 方向：Multi-Agent Organization × Market Adaptation (MAO)
+
+核心问题：不同 agent 团队组织形式在不同市场状态下表现如何？
+
+- **独特资产**：29 个 swarm preset 是别人没有的
+- **实验设计**：29 种架构 × 3 市场 × 5 种市场状态
+- **方法贡献**：Market-Adaptive Organization Router
+- **对标**：FinCon (NeurIPS 2024) 1 种架构，Market-Dependent Communication (NeurIPS 2025) 5 种
+
+### 前置工作（可与 Phase 2/3 并行）
+
+- [ ] Market Regime Detector：自动识别牛/熊/震荡/高波动/黑天鹅
+- [ ] 实验自动化框架：批量跑 29×3×5 实验矩阵
+- [ ] 结构化日志：记录每个 agent 的决策过程
+- [ ] Baseline 对齐：和 TradingAgents / FinCon 在相同数据集上对比
+
+### 目标
+
+AAAI 2027（截止 2026-08-01），但只在 Phase 2/3 有正反馈时才全力投入。
+
+---
+
+## 时间线
+
+| 时间 | 重点 |
+|------|------|
+| 4 月下旬 | Phase 2.2 + 2.3：上手门槛 + 杀手 demo 素材 |
+| 5 月 | Phase 2.1 + 2.4：前端打磨 + 社交媒体首发 |
+| 5-6 月 | Phase 3：MCP server 打磨 + 多客户端 + 分发 |
+| 6-7 月 | 看数据：star/用户/社区活跃度决定下一步 |
+| 7-8 月 | 如果数据好 → Phase 4 论文冲刺；如果不好 → 继续迭代 Phase 2/3 |
+
+---
+
+## 竞品定位
+
+| 项目 | 定位 | 我们的差异 |
+|------|------|-----------|
+| TradingAgents | 多 agent 交易框架 | 他们 3 种 agent，我们 29 种团队组织 |
+| FinRL | RL 量化交易库 | 他们训 RL，我们自然语言驱动 |
+| OpenBB | 金融数据终端 | 他们做数据，我们做全链路（策略→回测→报告） |
+| QuantConnect | 量化平台 | 他们给专业量化，我们零门槛自然语言 |
+
+---
+
+## 长期愿景
+
+```
+当前 (v0.1)            短期 (v0.3)              中期 (v0.5)              长期 (v1.0)
+   ┌──────┐          ┌──────────┐          ┌──────────┐          ┌──────────────┐
+   │ Skill │          │ 极致体验  │          │ MCP 生态  │          │  Autonomous   │
+   │ Pile  │    →     │ + 传播力  │    →     │ 金融插件  │    →     │  Research     │
+   │       │          │          │          │          │          │  Agent        │
+   └──────┘          └──────────┘          └──────────┘          └──────────────┘
+   68 skills          震撼 demo             Claude/Cursor 插件     自主金融研究
+   功能堆砌            一句话→完整报告        借生态获客              假设→验证→迭代
+```