git:20260518.6dd89eb to git:20260519.4b3c547

71 added, 24 removed. Audit A to A.

---

name: wind-find-finance-skill

- description: AIMarket 金融能力发现入口。当用户询问金融数据、分析、工具能力，且 AI 不确定应使用哪个具体 skill，或相关 skill 尚未安装时，使用本 skill 读取 catalog、推荐能力并引导安装。

+ description: 万得金融能力发现与安装路由入口。用于金融数据、行情查询、市场分析、今日大盘、市场主线、板块轮动、资金流向、估值、选股、复盘、仓位、交易计划、回测等任务。必须先读取 catalog 判断必需数据 skill / 工作流 skill；缺失时必须展示安装选项，用户确认后由 AI 直接安装，不得只给命令或用通用分析替代。

---

## 发现流程

- 本 skill 是 AIMarket 金融能力发现与安装路由器，不直接取数、不做业务分析、不需要 API Key。

+ 本 skill 是万得金融能力发现与安装路由器，不直接取数、不做业务分析、不需要 API Key。

- 1. 触发范围：用户询问 AIMarket / Wind 金融能力，或提出金融数据、分析、工具相关问题但未指定具体 skill，或指定的金融 skill 本地未找到 `SKILL.md`。若用户意图明确且对应 skill 已安装，直接使用对应 skill，不经过本入口。

+ 1. 触发范围：用户询问金融能力，或提出金融数据、分析、工具相关问题但未指定具体 skill，或指定的金融 skill 本地未找到 `SKILL.md`。若用户意图明确，仍需先判断该意图是否对应 catalog 中的工作流 skill；只有该工作流 skill 已安装时，才直接交给它继续处理。仅数据底座 skill 已安装，不等于工作流 skill 已满足。

2. 先尝试运行更新探活脚本，找到任一路径即执行 `node <path>`：

- - 当前 skill 目录下的 `scripts/check-updates.mjs`

- - `%USERPROFILE%\.agents\skills\wind-find-finance-skill\scripts\check-updates.mjs`

- - `~/.agents/skills/wind-find-finance-skill/scripts/check-updates.mjs`

+ - 当前 skill 目录下的 `scripts/update-check.mjs`

+ - `%USERPROFILE%\.agents\skills\wind-find-finance-skill\scripts\update-check.mjs`

+ - `~/.agents/skills/wind-find-finance-skill/scripts/update-check.mjs`

- 若 stderr 含 `[wind-skills]` 更新提示，同一会话首次触发时完整转告用户；遇到版本相关错误，可建议 `npx skills update -g -y`。

+ 若 stderr 含 `[wind-skills]` 提示：

+ - **检测到新版**（`检测到 N 个 skill 有新版`）：同一会话首次触发时完整转告用户一次，不重复。

+ - **检查失败**（`检查更新失败`）或**无法确认**（`无法确认是否最新`）：同一会话首次触发时简要告知用户一次即可，不可重复提示，也不影响后续发现流程。

+ - 遇到版本相关错误，可建议 `npx skills update -g -y`。

- 3. 读取 `references/skills-catalog.md`，将用户问题归类为取数 / 查询、分析 / 决策、探索 / 能力咨询，并按 catalog 推荐 1-5 个相关 skill。

+ 3. 读取 `references/skills-catalog.md`，将用户问题归类为取数 / 查询、分析 / 决策、探索 / 能力咨询，并按 catalog 识别 1-5 个相关 skill。输出判断时必须明确标注每个 skill 的角色：`必需工作流 skill`、`必需数据底座 skill`、`可选补充 skill`。分析 / 决策类任务只要 catalog 中存在高度匹配的工作流 skill，就必须把该工作流 skill 标为必需，不得只推荐数据底座。

- 4. 检测推荐 skill 是否已安装，顺序如下：

+ 4. 检测第 3 步识别出的所有 `必需工作流 skill` 和 `必需数据底座 skill` 是否已安装，顺序如下：

- 当前agent `.agents/skills/<name>/SKILL.md`

- `%USERPROFILE%\.agents\skills\<name>\SKILL.md`

- `~/.agents/skills/<name>/SKILL.md`

如果路径不存在、读取失败，或只是 IDE 标签页 / 历史上下文提到该 skill，一律视为未安装；不要做大范围递归搜索。

- 5. 已安装则交给对应 skill 继续处理。必需 skill 缺失时，安装前先征求用户确认，并明确询问安装范围：安装到当前 agent，还是安装到全部 agent。

+ 5. 若第 3 步识别出的全部必需 skill 均已安装，则交给对应的必需工作流 skill 继续处理；若任务只有取数 / 查询而没有工作流 skill，则交给必需数据底座 skill 继续处理。缺失任一必需 skill 时，必须进入安装交互流程。

- 当前 agent 使用不带 `-g` 的命令，全部 agent 使用带 `-g` 的命令。用户确认后由 AI 直接执行安装，不要只给命令让用户自己复制。安装前先测试 GitHub 和 Gitee 连通性与响应速度，选择当前可用且更稳定/更快的源。Gitee 不是备用源，GitHub 也不是固定首选；以测试结果决定。若首选源安装失败，切换到另一个已检测可用的源重试。

+ ### 安装交互流程

- GitHub 源命令：

+ #### 展示选项

- ```bash

- npx skills add Wind-Information-Co-Ltd/wind-skills --skill <name> -y

- npx skills add Wind-Information-Co-Ltd/wind-skills --skill <name> -g -y

- ```

+ 缺失任一必需 skill 时，必须先征求用户确认，并明确询问安装范围：安装到当前 agent，还是安装到全部 agent。在用户确认或拒绝前，不得用通用知识、`wind-mcp-skill`、`analytics_data`、网页搜索或自行推理替代缺失的工作流 skill。

