企业官网建设流程全解析

Valuation Reviewer 完整指南：GP估值包摄入与LP报告暂存的三步工作流

【免费下载链接】financial-services项目地址: https://gitcode.com/GitHub_Trending/fi/financial-services

Valuation Reviewer 是 financial-services 仓库中面向私募基金场景的托管智能体（Managed Agent）模板：它摄入 GP（普通合伙人）提供的估值包，运行估值模板与水瀑模型（Waterfall），最终生成并暂存 LP（有限合伙人）报告。本文带你快速理解它的完整流程与安全设计。

一、Valuation Reviewer 是什么？

Valuation Reviewer 的设定是一位"基金核算负责人（fund-accounting lead）"，给定一个基金名称和估值基准日，它交付三样东西：

它的定位是季度末组合估值审查，而不是交易时点的投资论证（那属于 model-builder 的职责）。完整角色定义见 valuation-reviewer.md。

二、三步工作流：从估值包到 LP 报告 📦

整个流程由三个子智能体（subagent）接力完成，每个角色只能看到自己需要的权限。

1️⃣ 摄入：package-reader 读取 GP 估值包

GP 提供的估值包被明确视为不可信输入（untrusted）。负责读取的 package-reader.yaml 子智能体：

• 只配备Read和Grep两个只读工具，没有任何连接器权限；
• 把文档里出现的任何"指令"都当作数据处理，防止提示词注入；
• 输出严格受 JSON Schema 约束的结构化结果：基金名、基准日（as_of）、每家 portco 的报告公允价值（reported_fv）和估值方法（market_multiple/dcf/recent_round等），单基金最多 500 家 portco。

2️⃣ 审查：valuation-runner 跑估值模板与水瀑模型

valuation-runner.yaml 拿到的是已通过 Schema 校验的干净数据，而不是原始文档：

• 通过portfolioMCP 服务器（只读模式）对照公司估值政策（policy）核对报告估值（reported marks）；
• 运行水瀑模型，计算 NAV 与分配；
• 输出审查标记（reviewer flags），全程只读。

它挂载了两个关键技能：returns-analysis（IRR / MOIC 与敏感性分析）和 portfolio-monitoring（组合公司 KPI 跟踪与红黄绿偏差标记）。

3️⃣ 暂存：publisher 生成 LP 报告包

publisher.yaml 是唯一拥有Write权限的工作节点：

• 只接收审查后的估值汇总与水瀑结果，绝不直接打开 GP 原始包；
• 使用 xlsx-author 技能，无头（headless）生成工作簿；
• 产物固定写入./out/lp-pack-<fund>.xlsx，作为"暂存"（staging）状态，等待 IR 复核。

三、三层隔离：为什么这个设计值得学习 🔒

README 中给出了清晰的权限隔离矩阵（见 README.md）：

核心思想：能读不可信内容的节点不能写文件，能写文件的节点接触不到不可信内容。即使 GP 估值包里嵌入了恶意指令，攻击面也被限制在最外层节点内。

四、快速部署与触发方式 🚀

整个菜谱（cookbook）由 agent.yaml 定义，模型为claude-opus-4-7，技能全部来自 Cowork 插件 plugins/agent-plugins/valuation-reviewer/。

部署只需两步：

1. 设置环境变量ANTHROPIC_API_KEY与PORTFOLIO_MCP_URL（指向你的组合数据 MCP 服务）；
2. 运行部署脚本：../../scripts/deploy-managed-agent.sh valuation-reviewer，脚本为 deploy-managed-agent.sh。

部署后可通过"转向事件"（steering event）触发任务，例如（示例见 steering-examples.json）：

• 季末全基金审查："Review portco valuations for fund Growth-III as of 2026-03-31"
• 单只 portco 深查："Review valuation: fund Growth-III, portco PC-014 only, as of 2026-03-31"
• 标记调整后重跑水瀑："Re-run waterfall for fund Growth-III after mark adjustments"

五、下游协作与边界 📤

• 交接（Handoff）：当审查发现被标记（flagged）的 portco 需要对账时，Valuation Reviewer 会发出handoff_request事件转给 GL Reconciler（总账核对智能体），由 orchestrate.py 负责路由——该脚本还专门做了防注入处理，避免被标记文档中的伪造 handoff 内容被原样执行。
• 明确边界：LP 报告的对外分发不在本智能体职责范围内，必须由 IR（投资者关系）与 CCO 在体系外完成签核（sign-off）。

六、总结

Valuation Reviewer 用三个职责单一的子智能体，把"不可信的 GP 估值包 → 合规的 LP 报告暂存"这条链路拆成了可审计的步骤：

1. package-reader：只读摄入，输出 Schema 校验的 JSON；
2. valuation-runner：只读审查，对照政策跑水瀑模型；
3. publisher：唯一的写入者，生成./out/lp-pack-<fund>.xlsx。

如果你正在为基金会计、估值审查等金融场景设计 AI 工作流，这套"最小权限 + 三层隔离 + 暂存而非分发"的模式非常值得直接参考。

【免费下载链接】financial-services项目地址: https://gitcode.com/GitHub_Trending/fi/financial-services