SKILL.md 全文

Frontmatter

name	a50-kyh-usd-pe-fund-analysis
description	>

KYH USD PE Fund Analysis — 海外私募一级存续解读

面向诺亚/ARK RM 的海外私募一级存续工作台

调用模式（v2 新增 · 必读）

本 Skill 支持 3 种调用模式，必须根据上游传入的 mode 参数切换行为。 模式标准、JSON 字段、评级标准、话术格式、合规免责、视觉 token 等 所有跨 Skill 一致性约束均定义在 references/kyh-shared-framework.md（本目录），必读。

模式 A · 完整模式（默认，RM 直接触发）

• 触发条件：mode 未传 或 mode="full"
• 行为：执行全部 Step（数据查询 → 框架梳理 → 分位/评级判断 → HTML 报告生成 → 对客逐字稿）
• 输出：完整 HTML 报告文件 + 对话内总结
• 适用场景：RM 单独对一只产品做深度存续分析时

模式 B · 精简模式（visit-prep 编排调用）

• 触发条件：mode="concise"
• 行为：
• 只执行数据查询 + 框架梳理 + 分位/评级判断
• 跳过 HTML 报告生成
• 跳过对客完整逐字稿生成（但保留 rm_message 一句话）
• 输出：标准化 JSON（字段定义见 references/kyh-shared-framework.md 第 2 节，强约束、不允许遗漏 key）

{
  "product_name": "...",
  "product_code": "...",
  "asset_class": "usd-pe",
  "region": "国内 | 香港 | 海外",
  "rating": "🟢 | 🟡 | 🟠 | 🔴",
  "rating_label": "继续持有 | 观察持有 | 边际减仓 | 建议赎回",
  "headline": "≤25 字的一句话判断",
  "key_metrics": { "primary": "...", "secondary": "...", "tertiary": "..." },
  "key_risks": ["≤30 字", "≤30 字"],
  "rm_message": "完整 1 句话，可直接对客户说的话",
  "next_action_date": "YYYY-MM-DD | null",
  "data_as_of": "YYYY-MM-DD",
  "data_source": "本 KYH 实际使用的 MCP 名称",
  "full_report_path": null
}

• 适用场景：visit-prep 编排层调用，用于生成 L2 单产品健康度矩阵

模式 C · 附录模式（visit-prep 编排调用）

• 触发条件：mode="appendix"
• 必传参数：
• client_id：客户集团号
• client_surname：客户姓氏（用于附录命名脱敏，例：「张」）
• output_dir：HTML 输出目录绝对路径
• 行为：执行全部 Step（与完整模式相同），但 HTML 文件按 visit-prep 命名规范保存到 output_dir
• 输出：与精简模式相同的 JSON，但 full_report_path 填写生成的 HTML 绝对路径
• 文件命名规范：{客户姓氏}总_{产品简称}_存续报告_{YYYYMMDD}.html
• 适用场景：visit-prep 编排层调用，用于生成 L3 完整存续报告附录

评级判断（统一标准）

必须遵守 references/kyh-shared-framework.md 第 3 节硬性触发规则：

• 当前回撤 > 产品说明书承诺回撤阈值 → 至少 🟠
• 当前回撤 > 产品说明书承诺回撤阈值 × 1.5 → 🔴
• 客户持仓产品风险等级 > 客户 KYC 风险等级 → 至少 🟠
• 30 天内开放赎回日 + 净值历史 80% 分位以上 → 至少 🟠
• IPO 项目已全部退出 + 进入退出期最后一年 → 至少 🟡

数据来源标注

每个关键数值必须标注 [来源：XX | 截至 YYYY-MM-DD]，详见 references/kyh-shared-framework.md 第 4 节。

RM 话术

精简模式的 rm_message 字段取与评级匹配的那一场景的核心句。 完整模式必须输出 🟢/🟡/🔴 三场景完整话术（详见 references/kyh-shared-framework.md 第 5 节）。

兼容性

未传 mode 参数时行为与原版完全一致（默认走模式 A）。 RM 现有的所有触发关键词不受影响。 --- 。输入产品信息，输出可直接发给客户的存续报告 + 沟通逐字稿。 ---

四步标准流程

Step 1 · 数据获取（Gopher/Olive MCP）

优先通过 MCP 工具获取最新数据；若 MCP 无法获取，使用上传文件中的数据，并明确标注数据来源和日期。

工具优先级（按顺序尝试）：
1. Olive MCP → shelf_detail / shelf_performance / shelf_portfolio / shelf_summary
2. Gopher MCP → query_pe_report / query_pims_doc / fuzzy_query_domestic_project / analyze_material_pdf
3. 上传的 PDF/DOCX（季报、存续报告、管理人会议纪要）
4. 上传的 BS 一页纸等内部培训材料

必须提取的关键字段（歌斐层）：

• 认缴规模、实缴金额、实缴比例
• 已分配金额、分配比例（占认缴 & 占实缴/DPI）
• 剩余账面估值 (RVPI)、累计净值 (TVPI)
• 基金成立日期、基金期限（投资期 + 退出期 + 延长期）
• 所处阶段（投资期/退出期/延长期）+ 数据截止日期（必须标注）

