# Qmt Bridge Feishu Doc

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-atorber-qmt-trading-skill-qmt-bridge-feishu-doc`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [atorber](https://agentstack.voostack.com/s/atorber)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [atorber](https://github.com/atorber)
- **Source:** https://github.com/atorber/qmt-trading-skill/tree/main/skills/qmt-bridge-feishu-doc
- **Website:** https://atorber.github.io/qmt-trading-skill/

## Install

```sh
agentstack add skill-atorber-qmt-trading-skill-qmt-bridge-feishu-doc
```

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

## About

# QMT Trading Skill · 飞书云文档

> **实现状态**：规程 + [doc-registry.md](references/doc-registry.md)；IO 走 **[lark-cli](https://github.com/larksuite/cli)** 官方 CLI

## 目标

1. 先由对应 QMT Skill 生成报告（复盘、盈亏等）
2. **当日复盘**：`daily_trade_report.py --feishu-md` 导出 `reports/feishu_daily_eval.md`（**禁止** Agent 手写摘要）
3. 用 **lark-doc** / **lark-drive**（`lark-cli docs +update` 等）写入飞书

## lark-cli 首次使用（Agent）

完整步骤见 **[references/lark-cli-setup.md](references/lark-cli-setup.md)**，摘要：

```bash
npx @larksuite/cli@latest install
npx skills add larksuite/cli -y -g
lark-cli config init --new          # 链接发给用户浏览器配置
lark-cli auth login --recommend
lark-cli auth status
```

执行飞书写操作前 **MUST** 读 **lark-shared**；改 docx 读 **lark-doc**（`--api-version v2`）；改列表标题 / 文件夹读 **lark-drive**。

**不要**使用本仓库 `scripts/` 下已移除的飞书 Python 脚本；**不要**在本目录维护上传脚本。

## 云空间目录

```
QMT Trading Skill/
├── 每日复盘/      ← daily-eval
├── 盈亏快照/      ← daily-pnl
├── 涨跌分析/      ← return-analysis
└── 组合风控/      ← portfolio-risk
```

文件夹 token → `.env`（见 doc-registry）。

## 报告类型

| type | 子目录 | 先执行的 QMT Skill | 本地 Markdown |
|------|--------|-------------------|---------------|
| daily-eval | 每日复盘 | [execution-review](../qmt-bridge-execution-review/SKILL.md) | `reports/feishu_daily_eval.md` |
| daily-pnl | 盈亏快照 | [daily-pnl](../qmt-bridge-daily-pnl/SKILL.md) | `reports/feishu_daily_pnl.md` |
| return-analysis | 涨跌分析 | [return-analysis](../qmt-bridge-return-analysis/SKILL.md) | `reports/feishu_return_analysis.md` |
| portfolio-risk | 组合风控 | [portfolio-risk](../qmt-bridge-portfolio-risk/SKILL.md) | `reports/feishu_portfolio_risk.md` |

doc token：`reports/feishu_doc_ids.json` 或 `FEISHU_*_DOC_ID`。

## 工作流：当日复盘

详见 **[references/workflows/daily-eval-sync.md](references/workflows/daily-eval-sync.md)**。同步前必须先跑 `--feishu-md`。

**放置位置**

| 情况 | 行为 |
|------|------|
| 用户**未**指定父文档 | `wiki +node-create --as user --title "..."`（**不传** `--parent-node-token`）→ **个人知识库根** |
| 用户给出 **wiki 父页面 URL/token** | 加 `--parent-node-token ` 建子文档 |
| 用户要求云空间子目录 | `docs +create --folder-token ...` |
| 覆盖已有 doc | `docs +update --doc DOC_TOKEN ...` |

勿在未指定时沿用历史对话中的父节点。父 token 可选：`FEISHU_DAILY_EVAL_WIKI_PARENT_TOKEN` 或 `feishu_doc_ids.json` 的 `daily-eval-wiki-parent`。

## 提示词示例

| 场景 | 提示词 |
|------|--------|
| 复盘上传 | `把今日交易复盘同步到飞书文档`（默认知识库根新建） |
| 指定父页 | `同步到飞书 wiki 父文档  下，新建子文档` |
| 盈亏 | `上传当日盈亏到飞书盈亏快照目录` |
| 新建 | `在飞书每日复盘目录新建一篇今日复盘` |

## 操作规程

1. `lark-cli auth status` 正常；已读 **lark-shared** + **lark-doc**
2. 运行对应 QMT Skill 脚本取数
3. 写 `reports/*.md`（`--content` 路径相对仓库根）
4. `docs +update` 或 `+create`（可先 `--dry-run`）
5. 核对云文档标题与 H1 一致
6. **只上传报告，不下单**

## 标题规范（摘要）

`QMT Trading Skill 当日复盘 2026-05-21 15:30:00` — 见 doc-registry。

## 安全

- 遵循 lark-cli 官方安全提示；凭证在系统密钥链，勿泄露
- 报告含交易数据，注意云文档权限范围

## Source & license

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

- **Author:** [atorber](https://github.com/atorber)
- **Source:** [atorber/qmt-trading-skill](https://github.com/atorber/qmt-trading-skill)
- **License:** MIT
- **Homepage:** https://atorber.github.io/qmt-trading-skill/

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:** yes
- **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-atorber-qmt-trading-skill-qmt-bridge-feishu-doc
- Seller: https://agentstack.voostack.com/s/atorber
- 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%.