OpenMobius-skill

OpenMobius-skill 代码分析报告

1. 项目定位与价值

OpenMobius-skill 是 MobiusQuant 公司出品的 AI Coding Agent 技能插件，核心理念是为 AI Agent 注入专业交易知识，让 AI 在回答 ICT/SMC（Inner Circle Trader / Smart Money Concepts）交易问题时不再胡说八道。每个答案必须基于知识库规则或实时市场数据，禁止凭空捏造价格和结构。

2. 技术架构

整体定位：非 Web 应用，是 SKILL.md 标准的 AI Agent 插件包。

OpenMobius-skill/
├── SKILL.md              # LLM 读取的主入口（YAML frontmatter + 工作流路由）
├── SKILL.body.md         # 跨平台共享内容
├── platforms/            # 四个平台的前置配置（claude-code/codex/openclaw/hermes）
├── workflows/             # 4 个子工作流
│   ├── qna.md            # 概念问答（向量检索 → 知识卡 → 生成答案）
│   ├── analyze.md        # 图表分析（实时 OHLCV → 结构提取 → 5段分析）
│   ├── annotate.md       # 图表标注（PIL 叠加图层）
│   └── klines.md         # K线数据获取（API → 指标计算 → 结构识别）
├── scripts/              # 核心 CLI 工具
│   ├── kb_retrieve.py    # ChromaDB 向量检索
│   ├── kb_klines.py      # 市场数据 API 客户端
│   ├── kb_draw_annotation.py  # PIL 图表标注
│   ├── kb_phase_b_to_c.py     # 结构化分析 → 标注 PNG
│   ├── build_index.py    # 向量索引构建
│   ├── kb_doctor.py      # 环境健康检查
│   └── chart_render/     # Playwright + lightweight-charts 渲染引擎
├── knowledge_base/       # 726 概念卡 + 1282 案例卡（ChromaDB）
└── install.py            # 跨平台安装器

3. 核心依赖

依赖	版本	用途
chromadb	≥0.5	本地向量数据库，存储 2008 张知识卡 embedding
sentence-transformers	≥3.0	加载 `nomic-embed-text-v1.5` embedding 模型
playwright	≥1.40	无头 Chromium，渲染 K 线图表
Pillow	≥10	PIL 图片处理，图表标注叠加
numpy	≥1.24	数值计算
openai	≥1.50	可选，远程 OpenAI 兼容 API 做 embedding

4. AI 框架使用

本项目本身是一个 AI Agent 插件，不内置 LLM 调用能力。安装后作为 AI Coding Agent（Claude Code / Codex 等）的技能扩展。其 SKILL.md 描述了 Agent 应如何调用内部脚本（kb_retrieve.py、kb_klines.py 等），本质上是把 AI Coding Agent 的工具集扩展到交易领域。

ai_framework_used：SKILL.md agent framework（技能插件框架，非独立 AI 框架）

5. 代码质量评估

维度	评分	说明
工程完整性	⭐⭐⭐⭐	覆盖安装/卸载/更新/诊断全生命周期，文档完善
代码规范	⭐⭐⭐⭐	Python 为主，结构清晰，有测试目录
知识库质量	⭐⭐⭐⭐⭐	726 概念 + 1282 案例，来源可追溯，持续迭代
平台兼容性	⭐⭐⭐⭐⭐	同时支持 4 个主流 AI Coding Agent 平台
部署复杂度	⭐⭐	无容器化，依赖手动安装（Python 3.10+），首次 5-10 分钟
依赖重量	⭐⭐	Playwright + Chromium（~280MB）+ embedding 模型（~274MB）

综合评分：8/10

6. 增量维护分析

更新频率：近期活跃（pushed 2026-08-24），持续迭代
文档完善度：README + README.zh + README_AGENT + INSTALL + CHANGELOG，体系完整
归因清晰：ATTRIBUTION.md 列出所有第三方依赖许可证，合规性好
许可证：Apache 2.0，商业友好

7. 局限性

极窄用户群：必须同时满足使用 AI Coding Agent + 做 ICT/SMC 交易，全球用户可能仅数千
首次安装重：Playwright Chromium + embedding 模型合计 ~550MB
强外部依赖：市场数据依赖 api.mobiusquant.ai（自建商业 API），非完全离线可用
许可存疑：README 声明 Apache 2.0，但 GitHub API 返回 license: null，LICENSE 文件不存在——建议项目方补充 LICENSE 文件以消除歧义

8. 总结

OpenMobius-skill 是 AI 交易垂直领域的一个高质量作品，体现了将专业知识转化为 AI Agent 可用技能的产品思路。其价值不在于代码量，而在于 2008 张知识卡的专业深度和对多 Agent 平台的广泛覆盖。适合作为 AI Coding Agent 生态中"交易专家"角色的代表项目入库。