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. 核心依赖

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. 代码质量评估

综合评分：8/10

6. 增量维护分析

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

7. 局限性

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

8. 总结

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