qmt-bridge-feishu-doc

Files (5)

• SKILL.md
• doc-registry.md · references/
• lark-cli-setup.md · references/
• daily-eval-sync.md · references/workflows/
• README.md · scripts/

SKILL.md (first lines)

# QMT Trading Skill · 飞书云文档

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

## 目标

1. 先由对应 QMT Skill 生成报告（复盘、盈亏等）
2. **当日复盘**：
   - 脚本 `--feishu-md` 导出客观章节 + 证据包（**禁止**篡改一～六数字）
   - Agent 按三角色规程写第七节专家评审（**禁止编造**；见 execution-review protocol）
   - 合并后再用 **lark-doc** / **lark-drive** 写入飞书
3. 其它报告类型仍用脚本/Skill 产物，禁止凭印象摘要

## 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)**。同步前必须：脚本客观 MD + evidence → 三角色专家第七节 → 合并后再上传。

**放置位置**

| 情况 | 行为 |
|------|------|
| 用户**未**指定父文档 | `wiki +node-create --as user --title "..."`（**不传** `--parent-node-token`）→ **个人知识库根** |
| 用户给出 **wiki 父页面 URL/token** | 加 `--parent-node-token <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 父文档 <URL> 下，新建子文档` |
| 盈亏 | `上传当日盈亏到飞书盈亏快照目录` |
| 新建 | `在飞书每日复盘目录新建一篇今日复盘` |

## 操作规程

1. `lark-cli auth status` 正常；已读 **lark-shared** + **lark-doc**
2. 运行对应 QMT Skill 脚本取数
3. 写 `reports/*.md`（相对工作区根；Agent 安装下为 skills 根下的 `reports/`，**禁止**写死 `C:\GitHub\...`）
4. `docs +update` 或 `+create`（可先 `--dry-run`）
5. 核对云文档标题与 H1 一致
6. **只上传报告，不下单**

## 标题规范（摘要）

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

## 安全

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

From atorber/qmt-trading-skill, MIT.

More from atorber/qmt-trading-skill