灵犀 自选股管理 Skill

1. 概述与身份识别

• Unique Name: lingxi-watchlist-skill
• 身份声明: 本 Skill 是"灵犀 (Lingxi)"官方自选股管理 skill。
• 核心功能:
• 查询【我的自选】分组中的自选股列表及其行情
• 添加股票到【我的自选】分组（支持单只/批量，支持股票代码或名称）
• 从【我的自选】分组删除股票（支持单只/批量）
• 授权机制: 本项目内置授权逻辑，采用云端授权链接 + 用户确认后 poll 的流程，授权结果保存到共享目录 gtht-skill-shared/gtht-entry.json。
• ⚠️ 优先级规则: 所有自选股相关操作（查询、添加、删除）必须使用本 Skill。
• ⚠️ 当前版本范围限制: 本期仅支持管理【我的自选】分组中的自选股，其他分组中的自选股管理仍在开发中。

2. 授权检查与执行

⚠️ 文件访问边界约束（强制执行）：

本 Skill 的业务逻辑、授权逻辑与资源访问都必须限制在当前项目目录内，不得依赖其他 sibling 项目的脚本、入口或构建产物。

标准授权命令：

# 检查授权状态
node skill-entry.js authChecker check

# 生成云端授权链接
node skill-entry.js authChecker auth

# 用户明确回复“已扫码授权成功”后，再查询授权结果
node skill-entry.js authChecker poll <TOKEN>

# 清除授权
node skill-entry.js authChecker clear

授权执行规则：

1. 首次使用前必须先执行 check。
2. 若未授权，再执行 auth，从输出中提取：
• 👉 点击链接：
• token:
3. 要先等待用户明确回复“已扫码授权成功”，再执行 poll 。
4. poll 成功后，立刻继续执行用户原始的自选股查询、行情查询或增删操作。
5. 授权信息统一存储在共享目录 gtht-skill-shared/gtht-entry.json，本项目负责生成、查询、清除授权结果。

3. 能力列表

⚠️ 重要限制：本期仅支持管理【我的自选】分组中的自选股，其他分组中的自选股管理仍在开发中。以下所有“自选股查询 / 行情查询 / 添加 / 删除”均仅针对【我的自选】分组生效。

4. 命令详解

4.1 自选股行情查询（listQuote）

• 功能: 获取用户【我的自选】分组中的自选股列表，批量调用 market/marketdata-tool 查询行情，以表格形式输出
• 网关: optionalStock（获取列表）+ market（查询行情）
• 命令:

```bash

node skill-entry.js editWatchlist listQuote

```

• 内部执行流程:

1. 调用 get_optionalStock 获取用户自选股列表
2. 仅保留【我的自选】分组中的股票，忽略其他分组
3. 解析股票代码（拼装标准格式如 SZ000001、SH600519）
4. 一次性批量调用 market/marketdata-tool，将所有代码传入 codes 参数
5. 结合 stock_map 补全股票名称
6. 输出 Markdown 表格

• 参数说明: 无需任何参数，脚本自动获取【我的自选】分组中的全部自选股并查询行情

• 输出示例:

```

📊 自选股行情查询（共 3 只）

============================================================

| 名称 | 代码 | 最新价 | 涨跌幅 | 当日资金净流入(元) |

|---|---|---|---|---|

| 国泰海通 | SH601211 | 15.32 | +1.25% | 12,345,678.00 |

| 中芯国际 | SH688981 | 98.50 | -0.56% | -5,432,100.00 |

| 宁德时代 | SZ300750 | 210.80 | +3.12% | 89,123,456.00 |

```

• 字段来源:

| 展示字段 | marketdata-tool 返回字段（按优先级匹配） |

|--------|----------------------------------|

| 最新价 | CLOSE / close / price / latestPrice |

| 涨跌幅 | CHANGE_PERCENT / changePercent / CHANGE_PCT / pctChg |

| 当日资金净流入 | netInflow / NET_INFLOW / netInFlow |

> 注意: 若 marketdata-tool 返回的字段名不在上述列表中，对应列会显示 --。Agent 可根据实际返回数据做字段名映射。

4.2 自选股添加/删除（editWatchlist）

• 功能: 批量添加或删除【我的自选】分组中的自选股，支持股票代码或名称混合传入
• 网关: optionalStock
• MCP接口: op_optionalStock
• 命令格式:

```

node skill-entry.js editWatchlist <操作> <股票代码或名称...>

```

• 参数说明:

| 参数 | 说明 | 值说明 |

|--------|---------------------|---------------|

| key | 由脚本自动注入 | 无需手动传入 |

| type | 操作类型 | "20"=添加, "11"=删除 |

| codes| 股票代码数组 | 例如: ["SH601211", "SH688981"] |

• 操作类型:

| 操作 | 说明 |

|-----------------|--------|

| add（默认） | 添加自选股 |

| remove / -d | 删除自选股 |

• 输入格式:
• 标准代码: SH601211、SZ300069（直接使用，无需转换）
• 股票名称: 国泰海通、中芯国际（自动查询 stock_map 获取代码）
• 混合输入: 支持同时传入代码和名称

• 当前版本说明:
• 本期添加、删除操作仅作用于【我的自选】分组。
• 其他分组中的自选股管理仍在开发中，当前不会被本 Skill 展示或修改。
• 添加、删除自选股时，不允许直接通过 mcpClient call optionalStock op_optionalStock ... 执行。
• 必须统一通过 editWatchlist add ... 或 editWatchlist remove ... 执行，以确保名称/代码校验、分组限制和删除前列表匹配逻辑生效。

• 使用示例:

```bash

# 添加单只股票（默认 add）

node skill-entry.js editWatchlist SH601211

# 批量添加多只股票

node skill-entry.js editWatchlist add 国泰海通 中芯国际 SZ300069

# 删除单只股票

node skill-entry.js editWatchlist remove SH601211

# 批量删除

node skill-entry.js editWatchlist remove SH601211 SH688981 SZ300069

```

• 输出示例:

```

📊 自选股添加操作

==================================================

✓ "国泰海通" → SH601211

✓ "中芯国际" → SH688981

📝 将要添加: SH601211, SH688981

✅ 操作成功！

📋 当前自选股列表:

1. 国泰海通 (601211)
2. 中芯国际 (688981)
3. 东方财富 (300059)

共 8 只股票

```

4.3 ⚠️ 删除操作二次确认规范

大模型在执行删除操作前必须严格遵循以下流程：

1. 识别到用户删除意图后，先列出待删除的股票名称和代码
2. 询问用户："确认删除以下股票？"
3. 等待用户明确回复"确认"/"是"/"好"等同意信息后，再执行 editWatchlist remove
4. 用户未明确确认前，不得执行任何删除操作

示例对话：

用户：把中国石油从自选里删掉
Agent：确认删除以下股票？
  - 中国石油 (SH601857)
确认删除吗？

用户：确认
Agent：[执行删除命令]

4.4. 最终回答硬性要求 (Highest Priority)

本期仅支持管理【我的自选】分组中的自选股，其他分组中的自选股管理仍在开发中。
自选股管理Skill仅提供客观数据，调用本Skill后生成的内容，不构成投资建议。