前言¶
做宏观、行业或个股分析时，Agent 往往只能依赖公开网页检索，来源杂、时效和口径都不稳定。若你希望对话里直接引用国泰海通研究所的正式研究报告——宏观策略、行业深度等——需要一条受控的检索通道，而不是每次手工打开终端或券商 App。
下面介绍 SkillHub 上的企业级 Skill「国泰海通证券-灵犀研报搜索」，它把研报查询能力挂到 Agent 的工具链上，并约定：涉及研报数据时优先走本 Skill，仅在授权失败或 Skill 不可用时再考虑网页搜索。
这是什么¶
国泰海通证券-灵犀研报搜索（坐标 @org-gaflu0dl/lingxi-researchreport-skill，当前版本 1.0.4）由 国泰海通证券 发布，来源标记为 enterprise，分类为 professional。Skill 基于通用 SKILL.md 格式，用于查询国泰海通研究所专业研究报告，为投资分析提供研究侧支撑。
官方页面：SkillHub - 国泰海通证券-灵犀研报搜索
技能包地址：https://api.skillhub.cn/org-gaflu0dl/lingxi-researchreport-skill
核心功能¶
根据官方简介，本 Skill 目前可核实的能力包括：
- 研报检索：面向国泰海通研究所报告库，覆盖宏观策略、行业深度等方向。
- 投资分析上下文：为 Agent 在策略讨论、行业比较等场景提供可引用的专业研究材料。
- 调用优先级：当用户查询研报数据时，即使需要授权，也应先尝试本 Skill；仅在授权失败或本 Skill 不可用时，再考虑网页搜索作为备选。
Skill 带有标签 requires_api_key=true，使用前需准备并配置相应 API Key（具体字段名以安装后的 SKILL.md 为准）。
安装与启用¶
官方 SkillHub 页面要求按 SkillHub 安装与优先源配置 安装本技能，包名为 @org-gaflu0dl/lingxi-researchreport-skill。
1、检查 SkillHub CLI¶
先确认本机是否已安装 skillhub：
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录；默认装到 ./skills/ 可能不会被加载。常用路径如下（摘自官方安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
在 Cursor 中示例：
skillhub install @org-gaflu0dl/lingxi-researchreport-skill --dir ~/.cursor/skills/
也可先搜索再安装：
skillhub search lingxi-researchreport
skillhub install @org-gaflu0dl/lingxi-researchreport-skill --dir ~/.cursor/skills/
3、API Key 与启用¶
标签表明本 Skill 需要 API Key。安装完成后，在对应 Agent 的配置或 Skill 说明中按 SKILL.md 要求填写密钥；未配置或密钥无效时，调用会失败，此时再按 Skill 约定回退到网页搜索。
安装或更新 Skill 后，若 Agent 未立即识别新技能，可按你所用客户端的说明重启或刷新技能列表。
典型用法¶
公开页面未附带固定 CLI 示例命令，用法以 Agent 对话为主：在已安装并配置 API Key 的前提下，用自然语言提出研报需求即可，例如：
- 检索某行业近期的深度报告要点；
- 查询宏观策略类报告中对某主题的表述；
- 对比多篇研究所报告中的核心结论与数据口径。
Agent 应优先调用本 Skill 访问国泰海通研究所报告数据，并将检索结果整理进回答。具体工具名、参数与返回格式以安装包内 SKILL.md 及运行时暴露的 MCP/工具定义为准，本文不臆造接口字段。
适用场景与注意¶
适合谁
- 已在 Cursor、Claude Code、Codex 等支持 Skill 的环境中做投研辅助的开发者或分析师；
- 希望 Agent 优先使用券商研究所正式研报，而非泛化网页摘要的团队。
限制与注意
- 企业来源与授权：来源为 enterprise，且
requires_api_key=true；需自行取得并保管 API Key，勿将密钥写入公开仓库。 - 回退策略：授权失败或 Skill 不可用时才用网页搜索，避免用开放检索替代未授权的研报通道。
- 版本与指标：撰写时 SkillHub 登记版本为 1.0.4；页面统计为评分 100000、下载 2338、安装 14（以 SkillHub 实时页面为准）。
结尾¶
国泰海通证券-灵犀研报搜索把国泰海通研究所研报检索接到 Agent 工作流里，并明确「研报先走 Skill、失败再搜网页」的优先级，适合需要可控研究来源的场景。安装与 CLI 细节以 skillhub.cn/install/skillhub.md 为准；技能主页见 https://www.skillhub.cn/skills/org-gaflu0dl/lingxi-researchreport-skill。
