Communitygithub.com

YoungCan-Wang/wyckoff_skill — 威科夫A股分析智能体

支持完整CLI + MCP集成的威科夫A股分析智能体。自动检测本地CLI安装,引导用户完成安装→注册→数据源配置→模型配置→可选MCP服务器的设置流程,随后执行威科夫风格的量价分析并生成可审计的投资组合决策。支持首次使用引导、日常操作工作流(投资组合管理、信号查询、推荐)及用于Claude Code / Cursor集成的14工具MCP服务器。

wyckoff_skill — 威科夫A股分析智能体 是什么?

这是一个面向中国A股市场的威科夫(Wyckoff)分析智能体,专为AI代理(如Claude Code、Cursor、Codex等)设计。它提供两种运行模式:设置模式(仅当预置条件缺失时运行)和分析工作流模式(步骤1-9)。智能体通过检测本地Wyckoff CLI是否安装,自动引导用户完成完整的配置流程:安装Python包、注册并登录账户、配置Tushare或TickFlow数据源、注册AI模型密钥,并可选择注册MCP服务器以实现与Claude Code等AI工具的深度集成。一旦配置完成,用户即可通过CLI命令直接执行投资组合管理、信号查询、市场筛选、回测、报表生成等日常操作。分析引擎遵循严格的威科夫结构分析方法,对当前交易时段(北京时区)、数据的权威性和时序深度进行多重验证,支持多符号、持仓对象、现金及候选股票的综合输入,为每个持仓生成明确的增仓/减仓/持有/退出决策。输出包括格式化中文报告,涉及北京时间、交易状态、数据审计表、威科夫阶段识别及时间+1安全的操作建议。智能体还支持通过CSV或图像输入锚定微观结构证据,并在数据或解析失败时提供优雅降级。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add YoungCan-Wang/wyckoff_skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Wyckoff 交易智能体

本技能以两种模式运行:设置(第0步)和分析(步骤1–9)。第0步仅在缺少预置条件时执行;一旦所有配置就绪,即可直接跳转到分析。

第0步:环境检测与引导设置

按顺序执行以下检查。在首次失败处停止,并引导用户修复后继续。

0.1 CLI 安装检查

运行 wyckoff --version。

  • 成功 → 继续到 0.2。
  • 失败 → 引导安装:
    pip install youngcan-wyckoff-analysis
    
    或一键安装:
    curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bash
    
    安装后,通过 wyckoff --version 验证。

0.2 认证检查

运行 wyckoff auth status。

  • 已登录 → 继续到 0.3。(凭证自动保存;令牌过期会触发自动重新登录。)
  • 未登录 → 引导注册和登录:
    1. 告知用户访问 https://wyckoff-analysis.pages.dev/ 注册账户。
    2. 注册后,运行:wyckoff auth login <邮箱> <密码>(凭证将被持久化,无需再次登录)。
    3. 通过 wyckoff auth status 验证。

0.3 数据源检查

运行 wyckoff config show。

  • tushare_token 存在 → 通过。
  • tushare_token 缺失 → 引导:
    • Tushare 令牌免费获取,注册后从 https://tushare.pro/ 获取。
    • 然后运行:wyckoff config tushare <令牌>
  • tickflow_api_key 存在 → 通过。
  • tickflow_api_key 缺失 → 引导:

注意:至少需要配置一个数据源(tushare 或 tickflow)。建议两者都配置,以获得更好的覆盖。

0.4 模型检查

运行 wyckoff model list。

  • 存在模型 → 继续到步骤1。
  • 无模型 → 引导:wyckoff model add(交互式)或 wyckoff model set <名称> <提供商> <api_key> --model <模型名称>。

0.5 MCP 服务器设置(可选——询问用户)

所有检查通过后,询问用户是否想要将 Wyckoff MCP 服务器注册到其 AI 工具(Claude Code / Cursor 等)。

  • 用户同意 → 引导:

    pip install "youngcan-wyckoff-analysis[mcp]"
    claude mcp add wyckoff -- wyckoff-mcp
    

    注册后,MCP 客户端可以直接调用14个 Wyckoff 工具(diagnose_stock、screen_stocks、get_signal_pending等),无需通过 CLI TUI。

    如果用户使用非 Claude MCP 客户端,引导用户将其添加到 MCP 配置中:

    {
      "mcpServers": {
        "wyckoff": {
          "command": "wyckoff-mcp",
          "env": {
            "TUSHARE_TOKEN": "<来自wyckoff.json的令牌>",
            "TICKFLOW_API_KEY": "<来自wyckoff.json的密钥>"
          }
        }
      }
    }
    

    已保存在 wyckoff.json 中的凭证也会被 MCP 服务器自动读取,因此如果已运行过 wyckoff login + wyckoff config,环境变量是可选的。

  • 用户拒绝/跳过 → 直接进入分析。

当所有检查通过后,打印简短摘要并进入分析。

CLI 操作命令

当用户的意图是操作性的(而非分析),直接路由到相应的 CLI 命令,而非运行分析流水线:

