# Wm Watchlist

> 查看或整理我的关注列表：返回公司名称、分组与关键指标快照，不是裸代码列表。加/删/分组加删用增量；整理前默认预览。统一跨市场 SoT。

- Skill: `open-winmale/wm-watchlist` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add open-winmale/wm-watchlist`
- Raw SKILL.md: https://api.skillmd.com/api/skills/open-winmale/wm-watchlist/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: open-winmale (https://skillmd.com/u/open-winmale)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/open-winmale/wm-watchlist

---


# 我的关注列表

## 何时使用

- 「我关注了哪些」「池子里现在怎样」
- 「把茅台加进自选 / 从自选删掉 / 建分组 / 整理分组」（先预览再确认）
- 「删组 / 改名」

## 何时不要用 (When NOT to use)

- **全市场条件选股/按指标找股票** → 使用 `wm-screen-index`（条件选股）
- **单只股票的深入基本面/估值/多期三表** → 使用 `wm-company-card` / `wm-valuation` / `wm-statements`

## 库主人

- Host：`watchlist.*`；归一化 / deeplink：`xs/skillhub/lib`
- 速查：[references/lib.md](references/lib.md)
- 用关注做回测 → `wm-backtest` `from_watchlist`（按 `backtest_market` 切片）

## 市场语义

- **存储**：每用户一份统一 Head；`SymbolEntry.market` 持久化；`Group.market` 可选（空=跨市场组）
- **读**：`view` 默认全量；`market=cn|hk|us` 为投影过滤
- **写**：可省略 `market`（按代码推断）；建组省略 `market` → 跨市场组；传 `cn|hk|us` → 绑定组

## 前置

- Scope：`analysis:skills:run` + `user:watchlist:read`
- 写操作另需：`user:watchlist:write`

## 调用

**优先**用统一门面 `wm.sh run`（**禁止**手搓 `curl` / 自行拼鉴权 HTTP）：

```bash
bash .cursor/skills/wm-skillhub/scripts/wm.sh run wm-watchlist \
  '{"action":"view"}' --result
```

### view

```json
{ "args": { "action": "view" } }
```

单市场投影：`"market": "cn"`。

**读结果**：`holdings` / `groups`（HTTP：`data.result.holdings`）。

### 增量加票

```json
{ "args": { "action": "add", "symbols": ["601633", "00700"] } }
```

写回执在 **`apply`**（HTTP：`data.result.apply`），**不是** `result`。对用户须再 `view`。

### 增量删票（推荐；勿用 organize 删单票）

```json
{ "args": { "action": "remove", "symbols": ["601633"] } }
```

或单码：`"symbol": "601633"`。默认 `cascade=true`（同步踢出各分组）；仅主列表删、留在分组传 `"cascade": false`。

### 建分组 / 加入分组 / 移出分组 / 改名 / 删组

```json
{ "args": { "action": "group_create", "group_name": "重点关注" } }
```

一步建组并入标的（可选）：

```json
{ "args": { "action": "group_create", "group_name": "重点关注", "symbols": ["600519", "00700"] } }
```

回执**始终**含非空 `group_id`（空组亦然）；再用 `group_add` 追加标的。

**批量/单票加入分组**：

```json
{ "args": { "action": "group_add", "group_id": "<id>", "symbols": ["601633", "00700"] } }
```

```json
{ "args": { "action": "group_add", "group_id": "<id>", "symbol": "601633" } }
```

**批量/单票移出分组**（仅从指定分组移出，保留在主关注列表）：

```json
{ "args": { "action": "group_remove", "group_id": "<id>", "symbols": ["601633", "00700"] } }
```

```json
{ "args": { "action": "group_remove", "group_id": "<id>", "symbol": "601633" } }
```

**改名与删组**：

```json
{ "args": { "action": "group_rename", "group_id": "<id>", "group_name": "核心池" } }
```

```json
{ "args": { "action": "group_delete", "group_id": "<id>" } }
```

写动作回执均在 **`apply`**。

### organize（全量替换，危险）

仅用于真·整池整理。计划键名固定为 **`organize_plan`**，其中 `symbols` 是完整主关注列表，`groups` 是完整分组列表；先用 `view` 的 `holdings` / `groups` 合并成完整计划。删几只请用 `remove`。

```json
{
  "args": {
    "action": "organize",
    "organize_plan": {
      "symbols": ["600519", "00700"],
      "groups": [{"id": "<id>", "name": "核心池", "symbols": ["600519"]}]
    }
  }
}
```

大计划用 CLI 文件输入，避免命令行转义或截断：`bash .cursor/skills/wm-skillhub/scripts/wm.sh run wm-watchlist @organize_plan.json --result`（文件 JSON 仍须包在 `{"args": {...}}` 中）。

**固定流程**：先 `action=organize`（默认 `dry_run=true`）检查 `apply.diff` / `symbols_removed`；用户确认后，以同一完整计划传 `confirm=true`、`dry_run=false`。含删除时还须 `allow_removals=true`。

回执：`apply` + 顶层 `diff` / `symbols_removed`。

## 禁止

- 用残缺 `organize_plan` 当「加几只 / 删几只」导致清空或误伤池子
- 未确认就 `confirm=true` 落库
- 与「按条件选股」混淆
- 再读 `data.result.result`（已改为 `apply`）