================================================================================
  client-insight — 私人银行客户洞察 Skill 使用说明
================================================================================

版本：v4.0 | 更新日期：2026-10-13

一、功能说明
────────────────────────────────────────────────────────────────
本 Skill 帮助私行客户经理（RM）、财富管理顾问，在客户拜访前、KYC 尽调中
或日常客户经营时，快速获取客户及关联企业的全面公开信息，生成包含 10 个
板块的结构化客户洞察简报。

10 个板块：
  1.  基本信息
  2.  企业信息（股权结构、对外投资、历史沿革、财务概况、上市信息）
  3.  教育学术信息
  4.  行政司法和信用信息
  5.  知识产权和商标信息
  6.  招投标和交易信息
  7.  媒体和自媒体信息
  8.  关联自然人信息
  9.  综合风险分析
  10. 总结和画像标签

二、适用场景
────────────────────────────────────────────────────────────────
  - 客户拜访前的背景调查准备
  - KYC 尽调的信息快速收集
  - 日常客户经营的洞察补充
  - 培训案例教学的企业背景研究

三、输入要求
────────────────────────────────────────────────────────────────
必填项：
  - 客户姓名

选填项（越多越精准）：
  - 关联企业名称
  - 所在行业
  - 毕业院校
  - 所在城市
  - 客户类型（自然人/企业主/上市公司股东/私募管理人/金融机构从业者/专业人士）
    ※ 客户类型决定是否启用"资本市场数据域"（上市、发债、基金、金融机构客户）
  - 查询目的（拜访准备/KYC尽调/日常经营/案例研究）
  - 客户行为描述（沟通风格、决策模式等，用于性格分析）

四、输出说明
────────────────────────────────────────────────────────────────
输出格式：Markdown 文件（.md）
文件命名：{客户姓名}_客户洞察简报_{日期}.md
简报包含 YAML 元数据和完整的 10 板块结构化内容。
每项数据均标注来源与实际使用的数据源级别，方便人工复核。

五、资源依赖（v4.0：无需额外注册/安装）
────────────────────────────────────────────────────────────────
本 Skill 采用"已有连接器优先、免注册兜底"设计，用户无需额外注册/安装任何服务：

L0 内置（必有）：
  web_search / web_fetch
  Jina Reader（https://r.jina.ai/<URL>，免注册，破反爬/SPA/PDF）
  domain_search（委托式多源尽调研究）
  wechat-article-search / xiaohongshu / AI 分析
  ※ 原则 8「抓取增强优先」：web_fetch 抓取官方公示页失败时，改用 Jina Reader 再试。

L1 用户已有连接器（自动探测，有则用），按功能域分组：
  F1 企业主体（工商/司法/知产/招投标）
     天眼查（tyc-mcp）        — 代理式三跳：search_companies → get_company_capabilities
                                → call_tool（首选）
     企查查（qcc-company）    — 100+ 工具：工商/股东/实控人/受益人/司法/行政/
                                股权质押·冻结/知产/自媒体矩阵/高管风险扫描（次选）
     启信慧眼（qixinhuiyan-mcp）— enterprise_resolve → catalog_get → api_call（再次）
     质数幻方（primematrix-company / yjidian-company / yjidian-risk）— 工商照面、知产质押（补充）
     同花顺快查（kuaicha-search）— discover → call：批量筛选/中标/客户供应商/融资（补充）
  F2 资本市场（仅上市/发债/基金/金融机构客户）
     Wind（wind-finance）     — 股票/债券/基金基本面与行情、股东、事件、公告、宏观 EDB
     NeoData（neodata）       — 公司概况/财务指标/估值/股东/事件/行业与研报检索
     同花顺 iFinD（ifind-mcp）— 公告语义检索/新闻/热点/个股摘要
     盈米（yingmi-mcp）/ 实时行情（real-time-stock-mcp）
  F3 舆情自媒体
     NeoData social_opinion   — 公众号/小红书/视频号混召（互动量、情感倾向、OCR、音频转写）
     企查查自媒体矩阵          — get_news_sentiment / 微博·公众号·抖音·快手·小程序·App·网店
     Trends Hub               — 21 平台热搜榜
  F4 地理
     腾讯/高德/百度地图 MCP    — 地址/区域核验
  可选存档：kdocs / ima-mcp（简报存入知识库）

