前言¶
在聚宽（JoinQuant）上写策略，成本往往不在策略逻辑本身，而在两头的琐事：一头是把一个模糊的想法（比如”做双均线，跌破 20 日线减仓”）翻译成平台能跑的 Python 代码，包括取数、调 API、写 init / handle_data；另一头是跑起来之后面对一堆报错，逐个去翻文档。这个 Skill 面向的就是这两头，中间的回测、模拟交易仍由聚宽平台完成。
这是什么¶
小果聚宽量化交易助手，是一个面向聚宽平台的量化策略生成与辅助工具。它做的事情是：接收用户的自然语言需求，产出可运行的 Python 策略代码，并在后续提供 API 使用指导、报错排查和策略优化建议。
出品方为社区作者”小果”，联系方式微信 xg_quant。SkillHub 上坐标 @user_676c825d/xg-joinquant-trader，版本 1.0.1，来源标注为 community，分类 professional，无需 API key（标签 requires_api_key=false）。截至抓取时页面显示评分 100000、下载 968 次。
它不替代聚宽平台，代码最终仍需在聚宽的回测与模拟交易环境中执行，因此它定位是”写代码 + 答疑”，不是”自动下单”。
核心功能¶
按官方简介，能力分三块：
1、策略代码生成。按用户需求产出可在聚宽平台运行的 Python 量化交易策略代码，覆盖交易逻辑、数据获取与平台 API 调用。
2、API 使用指导。针对聚宽 API 的取数与接口用法做说明，减少查文档的时间。
3、问题排查与优化。对报错进行定位，并给出策略层面的改进建议。
触发方式与适用任务¶
Skill 通过关键词触发，官方列出的关键词包括：聚宽、JoinQuant、JQ、写策略、生成策略、量化策略、回测代码、模拟交易、双均线、网格交易、因子选股、Alpha 因子、多因子、取数据、财务数据、聚宽 API、聚宽报错。
也就是说，输入里只要出现这些词，就可以直接把需求描述发给 Skill。描述越具体越好：标的范围、调仓周期、买卖条件、仓位规则，这些信息决定了产出代码的可用程度。
安装与启用¶
Skill 本体托管在 SkillHub：
页面: https://www.skillhub.cn/skills/user_676c825d/xg-joinquant-trader
坐标: @user_676c825d/xg-joinquant-trader
版本: 1.0.1
分类: professional（community 来源）
官方页面没有给出面向具体客户端（Cursor / Codex CLI / Claude Code）的独立安装命令，抓取时两个地址均无法访问，因此这里不臆造 curl 或 npx 之类的命令。启用方式以 SkillHub 页面当时的说明为准：先在页面确认坐标与版本，再按你所用客户端的 Skill 添加方式引入该坐标即可。
一个确定的信息是它不需要 API key，引入后即可调用，不需要额外配置密钥。
使用流程¶
下面是与官方能力描述对应的标准流程，供参考：
1、描述需求。把策略想法写成一句话需求，带上标的、周期和买卖条件，例如说明要做双均线还是网格，是因子选股还是单标的择时。
2、获取代码。Skill 生成聚宽可运行的 Python 策略代码，包含数据获取与交易逻辑。
3、在聚宽环境运行。把代码放到聚宽平台的回测环境中执行，看回测结果与成交明细。
4、反馈报错。回测或模拟交易中遇到报错，把报错信息回给 Skill，由它定位是 API 用法问题还是数据问题。
5、迭代优化。根据回测表现和 Skill 的建议调整参数或逻辑，再跑一轮。
适用场景与注意¶
适合这几类人：刚接触聚宽、不熟悉 API 调用方式的使用者；有明确策略思路但不想反复查文档的开发者；已经有策略在跑、需要帮忙定位报错的人。
需要注意的几点：
1、产出代码要在聚宽平台上实际跑通才算数，本地环境无法执行聚宽 API，不要假设生成即可用。
2、策略质量取决于需求描述的精度，只说”做一个量化策略”，拿到的多半是通用骨架，具体条件要自己补齐。
3、聚宽的财务数据、行情接口有平台自身的覆盖范围和频率限制，涉及财务数据取数时要以聚宽文档为准。
4、评分与下载量为抓取时页面数据，可能随时间变化。
结尾¶
这个 Skill 的价值在于把”查文档 + 写代码 + 排错”这三段重复劳动合并成一次对话，让精力回到策略逻辑本身。如果你正在聚宽上做策略，可以从官方页面按坐标引入，先用一个简单策略（比如双均线）走一遍上面的流程，确认产出代码的结构和风格符合预期，再逐步替换成自己的策略。
官方地址：https://www.skillhub.cn/skills/user_676c825d/xg-joinquant-trader
