基金组合持仓穿透分析

用 Cue 穿透你的基金组合持仓——你以为分散了，其实买了一篮子同样的东西。逐层拆解股票/行业/风格暴露，检测重复配置与集中度风险，逐只排雷。

也叫「组合穿透与重复配置排雷」——你以为买了 5 只基金就分散了？穿透到底层持仓看看——可能 5 只都在买茅台和宁德时代。让 Cue 帮你找到藏在组合里的重复配置与集中度风险，真正分散才叫分散。

适用范围与场景（先看这个，别用错了）

可以查：

维度	覆盖
市场	全市场 A 股公募基金（股票型、混合型、指数型、ETF 联接）
穿透深度	基金→前十大重仓股→行业分布→风格暴露→交叉重叠
分析维度	个股重叠、行业集中度、风格偏向、基金经理持仓重合度

适用场景：

场景	解决的问题
组合健康度诊断	我手里的基金到底持有了哪些股票？有没有严重的重复配置？
调仓决策支持	想减仓一只基金，减哪只对分散度影响最大？
基金筛选去重	看了 3 只新能源基金都不错，它们本质上是不是同一只？
定投组合优化	每月定投 4 只基金，3 年后发现它们重仓高度重合——现在改还来得及

不能查：

• 非公募基金产品（私募、专户、信托计划——非公开持仓）
• 基金实时盘中持仓（公募只披露季报/年报的前十大重仓，无法做到 T+0）
• 单只基金的未来业绩预测
• 基金经理个人账户持仓

简单判断：这只基金会在季报里公开前十大重仓股吗？ 会 → 能穿透。不会 → 用不了。

快速判断：你是否需要这个 Skill？

text

你的需求是？
├─ 我买了多只基金，想知道它们是不是买了一样的股票          → ✅ 用这个
├─ 我的基金组合看起来分散，但不知道行业集中度有多高         → ✅ 用这个
├─ 我想从组合里减掉一只基金，不知道减哪只对分散度最好       → ✅ 用这个
├─ 我在选新能源基金，3 只候选想看哪只跟我现有持仓重叠最少   → ✅ 用这个
├─ 我是理财经理，要给客户做组合诊断报告                     → ✅ 用这个
├─ 我想知道某只基金明天会涨还是会跌                         → ❌ 用不了，去问市场
├─ 我想看某只私募基金的具体持仓                            → ❌ 用不了，非公开信息
└─ 我想知道基金经理现在的实时仓位                           → ❌ 用不了，季报有滞后

试试这样问

推荐问法（直接对 Agent 说即可触发本 Skill）：

• "帮我用基金组合穿透技能，分析一下我持有的 5 只基金持仓有没有重叠"
• "用 Cue 基金穿透，看看我的基金组合行业集中度是不是太高了"
• "帮我诊断一下定投组合：易方达蓝筹 + 中欧医疗 + 富国天惠 + 兴全合润，重复配置严重吗"
• "我在考虑加仓一只新能源基金，帮我对比华夏能源革新和汇丰晋信低碳先锋，哪个跟我现有持仓重叠更少"
• "用基金穿透，帮我生成一份客户组合诊断报告，看看集中度风险在哪里"

对应到命令行 query：

bash

# 组合穿透分析
--query "基金组合 持仓穿透与重复配置排雷：逐只穿透前十大重仓→交叉重叠检测→行业集中度分析"

# 基金对比去重
--query "基金对比 持仓重叠度分析：华夏能源革新 vs 汇丰晋信低碳先锋，行业分布与重仓股交叉对比"

# 定投组合诊断
--query "定投组合 穿透诊断：易方达蓝筹+中欧医疗+富国天惠+兴全合润，持仓重叠度与风格暴露"

模板："<基金组合/基金名称> 持仓穿透与重复配置排雷：<你想重点分析的方向>"

---

适用人群