意图命令
查看投资组合wyckoff portfolio list
添加持仓wyckoff portfolio add <代码> <股数> <成本>
移除持仓wyckoff portfolio rm <代码>
设置现金wyckoff portfolio cash <金额>
查看信号wyckoff signal
查看推荐wyckoff recommend
市场筛选wyckoff screen
运行回测wyckoff backtest <代码>
生成报告wyckoff report <代码>
启动仪表盘wyckoff dashboard
查看聊天记录wyckoff log
管理记忆wyckoff memory
同步云端数据wyckoff sync
清理本地数据wyckoff cleanup
更新 CLIwyckoff update
注册 MCP 服务器pip install "youngcan-wyckoff-analysis[mcp]" && claude mcp add wyckoff -- wyckoff-mcp

完整的 CLI 参考,请参见 rules/cli-setup-guide.md。

输入协议

接受任意组合:

  • 股票代码,单个或多个。
  • holdings:[代码+成本+数量, ...]。
  • cash:可用现金金额。
  • candidate:可选的非持仓股票代码。
  • CSV 文件、图片、文本约束/目标。

自动推断场景:

  • holdings 非空 + candidate:轮换比较 + 每个持仓的操作。
  • holdings 非空 + 无 candidate:每个持仓的加仓/减仓/持有/退出。
  • holdings 空 + cash:空仓现金部署。
  • 无投资组合字段:股票分析流程。

不要要求用户明确说出“切换/加仓/减仓/空仓。”

完整能力编排(步骤1–9,必须按顺序)

  1. 解析并标准化输入。

    • 尽可能将股票代码标准化为交易所限定格式。
    • 解析持仓为 {symbol, cost, qty}。
    • 保留原始用户输入以供输出审计。
  2. 首先通过工具/系统获取当前时间。

    • 从工具/系统获取当前时间戳。
    • 转换为 Asia/Shanghai。
    • 打印 当前北京时间:YYYY-MM-DD HH:MM(UTC+8)。
  3. 通过权威日历检查判断交易可用性。

    • 判断工作日和连续竞价时段:09:30-11:30、13:00-15:00(北京时间)。
    • 当存在节假日/调休工作日不确定性时,查询权威交易日历。
    • 如果不可交易,降级为盘后复盘 + 下一交易时段计划 + T+1安全订单策略。
  4. 获取在线数据,支持来源回退。

    • 对于每个代码,严格遵循 rules/source-fallbacks.md。
    • 在接收数据源之前,执行模式(schema)和行数验证。
    • 记录每个代码的回退尝试和最终来源。
  5. 当提供 CSV/图片模态时进行整合。

    • 将 CSV 作为补充的历史结构输入使用,并与获取的数据进行协调。
    • 将图表视为微观结构证据;明确说明接收到图片。
    • 如果某模态失败,继续分析并准确说明失败原因。
  6. 首先运行威科夫结构分析。

    • 分析最新的可用窗口(目标500个交易日),使用 MA50/MA200。
    • 仅识别有证据的阶段/事件(SC/ST/Spring/LPS/SOS/UTAD)。
    • 事件日期新闻搜索仅用于验证上下文,绝不能用作主要交易逻辑。
  7. 结构分析后生成投资组合决策。

    • 对于每个持仓,输出一个明确的操作:增仓 / 减仓 / 持有 / 退出。
    • 如果存在候选股票,与当前结构最弱的持仓进行比较,决定 切换 / 部分切换 / 持有。
    • 如果持仓为空且有现金,输出分阶段现金部署建议。
  8. 仅当交易时段规则允许时渲染图表。

    • 在可交易的盘中时段跳过绘图。
    • 当允许绘图时,强制执行 rules/alpha-system-prompt.md 中的所有约束。
  9. 应用能力降级策略。

    • 绝不虚构 OHLCV 行、事件时间戳或交易状态。
    • 如果某股票的所有数据源都失败,标记为 data_unavailable 并继续其他股票。
    • 如果有效行数 < 30,报告 insufficient structure depth 并避免硬性的阶段标签。
    • 如果图片解析失败,解释原因并继续 CSV/文本/在线路径。

有关详细的能力路由策略,请阅读 rules/system-capability-playbook.md。

固定输出契约

始终按以下顺序输出:

  1. 当前北京时间:YYYY-MM-DD HH:MM(UTC+8)
  2. 交易裁定:当前是否可盘中交易:是/否(如果为否,附上理由)。
  3. 每个股票的数据审计表:symbol、source_used、rows_kept、window_end_date、fallback_count。
  4. 威科夫分析:当前周期背景和阶段(仅限有证据的)、关键事件及其理由、遵守 T+1 的操盘边界。
  5. 投资组合操作部分(仅限投资组合流程):持仓快照、每个持仓的操作、候选股票比较、现金建议、以威科夫口吻的最终总结。
  6. 绘图部分(仅当交易时段规则允许时)。

硬约束

  • 除非明确要求,否则不要更改固定的提示词措辞。
  • 不要虚构缺失的 OHLCV 行。
  • 如果图片输入可解析,不要忽略图片输入。
  • 不要在图表注释中使用不透明的白色文本框。
  • 如果获取数据需要运行 Python 脚本,仅在沙盒环境中运行。
  • 优先使用直接网页/API 获取;仅在需要回退、解析或标准化时才使用 Python 脚本。

资源

  • rules/alpha-system-prompt.md:固定角色和硬性规则。
  • rules/source-fallbacks.md:在线数据源切换策略。
  • rules/system-capability-playbook.md:完整系统能力路由和降级策略。
  • rules/cli-setup-guide.md:CLI 安装、注册、MCP 设置和命令参考。
  • GitHub:https://github.com/YoungCan-Wang/Wyckoff-Analysis

相关技能