前言¶
做量化研究时，因子从「算出来」到「能下单」往往要串起预处理、IC、回归、分层、拥挤度，再到多因子共线性、正交化、加权与打分。这些步骤分散在 notebook 和内部脚本里，换一个人或换一套数据就要重新拼流程。下面介绍中国银河证券在 SkillHub 发布的 星耀数智因子分析 skill，把星耀数智因子分析框架封装成 Agent 可执行的 Skill，并在完成后输出可视化 HTML 报告。
这是什么¶
星耀数智因子分析 skill（坐标 @org-rwhv0nty/ad-factor-analysis，当前版本 v1.0.9）是中国银河证券星耀数智团队提供的因子分析框架 Skill，来源标注为 enterprise，SkillHub 分类为 professional。
它面向两类任务：
- 单因子分析：预处理，以及 IC、回归、分层三类检验，并包含拥挤度相关分析。
- 多因子合成：共线性检测、正交化、八种加权方式与打分，并自动生成可视化 HTML 报告。
官方简介中列出的适用关键词包括：因子检验、因子有效性、因子合成、因子加权、因子正交化、因子打分、IC 分析、分层回测、因子拥挤度、多因子选股、因子组合、因子共线性、因子降维等。
核心功能¶
以下能力均来自 SkillHub 页面与已抓取元数据，不展开未在资料中出现的接口或参数。
单因子分析¶
- 预处理：在检验前对因子做框架约定的处理（具体步骤以安装后的
SKILL.md为准）。 - 三大检验方法：IC、回归、分层。
- 拥挤度：单因子链路中包含拥挤度相关分析。
多因子合成¶
- 共线性检测：在多因子组合前识别因子间共线性问题。
- 正交化：对因子做正交化处理。
- 八种加权：官方说明支持 8 种加权方式（具体名称与公式以 Skill 内文档为准）。
- 打分：在加权与合成后输出因子打分结果。
报告输出¶
分析完成后 自动生成可视化 HTML 报告，便于在浏览器中查看图表与结果，而不必在对话里逐段粘贴数值。
平台与依赖¶
- SkillHub 标签包含
requires_api_key=true，使用前需按 Skill 说明配置 API Key（密钥字段与获取方式以发布方文档为准）。 - 页面展示评分 100000，下载 8588 次（统计来自 SkillHub 抓取快照，会随平台更新变化）。
安装与启用¶
Skill 基于通用 SKILL.md 格式。安装时须把技能装进当前 Agent 能识别的 skills 目录，否则默认路径可能不会被加载。
方式一：让 AI 按官方指引安装¶
SkillHub 页面提供的安装提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@org-rwhv0nty/ad-factor-analysis`。
将上述内容发给 Cursor、Claude Code 等支持 Skills 的客户端，由 Agent 读取 SkillHub 安装文档 并完成安装。
方式二：SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按官方文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前环境的 skills 目录。常用路径示例（摘自官方安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令形式如下（将 <skills 目录> 替换为实际路径）：
skillhub install org-rwhv0nty/ad-factor-analysis --dir <skills 目录>
坐标在文档中亦写作 @org-rwhv0nty/ad-factor-analysis，与 skillhub search / skillhub install 使用的包名一致。
安装完成后，按 Skill 内 SKILL.md 配置 API Key（requires_api_key=true），并重启或刷新 Agent 的技能列表使技能生效。
典型用法¶
官方页面未附带独立的长示例代码库；典型用法是：在已安装并配置密钥的前提下，用自然语言描述数据与目标，让 Agent 调用本 Skill 走完分析链路。
可按任务类型组织请求，例如：
- 单因子：说明因子名称、收益与股票池时间范围，要求完成预处理，并输出 IC、回归、分层结果及拥挤度，并生成 HTML 报告。
- 多因子：提供多个因子或因子矩阵，要求先做共线性检测，再正交化，选定八种加权方式之一（或让 Agent 按 Skill 规则列举可选加权），最后合成打分并输出 HTML 报告。
具体输入字段、数据格式与默认参数以安装包内 SKILL.md 及星耀数智框架约定为准；本文不编造未在资料中出现的配置项或样例数据路径。
适用场景与注意¶
适合谁
- 已在星耀数智或银河证券相关环境中做 A 股或多因子选股研究，需要把「检验 + 合成 + 报告」固化成可重复对话流程的团队。
- 希望在 Cursor / Claude Code 等 IDE 里用 Agent 驱动因子分析，而不是每次手写一整套 notebook 脚本的开发者。
需要注意
- API Key：标签标明需要密钥；未配置时 Skill 可能无法访问后端能力。
- 合规与数据：来源为证券公司 enterprise 类 Skill，实际数据接入、合规边界以机构内部规定为准。
- 版本：撰写时核对到的版本为 1.0.9；升级后功能以 SkillHub 页面为准。
- 安装路径：务必使用
--dir指向当前 Agent 的 skills 目录，避免装到默认./skills/导致无法识别。
结尾¶
星耀数智因子分析 skill 把单因子（预处理、IC/回归/分层、拥挤度）与多因子（共线性、正交化、八种加权、打分）串成一条 Agent 可执行链路，并输出 HTML 可视化报告。若你的工作涉及因子有效性检验或多因子组合，可在 SkillHub 查看详情并安装。
- SkillHub 页面：https://www.skillhub.cn/skills/org-rwhv0nty/ad-factor-analysis
- API 坐标页：https://api.skillhub.cn/org-rwhv0nty/ad-factor-analysis