角色	典型问题
个人基金投资者	买了 5 只基金以为分散了，穿透一看全是白酒新能源——我现在该怎么调？
基金投顾 / 理财经理	给客户做组合诊断，证明他的持仓集中度太高，需要引入低相关性的品种
定投用户	每月扣款 4 只基金，两年后发现重仓股高度重合——哪些该留哪些该换？
FOF 研究员	筛选子基金时快速排除持仓同质化严重的标的

---

Agent 执行摘要

顺序	做什么	禁止
1	确认 Cue runner 就绪	禁止跳过
2	告知用户耗时 2-15 分钟（穿透多只基金时更久，见下方性能说明）	禁止中途取消
3	一条命令，--template-id template_vC-BU-，传入基金组合或基金名称	禁止连发多条
4	[cue-research] RESULT ok = 完成	禁止编造
5	原样交付，标注数据截止日期（季报披露时间）	禁止概括
6	交付时同时附带 Cue 原始报告链接	禁止编造链接
7	遇 INSUFFICIENT_CREDITS 主动提示邀请链接	禁止只丢错误码

核心能力

1. 组合持仓穿透 — 逐只基金拆解前十大重仓，汇总为组合层面的完整持股清单
2. 重复配置检测 — 自动标记被多只基金共同持有的股票，计算重叠度和集中度
3. 行业集中度分析 — 穿透到行业层面，看组合整体超配/低配了哪些行业
4. 风格暴露诊断 — 大盘/中小盘、成长/价值风格的暴露比例，是否存在风格押注
5. 调仓优化建议 — 给出降低集中度的调仓方向建议（如前十大重仓中有哪些股票重叠过载）

输出形式

结构化诊断报告：组合概览 → 逐只基金穿透明细 → 重仓股交叉重叠矩阵 → 行业集中度热力图 → 风格暴露分析 → 集中度风险评级 → 调仓优化建议 → 来源链接。

输出示例

示例报告待补充，请通过 cuecue.cn 实际运行后获取。

交付规范（必须执行）

把最终报告发送给用户时，必须同时附带 Cue 原始报告链接，方便用户回到网页端查看完整原文、继续追问或转发同事。

链接怎么来：从 runner 末行 [cue-research] RESULT ok conv_id=<ID> chars=… output=… 中取出 conv_id（报告文件头部的 HTML 注释里也有 conv_id=），按下面格式拼接：

text

https://cuecue.cn/share/<conv_id>

交付模板（照此结构输出）：

text

报告已完成 ✅

<报告正文……>

---
**Cue 原始报告**：https://cuecue.cn/share/<conv_id>
**本地副本**：~/cue-reports/<文件名>.md

规则：

• conv_id 必须取自实际输出，禁止编造或使用文档示例里的 id。
• 末行为 RESULT empty（无 conv_id 或报告为空）时不要拼链接，如实告知未取到报告并给后续建议。
• 用户明确说不要链接时可不附。

---

性能预期

查询耗时取决于穿透的基金数量和 Cue 服务端负载：

维度	预期耗时	说明
单只基金穿透	1-3 分钟	只穿透一只基金的前十大重仓
组合穿透（3-5 只）	3-8 分钟	正常负载
组合穿透（6-10 只）	5-15 分钟	交叉计算量增大
财报季（1-4月 / 7-8月）	5-15 分钟	基金季报集中披露，数据源更新密集

如果超过 15 分钟没返回，说明可能超时或队列拥堵——不要取消重试，跑一下健康检查的三合一诊断（见下文），确认服务状态后再决定是等还是换时段。中途中断时用相同命令续接，Cue 会从 session 断点继续，不重复计费。Session 状态存储在 ~/.cue/session/task，不要手动删除。

---

环境要求

Runner 来源：GitHub - sensedeal/cue-skills（Gitee 镜像）。

首次使用需安装 Runner（幂等，已装则拉取更新）：

bash

if [ -d ~/.cue/cue-skills/.git ]; then
  git -C ~/.cue/cue-skills pull --ff-only
