Agent Skills¶

QMT Trading Skill 在 skills/ 提供 22 个 Agent Skills（底层调用 QMT Bridge API），均已配套可执行 Python 脚本。人类通过自然语言或 @ Skill 触发，由 Agent 执行脚本，无需记忆命令别名。

路线图：skills/ROADMAP.md · 总览：skills/README.md · 开发命令：开发指南

环境准备¶

安装项目：pip install -e . 或 pip install -e ".[full]"
复制配置：cp .env.example .env
启用交易相关 Skill 时配置：
QMT_BRIDGE_API_KEY
QMT_BRIDGE_STOCK_ACCOUNT_ID / QMT_BRIDGE_CREDIT_ACCOUNT_ID（可选）
Bridge 已启动且 QMT 已登录（qmt-server --trading ...）

客户端连接地址

.env 中 QMT_BRIDGE_HOST=0.0.0.0 仅用于服务端监听。在本机跑 Agent 脚本时请用 127.0.0.1，或在命令行传 --host 127.0.0.1，不要用 0.0.0.0 作为客户端目标地址。

Windows 终端中文乱码：chcp 65001 或 set PYTHONIOENCODING=utf-8。

快速开始（自然语言）¶

在 Cursor 中直接说，例如：

帮我查持仓和可用资金
今天账户盈亏多少
生成今日交易复盘并同步到飞书

Agent 会读取对应 SKILL.md 并执行脚本。若需手动跑脚本（路径见各 Skill 文档）：

python skills/qmt-bridge-trading/scripts/trading_status.py --host 127.0.0.1 --port 8080 --api-key YOUR_KEY
python skills/qmt-bridge-daily-pnl/scripts/daily_pnl_snapshot.py --host 127.0.0.1 --port 8080 --api-key YOUR_KEY
python skills/qmt-bridge-execution-review/scripts/daily_trade_report.py --host 127.0.0.1 --port 8080 --api-key YOUR_KEY

提示词怎么用¶

自然语言（推荐）：直接说下表「提示词示例」中的句子。
@ Skill：@skills/qmt-bridge-daily-pnl/SKILL.md 等。
命令行（可选）：python skills/.../scripts/*.py（见各 Skill 的 SKILL.md）。

写操作须用户确认，脚本加 --execute --confirm。仓库内同源表格：skills/README.md。

全部 Skills（含提示词）¶

Skill	说明	提示词示例
qmt-bridge-trading	下单、清仓、状态	`帮我查持仓和可用资金` · `用 Bridge 下一笔买入（先预览）` · `清仓某只股票`
qmt-bridge-execution-review	复盘/操作评价	`今日操作评估` · `交易复盘+执行质量` · `评价今天买卖是否合理`

每日复盘报告长什么样？

完整章节结构（委托表、成交、按标的汇总、操作评价、近 3 日量能热度）见 每日复盘报告示例。示例中金额与盈亏已脱敏；实际报告由 --feishu-md 生成，可同步飞书。

当日盈亏（daily-pnl）¶

Skill：qmt-bridge-daily-pnl

结合 当前持仓、昨仓与 当日成交（含已清仓标的），输出表格化报告：

账户概览：总资产、持仓市值、现金、成交笔数、当日盈亏合计
个股表：代码、名称、状态、持仓/昨仓、现价、涨跌幅、市值、买卖量、昨仓/今买/今卖盈亏、当日盈亏

估算公式（无 QMT today_profit_loss 时）：

当日盈亏 = 现市值 − 昨收×昨仓 − 今日买入金额 + 今日卖出金额

参数	说明
`--json`	JSON 输出（含 `symbols` / `cleared`）
`--no-detail`	个股表隐藏昨仓/今买/今卖列
`--no-tick-fallback`	仅用柜台字段，不用行情估算
`--min-pnl 500`	仅显示 \|当日盈亏\| ≥ 500 的标的

优先使用 QMT 返回的 today_profit_loss；与柜台可能有手续费等细微差异。

累计涨幅与涨跌概率（return-analysis）¶

Skill：qmt-bridge-return-analysis

1/2/3/4/5/10/30 日累计涨幅 + 形态/量价历史统计 + 报告末尾 下一交易日策略与观察点。

python skills/qmt-bridge-return-analysis/scripts/return_probability_analysis.py \
  --holdings --host 127.0.0.1 --port 8080 --api-key YOUR_KEY

提示词（示例）	说明
`评估当前持仓的 1/5/10/30 日累计涨幅、量价涨跌概率，并总结明日操作策略与观察点`	推荐；走 `--holdings`
`分析 300394.SZ、688008.SH 阶段强弱和近 10 日上涨概率`	走 `--codes`
`结合成交量看持仓明日收涨概率`	量价指标 + 近 10 日放量占比
`根据报告给组合写明日优先观察哪几只`	策略总结块（`day_strategy`）

--holdings 需 API Key；缺日 K 自动 download_batch。更多提示词见 Skill 文档「提示词示例」表。

分类索引（脚本）¶

完整列表与提示词见上表。按类别对应的 Python 脚本：

类别	Skill	脚本
交易与执行	trading	`trading_status`, `place_order`, `liquidate`
	order-ops	`list_orders`, `cancel_orders`
	smart-execution	`execution_preview`
	rebalance	`rebalance_plan`
风控与复盘	portfolio-risk	`portfolio_snapshot`
	daily-pnl	`daily_pnl_snapshot`
	execution-review	`daily_trade_report`
研究	return-analysis / market-watch	`return_probability_analysis`, `watchlist_snapshot`
	sector-theme	`sector_rank`
	financial-download	`download_financial_data`
	fundamental-screen	`screen_financial`
	technical-signal	`formula_check`
实时/日历/品种	realtime-monitor	`ws_subscribe`
	event-calendar	`calendar_check`
	credit-margin	`credit_snapshot`
	etf / convertible / option / hk-connect	`etf_snapshot`, `cb_snapshot`, `option_chain_snapshot`, `hk_universe`

安全提示¶

实盘下单、撤单、调仓、清仓须 用户确认 且脚本加 --execute --confirm
下载财报（financial-download）会写服务端缓存，大批量前须说明
板块排序（sector-rank）对大板块默认仅扫描前 800 只成分；用 --list-sectors 查有效板块名
研究类与 daily-pnl 为只读，不替代投资建议
勿泄露完整 API Key

冒烟测试¶

pytest tests/test_skills_smoke.py -q

阶段	说明	提示词示例
日历	是否交易日	`今天是不是交易日`
强弱	持仓/阶段涨幅	`评估持仓涨幅概率并总结明日策略` · `指定股票 N 日涨幅对比`
看盘	板块	`板块内涨幅排名`
研究	财报	`下载财报到 Bridge 缓存` · `按 ROE、EPS 做基本面筛选`
风控	集中度、现金	`组合风险快照` · `下单前现金够不够`
盈亏	当日盈亏表	`今天账户盈亏多少` · `分标的列当日盈亏表`
执行	预览后下单	`预览这笔买单` · `用 Bridge 下一笔买入（先预览）`
复盘	委托/成交/操作评价	`今日操作评估` · `生成今日交易复盘`
量能	近3日两市成交额（复盘前）	`复盘前检查近3日量能` · `补齐上证深证近3日成交额`
飞书	复盘/盈亏/分析上传	`同步今日复盘到飞书文档`