- Gitee 源命令：

+ 向用户展示选项时必须包含：

- ```bash

- npx skills add https://gitee.com/wind_info/wind-skills.git --skill <name> -y

- npx skills add https://gitee.com/wind_info/wind-skills.git --skill <name> -g -y

- ```

+ 1. 缺失的 skill 名称和角色：`必需工作流 skill` 或 `必需数据底座 skill`。

+ 2. 当前 agent / 全部 agent 两种安装范围。

+ 3. 每种安装范围将执行的安装命令。

- 安装完成后检查对应 `SKILL.md` 是否存在；确认落盘后继续执行。不要默认要求用户重启或刷新会话，只有实际调用失败且明确是客户端未加载新 skill 时再提示。若 catalog 显示“装好需配置”为 API Key / Token / 依赖，安装后再引导用户补齐对应配置。

+ 展示命令只用于透明告知，不得要求用户复制执行。

+ 当前 agent 使用不带 `-g` 的命令，全部 agent 使用带 `-g` 的命令。

+ GitHub 源命令：

+ ```bash

+ npx skills add Wind-Information-Co-Ltd/wind-skills --skill <name> -y

+ npx skills add Wind-Information-Co-Ltd/wind-skills --skill <name> -g -y

+ ```

+ Gitee 源命令：

+ ```bash

+ npx skills add https://gitee.com/wind_info/wind-skills.git --skill <name> -y

+ npx skills add https://gitee.com/wind_info/wind-skills.git --skill <name> -g -y

+ ```

+ #### 用户确认后的强制动作

+ 用户确认安装范围后，AI 必须直接执行安装，不得在确认后只回复安装命令。

+ 执行顺序：

+ 1. 测试 GitHub 和 Gitee 连通性与响应速度。

+ 2. 选择当前可用且更稳定 / 更快的源。Gitee 不是备用源，GitHub 也不是固定首选；以测试结果决定。

+ 3. 直接执行对应安装命令。若首选源安装失败，切换到另一个已检测可用的源重试。

+ 4. 安装完成后检查对应 `SKILL.md` 是否存在。

+ 5. 确认落盘后继续原任务。

+ 不要默认要求用户重启或刷新会话，只有实际调用失败且明确是客户端未加载新 skill 时再提示。

+ 若 catalog 显示“装好需配置”为 API Key / Token / 依赖，安装后再引导用户补齐对应配置；其中 Wind `KEY_MISSING` 必须优先交给 `wind-mcp-skill` 的强制错误动作处理：立即执行 `node <wind-mcp-skill-dir>/scripts/cli.mjs open-portal` 打开开发者中心，只有该命令失败时才给手动链接。

## 路由规则

- 金融事实、行情、基金、财务、公告、新闻、宏观数据不得用网页搜索、WebFetch、浏览器公开页面或通用知识替代。取数 / 查询必须使用 `wind-mcp-skill` 或 catalog 中匹配的数据 skill；需要“数据 + 分析”的问题，优先推荐 `wind-mcp-skill` + 对应分析 skill。必要 skill 未安装时先安装，不要绕过到网页数据或公开页面。

+ 金融事实、行情、基金、财务、公告、新闻、宏观数据不得用网页搜索、WebFetch、浏览器公开页面或通用知识替代。取数 / 查询必须使用 `wind-mcp-skill` 或 catalog 中匹配的数据 skill；需要“数据 + 分析”的问题，必须同时识别必需数据底座 skill 和必需工作流 skill。第 3 步识别出的必需 skill 未安装时先走安装流程，不要绕过到网页数据、公开页面或简化分析。

具体推荐以 `references/skills-catalog.md` 为准：取数 / 查询从“数据类”选择，分析 / 决策从“工作流类”选择，探索类问题按 catalog 的 category 索引各给 1 个代表 skill。默认推荐 `wind-mcp-skill` 作为数据底座，除非用户明确只要方法论或模板。

+ ## 工作流 skill 硬门禁

+ 当用户请求估值 / DCF / 定价 / 盘后复盘 / 市场主线 / 选股 / 仓位 / 交易计划 / 回测等 catalog 中明确存在的工作流类任务时：

+ 1. 必须先读取 `references/skills-catalog.md`。

+ 2. 必须识别最匹配的工作流 skill。

+ 3. 必须按第 4 步检测该工作流 skill 是否已安装；若未安装，必须停止业务执行，先按第 5 步询问安装范围。

+ 4. 在用户确认或拒绝前，不得输出简化版分析，也不得用 `wind-mcp-skill`、`analytics_data` 或自行推理替代。

+ 5. 只有用户拒绝安装后，才允许说明将降级为简化分析，并继续执行。

+ 示例：

+ - “小米 DCF 估值” → 必需 skill: `dcf-model`；数据底座: `wind-mcp-skill`。若 `dcf-model` 缺失，先问安装范围，不得直接做简化 DCF。

+ - “昨日盘后复盘” → 必需 skill: `post-market-debrief`；数据底座: `wind-mcp-skill`。

+ - “今天市场主线是什么” → 推荐主题识别或板块轮动类工作流 skill；若缺失，先问安装范围。

## 边界

- 本 skill 不直接取数、不输出金融事实结论、不写业务数据。更新探活只写 `~/.cache/wind-aimarket/wind-find-update-state.json` 等缓存。`references/skills-catalog.md` 是随 skill 包发布的本地快照；更新通过 `npx skills update -g -y` 完成。

+ 本 skill 不直接取数、不输出金融事实结论、不写业务数据。更新探活只写 `~/.cache/wind-aifinmarket/wind-find-update-state.json` 等缓存。`references/skills-catalog.md` 是随 skill 包发布的本地快照；更新通过 `npx skills update -g -y` 完成。