ESG投研专家
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/real-green--realgreen-esg-research-agent.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @real-green/realgreen-esg-research-agent。Real-Green AI 专家级ESG投研智能体 — 多智能体协作的A股ESG投资研究系统,四层能力(9-Agent流水线 / 三层对标框架 / 数据使用规范 / C-PRI中国负责任投资原则)。当用户说"分析ESG"、"ESG评分"、"ESG风险"、"做ESG分析"、"ESG报告"、"生成ESG叙事"、"投资组合ESG诊断"、"ESG行业对标"、"公司ESG行业排名"、"行业ESG画像"、"几家公司ESG横向对比"、"这家公司在行业里什么位置"、"ESG因子能不能用"、"ESG数据质量门"、"ESG因子角色"、"漂绿检测"、"PRI负责任投资"、"C-PRI筛选"、"ESG筛选"、"A股ESG"、"中国可持续投资"、"洪灏周期分析"、"康波周期"、"政策周期共振"、"双重重要性"、"实质性评估"、"规模分层"、"尽责管理"、"stewardship"、"积极所有权"、"绿色投资框架"、"共同富裕贡献"、"碳中和投资",或需要完成从"该不该投"到"投了之后怎么管"的完整ESG投研流程时激活。
提供9个专业Agent协作(IC/CV/IA/SI/RSM/ES/HIA等)、四个分析视图(单一公司/横向对比/行业对标/行业画像)与风险归因分离、因子角色四分类(AR/RE/UT/MG)与QD质量门与10条红线,以及C-PRI五步筛选(负面筛选/规模分层实质性评估/尽责管理可行性/双重重要性验证/增量价值量化)、双周期共振决策、原则对齐审计与C-PRI负责任投资报告。
阅读全文 (展开查看完整说明)
概述
Real-Green AI 专家级 ESG 投研智能体
一套面向机构投资人的可信 AI 驱动 ESG 投研系统。核心主张是:ESG 投研的产出不是评分,而是可验证、可追溯、可审计的研究过程——谁是合格标的、谁比谁强、差距归因于谁、该按什么原则投、投了之后怎么管。
四层正交架构
四层可单独调用,也可叠加;C-PRI 层与视图层是串联关系(前置筛选决定样本池)。
| 层 | 切分维度 | 回答的问题 | 编排入口 | 规格说明书 |
|---|---|---|---|---|
| ① 流程层 | 按流程阶段:采集→验证→叙事→组合→尽责 | "这份结论可信吗、流程走完了吗" | scripts/full_workflow_v2.py | references/ESG_FACTOR_ENGINE_v2.md |
| ② 视图层 | 按分析对象层级:个体→对标→行业 | "这家公司在行业里什么位置、差距归因于谁" | scripts/three_layer_workflow.py | references/ESG_THREE_LAYER_FRAMEWORK.md |
| ③ 规范层 | 按因子角色与准入:AR/RE/UT/MG + QD 门 | "这个因子能不能用、怎么用" | scripts/esg_data_gate.py | references/DATA_USAGE_SPEC.md |
| ④ 原则层(C-PRI) | 按负责任投资原则与选股流程 | "该不该投、按什么原则投、投后怎么管" | scripts/cpri_workflow.py | references/CPRI_CHINA_FRAMEWORK.md |
执行顺序:
C-PRI 五步筛选(原则层) → 决定「谁能进池、按什么权重评」
↓
三层对标框架(视图层) → 决定「进池的谁更强、差距归因于谁」
↓
9-Agent 流水线(流程层) → 保证每一步的可信度分级与人类签字留痕
↓
数据使用规范(规范层) → 贯穿全程,约束每个因子的使用方式规范层与原则层对前两者强制生效:质量门、红线检查、原则对齐审计位于流程关键节点,不过门的数据不得进入结论部分。
文件结构
scripts/
├── full_workflow_v2.py # 【流程层】完整工作流演示(9个Agent协作)
├── ic_orchestrator.py # IC 首席分析师(任务编排)
├── cv_credibility_validator.py # CV 可信度验证(A/B/C/D 四级 + CIQI)
├── ia_intelligence_aggregator.py # IA 情报聚合(采集 + 去重 + 冲突仲裁)
├── si_strategic_interpreter.py # SI 战略解读(Materiality 矩阵 + 政策周期)
├── rsm_risk_signal_monitor.py # RSM 风险监测(负面事件 + 漂绿 + 舆情)
├── es_engagement_steward.py # ES 尽责管理(行动计划 + 投票建议)
├── hia_human_intelligence_advisor.py # HIA 人类分析师(8 个强制签字节点)
├── esg_scorer.py # ESG 评分(行业权重配置 + 政策导向因子)
├── portfolio_analyst.py # 投资组合诊断
├── factor_quant.py # 因子归因
│
├── esg_framework_config.py # 【视图层】统一数据口径(申万2021行业树 + 14 二级维度)
├── esg_three_layer_views.py # 【视图层】四个分析视图 + 风险归因 + MD/HTML 双渲染
├── three_layer_workflow.py # 【视图层】两条研究路径编排(自上而下 / 自下而上)
│
├── esg_report_blocks.py # 【规范层】统一文档块模型 + 双渲染器
├── esg_factor_taxonomy.py # 【规范层】因子角色四分类/预测方向/中性化/门槛/14维度映射
├── esg_data_gate.py # 【规范层】QD 质量门 + 红线检查 + 披露标注 + 合规声明块
│
├── esg_cpri_config.py # 【原则层】C-PRI 规范源(原则矩阵/分层权重/双周期/双重重要性)
├── esg_cpri_engine.py # 【原则层】五步筛选引擎 + 共振决策 + 原则审计 + C-PRI 报告
├── cpri_workflow.py # 【原则层】五步筛选全流程编排(含三层联动)
└── verify_dual_output.py # 【通用】MD/HTML 双版本一致性校验器(回归工具)
references/
├── ESG_FACTOR_ENGINE_v2.md # 【流程层】完整系统规格说明书
├── ESG_THREE_LAYER_FRAMEWORK.md # 【视图层】四个分析视图规格说明书
├── DATA_USAGE_SPEC.md # 【规范层】数据使用规范(ESGFE-SPEC-001)
├── CPRI_CHINA_FRAMEWORK.md # 【原则层】C-PRI 中国负责任投资框架规格(RG-CPRI-001)
└── cpri/ # C-PRI 原始方法论文档(7 篇,完整保留)
├── esg-dao-principles.md # ESG Investment DAO 三原则原文(2023-07-26)
├── c-pri-framework-overview.md # 双轮驱动模型 + 融合矩阵 + 四大机制 + 五步流程
├── china-materiality-assessment.md # 双重重要性中国化表达
├── size-tiered-screening.md # 规模分层筛选细则
├── policy-cycle-integration.md # 政策周期 × 康波周期共振模型
├── engagement-playbook-china.md # 中国尽责管理操作手册
└── reporting-template.md # C-PRI 报告模板
output/ # 分析报告输出目录(.md 与 .html 同名同内容)一、原则层:C-PRI 中国负责任投资
来源:联合国 PRI 六大原则 × ESG Investment DAO《ESG Investment Principles》(2023-07-26)× 中国 A 股适配层。完整规格见 references/CPRI_CHINA_FRAMEWORK.md(RG-CPRI-001)。
五步筛选流程
第一步 负面筛选(PRI P1) → 排除高违规风险标的
第二步 规模分层实质性评估 → 大/中/小盘差异化权重 + 政策周期校正
第三步 尽责管理可行性评估 → 沟通渠道 + 治理改善空间
第四步 双重重要性验证 → 影响重要性 × 财务重要性
第五步 增量价值量化 → 社会/环境贡献 + 风险调整收益python3 scripts/cpri_workflow.py # 全流程(五步 + 三层联动)
python3 scripts/cpri_workflow.py --steps 1,2 # 仅跑指定步骤
python3 scripts/cpri_workflow.py --no-three-layer # 不执行三层联动
python3 scripts/cpri_workflow.py --policy-signal headwind --phase autumn # 双逆风场景
python3 scripts/esg_cpri_engine.py # 五步视图 + 报告演示
python3 scripts/esg_cpri_config.py # 原则矩阵/分层权重/双周期/双重重要性自检核心理论支点
DAO P3.2:"We track direction, not just position"
改善方向优先于当前评分。低分但改善弹性大的标的,其超额收益来源是尽责管理带来的改善,而非当前估值。这是 C-PRI 与纯打分筛选的分水岭——后者只能发现"已经好的公司",前者可以去投"正在变好的公司"并参与推动它变好。因此低分标的不是直接剔除,而是先评估能否通过尽责管理使其改善(PRI Principle 2 的落地要求)。
机制 1:规模分层实质性评估(S > E > G)
国信证券研究结论:A 股 ESG 因子有效性呈现 S > E > G,且随市值层级变化。一套权重打所有规模层会得出错误排序。
| 市值层 | 对应指数 | E | S | G | 数据可得性 |
|---|---|---|---|---|---|
| 大盘 | 沪深300 | 40% | 35% | 25% | 高 |
| 中盘 | 中证500 | 30% | 40% | 30% | 中 |
| 小盘 | 中证1000 及以下 | 20% | 50% | 30% | 低(需代理指标) |
权重推导链:规模层基准权重 → 行业实质性倾斜 → 政策周期方向校正。
- 行业倾斜:以「100 − 行业该维度得分」作为关注度权重。行业普遍薄弱的维度权重上浮——含义是行业洼地正是个体差异最容易形成超额收益的地方。
- 政策校正:顺风加重 E(资金配套最直接),逆风加重 G(防御性来源)。
- 小盘代理指标:碳排放用「行业排放因子 × 营收规模」,员工满意度用「招聘网站评分、离职率」,供应链审计用「行业协会认证、抽查记录」。
- 动态调整:政策超配(明确支持某规模层时权重上浮 10%)、康波校正(收缩期→大盘防御,扩张期→中小盘成长)、季度复盘。
机制 2:政策周期 × 康波周期共振
| 政策信号 | 康波扩张 | 康波收缩 |
|---|---|---|
| 🟢 顺风 | 超配 ESG 主题 | 审慎配置,E 优先 |
| 🔴 逆风 | 选择性配置 | 防御 + 等待信号 |
康波四阶段与有效因子:春季·扩张→E(清洁技术);夏季·过热→S(劳工权益);秋季·收缩→G(治理质量);冬季·萧条→S+G(稳定性)。
洪灏量化工具集成:情绪周期指标→ESG 溢价/折价窗口识别;资产轮动模型→ESG 因子在成长/价值风格中的有效性切换;宏观流动性追踪(M2/社融脉冲)→绿色债券定价与 ESG 估值校正;技术周期定位→清洁技术介入时机。
边界:共振判断回答「主题该配多重」,不回答「哪家公司该配」。选标必须回到五步筛选。
机制 3:双重重要性中国化
| 重要性维度 | 方向 | 国际定义 | 中国情境映射 |
|---|---|---|---|
| 影响重要性 | Inside-out | 企业对 ESG 议题的影响 | 对共同富裕 / 绿色发展的实质贡献 |
| 财务重要性 | Outside-in | ESG 风险对财务的影响 | 政策风险敞口 + 绿色信贷优惠 |
中国政策语言映射:气候变化→"3060" 双碳目标合规性;生物多样性→生态保护红线合规;劳工标准→共同富裕工资增长贡献;供应链→产业链安全/国产替代;公司治理→国企改革进度。
14 维度 ↔ 双重重要性定位(esg_cpri_config.CPRI_DIMENSION_MATERIALITY)
- 影响重要性主导:E2 排放物与废弃物、S1 人力资本、S3 健康与安全
- 财务重要性主导:E4 气候变化、E5 绿色机遇、G1 治理结构、G2 治理机制、G3 信息披露
- 双重要性并重:E1、E3、S2、S4、S5、G4
该映射标注 D(设计/推断,未经回测验证),是本智能体自行映射,不得写入客户交付物或投标材料的结论部分。
机制 4:尽责管理中国路径
可行性评估五维(1–5 分,合计 ≥15 分建议开展主动尽责管理):沟通渠道可及性 / 治理改善空间 / 集体参与可能性 / 管理层 ESG 意识 / 监管压力传导。
三条中国路径:① 国企改革窗口期参与(国企 + 混改推进中,聚焦 G 维度质询,联合机构形成集体声音以规避单一机构政治敏感性);② 绿色信贷联动参与(以"绿色顾问"替代"维权股东"角色,将 ESG 改善条款嵌入融资安排);③ 监管协同参与(协助解读 ISSB/GRI/国内披露要求,参与行业标准制定)。
撤资升级梯次:内部提醒函(30 天窗口)→ 股东大会正式提案 → 联合声明 → 减持/撤资。在中国市场前三级优先于撤资,以维护与监管方和企业的长期合作关系。
原则对齐审计(principle_alignment)
10 项自查,值 True/False/None(None = 未校验,不假装通过)。高风险项:A1(须同时给财务与影响)、A2(须标注可信度等级)、A4(须区分当前评分与改善方向)、A5(须奖励实质行动)、A7(披露完整度不得等同收益信号)、A10(ESG 不得作单一正向 alpha 因子)。
原则对齐未通过时,相关结论不得直接对外交付。
二、视图层:三层对标框架(四个分析视图)
来源:光大证券《ESG+skill 提升研究效率》(王开,2026-08-21)。完整规格见 references/ESG_THREE_LAYER_FRAMEWORK.md。
视图与层级映射
| 层级 | 分析视图 | 定位 | 典型输入指令 |
|---|---|---|---|
| 个体层 | esg-company-analysis | 单一公司 ESG 深度评估 | "分析某上市公司(或股票代码)的 ESG 表现" |
| 对标层 | esg-selected-company-comparison | 2–4 家公司横向对比 | "对比上市公司A、B、C的ESG表现" |
| 对标层 | esg-company-industry-benchmark | 单公司 vs 所在行业对标 | "分析某上市公司在所属行业的ESG表现水平" |
| 行业层 | esg-industry-profile | 行业 ESG 整体画像 | "分析某行业的ESG整体表现" |
| 跨层 | esg-risk-attribution | 公司特有风险 vs 行业系统性风险分离 | 由前两者自动触发 |
统一数据口径(跨层可比的前提)
| 口径 | 默认值 | 可选项 |
|---|---|---|
| 行业分类 | 申万2021版二级行业分类 | GICS、中证行业分类 |
| 时间 | 同一月度截面,默认最新月度 | 必须同 asof,禁止跨期混用 |
| 维度 | 环境/社会/治理 3 个一级 + 14 个二级 | — |
14 个二级维度:E1 环境管理体系、E2 排放物与废弃物、E3 资源与能耗、E4 气候变化、E5 绿色机遇;S1 人力资本、S2 产品责任、S3 健康与安全、S4 社会资本、S5 业务创新;G1 治理结构、G2 治理机制、G3 信息披露、G4 ESG治理。
口径唯一来源为 esg_framework_config.py,提供 resolve_industry()(行业名→申万二级)与 validate_caliber()(跨层口径一致性校验)。
两条研究路径
自上而下(覆盖拓展:先选赛道、再选标的):行业画像与初筛 → 同业对标定位 → 个体深度认知
自下而上(已有关注标的的深度研究):个股基线与短板识别 → 行业坐标中的相对定位 → 行业共性验证
python3 scripts/three_layer_workflow.py --path both # 两条路径都跑
python3 scripts/three_layer_workflow.py --path top_down # 仅自上而下
python3 scripts/three_layer_workflow.py --path bottom_up # 仅自下而上风险归因(框架的核心贡献)
对每个二级维度做差(公司得分 − 行业均值,阈值 ±8 分),把一项 ESG 劣势拆开:
| 归因结论 | 判定条件 | 使用原则 |
|---|---|---|
| 公司特有短板 | 显著低于行业均值,行业本身不弱 | 可归因于标的管理能力 |
| 双重承压 | 显著低于行业均值,行业整体也弱 | 区分行业性约束与自身欠配 |
| 行业共性风险 | 与行业均值同步,行业整体弱 | 不应作为下调评价的独立理由 |
| 相对优势 | 高于行业均值,行业整体弱 | 受行业天花板限制 |
| 无显著偏离 | 与行业均值同步,行业不弱 | 不构成差异化研究抓手 |
输出物规范
四个视图统一输出 Markdown 与 HTML 两份文件,同名、内容逐字一致,一并呈现。实现上由统一文档块模型双渲染(blocks_to_markdown() / blocks_to_html()),机制上保证两版内容一致。命名:{task_id}_{view}_{标识}.md / .html。
python3 scripts/esg_three_layer_views.py # 运行四个视图演示并输出到 output/
python3 scripts/verify_dual_output.py # 校验 output/ 内所有 MD/HTML 是否逐字一致三、规范层:数据使用规范(强制)
上位文件:《Real-Green ESG 因子清单(量化投研版)v2.0》(RG-FL-QT-002)。完整规范见 references/DATA_USAGE_SPEC.md(ESGFE-SPEC-001)。可判定条款均有代码实现,不依赖人工自觉。
因子角色四分类(核心规则)
ESG 因子不应被当作单一正向 alpha 因子使用,须拆成四类角色分别处理。
| 角色 | 定义 | 模型用法 | 可否打分 |
|---|---|---|---|
| AR Alpha 信号 | 有明确风险溢价或错误定价机制 | 多空组合 / 负向剔除 | 可(仅限事件驱动+方向明确) |
| RE 风险暴露 | 刻画风险特征 | 风险预算 / 中性化约束 | 不可 |
| UT 工具性因子 | 服务于组合构建或正交化 | 入模前工序 / 优化器输入 | 不可 |
| MG 元因子(质量门) | 决定其他因子可用性 | 样本筛选 / 降权触发 | 不可 |
关键纪律:不得将披露完整度等同于收益信号。
14 个二级维度的角色:可作信号——E2、S2、S3、G3(负向剔除)、G2(负向剔除,含一票否决)、E5(正向,方向属 D 须先回测);仅作风险暴露/过滤——E1、E3、E4、S1、S4、S5、G1、G4。
样本质量门(QD 门)—— 前置过滤器
三条件全部满足才放行;字段缺失即视为未通过(无法证明合规不得放行)。
| 条件 | 阈值 | 对应因子 |
|---|---|---|
| 估算值占比(proxy 强度) | ≤ 30% | QD2-04 |
| ESG 评级覆盖家数 | ≥ 3 家 | QD1-03 |
| ESG 因子历史深度 | ≥ 5 年 | CN4-04 |
评级覆盖 <3 家时,QD1-01~05、MP2-01~04 共 9 项因子强制置空,禁止单点填充。
与 C-PRI 负面筛选的关系:两道闸门串联但性质不同——负面筛选剔除的是「不该投」(价值判断),质量门剔除的是「看不清」(数据判断),不可互相替代。
红线(10 条,执行方式:初检 → 整改 → 复检)
R1 未过门样本不得进入结论 | R2 标注不得移除 | R3 RE/UT 不得作 alpha 打分 | R4 未正交化不得直接用于组合构建 | R5 重复因子不得重复计入 | R6 覆盖 <3 家须强制置空 | R7 估算占比 >30% 须剔除或降权 | R8 一票否决因子只作剔除 | R9 漂绿信号须人工复核证据链 | R10 承诺兑现率分母仅计已到期配对
未提供输入的条款记为「未校验」,不假装通过。
一票否决型元因子
G3-02 非标审计意见、G3-06 内幕交易/市场操纵 —— 只作剔除条件,不得作打分项。
重复因子合并(防共线性)
CN1-01 ≡ S3-02(共同富裕)、CN1-02 ≡ S3-03(乡村振兴)、CN3-01 ≈ S2-04(数据安全)——同一 LLM 抽取结果不得在回归中重复计入。
透明披露纪律
| 标注 | 含义 |
|---|---|
| 设计·待回测 | v1.1 新增因子,未通过样本外 IC/ICIR 检验 |
| D(设计/推断) | 属设计判断,未经回测验证(含本引擎的 14 维度映射、预测方向、C-PRI 双重重要性映射、E/S/G 贡献分解口径) |
标注不得移除;携带标注的内容不得写入客户交付物或投标材料的结论部分。
报告强制附件
每份报告均自动附带「数据使用规范符合性声明」(因子角色表 + 质量门结果 + 红线检查表 + 披露纪律),由 usage_spec_blocks() 生成。
python3 scripts/esg_factor_taxonomy.py # 14 维度角色/方向/用法对照
python3 scripts/esg_data_gate.py # 质量门+越界+重复+标注+红线 自检四、流程层:9-Agent 流水线
python3 scripts/full_workflow_v2.py # 串联全部 9 个 Agent,7 步流水线 + 8 个人类签字节点| Agent | 文件 | 关键函数 |
|---|---|---|
| IC | ic_orchestrator.py | ICOrchestrator().receive_task() / .finalize() |
| CV | cv_credibility_validator.py | assess_data_credibility(source, cross_validated, completeness, recency_days) |
| IA | ia_intelligence_aggregator.py | IAIntelligenceAggregator().ingest() / .fuse() |
| SI | si_strategic_interpreter.py | interpret_esg_materiality(code, name, industry, e, s, g, policies) |
| RSM | rsm_risk_signal_monitor.py | monitor_risk_signals(code, name, esg_score, news_items) |
| ES | es_engagement_steward.py | generate_engagement_plan(code, name, risk_signals, esg_scores) |
| HIA | hia_human_intelligence_advisor.py | HumanAdvisor().sign(node, analyst, decision) |
可信度分级标准(CV)
| 等级 | 说明 | 来源示例 |
|---|---|---|
| A | 高可信,多方交叉验证 | 交易所年报、审计报告 |
| B | 较可信,权威单一来源 | Wind ESG、华证ESG |
| C | 需审慎,存在信息缺口 | 行业估算、媒体推断 |
| D | 仅参考,非官方来源 | 社交媒体 |
交叉验证可将 B 升 A;综合输出 CIQI 指数(0-100)。
行业 Materiality 矩阵(SI)
si_strategic_interpreter.py 中的 MATERIALITY_MATRIX 配置支持 30+ 行业 E/S/G 实质性议题,包括新能源、光伏、锂电、电力、半导体、白酒、煤炭、银行、保险等。
人机协作节点(HIA)
8 个强制人类签字节点,定义于 HumanAdvisor.CHECKPOINT_DESCRIPTIONS:
- 任务范围确认 | 2. 数据溯源确认 | 3. 争议数据复核 | 4. 风险定级确认
- 趋势解读确认 | 6. 战略对齐审核 | 7. 投资建议签字 | 8. 合规最终审查
用 HumanAdvisor().sign(node, analyst_name, decision) 记录签字。
各层编排在运行时会把 8 个节点与真实分析动作对应签满,例如 C-PRI 流程中:节点 3 对应尽责管理可行性自动推断值的复核,节点 6 对应原则对齐审计。
五、快速参考
原则层
| 视图 | 文件 | 关键函数 |
|---|---|---|
| 负面筛选(第一步) | esg_cpri_engine.py | negative_screening(universe, asof) |
| 规模分层实质性评估(第二步) | esg_cpri_engine.py | size_tiered_materiality(companies, policy_signal, industry_scores) |
| 尽责管理可行性(第三步) | esg_cpri_engine.py | stewardship_feasibility(code, name, scores, is_soe, ...) |
| 双重重要性验证(第四步) | esg_cpri_engine.py | double_materiality(code, name, dims) |
| 增量价值量化(第五步) | esg_cpri_engine.py | incremental_value(holdings, benchmark, portfolio_name) |
| 双周期共振决策 | esg_cpri_engine.py | policy_resonance_view(policy_signal, phase, policy_evidence) |
| 原则对齐审计 | esg_cpri_engine.py | principle_alignment(context) |
| C-PRI 报告 | esg_cpri_engine.py | cpri_report(period, institution, integration, ownership, materiality, value, improvement) |
| 全流程编排 | cpri_workflow.py | CPRIRunner().run_screening(...) / main() |
| 分层权重 | esg_cpri_config.py | resolve_size_tier() / weights_for_tier() / industry_tilted_weights() / apply_correction() |
| 双周期查询 | esg_cpri_config.py | resonance(policy_signal, phase) / policy_cycle_correction(signal) |
| 维度重要性 | esg_cpri_config.py | dimension_materiality(sid) / dual_materiality_matrix() |
record 字段:st_risk / major_penalty_3y / industry_redline(负面筛选);index_membership / market_cap_billion(规模层)
视图层
| 视图 | 文件 | 关键函数 |
|---|---|---|
| 单一公司分析 | esg_three_layer_views.py | analyze_company(code, name, industry, esg, dims, risk_events, universe, asof) |
| 精选公司横向对比 | esg_three_layer_views.py | compare_selected_companies(companies, asof) — 主体必须 2–4 家 |
| 公司所在行业对标 | esg_three_layer_views.py | benchmark_against_industry(code, name, industry, esg, dims, universe, asof) |
| 行业 ESG 画像 | esg_three_layer_views.py | profile_industry(industry, universe, risk_events, asof, gate) |
| 风险归因 | esg_three_layer_views.py | attribute_risk(company_view, industry_view) |
| 样本前置过滤 | esg_three_layer_views.py | qualified_universe(universe) |
| 口径解析/校验 | esg_framework_config.py | resolve_industry(name) / validate_caliber(records) / all_sub_dimensions() |
| 双版本输出 | esg_three_layer_views.py | save_dual_output(view, outdir) |
规范层
| 功能 | 文件 | 关键函数 |
|---|---|---|
| 维度角色/方向/用法查询 | esg_factor_taxonomy.py | usage_of_dimension(sid) / dimension_table_rows() |
| 可打分维度 / 仅风险暴露维度 | esg_factor_taxonomy.py | scoring_dimensions() / risk_only_dimensions() |
| 重复因子共线检查 | esg_factor_taxonomy.py | dedupe_conflicts(factor_codes) |
| 单样本质量门 | esg_data_gate.py | evaluate_gate(record) |
| 样本池质量门 | esg_data_gate.py | gate_universe(records) |
| 使用范围越界检查 | esg_data_gate.py | check_scoring_scope(dimension_ids) |
| 透明披露标注 | esg_data_gate.py | annotate_disclosure(text, status, is_design) |
| 红线检查 | esg_data_gate.py | redline_check(context) |
| 合规声明块 | esg_data_gate.py | usage_spec_blocks(dimension_ids, gate, redlines) |
record 字段:proxy_ratio / rating_coverage / history_years / veto_flags(可选)
六、使用场景
该不该投(负责任投资筛选): "用 C-PRI 框架筛一遍 A 股 ESG 标的" / "这家公司符合 PRI 原则吗" / "按规模分层给我一个 ESG 加权排名" → cpri_workflow.py
宏观时点判断: "现在是配置 ESG 主题的窗口吗" / "政策周期和康波周期共振到什么程度" → policy_resonance_view()
投后管理: "这家公司 ESG 分低,值得介入改善吗" / "设计一套尽责管理方案" / "要不要联合其他机构参与" → stewardship_feasibility() + es_engagement_steward.py
对外披露: "出一份年度 C-PRI 负责任投资报告" → cpri_report()
多层次 ESG 对标研究:
- 单公司深读:"分析某上市公司的ESG表现" →
analyze_company() - 同业横向对比:"对比A、B、C的ESG表现" →
compare_selected_companies() - 行业位次与差距:"这家公司在通信设备行业排第几" →
benchmark_against_industry() - 行业整体画像:"通信设备行业的ESG整体表现如何" →
profile_industry() - 归因判断:"这家公司的ESG短板是自身问题还是行业普遍现象" →
attribute_risk() - 完整研究:"对某行业做自上而下的ESG筛选" / "对某标的自下而上做ESG深度研究" →
three_layer_workflow.py
快速单股票分析:调用 si_strategic_interpreter + cv_credibility_validator + rsm_risk_signal_monitor 三个 Agent 组合输出。
完整持仓诊断:portfolio_analyst.py 的 diagnose_portfolio_esg(),配合 HIA 8 节点签字流程。
ESG 评分排名:esg_scorer.py 的 build_esg_score(),配合行业权重配置与 weights_for_tier() 规模分层权重。
七、结论口径纪律(不可越界项)
- ESG 不得作为单一正向 alpha 因子。C-PRI 加权得分是"负责任投资适配度"排序,不是预期收益排序。
- 披露完整度不得等同于收益信号。披露质量提升计入合规与融资资格,不计入正向 alpha。
- 共振判断不替代选标。双周期共振只决定主题暴露的轻重。
- 原则对齐未通过时,相关结论不得直接对外交付。
- D 标注内容不得进入客户交付物或投标材料的结论部分。当前属 D 的有:14 维度 ↔ 双重重要性映射、14 维度 ↔ Real-Green 因子映射、预测方向、E/S/G 收益贡献分解口径、尽责管理自动推断值。
- 尽责管理自动推断值须人工复核(未提供人工评分时程序会按可得条件推断并标注)。
- 所有输出为研究过程产物,不构成投资建议。