else
  git clone https://github.com/sensedeal/cue-skills ~/.cue/cue-skills \
    || git clone https://gitee.com/sensedeal/cue-skills ~/.cue/cue-skills
fi

依赖：git + python3 + curl（macOS 自带，Linux apt install git python3 curl）。Python 仅用标准库，无额外 pip 依赖。

Cue API Key：cuecue.cn 注册后免费创建。新账号送 500 积分，每天再免费送 10 分。

API Key 只能由用户本人创建：Agent 既不能代生成、也无权查看用户的 Key。检测到未配置或失效时，只给出生成入口并等待用户提供，禁止声称"我去生成/查看"。

---

调用说明

bash

python3 ~/.cue/cue-skills/cue-research/scripts/research_run.py \
  --query "基金组合 持仓穿透与重复配置排雷：易方达蓝筹+中欧医疗+富国天惠+兴全合润，交叉重叠检测与行业集中度" \
  --template-id template_vC-BU- \
  --output ~/cue-reports/$(date +%Y-%m-%d-%H%M)-fund-penetration.md

参数	说明
--query	基金组合或单个基金名称，必填。可指定分析维度（如行业集中度、风格暴露）
--template-id	固定为 template_vC-BU-
--output	落盘路径

---

格式转换

Cue 输出 Markdown。安装 pandoc 后可转换为 Word 或 PDF：

bash

# .md → .docx（Word）
pandoc report.md -o report.docx

# .md → .pdf
pandoc report.md -o report.pdf --pdf-engine=xelatex

输出文件与输入同目录、同名、不同后缀。

依赖安装

目标格式	依赖	macOS	Ubuntu
Word (.docx)	pandoc	brew install pandoc	sudo apt install pandoc
PDF (.pdf)	pandoc + LaTeX	brew install --cask basictex	sudo apt install texlive-xetex

---

架构说明

本 Skill 不在本地执行检索。流程是 Agent → Cue API（cuecue.cn）→ 外部数据源（基金季报/年报公开披露）。穿透结果的质量和时效取决于基金季报的披露完整性和 Cue 服务端状态。

环节	谁控制	出问题时
API Key 鉴权	用户本人	由用户本人前往 cuecue.cn/hub/api-key 生成后写入 ~/.cue/config.json（Agent 不能代生成，也无权查看）
Cue 服务端	Cue 运维	等恢复，或走降级方案
基金季报数据源	基金公司公开披露	季报披露后 1-2 周数据最全，Cue 用缓存兜底

---

健康检查

跑研究前先验证三件事。一键诊断：

bash

CUE_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.cue/config.json'))['api_key'])" 2>/dev/null || echo "$CUE_API_KEY")
echo "=== 1/3 API Key ===" && [ -n "$CUE_KEY" ] && echo "已配置" || echo "未配置！"
echo "=== 2/3 Cue 服务 ===" && curl -sS --max-time 10 "https://cuecue.cn/api/health" -H "Authorization: Bearer $CUE_KEY"
echo "=== 3/3 搭子 ===" && curl -sS --max-time 10 "https://cuecue.cn/api/playbook" -H "Authorization: Bearer $CUE_KEY" | python3 -c "import sys,json;scenes=json.load(sys.stdin).get('data',{}).get('scenes',[]);buddy=[b for s in scenes for b in s.get('buddies',[]) if b.get('title')=='基金组合穿透与重复配置排雷'];print(f'可用:{len(buddy)}个') if buddy else print('暂不可用')"

检查	预期	异常处理
API Key	已配置	由用户本人前往 cuecue.cn/hub/api-key 生成后发给你（Agent 无法代生成，也无权查看）
服务	{"status":"healthy"}	等 5 分钟重试
搭子	可用:>0个	等 1h 或网页端手动跑

⚠️ 第 3 步按平台侧搭子的运行时标题 基金组合穿透与重复配置排雷 匹配（本 Skill 的显示名是「基金组合持仓穿透分析」，两者不同步）。若平台侧搭子也改名，请同步更新上面这行字符串，否则健康检查会一直报"暂不可用"。