L2 免注册公开资源（自动兜底，共 23 项）：
  国家企业信用信息公示系统 / 信用中国 / 中国裁判文书网 / 人民法院案例库
  中国执行信息公开网 / 全国企业破产重整案件信息网 / 人民法院公告网
  中国证券投资基金业协会（中基协，私募管理人公示）
  中国证监会 / 巨潮资讯网 / 国家知识产权局 / 中国商标网
  中国政府采购网 / 全国公共资源交易平台 / 海关企业信用信息公示平台
  慈善中国 / 国家法律法规数据库
  OpenAlex / ORCID / Crossref / Semantic Scholar / ChinaXiv / GoOA

L3 可选增强（未配置不阻塞）：
  Firecrawl（降级 → Jina Reader / web_fetch）
  Open Personality MCP（降级 → AI 基于用户描述直接推断）
  Jina API Key（提升 Reader 限额）/ Exa / Tavily
  （企业数据已由 F1 连接器覆盖，无需再注册天眼查 API Key）

外部数据解析阶梯（统一规则）：
  ①WorkBuddy 已接通连接器 → ②其他 MCP 配置资源 → ③在 WorkBuddy 内则提醒接通连接器
  → ④仅当不在 WorkBuddy 内运行时，才引导外部注册并配置数据资源

详细说明见 references/resource-guide.md
连接器真实工具名见 references/connector-tool-catalog.md

六、环境变量
────────────────────────────────────────────────────────────────
无需环境变量。天眼查连接器（tyc-mcp）已在 WorkBuddy 中接通即可用；
CLI 兜底仅在连接器不可用时才需配置 ~/.tyc/config.json（可选，非必须）。

七、使用示例
────────────────────────────────────────────────────────────────
用户：帮我查一下客户"张伟"，他是深圳某科技公司创始人。

系统：
  1. Step 0：资源普查 → ✅ 天眼查/企查查/启信慧眼可用 / ✅ 免注册源就绪
  2. Step 1：收集信息 → 姓名：张伟，城市：深圳，行业：科技，
            客户类型：企业主
  3. Step 1.5：展示确认清单 → 用户确认
  4. Step 2-10：逐板块查询并生成简报
     - 企业主体：天眼查/企查查（股权/实控人/司法/知产/招投标）
     - 若关联企业为上市主体 → 追加 Wind / NeoData 财务与股东数据
     - 舆情：NeoData 社媒舆情 + 企查查自媒体矩阵 + Trends Hub
     - 学术：ORCID 消歧 + OpenAlex
  5. 输出：张伟_客户洞察简报_2026-10-13.md

八、注意事项
────────────────────────────────────────────────────────────────
  1. 所有数据来自公开来源，不涉及非公开个人信息
  2. 中文名同名可能性高，查询结果需标注"需确认是否为该客户本人"；
     学术侧建议先用 ORCID 消歧，可显著提升身份确认度
  3. 工商数据有 1-3 天延迟，非实时
  4. 企业核验返回多候选时必须请用户确认，禁止自动选择第一个
  5. 一层持股比例须逐字引用，禁止相乘推断穿透持股
  6. 防幻觉机制强制执行：严禁编造任何数据
  7. 未接通企业主体连接器时，自动使用免注册公开源，流程不中断
  8. 非上市小微企业跳过资本市场数据域，直接走企业主体源 + 免注册源

九、已知限制
────────────────────────────────────────────────────────────────
  1. 免注册网页源（公示系统、裁判文书网等）可能存在反爬限制，
     抓取失败时降级 Jina Reader，仍失败再降级 web_search
  2. 裁判文书网近年收录面收缩，司法信息建议以"案例库 + 企查查/天眼查司法接口"交叉验证
  3. 小微企业和个体工商户数据覆盖不完整
  4. 中基协仅覆盖已登记/已注销私募管理人，不含未登记主体
  5. 性格分析基于用户描述推断，需结合面谈验证

十、文件结构
────────────────────────────────────────────────────────────────
  SKILL.md                                  — 技能执行指令（v4.0.0）
  tyc_tools.py                              — 天眼查 CLI 工具库（可选，连接器不可用时兜底）
  references/resource-guide.md              — 资源分层与免注册替代说明（v4.0）
  references/connector-tool-catalog.md      — 已接通连接器真实工具目录（v4.0）
  使用说明.txt                              — 本文件

  已归档（v4.0 清理）：v0.7_design.md、client_insight_full_design.md、
  references/tyc_tools.py 重复副本 —— 见工作区存档目录
  _archive_client-insight_v3.0.0_20261013/