底层子基金/项目层：

• FOF 类：每只子基金的 PI / DPI / RVPI / TVPI
• 直投/S 基金类：前 5-10 大未退出持仓（RV 降序）— 行业、地区、RV 金额、占基金总 RV 比例、项目基本面

---

Step 2 · 基金类型判断 → 选择解读框架

| 判断条件 | 使用框架 | |---|---| | 歌斐层下有 ≥2 个子基金（真正的母基金） | FOF 类 → 读 references/fof-framework.md | | 歌斐层只投 1 个子基金，底层有多个直投项目 | S 基金/筛选类 → 读 references/single-fund-framework.md | | 单一直投项目 | 同 single-fund-framework.md | ---

Step 3 · 存续分析内容组织（三大模块）

模块 A — 基金概况（客户层/歌斐层） 按以下模板句式输出：

「歌斐海外XX基金成立于XXXX年XX月，基金规模XX万美元，基金期限X+X年（含X年投资期、X年退出期、X年延长期）。客户实际缴款金额约XX万美元，实缴比例XX%。截至[数据日期]，TVPI约X.XXx。累计分配X次，分配比例占认缴XX%（DPI XX%）。基金结构：歌斐海外XX基金投资于[子基金名称]，继而持有[底层项目数量]个项目/子基金。」

模块 B — 持仓解读（底层层）

• FOF 类：参见 references/fof-framework.md（每只子基金分页解读）
• S 基金/直投类：前 5-10 大未退出持仓（按 RV 降序），每个持仓说明：项目名称、行业/地区、RV及占比、基本面（出租率/营收/EBITDA等，引用管理人会议纪要）、退出路径预判

模块 C — 退出规划 & 分位判断

• 引用最新管理人会议纪要/季报中关于退出的表述（直接引用原文并注明来源）
• 宏观环境分析（利率、流动性、行业供需）
• 分位判断：读 references/benchmark-guide.md，与同策略 vintage year ±2年基金的 TVPI/DPI 比较
• 对客沟通建议（继续持有/二级市场询价/等待分配节奏）

---

精简模式（mode=concise）止步：Step 3 完成存续分析三大模块输出 + 评级 + rm_message 后，即可按 references/kyh-shared-framework.md 第 2 节拼装标准化 JSON 并返回，跳过 Step 4 的 HTML 生成。

Step 4 · 生成 HTML 存续报告

仅完整模式（mode=full 或未传）/ 附录模式（mode=appendix）执行本步。精简模式跳过整个 Step 4。

读取 references/html-report-template.md 获取 HTML 结构规范，生成包含以下 5 个 Tab 的完整报告： | Tab | 内容 | |---|---| | 基金概览 | KPI 卡片（TVPI/DPI/实缴比例/剩余估值）+ 基金结构示意 | | 持仓解读 | 持仓表格（RV 占比可视化）+ 前 5 大项目卡片 | | 退出规划 | 退出时间线 + 管理人原文引用区块 | | 分位分析 | 同策略 benchmark 对比 + 分位结论说明 | | 对客沟通稿 | 30 秒 brief + 完整逐字稿 + 常见 Q&A | HTML 报告必须包含：

• 每个数据点的来源标注（格式：数值 [来源：XX | 截至 YYYY-MM-DD]）
• references/risk-disclaimer.md 中的完整风险提示段落
• 报告生成日期水印

---

数据标注规范（强制）

正确示例：
TVPI 1.07x [来源：Olive MCP | 截至 2025-06-30]
Buckingham RV $138.78M [来源：歌斐海外黑石地产S基金2025Q2季报 | 截至 2025-06-30]
分配比例 92.66% [来源：歌斐海外黑石地产S基金2025Q2季报 | 截至 2025-06-30]

错误示例（禁止）：
TVPI 1.07x（无来源标注）
"最新数据显示..."（无具体日期）

---

对客风险提示（生成任何对客材料时必须包含）

对客沟通稿开头必须提醒 RM 宣读：

• 所有数据基于账面估值，不代表最终投资表现
• 历史业绩不代表未来收益，不构成投资建议
• 分位判断为参考性分析，同策略 benchmark 数据存在局限性
• 实际退出时间受市场流动性、宏观环境等多重因素影响，无法保证
• 调仓建议需结合客户整体资产配置及风险承受能力综合判断

完整风险提示文本：读 references/risk-disclaimer.md ---

参考文件索引

| 文件 | 内容 | 何时读取 | |---|---|---| | references/fof-framework.md | FOF 类基金存续框架详细模板 | Step 2 判断为 FOF 类时 | | references/single-fund-framework.md | S 基金/直投/筛选类存续框架 | Step 2 判断为单一子基金时 | | references/benchmark-guide.md | 同策略分位判断方法与常见 benchmark 数据 | Step 3 模块 C 分位判断时 | | references/html-report-template.md | HTML 报告结构规范与配色主题 | Step 4 生成报告时 | | references/risk-disclaimer.md | 标准风险提示段落（中英文） | 生成任何对客材料时 | | references/example-bxsp.md | 歌斐海外黑石地产S基金完整案例（存续报告+逐字稿） | 需要参考案例时 |