diff --git "a/A\350\202\241\351\207\217\345\214\226\347\255\226\347\225\245\346\212\245\345\221\212_\345\244\247\347\233\230\346\214\207\346\225\260\344\272\224\345\271\264\345\244\215\347\233\230\344\270\216\344\270\211\345\271\264\345\211\215\347\236\273_20260515.md" "b/A\350\202\241\351\207\217\345\214\226\347\255\226\347\225\245\346\212\245\345\221\212_\345\244\247\347\233\230\346\214\207\346\225\260\344\272\224\345\271\264\345\244\215\347\233\230\344\270\216\344\270\211\345\271\264\345\211\215\347\236\273_20260515.md" new file mode 100644 index 00000000..8b61a26c --- /dev/null +++ "b/A\350\202\241\351\207\217\345\214\226\347\255\226\347\225\245\346\212\245\345\221\212_\345\244\247\347\233\230\346\214\207\346\225\260\344\272\224\345\271\264\345\244\215\347\233\230\344\270\216\344\270\211\345\271\264\345\211\215\347\236\273_20260515.md" @@ -0,0 +1,200 @@ +# 中国大陆 A 股大盘指数：过去 5 年复盘与未来 3 年前瞻（量化策略视角） + +截至：2026-05-15 +样本区间：2021-05-17 ～ 2026-05-15（日频） + +> 免责声明：本文仅用于研究与技术讨论，不构成任何投资建议、交易建议或收益保证。市场存在重大不确定性，请自行评估并对交易结果负责。 + +## 1. 结论摘要（给策略准备的要点） + +- 过去 5 年区间内：中证 500 / 中证 1000 的累计收益显著高于沪深 300，但波动与最大回撤也更大；从“大小盘相对强弱”看，小盘长期占优（1000/300、500/300 比值显著上行）。 +- 三大指数日收益相关性整体偏高（0.78～0.96），多指数分散有效但有限；更有效的分散往往来自“仓位控制/风控机制”和“跨资产”（债券/黄金/CTA 等），而不仅是大盘指数之间切换。 +- 简单的趋势过滤（200 日均线过滤：上方持有、下方空仓/低风险资产）在样本期显著降低最大回撤（约从 -41%～-47% 降至 -16%～-17%），且在中证 500/1000 上提升了风险调整后表现。 +- 面向未来 3 年：更建议把策略重心放在“波动与回撤可控的收益曲线”上（趋势/波动目标/动态对冲），而不是做单点方向预测；尤其当宏观与政策变量变化更快时，风控框架比“观点正确”更重要。 + +## 2. 数据来源与方法说明 + +### 2.1 指数与代码 + +- 沪深 300：`sh000300` +- 中证 500：`sh000905` +- 中证 1000：`sh000852` + +### 2.2 数据来源 + +使用新浪财经的日 K 线接口抓取（返回字段含交易日、开高低收、成交量）。示例： + +- https://quotes.sina.cn/cn/api/json_v2.php/CN_MarketData.getKLineData?symbol=sh000300&scale=240&ma=no&datalen=1800 + +说明： + +- `scale=240` 表示日线；`datalen` 为最近 N 根 K 线。 +- 本报告只使用收盘价（Close）做复盘统计；不含分红再投资与全收益处理（指数本身通常已较接近价格指数口径）。 + +### 2.3 统计口径 + +- 日收益：`r_t = close_t / close_{t-1} - 1` +- 年化波动率：`std(r) * sqrt(252)`（252 交易日假设） +- CAGR：按自然日跨度折算 +- 最大回撤：基于收盘价/策略净值的峰值回撤 +- 夏普比：以 2% 作为名义无风险利率，仅用于横向比较（不代表可实现） + +## 3. 过去 5 年：指数表现复盘 + +### 3.1 核心指标总览 + +| 指数 | 累计收益 | CAGR | 年化波动 | 最大回撤 | 最大回撤区间（峰值→谷底） | 日收益相关性（与沪深300） | +|---|---:|---:|---:|---:|---|---:| +| 沪深300 | -6.28% | -1.29% | 17.56% | -40.86% | 2021-06-01 → 2024-09-13 | 1.00 | +| 中证500 | +29.77% | +5.36% | 21.30% | -41.81% | 2021-09-13 → 2024-09-13 | 0.85 | +| 中证1000 | +34.46% | +6.11% | 24.27% | -46.71% | 2021-12-01 → 2024-02-05 | 0.78 | + +补充：指数之间的日收益相关性（样本交集 1210 天）： + +- 沪深300 vs 中证500：0.85 +- 沪深300 vs 中证1000：0.78 +- 中证500 vs 中证1000：0.96 + +策略含义： + +- 中证 500 与中证 1000 几乎同涨同跌，更多是“Beta + 小盘风格差异”，不是独立风险因子。 +- 若要降低回撤，仅靠 500/1000 内部切换不够，通常需要引入趋势/波动控制，或跨资产对冲。 + +### 3.2 分年度收益（自然年，2021 为区间内的部分年份） + +| 年份 | 沪深300 | 中证500 | 中证1000 | +|---:|---:|---:|---:| +| 2021（05/17 起） | -4.72% | +11.88% | +24.05% | +| 2022 | -21.27% | -20.26% | -21.31% | +| 2023 | -11.75% | -8.84% | -8.35% | +| 2024 | +16.20% | +5.85% | +1.76% | +| 2025 | +21.19% | +34.62% | +31.02% | +| 2026（截至 05/15） | +3.01% | +11.57% | +11.98% | + +结构性观察： + +- 2022～2023 是“整体偏弱 + 风格分化不稳定”的阶段，方向性策略更依赖风控而非选对指数。 +- 2024～2026 早期出现修复/反弹，且中小盘弹性更强（从年度收益与累计收益可见）。 + +### 3.3 大小盘相对强弱（风格漂移） + +以“指数比值”衡量小盘相对大盘的长期趋势： + +- 中证1000 / 沪深300：从 1.245 上行至 1.787（区间显著走强） +- 中证500 / 沪深300：从 1.269 上行至 1.757（区间显著走强） + +策略含义： + +- 如果策略允许做“指数相对价值/强弱轮动”，该信号在过去 5 年呈现更稳定的中长期趋势特征（适合中低频切换、配合趋势过滤）。 +- 但要注意：风格趋势可能发生结构性反转（例如政策/监管对小盘流动性与杠杆行为更敏感），因此应当搭配回撤约束与仓位上限。 + +## 4. 一个可落地的量化核心：趋势过滤（MA200）示例 + +### 4.1 策略定义（示例） + +- 计算 200 日简单移动均线 SMA200 +- 若昨日收盘 > 昨日 SMA200：持有该指数（或对应 ETF/期货多头） +- 否则：空仓（或转入低风险资产，如货币/短债；本报告回测按“空仓=0收益”处理） + +### 4.2 回测结果（同样本区间） + +| 指数 | 指数本身最大回撤 | MA200 过滤后最大回撤 | MA200 过滤后累计收益 | MA200 过滤后年化波动 | 持仓时间占比 | +|---|---:|---:|---:|---:|---:| +| 沪深300 | -40.86% | -15.66% | +9.84% | 11.49% | 40.17% | +| 中证500 | -41.81% | -16.48% | +46.59% | 14.52% | 38.93% | +| 中证1000 | -46.71% | -16.87% | +37.37% | 15.18% | 39.09% | + +解读： + +- 该过滤器本质是“尽量不在深度下跌趋势里承受 Beta”，对回撤控制非常直接。 +- 代价是：会错过部分 V 型反弹初段；因此更适合作为“风控层/仓位上限层”，而不是唯一 alpha 来源。 + +## 5. 面向未来 3 年的“走势分析”：用情景代替预测 + +你要做的是量化策略准备，因此更推荐将“未来 3 年走势判断”组织为可交易、可回测、可风控的情景集合，而不是给单一路径预测。 + +### 5.1 关键变量（不依赖单一新闻事件） + +国际侧（影响风险偏好与资金折现）： + +- 全球主要经济体利率路径与美元流动性（影响成长股估值、海外风险资产 β、跨境资金行为） +- 地缘与供应链风险（影响风险溢价与行业景气分布） +- 大宗商品周期（影响资源品与制造业利润、通胀预期） + +国内侧（影响 A 股盈利与风险溢价）： + +- 经济增长结构：消费/制造/出口的再平衡，以及信用扩张节奏 +- 政策组合：财政、货币、产业政策与资本市场制度变化 +- 盈利周期：企业利润修复的持续性与行业分化 +- 风险偏好与流动性：增量资金结构（居民/机构/量化/被动化）与交易拥挤度 + +### 5.2 三类情景（建议用于策略参数与风控阈值设计） + +**情景 A：区间震荡 + 结构性分化（基准情景）** + +- 表现特征：指数整体收益不高但波动常态化，风格与行业轮动更频繁；趋势信号容易“假突破”。 +- 策略更优解：波动目标（Vol targeting）+ 趋势过滤 + 分散持仓（多指数/多因子），控制单次回撤。 + +**情景 B：政策/盈利共振上行（偏乐观情景）** + +- 表现特征：风险偏好提升，指数更容易走出 6～18 个月级别上升趋势；小盘弹性可能更强但波动也更大。 +- 策略更优解：趋势跟踪与动量（12M/6M）在指数层面更占优；可加入“超额仓位”但必须用回撤预算约束。 + +**情景 C：外部冲击/信用收缩导致的再下探（偏悲观情景）** + +- 表现特征：下跌阶段速度快、反弹短促；回撤控制成为首要目标。 +- 策略更优解：趋势过滤/防御仓位切换优先；若允许做对冲，可考虑股指期货的轻量对冲（降低组合净 β）。 + +## 6. 量化策略框架建议（以三大指数为核心资产池） + +下面给出一个“能从今天开始做”的策略设计蓝图，重点是可落地与可扩展： + +### 6.1 交易标的建议（示例） + +- ETF：沪深300ETF / 中证500ETF / 中证1000ETF（用于现货化持仓，适配 T+1 交易规则与资金管理） +- 股指期货：IF（沪深300）、IC（中证500）、IM（中证1000）（用于对冲、杠杆与高效换仓） + +### 6.2 策略层次（推荐分层） + +1) **信号层（决定方向/偏好）** + +- 趋势信号：MA200/MA120 等低频过滤（用于风险开关） +- 动量信号：3M/6M/12M 绝对动量与相对动量（决定指数间权重） +- 估值/盈利过滤（可选）：若你能接入盈利/估值数据，可作为仓位上限或风格约束 + +2) **仓位层（决定风险暴露大小）** + +- 波动目标：例如目标年化波动 10%～15%，根据近 20/60 日波动做杠杆/降杠杆 +- 相关性约束：500 与 1000 高相关，权重不应同时拉满；用风险预算（risk budget）而非名义资金分配 + +3) **风控层（决定“能不能活下来”）** + +- 回撤阈值：组合回撤触发降仓/清仓/冷静期 +- 风险事件开关：当波动骤升（例如 20 日波动超过长期均值的 1.5～2 倍）触发减仓 +- 交易成本与滑点：将换手率与成本显式入回测，不然信号会被高估 + +### 6.3 一个可作为起点的“指数轮动 + 风控”伪代码（描述级） + +- 每周/每月评估一次：计算沪深300/中证500/中证1000 的 12M 动量 +- 只在指数位于 MA200 上方时参与（否则权重置零） +- 在满足趋势过滤的指数中，选择动量最高的 1～2 个做配置 +- 用波动目标控制总仓位；并设置组合最大回撤阈值 + +## 7. 你接下来需要补齐的数据与验证（建议清单） + +- 加入“无风险资产”与对冲资产：短债、利率债 ETF、黄金等，用于在趋势过滤空仓时承接资金 +- 引入更多解释变量：成交额/换手、融资融券、北向/机构行为、行业景气指标（用于过滤交易拥挤与风格反转） +- 回测增强：成本、滑点、限价与交易制度（T+1、涨跌停）、期货保证金与展期成本 +- 风险测试：压力测试（单日极端跌幅）、参数敏感性、滚动样本外验证（walk-forward） + +--- + +## 附录：本报告复盘统计的可复现抓取方式（供你校验） + +示例（获取沪深300近 N 日数据）： + +```text +GET https://quotes.sina.cn/cn/api/json_v2.php/CN_MarketData.getKLineData?symbol=sh000300&scale=240&ma=no&datalen=1800 +``` + +本报告的统计结果来自 2026-05-15 抓取快照；如你在不同日期重跑，尾部数据会发生变化。 diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 00000000..e31f3f3a --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,259 @@ +# 面向金融服务的 Claude + +面向我们最常见金融服务工作流（投行、股票研究、私募股权与财富管理）的参考代理、技能与数据连接器。 + +这里的所有内容都以**同一套源文件提供两种使用方式**：你可以把它安装为 [Claude Cowork](https://claude.com/product/cowork) 插件，或通过 [Claude Managed Agents API](https://docs.claude.com/en/api/managed-agents) 在你自己的工作流引擎后端进行部署。系统提示词相同、技能相同——由你决定运行位置。 + +> [!IMPORTANT] +> 本仓库中的任何内容均不构成投资、法律、税务或会计建议。这些代理会起草分析师工作产出（模型、备忘录、研究笔记、对账结果等），供具备资质的专业人士审核。它们不会给出投资建议、执行交易、承担风险、记账入账或批准准入；所有输出都需要人工签字确认。你需要自行验证输出并确保遵守适用于贵机构的法律与监管要求。 + +仓库内容概览： + +- **[Agents](#agents)** —— 具名的端到端工作流代理（Pitch Agent、Market Researcher、GL Reconciler 等）。每个代理同时以 Cowork 插件形式发布，且提供对应的 [Claude Managed Agent 模板](./managed-agent-cookbooks)，供你通过 `/v1/agents` 部署。 +- **[Vertical plugins](#vertical-plugins)** —— 按金融垂直领域打包的底层技能、斜杠命令与数据连接器。如果你只想使用 `/comps`、`/dcf`、`/earnings` 以及连接器，而不需要完整代理，可以只安装这些垂直插件。 + +## Agents + +每个代理以它所运行的工作流命名。它们是起点：先安装与你的工作相关的代理，再根据你所在机构的流程调整提示词、技能与连接器。 + +每个代理插件都是**自包含**的——它会打包自己使用到的技能，因此安装代理本身就足够。 + +| 职能 | 代理 | 功能 | +|---|---|---| +| **研究覆盖与投顾** | **[Pitch Agent](./plugins/agent-plugins/pitch-agent)** | 可比公司、可比交易、LBO → 品牌化 pitch deck，全流程端到端 | +| | **[Meeting Prep Agent](./plugins/agent-plugins/meeting-prep-agent)** | 每次客户会议前生成简报包 | +| **研究与建模** | **[Market Researcher](./plugins/agent-plugins/market-researcher)** | 行业/主题 → 行业概览、竞争格局、同业可比、想法清单 | +| | **[Earnings Reviewer](./plugins/agent-plugins/earnings-reviewer)** | 电话会 + 披露文件 → 更新模型 → 起草纪要 | +| | **[Model Builder](./plugins/agent-plugins/model-builder)** | DCF、LBO、三表、可比——直接生成 Excel 文件 | +| **基金后台与财务运营** | **[Valuation Reviewer](./plugins/agent-plugins/valuation-reviewer)** | 导入 GP 包，运行估值模板，准备 LP 报告 | +| | **[GL Reconciler](./plugins/agent-plugins/gl-reconciler)** | 找出差异、追踪根因、提交签字确认 | +| | **[Month-End Closer](./plugins/agent-plugins/month-end-closer)** | 计提、滚动表、差异说明 | +| | **[Statement Auditor](./plugins/agent-plugins/statement-auditor)** | 在分发前审计 LP 对账单 | +| **运营与准入** | **[KYC Screener](./plugins/agent-plugins/kyc-screener)** | 解析准入材料，运行规则引擎，标记缺口 | + +如需 Managed Agent 部署用的 `agent.yaml`、叶子子代理（leaf-worker）、steering event 示例以及每个代理的安全说明，请查看 **[managed-agent-cookbooks/](./managed-agent-cookbooks)**。 + +## 仓库结构 + +```text +plugins/ + agent-plugins/ # 具名代理 — 每个目录是一个自包含插件 + vertical-plugins/ # 按金融垂直领域打包的技能 + 命令 + MCP 连接器 + partner-built/ # 合作伙伴编写的插件（LSEG、S&P Global） +managed-agent-cookbooks/ # Claude Managed Agent 配方 — 每个代理一个目录 +claude-for-msft-365-install/ # 用于配置 Claude Microsoft 365 加载项的管理员工具 +scripts/ # deploy-managed-agent.sh · check.py · validate.py · orchestrate.py · sync-agent-skills.py +``` + +## 快速开始 + +### Cowork + +在 Cowork 中，打开 **Settings → Plugins → Add plugin**，然后选择其一： + +- **粘贴本仓库 URL**：`https://github.com/anthropics/claude-for-financial-services`，随后从市场列表中选择你想要的代理与垂直插件，或 +- **上传 zip**：将 `plugins/` 下任一目录（例如 `plugins/agent-plugins/pitch-agent/`）打包成 zip 并上传。 + +### Claude Code + +```bash +# 添加 marketplace +claude plugin marketplace add anthropics/claude-for-financial-services + +# 核心技能 + 连接器（建议先装） +claude plugin install financial-analysis@claude-for-financial-services + +# 具名代理 — 按需选择 +claude plugin install pitch-agent@claude-for-financial-services +claude plugin install gl-reconciler@claude-for-financial-services +claude plugin install market-researcher@claude-for-financial-services + +# 垂直领域技能包 +claude plugin install investment-banking@claude-for-financial-services +claude plugin install equity-research@claude-for-financial-services +``` + +安装后，代理会出现在 Cowork 的分发界面；当相关时技能会自动触发；斜杠命令可在会话中使用（`/comps`、`/dcf`、`/earnings`、`/ic-memo` 等）。 + +### Claude Managed Agents + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +scripts/deploy-managed-agent.sh gl-reconciler +``` + +[`managed-agent-cookbooks/`](./managed-agent-cookbooks) 下的每个模板都会引用与其插件版本一致的系统提示词与技能。部署脚本会解析文件引用、上传技能、创建 leaf-worker 子代理，并将编排器（orchestrator）POST 到 `/v1/agents`。可参考 [`scripts/orchestrate.py`](./scripts/orchestrate.py) 中的事件循环示例，它展示了如何通过你自己的编排层在代理之间路由 `handoff_request` 事件。 + +> **研究预览：** 子代理委派（`callable_agents`）是预览能力。安全与交接建议见各代理 README。 + +## 它们如何协同工作 + +| | 定义 | 所在位置 | +|---|---|---| +| **Agents** | 端到端工作流的自包含插件——系统提示词 + 它所使用的技能。Cowork 与 Managed Agent 外壳都引用同一目录。 | `plugins/agent-plugins//` | +| **Skills** | Claude 在相关时会自动调用的领域知识、约定与分步方法。技能在垂直插件中只写一次；每个代理会同步一份自己需要的技能。 | `plugins/vertical-plugins//skills/`（源）· `plugins/agent-plugins//skills/`（打包） | +| **Commands** | 你显式触发的斜杠动作（`/comps`、`/earnings`、`/ic-memo`）。 | `plugins/vertical-plugins//commands/` | +| **Connectors** | 将 Claude 连接到你的数据（终端、研究平台、文档库等）的 [MCP servers](https://modelcontextprotocol.io/)。 | `plugins/vertical-plugins/financial-analysis/.mcp.json` | +| **Managed-agent wrappers** | 用于无界面部署的 `agent.yaml` + 一级子代理 + steering 示例。 | `managed-agent-cookbooks//` | + +所有内容均为文件（Markdown 与 JSON），无需构建步骤。 + +## Vertical Plugins + +建议从 **financial-analysis** 开始——它包含共享建模技能以及所有数据连接器。再按需叠加其它垂直插件。 + +| 插件 | 增加的能力 | +|---|---| +| **[financial-analysis](./plugins/vertical-plugins/financial-analysis)**（核心） | 可比、DCF、LBO、三表、deck 质检、Excel 审计；全部 11 个数据连接器。 | +| **[investment-banking](./plugins/vertical-plugins/investment-banking)** | CIM、teaser、process letter、buyer list、merger model、deal tracking。 | +| **[equity-research](./plugins/vertical-plugins/equity-research)** | 财报纪要、覆盖启动（initiation）、模型更新、投资主线与催化剂跟踪。 | +| **[private-equity](./plugins/vertical-plugins/private-equity)** | Sourcing、筛选、尽调清单、IC memo、投后监控。 | +| **[wealth-management](./plugins/vertical-plugins/wealth-management)** | 客户回顾、财务规划、再平衡、客户报告、TLH。 | +| **[fund-admin](./plugins/vertical-plugins/fund-admin)** | GL 对账、break tracing、计提、滚动表、差异说明、NAV tie-out。 | +| **[operations](./plugins/vertical-plugins/operations)** | KYC 文档解析与规则网格评估。 | +| **[lseg](./plugins/partner-built/lseg)**（合作伙伴） | 基于 LSEG 数据的债券 RV、swap curve、FX carry、期权波动率、宏观利率监控。 | +| **[sp-global](./plugins/partner-built/spglobal)**（合作伙伴） | 基于 S&P Capital IQ 的 tear sheet、财报预览、融资摘要。 | + +## MCP 集成 + +所有连接器集中在 **financial-analysis** 核心插件中，并在其它插件间共享。 + +| 提供方 | URL | +|---|---| +| [Daloopa](https://www.daloopa.com/) | `https://mcp.daloopa.com/server/mcp` | +| [Morningstar](https://www.morningstar.com/) | `https://mcp.morningstar.com/mcp` | +| [S&P Global](https://www.spglobal.com/) | `https://kfinance.kensho.com/integrations/mcp` | +| [FactSet](https://www.factset.com/) | `https://mcp.factset.com/mcp` | +| [Moody's](https://www.moodys.com/) | `https://api.moodys.com/genai-ready-data/m1/mcp` | +| [MT Newswires](https://www.mtnewswires.com/) | `https://vast-mcp.blueskyapi.com/mtnewswires` | +| [Aiera](https://www.aiera.com/) | `https://mcp-pub.aiera.com` | +| [LSEG](https://www.lseg.com/) | `https://api.analytics.lseg.com/lfa/mcp` | +| [PitchBook](https://pitchbook.com/) | `https://premium.mcp.pitchbook.com/mcp` | +| [Chronograph](https://www.chronograph.pe/) | `https://ai.chronograph.pe/mcp` | +| [Egnyte](https://www.egnyte.com/) | `https://mcp-server.egnyte.com/mcp` | + +> MCP 访问可能需要供应商订阅或 API key。 + +## Claude for Microsoft 365 — 安装工具 + +如果你的机构通过 Microsoft 365 加载项在 Excel、PowerPoint、Word 与 Outlook 中使用 Claude，那么 [`claude-for-msft-365-install/`](./claude-for-msft-365-install) 提供管理员工具，用于将其配置为调用**你自己的云**（Vertex AI、Bedrock 或内部 LLM gateway），而不是 Anthropic 的 API。 + +它是一个 Claude Code 插件（不是 Cowork 插件），会引导 IT 管理员生成定制的加载项清单、获取 Azure 管理员同意，并通过 Microsoft Graph 写入按用户的路由配置。安装方式： + +```bash +claude plugin install claude-for-msft-365-install@claude-for-financial-services +/claude-for-msft-365-install:setup +``` + +这与上面的代理与垂直插件是分开的——它负责把加载项部署到租户中；部署完成后，运行在其中的才是本仓库的代理与技能。 + +## 个性化定制 + +这些是参考模板——当你按自身工作方式调优后会更强。 + +- **替换连接器**：把 `.mcp.json` 指向你的数据供应商与内部系统。 +- **补充机构上下文**：将你的术语、流程、格式标准写入 skill 文件。 +- **引入你的模板**：`/ppt-template` 可以教 Claude 学会你品牌化的 PowerPoint 版式。 +- **调整代理边界**：编辑 `agents/.md` 以匹配团队真实工作流。 +- **新增内容**：复制现有结构，覆盖仓库未包含的工作流。 + +## Skill & Command 参考 + +
+financial-analysis — 核心建模、Excel、deck 质检 + +| Skill | Command | 描述 | +|---|---|---| +| comps-analysis | `/comps` | 可比公司分析（交易倍数） | +| dcf-model | `/dcf` | DCF 估值（WACC 与敏感性分析） | +| lbo-model | `/lbo` | 杠杆收购（LBO）模型 | +| 3-statement-model | `/3-statement-model` | 填充三表财务模型模板 | +| audit-xls | `/debug-model` | Excel 模型审计：公式追踪、硬编码检测、平衡校验 | +| clean-data-xls | — | 归一化并清洗 Excel 表格数据 | +| deck-refresh | — | 重新链接并刷新 deck 中嵌入的图表/表格 | +| competitive-analysis | `/competitive-analysis` | 竞争格局与市场定位 | +| ib-check-deck | — | 演示文稿错误与一致性质检 | +| pptx-author | — | 无界面生成 `.pptx` 文件（Managed Agent 模式） | +| xlsx-author | — | 无界面生成 `.xlsx` 文件（Managed Agent 模式） | +| ppt-template-creator | `/ppt-template` | 创建可复用的 PPT 模板技能 | +| skill-creator | — | 创建新技能的指南 | + +
+ +
+investment-banking — 交易材料与执行 + +| Skill | Command | 描述 | +|---|---|---| +| strip-profile | `/one-pager` | pitch book 用的一页公司 profile | +| pitch-deck | — | 以数据填充 pitch deck 模板 | +| datapack-builder | — | 从 CIM 与披露文件构建数据包 | +| cim-builder | `/cim` | 起草保密信息备忘录（CIM） | +| teaser | `/teaser` | 匿名的一页 teaser | +| buyer-list | `/buyer-list` | 战略/财务买家清单 | +| merger-model | `/merger-model` | 并购增厚/摊薄分析 | +| process-letter | `/process-letter` | 投标流程信与流程沟通材料 | +| deal-tracker | `/deal-tracker` | 跟踪在途交易与里程碑 | + +
+ +
+equity-research — 覆盖与发布 + +| Skill | Command | 描述 | +|---|---|---| +| earnings-analysis | `/earnings` | 财报后季度更新报告 | +| earnings-preview | `/earnings-preview` | 财报前情景分析与关键指标 | +| initiating-coverage | `/initiate` | 机构级 initiating 报告 | +| model-update | `/model-update` | 基于新数据更新财务模型 | +| morning-note | `/morning-note` | 早会要点与交易想法 | +| sector-overview | `/sector` | 行业格局与主题报告 | +| thesis-tracker | `/thesis` | 维护并更新投资主线 | +| catalyst-calendar | `/catalysts` | 跟踪覆盖标的催化剂 | +| idea-generation | `/screen` | 股票筛选与想法生成 | + +
+ +
+private-equity — 从 sourcing 到投后运营 + +| Skill | Command | 描述 | +|---|---|---| +| deal-sourcing | `/source` | 寻找公司、查 CRM、起草创始人外联 | +| deal-screening | `/screen-deal` | 对入站 CIM/teaser 的快速通过/拒绝 | +| dd-checklist | `/dd-checklist` | 按工作流分解的尽调清单 | +| dd-meeting-prep | `/dd-prep` | 管理层演示与专家访谈准备 | +| unit-economics | `/unit-economics` | ARR cohort、LTV/CAC、净留存、收入质量 | +| returns-analysis | `/returns` | IRR/MOIC 敏感性表 | +| ic-memo | `/ic-memo` | 起草投委会备忘录 | +| portfolio-monitoring | `/portfolio` | 跟踪投后 KPI 与偏差 | +| value-creation-plan | `/value-creation` | 交割后 100 天计划与 EBITDA bridge | +| ai-readiness | `/ai-readiness` | 评估被投公司的 AI readiness | + +
+ +
+wealth-management — 理财顾问工作流 + +| Skill | Command | 描述 | +|---|---|---| +| client-review | `/client-review` | 基于业绩与要点为客户会面做准备 | +| financial-plan | `/financial-plan` | 退休、教育、遗产与现金流预测 | +| portfolio-rebalance | `/rebalance` | 偏离分析与税务友好再平衡 | +| client-report | `/client-report` | 面向客户的业绩报告 | +| investment-proposal | `/proposal` | 面向潜在客户的提案 | +| tax-loss-harvesting | `/tlh` | TLH 机会识别与 wash sale 管理 | + +
+ +## 贡献指南 + +所有内容都是 Markdown 与 YAML。Fork、编辑、提交 PR 即可。新增内容建议： + +- 新增 skill：添加到 `plugins/vertical-plugins//skills/`，然后运行 `python3 scripts/sync-agent-skills.py` 同步到会打包它的代理。 +- 新增 agent：创建 `plugins/agent-plugins//`（含 `agents/.md` + `skills/`），并同步创建匹配的 `managed-agent-cookbooks//`。 +- 提交前运行 `python3 scripts/check.py`：它会 lint 所有 manifest，验证跨文件引用是否可解析，并在打包 skill 与其垂直源不一致时失败。 + +## 许可证 + +[Apache License 2.0](./LICENSE) diff --git a/claude-for-msft-365-install/README.zh-CN.md b/claude-for-msft-365-install/README.zh-CN.md new file mode 100644 index 00000000..6a983c43 --- /dev/null +++ b/claude-for-msft-365-install/README.zh-CN.md @@ -0,0 +1,23 @@ +# Claude for Office — 直连自有云的配置工具 + +用于配置 Claude Office 加载项的管理员工具，使其调用你自己的云端服务 +（Vertex AI、Bedrock 或 LLM gateway），而不是 Anthropic 的 API。 + +## 安装 + +```bash +claude plugin marketplace add anthropics/financial-services-plugins +claude plugin install claude-for-msft-365-install@financial-services-plugins +``` + +然后在会话中运行：`/claude-for-msft-365-install:setup` + +## Commands + +| Command | 功能 | +|---|---| +| `/claude-for-msft-365-install:setup` | 交互式向导：创建云资源、完成管理员同意、写入 manifest | +| `/claude-for-msft-365-install:manifest` | 生成定制化加载项 manifest XML | +| `/claude-for-msft-365-install:consent` | 生成加载项应用注册所需的 Azure 管理员同意 URL | +| `/claude-for-msft-365-install:update-user-attrs` | 通过 Microsoft Graph extension attributes 写入按用户配置 | +| `/claude-for-msft-365-install:bootstrap` | 构建 bootstrap endpoint：按用户下发 MCP servers、skills 与动态配置 | diff --git a/claude-for-msft-365-install/examples/python-bootstrap/README.zh-CN.md b/claude-for-msft-365-install/examples/python-bootstrap/README.zh-CN.md new file mode 100644 index 00000000..4bacfd5f --- /dev/null +++ b/claude-for-msft-365-install/examples/python-bootstrap/README.zh-CN.md @@ -0,0 +1,42 @@ +# Bootstrap endpoint — Python 参考实现 + +一个最小化的 FastAPI 实现，用于 Claude in Office 的 `/bootstrap` endpoint。 +它会校验调用方的 Entra ID token，并基于一个简单的“首条匹配”RBAC 表，为每位员工返回对应的 `skills` 与 `mcp_servers`。 + +## 连接到你的真实 Entra 租户运行 + +```bash +pip install -r requirements.txt +# 查找你的 tenant ID： +python get_tenant_id.py you@yourcompany.com +export TENANT_ID= +python app.py +``` + +## 使用假 token 本地运行 + +```bash +pip install -r requirements.txt +export TENANT_ID=dev-tenant +TOKEN=$(python mint_dev_token.py --oid alice --group investment-banking) +DEV_JWKS_PATH=dev_jwks.json python app.py & +curl -H "Authorization: Bearer $TOKEN" \ + -H "X-Claude-User-Agent: claude-word/1.0.0" \ + http://127.0.0.1:8080/bootstrap +``` + +## 定制方式 + +你需要修改的内容都在 **`config.py`** ——通常无需编辑 `app.py`。 + +- 编辑 `SKILLS` 与 `MCP_SERVERS`：你可下发的完整目录（catalog）。 +- 编辑 `RULES`：按“首条匹配即生效”的规则；底部空的 `when: {}` 是默认兜底。 +- 将 `RULES` 中的占位 group/user 名替换为你真实的 Entra Object IDs（GUIDs）。 +- token 的 `groups` claim 用于读取群组成员关系。如果你的租户不下发它，把 `app.py` 里 `groups = ...` 的逻辑替换为对内部目录的查询。 +- 规则可按 Office host 限定：`"app": "word" | "excel" | "powerpoint"`，来源于加载项发送的 `X-Claude-User-Agent` header。 +- Entra token 默认**不包含** `groups` claim。请在应用注册中启用：*App registration → Token configuration → Add groups claim*。 +- 将内存中的 `RULES` 替换为你真实的事实来源（DB、配置服务等）。 + +## 安全 + +`DEV_JWKS_PATH` 允许服务端信任自签名密钥，而不是 Microsoft 的签名密钥。服务只会在绑定到 `127.0.0.1` 时允许启用该选项。**不要**在部署环境中设置它。 diff --git a/managed-agent-cookbooks/README.zh-CN.md b/managed-agent-cookbooks/README.zh-CN.md new file mode 100644 index 00000000..8bfd09f7 --- /dev/null +++ b/managed-agent-cookbooks/README.zh-CN.md @@ -0,0 +1,38 @@ +# 金融服务的 Managed Agent 模板 + +本仓库中的每个代理都以**两种方式**发布：一种是分析师今天就能安装使用的 Cowork 插件（见仓库根目录下按垂直领域划分的目录），另一种是供平台团队在自有工作流引擎后部署的 Claude Managed Agent 模板。**同一个代理、同一套技能——由你选择接入面。**下表中的每个目录都是一个部署清单（deploy manifest），它引用与对应插件一致的“规范系统提示词”和技能文件，因此全仓库保持单一事实来源（single source of truth）。 + +运行 `../scripts/deploy-managed-agent.sh ` 可上传技能、创建 leaf workers，并用解析后的配置 `POST /v1/agents`。每个模板都带有 [`steering-examples.json`](./pitch-agent/steering-examples.json) 以及对应代理的 README（包含安全分级与 handoff 说明）。 + +| Agent | Vertical plugin | Cowork tile | CMA steering event | Leaf workers | +|---|---|---|---|---| +| [`pitch-agent`](./pitch-agent/) | investment-banking | 可比公司、可比交易、LBO → 品牌化 pitch deck | `Build pitch book: / , thesis: ` | researcher · modeler · **deck-writer** | +| [`market-researcher`](./market-researcher/) | equity-research | 行业/主题 → 概览、格局、同业可比、想法清单 | `Primer: , angle: ` | sector-reader · comps-spreader · **note-writer** | +| [`earnings-reviewer`](./earnings-reviewer/) | equity-research | 电话会 + 披露文件 → 模型更新 → 纪要草稿 | `Process earnings: ` | transcript-reader · model-updater · **note-writer** | +| [`meeting-prep-agent`](./meeting-prep-agent/) | wealth-management | 每次客户会议前生成简报包 | `Briefing pack for , meeting ` | profiler · news-reader · **pack-writer** | +| [`model-builder`](./model-builder/) | financial-analysis | DCF、LBO、三表、可比——以文件产出 | `Build for , assumptions: {...}` | data-puller · **builder** · auditor | +| [`gl-reconciler`](./gl-reconciler/) | financial-analysis | 找出差异、追踪根因、提交签字确认 | `Reconcile GL vs subledger, trade date , classes: ` | reader · critic · **resolver** | +| [`kyc-screener`](./kyc-screener/) | financial-analysis | 解析准入材料、运行规则、标记缺口 | `Screen onboarding packet ` | doc-reader · rules-engine · **escalator** | +| [`valuation-reviewer`](./valuation-reviewer/) | private-equity | 导入 GP 包，运行估值模板，准备 LP 报告 | `Review portco valuations for fund as of ` | package-reader · valuation-runner · **publisher** | +| [`month-end-closer`](./month-end-closer/) | financial-analysis | 计提、滚动表、差异说明 | `Close for period ` | ledger-reader · rollforward · **poster** | +| [`statement-auditor`](./statement-auditor/) | private-equity | 在分发前审计 LP 对账单 | `Tie out statement batch against NAV pack` | statement-reader · reconciler · **flagger** | + +**加粗** leaf 表示它是唯一持有 `Write` 的 worker。 + +## Manifest 与 API 的关系 + +`agent.yaml` 文件使用真实的 `POST /v1/agents` 字段名，并加入少量部署脚本会解析的约定： + +| Manifest 约定 | 解析后对应 | +|---|---| +| `system: {file: ../../plugins/agent-plugins//agents/.md, append: "..."}` | `system: "<内联文件内容 + append>"` | +| `system: {text: "..."}` | `system: ""` | +| `skills: [{from_plugin: ../../plugins/agent-plugins/}]` | 上传该目录下 `skills/*` → `[{type: custom, skill_id: ...}, ...]` | +| `skills: [{path: ../../...}]` | `skills: [{type: custom, skill_id: }]` | +| `callable_agents: [{manifest: ./subagents/x.yaml}]` | `callable_agents: [{type: agent, id: , version: latest}]` | + +> **研究预览：** `callable_agents`（多代理委派）仅支持**一层委派**。编排器可以调用 worker；worker 不能再调用更深层的子代理。 + +## 跨代理 handoff + +具名代理不会彼此直接调用。当一个代理需要另一个代理时，会在输出中发出 `handoff_request`；[`../scripts/orchestrate.py`](../scripts/orchestrate.py)（或你的 Temporal/Airflow/Guidewire 事件总线）会将其路由为目标会话的新 steering event。参考脚本会对目标做强 allowlist，并对 payload 做 schema 校验——其 threat model 见脚本头部说明。 diff --git a/managed-agent-cookbooks/earnings-reviewer/README.zh-CN.md b/managed-agent-cookbooks/earnings-reviewer/README.zh-CN.md new file mode 100644 index 00000000..8f80e4c4 --- /dev/null +++ b/managed-agent-cookbooks/earnings-reviewer/README.zh-CN.md @@ -0,0 +1,31 @@ +# Earnings Reviewer — managed-agent 模板 + +## 概览 + +电话会 + 披露文件 → 模型更新 → 纪要草稿。本目录与 Cowork 插件 [`earnings-reviewer`](../../plugins/agent-plugins/earnings-reviewer) 使用同一套源文件——这里是用于 `POST /v1/agents` 的 Managed Agent cookbook。 + +## 部署 + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +export FACTSET_MCP_URL=... DALOOPA_MCP_URL=... +../../scripts/deploy-managed-agent.sh earnings-reviewer +``` + +## Steering events + +见 [`steering-examples.json`](./steering-examples.json)。可由你的编排层基于覆盖列表进行扇出（fan out）：每个 ticker 启动一个会话。 + +## 安全与 handoff + +电话会纪要与新闻稿不可信（untrusted）。采用三层隔离： + +| Tier | 会接触不可信文档？ | Tools | Connectors | +|---|---|---|---| +| **`transcript-reader`** | **是** | 仅 `Read`, `Grep` | 无 | +| `model-updater` / Orchestrator | 否 | `Read`, `Grep`, `Glob`, `Agent` | FactSet、Daloopa（只读） | +| **`note-writer`**（持有 Write） | 否 | `Read`, `Write`, `Edit` | 无 | + +`transcript-reader` 只返回长度受限、并经 schema 校验的 JSON。`note-writer` 会产出 `./out/note-.docx`，并将更新后的模型写到 `./out/model-.xlsx`。 + +**Handoff：** 若财报驱动 thesis 变化需要重建 DCF，可发出面向 `model-builder` 的 `handoff_request`；`scripts/orchestrate.py` 会将其路由为新的 steering event。 diff --git a/managed-agent-cookbooks/gl-reconciler/README.zh-CN.md b/managed-agent-cookbooks/gl-reconciler/README.zh-CN.md new file mode 100644 index 00000000..b1e6fb2d --- /dev/null +++ b/managed-agent-cookbooks/gl-reconciler/README.zh-CN.md @@ -0,0 +1,36 @@ +# GL Reconciler — managed-agent 模板 + +## 概览 + +针对某个交易日与资产类别集合，找出总账（general ledger）与分账（subledger）之间的差异，追踪根因，并生成供财务主管签字的异常报告。 + +本目录与 Cowork 插件 [`gl-reconciler`](../../plugins/agent-plugins/gl-reconciler) 使用同一套源文件——这里是用于 `POST /v1/agents` 的 Managed Agent cookbook。 + +## 部署 + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +export GL_MCP_URL=... # 只读 GL MCP +export SUBLEDGER_MCP_URL=... # 只读 subledger MCP +../../scripts/deploy-managed-agent.sh gl-reconciler +``` + +## Steering events + +见 [`steering-examples.json`](./steering-examples.json)。用交易日与资产类别列表启动会话；后续事件可用于重新追踪某一条差异。 + +## 安全与 handoff + +本代理需要读取交易对手/托管方对账单等外部文档——这些由第三方撰写的文件可能包含对抗性指令。该模板通过结构化隔离，确保文档中的 payload 无法触达 shell、写工具或公司系统： + +| Tier | 会接触不可信文档？ | Tools | Connectors | +|---|---|---|---| +| **`reader`** | **是** | 仅 `Read`, `Grep` | 无 | +| **Orchestrator** | 否 | `Read`, `Grep`, `Glob`, `Agent` | 只读 GL + subledger MCP | +| **`resolver`**（持有 Write） | 否 | `Read`, `Write`, `Edit` | 无 | + +`reader` 仅返回长度受限、并经 schema 校验的 JSON（由 `scripts/validate.py` 校验）。`critic` 会基于可信来源独立复核每一条差异，编排器再将结果交给 `resolver`。`resolver` 会将异常报告写入 `./out/`；它不会打开任何外部文件。 + +**Handoff：** 若要把已验证的 breaks 交给 Month-End Closer，编排器会在最终输出中发出面向 `month-end-closer` 的 `handoff_request`；`scripts/orchestrate.py`（或你的 Temporal/Airflow worker）将其路由为新的 steering event。allowlist + payload 校验模式见脚本。 + +**不保证：** 本流程不会写入系统记录（system of record）。对总账的调整仍需代理之外的人工审批。 diff --git a/managed-agent-cookbooks/kyc-screener/README.zh-CN.md b/managed-agent-cookbooks/kyc-screener/README.zh-CN.md new file mode 100644 index 00000000..792df85f --- /dev/null +++ b/managed-agent-cookbooks/kyc-screener/README.zh-CN.md @@ -0,0 +1,31 @@ +# KYC Screener — managed-agent 模板 + +## 概览 + +解析准入材料，运行规则引擎，筛查制裁/PEP，并标记缺口。本目录与 Cowork 插件 [`kyc-screener`](../../plugins/agent-plugins/kyc-screener) 使用同一套源文件——这里是用于 `POST /v1/agents` 的 Managed Agent cookbook。 + +## 部署 + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +export SCREENING_MCP_URL=... +../../scripts/deploy-managed-agent.sh kyc-screener +``` + +## Steering events + +见 [`steering-examples.json`](./steering-examples.json)。 + +## 安全与 handoff + +准入文档不可信（untrusted）。采用三层隔离： + +| Tier | 会接触不可信文档？ | Tools | Connectors | +|---|---|---|---| +| **`doc-reader`** | **是** | 仅 `Read`, `Grep` | 无 | +| `rules-engine` / Orchestrator | 否 | `Read`, `Grep`, `Glob`, `Agent` | screening（只读） | +| **`escalator`**（持有 Write） | 否 | `Read`, `Write`, `Edit` | 无 | + +`doc-reader` 只返回长度受限、并经 schema 校验的 JSON。`escalator` 会产出 `./out/escalation-.xlsx`。 + +**不保证：** 本代理只给出风险评级建议；最终由合规官决策。 diff --git a/managed-agent-cookbooks/market-researcher/README.zh-CN.md b/managed-agent-cookbooks/market-researcher/README.zh-CN.md new file mode 100644 index 00000000..bd4ae94d --- /dev/null +++ b/managed-agent-cookbooks/market-researcher/README.zh-CN.md @@ -0,0 +1,31 @@ +# Market Researcher — managed-agent 模板 + +## 概览 + +行业/主题 → 行业概览 → 竞争格局 → 同业可比 → 想法清单 → 研究纪要。本目录与 Cowork 插件 [`market-researcher`](../../plugins/agent-plugins/market-researcher) 使用同一套源文件——这里是用于 `POST /v1/agents` 的 Managed Agent cookbook。 + +## 部署 + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +export CAPIQ_MCP_URL=... FACTSET_MCP_URL=... +../../scripts/deploy-managed-agent.sh market-researcher +``` + +## Steering events + +见 [`steering-examples.json`](./steering-examples.json)。可由 research-queue 事件触发，或由覆盖地图扇出（fan out）并行运行。 + +## 安全与 handoff + +第三方报告与发行人材料不可信（untrusted）。采用三层隔离： + +| Tier | 会接触不可信文档？ | Tools | Connectors | +|---|---|---|---| +| **`sector-reader`** | **是** | 仅 `Read`, `Grep` | 无 | +| `comps-spreader` / Orchestrator | 否 | `Read`, `Grep`, `Glob`, `Agent` | CapIQ、FactSet（只读） | +| **`note-writer`**（持有 Write） | 否 | `Read`, `Write`, `Edit` | 无 | + +`sector-reader` 只返回长度受限、并经 schema 校验的 JSON。`note-writer` 会产出 `./out/primer-.docx`（若请求 slides，也会生成 `.pptx`）。 + +**Handoff：** 若要对想法清单中的单一标的建模，可发出面向 `model-builder` 的 `handoff_request`；`scripts/orchestrate.py` 会将其路由为新的 steering event。 diff --git a/managed-agent-cookbooks/meeting-prep-agent/README.zh-CN.md b/managed-agent-cookbooks/meeting-prep-agent/README.zh-CN.md new file mode 100644 index 00000000..cf1eed06 --- /dev/null +++ b/managed-agent-cookbooks/meeting-prep-agent/README.zh-CN.md @@ -0,0 +1,31 @@ +# Meeting Prep Agent — managed-agent 模板 + +## 概览 + +每次客户会议前生成简报包。本目录与 Cowork 插件 [`meeting-prep-agent`](../../plugins/agent-plugins/meeting-prep-agent) 使用同一套源文件——这里是用于 `POST /v1/agents` 的 Managed Agent cookbook。 + +## 部署 + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +export CRM_MCP_URL=... CAPIQ_MCP_URL=... +../../scripts/deploy-managed-agent.sh meeting-prep-agent +``` + +## Steering events + +见 [`steering-examples.json`](./steering-examples.json)。通常由你的工作流引擎从日历事件触发。 + +## 安全与 handoff + +客户提供的文档与入站邮件均不可信（untrusted）。采用三层隔离： + +| Tier | 会接触不可信文档？ | Tools | Connectors | +|---|---|---|---| +| `profiler` | 否 | `Read`, `Grep` | CRM、CapIQ（只读） | +| **`news-reader`** | **是** | 仅 `Read`, `Grep` | 无 | +| **`pack-writer`**（持有 Write） | 否 | `Read`, `Write`, `Edit` | 无 | + +`pack-writer` 会产出 `./out/briefing-.pptx`；它不会直接打开客户提供的内容。 + +**不保证：** 简报包面向顾问，而非客户。不会直接面向客户发送。 diff --git a/managed-agent-cookbooks/model-builder/README.zh-CN.md b/managed-agent-cookbooks/model-builder/README.zh-CN.md new file mode 100644 index 00000000..a982c1c3 --- /dev/null +++ b/managed-agent-cookbooks/model-builder/README.zh-CN.md @@ -0,0 +1,31 @@ +# Model Builder — managed-agent 模板 + +## 概览 + +DCF、LBO、三表、可比——以文件 artifact 形式产出。本目录与 Cowork 插件 [`model-builder`](../../plugins/agent-plugins/model-builder) 使用同一套源文件——这里是用于 `POST /v1/agents` 的 Managed Agent cookbook。 + +## 部署 + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +export CAPIQ_MCP_URL=... DALOOPA_MCP_URL=... +../../scripts/deploy-managed-agent.sh model-builder +``` + +## Steering events + +见 [`steering-examples.json`](./steering-examples.json)。 + +## 安全与 handoff + +任务拆分（task-decomposition）——输入来自可信 MCP，因此隔离重点在 artifact 边界与复核。只有一个 worker 持有 `Write`： + +| Leaf | Tools | Connectors | +|---|---|---| +| `data-puller` | `Read`, `Grep` | CapIQ、Daloopa（只读） | +| **`builder`**（持有 Write） | `Read`, `Write`, `Edit`, `Bash`（沙箱） | 无 | +| `auditor` | `Read`, `Grep` | 无 | + +`auditor` 会在 `builder` 写出 `./out/model.xlsx` 后重新检查勾稽与平衡。 + +**Handoff：** 当从 `earnings-reviewer` 或 `pitch-agent` 调用时，调用方输出中的 `handoff_request` 会由 `scripts/orchestrate.py` 路由到这里，作为新的 steering event。 diff --git a/managed-agent-cookbooks/month-end-closer/README.zh-CN.md b/managed-agent-cookbooks/month-end-closer/README.zh-CN.md new file mode 100644 index 00000000..57df50d2 --- /dev/null +++ b/managed-agent-cookbooks/month-end-closer/README.zh-CN.md @@ -0,0 +1,31 @@ +# Month-End Closer — managed-agent 模板 + +## 概览 + +计提、滚动表与差异说明。本目录与 Cowork 插件 [`month-end-closer`](../../plugins/agent-plugins/month-end-closer) 使用同一套源文件——这里是用于 `POST /v1/agents` 的 Managed Agent cookbook。 + +## 部署 + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +export GL_MCP_URL=... +../../scripts/deploy-managed-agent.sh month-end-closer +``` + +## Steering events + +见 [`steering-examples.json`](./steering-examples.json)。 + +## 安全与 handoff + +支持性发票与供应商对账单均不可信（untrusted）。采用三层隔离： + +| Tier | 会接触不可信文档？ | Tools | Connectors | +|---|---|---|---| +| **`ledger-reader`** | **是** | 仅 `Read`, `Grep` | 无 | +| `rollforward` / Orchestrator | 否 | `Read`, `Grep`, `Glob`, `Agent` | internal-gl（只读） | +| **`poster`**（持有 Write） | 否 | `Read`, `Write`, `Edit` | 无 | + +`poster` 会产出 `./out/close-package--.xlsx`。JE 草稿仅用于暂存，不会直接入账到 GL。 + +**Handoff：** 接收来自 `gl-reconciler` 的 `handoff_request`（已验证的 breaks），并将其纳入月结差异说明。 diff --git a/managed-agent-cookbooks/pitch-agent/README.zh-CN.md b/managed-agent-cookbooks/pitch-agent/README.zh-CN.md new file mode 100644 index 00000000..1326e186 --- /dev/null +++ b/managed-agent-cookbooks/pitch-agent/README.zh-CN.md @@ -0,0 +1,31 @@ +# Pitch Agent — managed-agent 模板 + +## 概览 + +可比公司、可比交易、LBO → 品牌化 pitch deck，端到端完成。本目录与 Cowork 插件 [`pitch-agent`](../../plugins/agent-plugins/pitch-agent) 使用同一套源文件——这里是用于 `POST /v1/agents` 的 Managed Agent cookbook。 + +## 部署 + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +export CAPIQ_MCP_URL=... DALOOPA_MCP_URL=... +../../scripts/deploy-managed-agent.sh pitch-agent +``` + +## Steering events + +见 [`steering-examples.json`](./steering-examples.json)。 + +## 安全与 handoff + +任务拆分（task-decomposition）——与其说是处理不可信输入（数据来自 CapIQ/Daloopa MCP），不如说是为了并行与 artifact 隔离。只有一个 worker 持有 `Write`： + +| Leaf | Tools | Connectors | +|---|---|---| +| `researcher` | `Read`, `Grep` | CapIQ、Daloopa（只读） | +| `modeler` | `Read`, `Bash`（沙箱） | CapIQ、Daloopa（只读） | +| **`deck-writer`**（持有 Write） | `Read`, `Write`, `Edit` | 无 | + +通过 `pptx-author` / `xlsx-author` 产出文件到 `./out/pitch-.pptx` 与 `./out/model.xlsx`。 + +**Handoff：** 若因 thesis 变更需要重建模型，编排器会发出面向 `model-builder` 的 `handoff_request`；`scripts/orchestrate.py`（或你的工作流引擎）将其路由为新的 steering event。allowlist + payload 校验模式见脚本。 diff --git a/managed-agent-cookbooks/statement-auditor/README.zh-CN.md b/managed-agent-cookbooks/statement-auditor/README.zh-CN.md new file mode 100644 index 00000000..df6e8218 --- /dev/null +++ b/managed-agent-cookbooks/statement-auditor/README.zh-CN.md @@ -0,0 +1,31 @@ +# Statement Auditor — managed-agent 模板 + +## 概览 + +在分发前审计预生成的 LP 对账单。本目录与 Cowork 插件 [`statement-auditor`](../../plugins/agent-plugins/statement-auditor) 使用同一套源文件——这里是用于 `POST /v1/agents` 的 Managed Agent cookbook。 + +## 部署 + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +export NAV_MCP_URL=... +../../scripts/deploy-managed-agent.sh statement-auditor +``` + +## Steering events + +见 [`steering-examples.json`](./steering-examples.json)。 + +## 安全与 handoff + +生成的对账单被视为不可信（上游系统不在本代理范围内）。采用三层隔离： + +| Tier | 会接触不可信文档？ | Tools | Connectors | +|---|---|---|---| +| **`statement-reader`** | **是** | 仅 `Read`, `Grep` | 无 | +| `reconciler` / Orchestrator | 否 | `Read`, `Grep`, `Glob`, `Agent` | nav（只读） | +| **`flagger`**（持有 Write） | 否 | `Read`, `Write`, `Edit` | 无 | + +`flagger` 会产出 `./out/signoff-.xlsx`。 + +**不保证：** 本代理只给出通过/暂缓的建议；IR 在人工签字后再分发。 diff --git a/managed-agent-cookbooks/valuation-reviewer/README.zh-CN.md b/managed-agent-cookbooks/valuation-reviewer/README.zh-CN.md new file mode 100644 index 00000000..c4e154a2 --- /dev/null +++ b/managed-agent-cookbooks/valuation-reviewer/README.zh-CN.md @@ -0,0 +1,33 @@ +# Valuation Reviewer — managed-agent 模板 + +## 概览 + +导入 GP 包，运行估值模板，准备 LP 报告。本目录与 Cowork 插件 [`valuation-reviewer`](../../plugins/agent-plugins/valuation-reviewer) 使用同一套源文件——这里是用于 `POST /v1/agents` 的 Managed Agent cookbook。 + +## 部署 + +```bash +export ANTHROPIC_API_KEY=sk-ant-... +export PORTFOLIO_MCP_URL=... +../../scripts/deploy-managed-agent.sh valuation-reviewer +``` + +## Steering events + +见 [`steering-examples.json`](./steering-examples.json)。 + +## 安全与 handoff + +GP 提供的估值材料不可信（untrusted）。采用三层隔离： + +| Tier | 会接触不可信文档？ | Tools | Connectors | +|---|---|---|---| +| **`package-reader`** | **是** | 仅 `Read`, `Grep` | 无 | +| `valuation-runner` / Orchestrator | 否 | `Read`, `Grep`, `Glob`, `Agent` | portfolio（只读） | +| **`publisher`**（持有 Write） | 否 | `Read`, `Write`, `Edit` | 无 | + +`package-reader` 只返回长度受限、并经 schema 校验的 JSON。`publisher` 会产出 `./out/lp-pack-.xlsx`。 + +**Handoff：** 若要将标记的被投公司（portcos）交给 GL Reconciler 进一步处理，可发出面向 `gl-reconciler` 的 `handoff_request`；`scripts/orchestrate.py` 会负责路由。 + +**不保证：** LP 报告在本代理之外仍需 IR 与 CCO 签字确认。 diff --git a/plugins/partner-built/lseg/README.zh-CN.md b/plugins/partner-built/lseg/README.zh-CN.md new file mode 100644 index 00000000..49d64720 --- /dev/null +++ b/plugins/partner-built/lseg/README.zh-CN.md @@ -0,0 +1,62 @@ +# LSEG 金融分析插件 + +使用 LSEG 金融数据与分析能力对债券定价、分析收益率曲线、评估 FX carry 交易、期权估值，并构建宏观仪表盘。 + +## 本插件做什么 + +本插件将 LSEG 的金融分析 MCP 工具封装为 8 个高层工作流：每个命令会将多个工具调用串联起来，以完成常见金融分析任务。你无需逐个调用底层工具；每个命令会把 4–5 个工具编排成一个连贯的分析流程。 + +## Commands + +| Command | 描述 | +|---------|-------------| +| `/analyze-bond-rv` | 分析债券相对价值：利差拆解与情景压力测试 | +| `/analyze-fx-carry` | 评估 FX carry 机会：现汇、远期、波动率曲面与历史背景 | +| `/research-equity` | 生成股票研究快照：一致预期、基本面与价格表现 | +| `/analyze-swap-curve` | 分析 swap curve：叠加国债与通胀曲线，产出曲线交易想法 | +| `/analyze-option-vol` | 分析期权波动率：波动率曲面、希腊值、隐含 vs 已实现对比 | +| `/review-fi-portfolio` | 审阅固收组合：定价、现金流与情景分析 | +| `/macro-rates` | 构建宏观与利率仪表盘：经济指标、收益率曲线与 swap 利差 | +| `/analyze-bond-basis` | 分析债券期货基差：CTD 识别与 implied repo rate | + +## Skills + +每个命令都由对应的 skill 支撑，提供深入的领域方法论： + +| Skill | 领域知识 | +|-------|-----------------| +| `bond-relative-value` | 利差框架、G-spread/Z-spread/OAS、rich-cheap 分析 | +| `fx-carry-trade` | carry 机制、carry-to-vol 比率、G10 与新兴市场 carry 动态 | +| `equity-research` | IBES 一致预期解读、基本面分析、估值指标 | +| `swap-curve-strategy` | swap curve 构建、曲线交易、实际利率分析 | +| `option-vol-analysis` | 波动率曲面解读、SABR 模型、希腊值、隐含 vs 已实现波动率 | +| `fixed-income-portfolio` | 组合分析、关键期限久期、现金流分析、情景测试 | +| `macro-rates-monitor` | 宏观指标、收益率曲线形态、实际利率、金融条件 | +| `bond-futures-basis` | CTD 机制、基差计算、implied repo、交割期权 | + +## Integrations + +本插件连接到 **LFA MCP Server**，可访问 LSEG 在以下领域的金融数据与分析能力： + +- **债券定价**：债券与债券期货估值 +- **外汇定价**：即期与远期汇率 +- **曲线**：利率、信用、通胀与 FX 远期曲线 +- **掉期**：利率掉期定价 +- **期权**：包含全部希腊值的期权估值 +- **波动率**：FX 与股票隐含波动率曲面 +- **量化分析**：分析师预期、公司基本面、股票价格、宏观数据 +- **时间序列**：历史定价摘要 +- **YieldBook**：固收参考数据、现金流、情景与风险分析 + +完整工具清单见 [CONNECTORS.md](CONNECTORS.md)。 + +## 安装 + +``` +claude plugins add LSEG +``` + +## 要求 + +- 具备可用凭据的 LSEG MCP Server 访问权限 +- 对应产品的 LSEG 数据授权（entitlements） diff --git a/plugins/partner-built/spglobal/README.zh-CN.md b/plugins/partner-built/spglobal/README.zh-CN.md new file mode 100644 index 00000000..01e48187 --- /dev/null +++ b/plugins/partner-built/spglobal/README.zh-CN.md @@ -0,0 +1,88 @@ +# S&P Global 插件 + +本插件通过一组预置技能，将 S&P Global 的金融数据与分析能力直接带入你的 AI 工作流。它面向希望基于权威 S&P Global 数据进行 AI 辅助研究、分析与文档生成的金融从业者。 + +这些技能构建在开放标准（MCP）之上，能够跨 AI 平台与 agent 框架工作。尽管本插件遵循 Claude Cowork 标准，但所有技能以及底层数据层均与平台无关。如果你希望在其它环境中使用这些技能，欢迎这样做。 + +我们理解每家机构都有独特需求。这里的技能是帮助你起步的起点，你可以根据本机构的流程、模板与数据需求，调整提示词、输出与工作流。 + +本插件内技能按“现状”提供。生成的输出与数据不保证正确。**请始终对 LLM 生成的结果进行校验。** + +## 包含的技能 + +### Tearsheets +**需要**：订阅 [S&P Global LLM-ready API](https://www.marketplace.spglobal.com/en/solutions/kensho-llm-ready-api-%28a156fe9f-5564-4f60-a624-95d8645dc98f%29) + +生成一到两页格式化的公司 tearsheet（Word 文档），并使用 S&P Capital IQ 的实时数据填充。支持四种受众类型，每种针对不同场景优化： +* 股票研究：为买方/卖方分析师生成投资主线快照 +* 投资银行 / 并购：在交易语境下的公司 profile +* 企业发展（Corp Dev）：面向内部战略团队的收购标的 profile +* 销售 / 商务拓展：面向商业团队的客户会议准备 + +**示例提示词**："Generate a business development tearsheet for Palantir." + +### 行业交易摘要（Industry Transaction Summaries） +**需要**：订阅 [S&P Global LLM-ready API](https://www.marketplace.spglobal.com/en/solutions/kensho-llm-ready-api-%28a156fe9f-5564-4f60-a624-95d8645dc98f%29) + +基于 S&P Capital IQ 交易数据，总结某个行业（或某家公司）近期并购与交易活动。适用于市场映射、pitch 准备与竞争情报。 + +**示例提示词**："Summarize recent transactions in the data infrastructure space” + +### 财报预览（Earnings Previews） +**需要**：订阅 [S&P Global LLM-ready API](https://www.marketplace.spglobal.com/en/solutions/kensho-llm-ready-api-%28a156fe9f-5564-4f60-a624-95d8645dc98f%29) + +为即将发布的财报生成结构化预览，包括一致预期、近期指引、分析师情绪与关注要点——全部来源于 S&P Capital IQ。 + +**示例提示词**："Give me an earnings preview for Salesforce." + +## 使用方式 + +插件与技能需要访问 S&P Global 数据方可工作，可使用 [Capital IQ Pro](https://www.spglobal.com/market-intelligence/en/solutions/products/sp-capital-iq-pro) 或订阅 [S&P Global LLM-ready API](https://www.marketplace.spglobal.com/en/solutions/kensho-llm-ready-api-%28a156fe9f-5564-4f60-a624-95d8645dc98f%29)。 + +LLM-ready API 可以通过其 MCP server 轻松集成到 Claude 或其它应用中。请按照 [这些步骤](docs.kensho.com/llmreadyapi/mcp/third-party/claude) 进行设置。 + +### 在 Cowork 中 +你需要付费的 Claude 计划（Pro、Max、Team 或 Enterprise）以及 macOS 或 Windows 的 Claude Desktop 应用。 + +1. 打开 Claude Desktop 并进入 **Cowork** 标签页 +1. 点击 **Customize with Plugins** +1. 在 Browse Plugins 中选择 **Personal** +1. 点击 **加号 “+”** 添加插件 +1. 按提示使用你的 S&P Global 凭据完成认证 + +安装后，相关场景下技能会自动激活——用自然语言描述你的需求即可。你也可以在聊天里输入 `/` 查看可用命令并显式调用特定技能。 + +要将插件定制为适配你机构的工作流、模板或术语，请在已安装插件界面点击 **Customize**。我们鼓励你这样做；默认配置只是起点，而非标准答案。 + +### 在 Claude Desktop 中（单独安装技能） +如果你想在 Claude Desktop 中只安装单独技能，而不安装整个插件： + +1. 打开 **Settings** +1. 进入 **Capabilities → Skills** +1. 点击 **Add** +1. 上传本仓库中的 skill 文件 + +上传后技能会立即可用。你可以按需安装一个或多个。 + +### 在 Claude Code 中（单独安装技能） + +请参考 [Claude Code 文档](https://code.claude.com/docs/en/discover-plugins#add-from-github)。 + +### 其它平台 +本仓库中的技能是 Markdown 文件。任何支持自定义指令、系统提示词或知识文件上传的 AI 平台都可以使用它们——具体机制随平台而异，但原则相同：将 skill 内容加载为持久上下文。 + +**ChatGPT**：把 skill 内容粘贴到自定义指令（Settings → Customize ChatGPT），作为 Project 的知识文件上传，或加入自定义 GPT 的配置。自定义指令对所有会话全局生效；Project 级文件将上下文限制在特定工作流内。 + +**Microsoft Copilot**：根据你的 Copilot 配置（M365 Copilot、Copilot Studio 等），将 skill 内容粘贴到自定义提示词或系统指令中。通过 Copilot Studio 的企业部署通常支持直接上传知识源。 + +**其它平台**：如果平台支持系统提示词或持久指令层，将 skill Markdown 粘贴到该处；如果支持文件式知识检索，则上传 skill 文件。技能是纯 Markdown，不需要任何特殊格式或工具。 + +## 后续计划 + +我们正在持续构建更多覆盖金融工作流的技能与插件。欢迎告诉我们你最希望看到什么能力！如有一般问题、反馈或合作咨询，请联系 [commercial@kensho.com](mailto:commercial@kensho.com) 或在本仓库中提 issue。 + +# 许可证 + +Licensed under the Apache 2.0 License. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +Copyright 2026-present Kensho Technologies, LLC. The present date is determined by the timestamp of the most recent commit in the repository. diff --git a/plugins/vertical-plugins/investment-banking/README.zh-CN.md b/plugins/vertical-plugins/investment-banking/README.zh-CN.md new file mode 100644 index 00000000..06d8fd15 --- /dev/null +++ b/plugins/vertical-plugins/investment-banking/README.zh-CN.md @@ -0,0 +1,83 @@ +# 投资银行插件 + +面向股票研究、估值、演示文稿与交易材料的投行效率工具。 + +## 功能 + +- **交易材料**：CIM、teaser、process letter、buyer list +- **演示文稿**：strip profile、一键生成带品牌模板的 pitch deck +- **交易支持**：merger model、deal tracking、data pack + +## 安装 + +```bash +claude --plugin-dir /path/to/investment-banking +``` + +或将本目录复制到你项目的 `.claude-plugin/` 目录中。 + +## Commands + +| Command | 描述 | +|---------|-------------| +| `/one-pager [company]` | 为 pitch book 生成一页式 strip profile | +| `/cim [company]` | 起草保密信息备忘录（CIM） | +| `/teaser [company]` | 匿名的一页公司 teaser | +| `/buyer-list [company]` | 战略/财务买家清单 | +| `/merger-model [deal]` | 并购增厚/摊薄分析 | +| `/process-letter [deal]` | 投标说明与流程沟通材料 | +| `/deal-tracker` | 跟踪在途交易、里程碑与行动项 | + +## Skills + +### 交易材料 +| Skill | 描述 | +|-------|-------------| +| **cim-builder** | 起草保密信息备忘录（CIM） | +| **teaser** | 匿名的一页公司 teaser | +| **process-letter** | 投标说明与流程沟通材料 | +| **buyer-list** | 战略/财务买家清单 | +| **datapack-builder** | 从 CIM 与披露文件构建数据包 | + +### 演示文稿 +| Skill | 描述 | +|-------|-------------| +| **strip-profile** | pitch book 用的高信息密度公司 profile | +| **pitch-deck** | 以数据填充 pitch deck 模板 | + +### 交易支持 +| Skill | 描述 | +|-------|-------------| +| **merger-model** | 并购增厚/摊薄分析 | +| **deal-tracker** | 跟踪在途交易、里程碑与行动项 | + +## 示例工作流 + +### 一页式 Strip Profile +``` +/one-pager Target + +# 生成内容： +# - 使用 PPT 模板的一页公司 profile +# - 四象限：概览、业务、财务、股权/持股结构 +# - 遵守模板边距与品牌规范 +``` + +### CIM 起草 +``` +/cim Target + +# 生成内容： +# - 完整 CIM 文档：执行摘要、业务概览、 +# 财务分析与市场定位 +``` + +### Merger Model +``` +/merger-model Acquirer acquiring Target + +# 生成内容： +# - 增厚/摊薄分析 +# - 资金来源与用途、备考财务报表 +# - 对收购价与协同的敏感性分析 +```