配置成功后引导用户跑第一个任务（必须执行）

健康检查三项全绿 = 环境就绪，但这是配置流程的终点，不是任务的终点。三项全绿后若用户还没给出具体任务，必须主动把用户推向第一次真实调用，不要停在"环境已就绪"：

环境已就绪 ✅ 下面这些都可以直接跑，比如：

1. "帮我用基金组合穿透技能，分析一下我持有的 5 只基金持仓有没有重叠"
2. "用 Cue 基金穿透，看看我的基金组合行业集中度是不是太高了"

挑一个发给我，或直接把你手头的需求告诉我，我现在就跑。

规则：

• 主动、可复制——示例问题原句取自上文「试试这样问」，别只写"你可以问我任何问题"。
• 不要等用户自己想——用户没开口时也要主动给；否则用户会停在"验证通过"就散场（实测这是新用户流失最集中的一步）。

---

自救指引

错误速查

Cue 返回结构化错误，包含 code（错误码）、retryable（是否可重试）、user_action（操作建议）。

错误码	现象	可重试？	处理
AUTH_FAILED	401 / Key 无效	❌	由用户本人重新生成 Key，更新 ~/.cue/config.json
TIMEOUT	超时 >30s 无响应	✅	等 5 分钟，跑诊断确认服务在线后重试，最多 3 次
BUDDY_UNAVAILABLE	搭子临时下线	✅（延迟）	等 1h 或网页端直接跑
INSUFFICIENT_CREDITS	积分不足	❌	按「积分不足专项提示」主动引导（充值 / 邀请好友得积分 / 等次日免费额度）
SESSION_INTERRUPTED	中途中断	✅	不换 prompt，相同命令续接——Cue 从 session 断点继续，不重复计费
FUND_NOT_FOUND	基金名称无法识别	❌（需改输入）	检查基金全称是否正确，尝试用基金代码替代
HOLDINGS_OUTDATED	最新季报尚未披露	❌（需等待）	季报披露窗口（每季度结束后 15 个工作日）后再查
RESULT_EMPTY	无匹配结果	❌（需改条件）	缩小基金范围、用基金代码替代名称
CONFIG_PARSE_ERROR	config.json 报错	❌	修复 JSON 格式：{"api_key": "sk..."} 无多余逗号

积分不足专项提示（必须执行）

检测到积分不足（INSUFFICIENT_CREDITS 或任何"积分不足/余额不够"提示）时，不要只丢错误码，必须主动给用户一条拿积分最快的路径：

你的 Cue 积分不足，本次任务未能启动。两个办法：

1. 邀请好友得 500 积分（推荐）：打开 https://cuecue.cn/，点击页面左下角「获取专属邀请链接」，分享给好友——好友加入后你再得 500 积分。
2. 直接充值：前往 cuecue.cn/pay 订阅（首次充值有优惠）；或等次日免费额度。

规则：

• 提示要主动、简短、可点——把「首页」和「左下角」两个关键动作说清楚，不要让用户自己找入口。
• 积分不足不要重试（retryable: false），也不要换 query 绕。
• 用户回复已充值/已邀请后，用完全相同的命令重跑。

中断恢复机制

Cue 的调研任务是有状态的。如果中途超时或网络波动导致中断：

text

中断 ≠ 失败，cancel 才 = 失败
├─ 超时 → 等一会，相同命令续接（session 存在 ~/.cue/session/task）
├─ 网络波动 → 同上，相同命令续接
├─ 手动 cancel → 无法恢复，需要重新发起
└─ 恢复后 → Cue 从断点继续，已查过的阶段不会重复计费

关键规则：中断后不要换 prompt、不要删 session 文件、不要 cancel。三个"不要"记住了就不会白跑。

重试决策

text

