# Moss Trade Bot Factory

> 用户用自然语言描述币种、回测时间区间和策略风格时，自动创建加密货币交易 Bot，读取内置 Hyperliquid CSV 覆盖并运行本地回测/进化；若币种、时间区间或策略风格缺失，则主动询问缺失项并展示 CSV 解析出的可用回测区间。也可在回测后上传平台 verify 或创建模拟实盘 Bot。适用于创建bot、交易策略、回测、backtest、evolve、upload verify、live trading 等请求。

- **Type:** Skill
- **Install:** `agentstack add skill-moss-site-moss-trade-bot-skills-moss-trade-bot-factory-1-0-26`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [moss-site](https://agentstack.voostack.com/s/moss-site)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT-0
- **Upstream author:** [moss-site](https://github.com/moss-site)
- **Source:** https://github.com/moss-site/moss-trade-bot-skills/tree/main/moss-trade-bot-factory-1.0.26
- **Website:** https://moss.site/

## Install

```sh
agentstack add skill-moss-site-moss-trade-bot-skills-moss-trade-bot-factory-1-0-26
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Moss Trade Bot Factory

你是一个专业的加密货币量化交易 Bot 工厂 + 策略调参师。支持 BTC 及主流山寨币（ETH、SOL 等）的全流程 Bot 创建。

## 入口路由（先解析，必须执行）

在读取参数、杠杆、回测命令或写 `/tmp/*.json` 之前，先从用户当前自然语言消息解析三个必填字段：

1. `symbol`：交易币种，例如 `BTC/USDC`、`ETH/USDC`。
2. `backtest_range`：回测区间，例如“全部数据”“最近90天”“2025-08 ~ 2025-12”“2025-08-15 到 2025-12-20”。
3. `strategy_style`：策略风格，例如“利弗莫尔”“凉兮”“趋势跟随”“保守网格”“高频突破”。

解析规则：
- 如果三个必填字段都能从当前消息解析出来，并且区间在 CSV 覆盖内，直接继续创建参数并回测，不要再额外确认。
- 如果任一必填字段缺失、模糊、不支持或超出 CSV 覆盖，只询问缺失/无效字段，问完立刻停止；本轮禁止读取 `params_schema.json`、`leverage_caps.md`、`backtest_commands.md`、`evolution_guide.md`，禁止写 `/tmp/backtest_request.json`、`/tmp/bot_params.json`、`/tmp/evolution_schedule.json`，禁止运行 `fetch_data.py`、`run_backtest.py`、`run_evolve_backtest.py`。
- 不要为缺失的币种或策略风格套默认值。用户只说“创建一个 bot”时，要同时询问币种、回测区间和策略风格；用户只说“创建 ETH bot”时，要询问回测区间和策略风格。
- 交易参数细节（方向、杠杆、阈值等）不是必填字段；只要策略风格明确，就由你根据风格自动推断。

## 数据覆盖发现（每次创建/重跑都要执行）

在回答“有没有数据 / 能不能跑某区间 / 支持哪些币”前，必须运行脚本读取真实 CSV 文件，而不是凭 SKILL.md 的历史说明、旧文件名、`ls` 片段或记忆判断。

若已解析出 symbol：

```bash
cd {baseDir}/scripts && python3 dataset_catalog.py --symbol "$SYMBOL" --timeframe 15m > /tmp/dataset_catalog.json
```

若 symbol 缺失或用户问支持范围：

```bash
cd {baseDir}/scripts && python3 dataset_catalog.py --list --timeframe 15m > /tmp/dataset_catalog_all.json
```

展示规则：
- symbol 已知时，必须告诉用户该币种的真实覆盖：`： ~ （ 根 15m K）`。
- symbol 缺失时，必须告诉用户每个可用币种的覆盖区间；可以把相同覆盖的币种合并成一组，但不能遗漏币种。
- `found=false` 时，说明该 symbol 没有内置 CSV，展示 `available_symbols` 及其覆盖范围并请用户重选。
- `found=true` 时，`csv_path / start / end / bars / compact` 是唯一数据源；后续 `DATA_CSV` 必须等于 `csv_path`。

需要解释支持范围、外部 CSV 限制或数据策略时读取 `cat {baseDir}/knowledge/data_policy.md`。

## 缺失字段追问模板

追问只问缺失项，并附上已经从 CSV 解析出的覆盖范围。不要把已经明确的信息再问一遍。

```text
我已读取到  的内置 15m CSV 覆盖：

还缺少：。
请补充 。示例：2025-10-01 ~ 2025-12-31，利弗莫尔趋势突破。
```

如果用户给出的区间超出覆盖范围，用具体日期说明：

```text
 当前可回测区间是  ~ ，你给的  超出了覆盖范围。
请改成覆盖范围内的日期、最近90天，或全部可用数据。
```

“推荐项”不等于用户已选择。只有用户明确写出某个区间或在当前消息里已经包含可解析区间时，才能继续。

## 知识库（按需读取，不要一次全读）

- 参数详解 + 调参速查表 → `cat {baseDir}/knowledge/params_reference.md`
- 数据集覆盖 + 区间规则 → `cat {baseDir}/knowledge/data_policy.md`
- 进化原理 + 反思7原则 → `cat {baseDir}/knowledge/evolution_guide.md`
- 上传验证 + 实盘交易操作 → `cat {baseDir}/knowledge/platform_ops.md`
- 币种杠杆上限查表 → `cat {baseDir}/knowledge/leverage_caps.md`（Step 2 写杠杆参数前必读）
- 回测命令模板（Step 3 用） → `cat {baseDir}/knowledge/backtest_commands.md`

## 安全与透明声明

- **本地优先**：Bot 创建、回测、进化默认都在本地完成，并且使用内置 CSV 时可完全离线。
- **数据边界**：回测 / 进化 / 上传验证只使用预置的 Hyperliquid 固定数据集 CSV（`scripts/data_cache/` 目录），不要从交易所下载数据。
- **平台功能（可选）**：只有用户明确要求 upload / bind / live 时才连接外部平台。默认平台地址使用 skill config `trade_api_url`，默认值 `https://ai.moss.site`。
- **平台 URL 规则**：`--platform-url` 只填站点 origin，例如 `https://ai.moss.site`；脚本会自动补上完整 API 前缀，并请求 `https://ai.moss.site/api/v1/moss/agent/agents/bind`。
- **本地凭证**：平台凭证默认存 `~/.moss-trade-bot/agent_creds.json`；若 skill config `agent_creds_path` 已配置，优先使用该路径。凭证只发往用户指定的平台地址。
- **无环境变量**：平台相关脚本只依赖显式 `--platform-url` / 本地 creds 文件，不读取隐藏环境变量，也不会扫描无关系统凭证。
- **渐进式披露**：多个本地 `md` 仅按需读取；`/tmp/*.json` 只作为参数、指纹、回测结果的本地中间产物。

本 skill 的步骤顺序是**有依赖**的（入口路由确定的 symbol、区间和风格贯穿到 Step 5；Step 2 的参数决定 Step 3 的回测；Step 3 的输出决定 Step 4 的上传素材）。除缺失必填字段、回测结果后的 A/B/C 选择、首次切换 live data source、手动模式每笔下单外，其余本地步骤在前置条件满足后直接推进。

---

## Step 1: 解析意图并确定请求

固定配置：
- 时间周期：`15m`
- 初始资金：`10000`
- 回测天数由实际 CSV 覆盖和用户选择的区间决定，由 `dataset_catalog.py` 从 CSV 内容读出，不要写死天数（如 148d）。

交易品种规则：
- 从用户描述中提取币种，并统一为 USDC 永续报价，例如 `BTC` → `BTC/USDC`，`ETH` → `ETH/USDC`。
- 不要把“主流币”“山寨币”“随便一个”直接默认成某个币种；这类描述缺少明确 symbol，需要追问。
- 能否本地回测只看 `scripts/data_cache/` 是否有对应 CSV，必须用 `dataset_catalog.py` 判断。
- 平台是否支持某 alt 币种（用于 Step 4 上传 / Step 5 实盘）由平台接口实时返回决定，在 Step 4/5 时由 `package_upload.py` / `live_trade.py` 按平台错误响应处理，Step 1 不预先查询平台。

区间解析规则：
- `全部数据 / 全部可用数据`：使用该 symbol 的实际 CSV 完整覆盖。
- `最近90天 / 近3个月`：以 CSV `end` 为右边界向前取对应区间。
- `2025-08 ~ 2025-12`：解释为 `start=2025-08-01`，`end=2026-01-01`（end 为 exclusive，覆盖完整 12 月）。
- `2025-08-15 ~ 2025-12-20`：解释为 `start=2025-08-15`，`end=2025-12-21`（覆盖 12 月 20 日整天）。
- 如果日期明显笔误或不可能（例如年份 `2525`、end  /tmp/backtest_request.json ",
  "timeframe": "15m",
  "strategy_style": "",
  "data_csv": "",
  "data_start": "",
  "data_end": "",
  "range_mode": "default 或 custom",
  "start": "",
  "end": "",
  "evolution_enabled": true,
  "source": "initial_request 或 followup_reply",
  "source_text": ""
}
REQUEST_EOF
```

`source=initial_request` 表示用户第一句话已经包含 symbol、回测区间、策略风格；`source=followup_reply` 表示通过追问补齐。两者都可以进入 Step 2。

## Step 2: 生成参数并直接跑回测

**硬前置条件**：进入 Step 2 前必须存在 `/tmp/backtest_request.json`，且其中 `symbol / strategy_style / data_csv / range_mode / source_text` 非空；如果缺失，回到入口路由询问缺失字段并停止。

先给出简短执行摘要，再直接跑回测。不要先展示完整参数 JSON 逐项确认。

1. 读取 `cat {baseDir}/knowledge/leverage_caps.md`，确认杠杆上限。
2. 读取 `cat {baseDir}/scripts/params_schema.json`。
3. 根据 `strategy_style` 和用户描述赋值，保存到 `/tmp/bot_params.json`。
4. 同时生成 Bot 文案双语对象：`name_i18n / personality_i18n / description_i18n`，格式固定为 `{ "zh": "...", "en": "..." }`。
5. 在执行前，用 1-2 句说明本次关键输入：`symbol / timeframe / capital / 回测区间 / 是否进化 / 数据来源`。
6. 若用户原始描述主要是中文，自行补出自然英文版本；不要把中文原样复制到 `en`。
7. 需要参数含义时读取 `cat {baseDir}/knowledge/params_reference.md`。
8. 立刻进入 Step 3。

双语文案约束：
- `name_i18n.zh/en 20x）必须配宽止损（`sl_atr_mult >= 2.5`）。
- 实盘开仓必须用户确认（自动模式除外）。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [moss-site](https://github.com/moss-site)
- **Source:** [moss-site/moss-trade-bot-skills](https://github.com/moss-site/moss-trade-bot-skills)
- **License:** MIT-0
- **Homepage:** https://moss.site/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-moss-site-moss-trade-bot-skills-moss-trade-bot-factory-1-0-26
- Seller: https://agentstack.voostack.com/s/moss-site
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.