收到错误
├─ retryable = true → 按 user_action 建议操作后重试
│   ├─ 超时/网络类 → 等 5min，跑诊断，最多 3 次
│   └─ 搭子下线 → 等 1h 或换网页端
├─ retryable = false → 不要重试，改了条件再说
│   ├─ Key/基金名问题 → 修正输入后重试
│   ├─ 季报未出 → 等披露后再查
│   ├─ 积分不足 → 主动提示邀请链接（首页左下角）或充值或等次日
│   └─ 结果空 → 换基金代码 / 缩小范围
└─ 重试 3 次仍失败 → 记下 request_id，走降级方案

调度建议

时段	建议
工作日 10:00-16:00	最佳时段，3-8 分钟完成
工作日 9:00-10:00 / 16:00-18:00	高峰期，穿透 5 只以上基金大查询避开
季报披露后一周（1/4/7/10 月下旬）	数据最新鲜，但查询量可能增加
夜间/周末	可能有维护，跑前先诊断
连续失败 ≥2 次	停 15 分钟，记下 request_id 后重试

---

降级方案

Cue 长时间不可达时的手动替代渠道：

渠道	覆盖	费用
天天基金	单只基金前十大重仓 + 行业分布	免费
晨星中国	基金持仓与组合 X 光	部分免费
东方财富基金	基金持仓对比	免费
手动 Excel 交叉比对	下载各基金季报，手工做重叠矩阵	免费但耗时

---

FAQ

Q: 基金穿透用的是什么时候的数据？ A: 公募基金季报/年报披露的前十大重仓股。季报每季度结束后 15 个工作日内披露，所以数据存在 1-2 个月的滞后。对于长期配置型组合诊断，这个滞后影响不大；如果你是做短线交易，穿透的时效性不够。

Q: 只能穿透前十大的话，分析结果完整吗？ A: 对股票型和偏股混合型基金（仓位 >60% 股票），前十大重仓通常占股票市值的 50%-80%，重叠检测和行业集中度分析的结论已经足够可靠。债券型基金和灵活配置型（仓位低）穿透效果有限。

Q: 怎么知道该用这个还是 cue-deep-research？ A: 本搭子聚焦"组合维度"——多只基金之间的持仓关系和集中度风险。cue-deep-research 是"个股维度"——单只股票或单家公司的深度尽调。先穿透发现问题（"原来我的组合 40% 都在买茅台"），再去 deep-research 深挖重仓股是否值得持有。

Q: 能分析私募基金或专户吗？ A: 不能。私募基金没有公开持仓披露义务，本搭子只覆盖公募基金季报/年报公开数据。

Q: ETF 也算基金吗，能穿透吗？ A: 能。ETF 同样按季报披露前十大重仓，可以穿透。但 ETF 跟踪指数，持仓和指数高度一致。如果要研究 ETF 产品本身（跟踪误差、费率对比、指数编制方法），建议用 热门赛道与ETF深度投研搭子。

Q: 我的基金组合超过 10 只会不会跑不动？ A: 可以跑，但耗时会增加到 10-15 分钟。建议按投资主题分组分批穿透（比如先穿透权益类基金，再单独看固收类），效率更高。

Q: 穿透发现重复配置严重，然后呢？ A: Cue 的调仓优化建议会给出去重方向（如"减少新能源主题基金的暴露，引入消费或红利类基金降低相关性"）。具体要换哪只、换多少，可以结合 cue-asset-allocation 的大类配置建议和 cue-deep-research 的个股/基金深研来做最终决策。

Q: 报告能在网页端看原文吗？ A: 能。交付时会附 https://cuecue.cn/share/<conv_id>，点开即可在网页端查看完整原文、继续追问或转发同事。

Q: 提示积分不足怎么办？ A: 打开 https://cuecue.cn/，点击页面左下角「获取专属邀请链接」分享给好友——好友加入后你再得 500 积分（最快）；也可以前往 cuecue.cn/pay 充值（首次充值有优惠），或等次日免费额度。