@baimingtao/lbs-agent 1.0.0

package/extensions/skills/optional/finance/lbo-model/SKILL.md

@@ -0,0 +1,290 @@
+---
+name: lbo-model
+description: 在 Excel 中构建杠杆收购（LBO）模型 — 资金来源与运用 (Sources & Uses)、债务偿还表 (Debt schedule)、现金流扫除 (Cash sweep)、退出倍数 (Exit multiple)、IRR/MOIC 敏感性分析。与 excel-author 搭配使用。适用于私募股权 (PE) 初筛、买方估值 (Sponsor-case valuation) 或路演 (Pitch) 中的说明性 LBO。
+version: 1.0.0
+author: Anthropic (adapted by Nous Research)
+license: Apache-2.0
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [finance, valuation, lbo, private-equity, excel, openpyxl, modeling]
+    related_skills: [excel-author, pptx-author, dcf-model, 3-statement-model]
+---
+
+## 环境
+
+这个 skill 假定使用 **headless openpyxl** — 即在磁盘上生成一个 .xlsx 文件。
+请遵循 `excel-author` skill 的规范来处理单元格颜色、公式、命名范围 (named ranges) 和敏感性分析表。
+在交付前重新计算：`python /path/to/excel-author/scripts/recalc.py ./out/model.xlsx`。
+
+---
+
+## 模板要求
+
+**这个 skill 使用模板来构建 LBO 模型。请务必首先检查是否附带了模板文件。**
+
+在开始任何 LBO 模型之前：
+1. **如果附带/提供了模板文件**：严格按照该模板的结构进行操作 - 复制它并填入用户的数据
+2. **如果没有附带模板**：询问用户：*“您是否有希望我使用的特定 LBO 模板？如果没有，我可以使用包含资金来源与运用 (Sources & Uses)、运营模型 (Operating Model)、债务偿还表 (Debt Schedule) 和回报分析 (Returns Analysis) 的标准模板。”*
+3. **如果使用标准模板**：复制 `examples/LBO_Model.xlsx` 作为起点，并填入用户的假设
+
+**重要提示**：当像 `LBO_Model.xlsx` 这样的文件被附带时，您**必须**将其用作您的模板 - 不要从头开始构建。即使模板看起来很复杂或具有比所需更多的功能，也请复制它并根据用户的要求进行调整。当提供了模板时，绝对不要决定“从头开始构建”。
+
+---
+
+## 关键说明 — 请首先阅读
+
+使用 Python/openpyxl。编写公式字符串 (`ws["D20"] = "=B5*B6"`)，然后在交付前运行 `excel-author` skill 的 `recalc.py` 辅助脚本。
+
+### 核心原则
+* **每个计算都必须是 Excel 公式** - 绝对不要在 Python 中计算值并将结果硬编码到单元格中。使用 openpyxl 时，请编写 `cell.value = "=B5*B6"` (公式字符串)，而不是 `cell.value = 1250` (计算结果)。模型必须是动态的，并在输入更改时更新。
+* **使用模板结构** - 遵循 `examples/LBO_Model.xlsx` 或用户提供的模板中的组织方式。不要发明您自己的布局。
+* **使用正确的单元格引用** - 所有公式都应引用相应的单元格。绝对不要输入应该来自其他单元格的数字。
+* **保持正负号惯例的一致性** - 遵循模板使用的任何正负号惯例（有些流出用负数表示，有些用正数表示）。在整个过程中保持一致。
+* **按部分工作，在每个步骤与用户进行验证** - 完整完成一个部分，向用户展示构建的内容，运行该部分的验证检查，并在继续下一部分**之前**获得确认。**不要**从头到尾构建整个模型然后再展示 — 后面的部分取决于前面的部分，因此如果在已经构建了回报之后在“资金来源与运用”中发现错误，意味着到处都要返工。
+
+### 公式颜色惯例
+* **蓝色 (0000FF)**：硬编码的输入 - 不引用其他单元格的键入数字
+* **黑色 (000000)**：带有计算的公式 - 任何使用运算符或函数的公式 (`=B4*B5`, `=SUM()`, `=-MAX(0,B4)`)
+* **紫色 (800080)**：链接到**同一选项卡**上的单元格 - 没有计算的直接引用 (`=B9`, `=B45`)
+* **绿色 (008000)**：链接到**不同选项卡**上的单元格 - 跨表引用 (`=Assumptions!B5`, `='Operating Model'!C10`)
+
+### 填充颜色调色板 — 专业蓝与灰 (除非用户/模板另有指定，否则为默认)
+* **保持极简** — 仅使用蓝色和灰色作为单元格填充。**不要**引入绿色、黄色、红色或多种强调色。专业的 LBO 模型讲究克制。
+* **默认填充调色板：**
+  * **部分标题** (资金来源与运用，运营模型等)：深蓝色 `#1F4E79` 配白色加粗文本
+  * **列标题** (Year 1, Year 2 等)：浅蓝色 `#D9E1F2` 配黑色加粗文本
+  * **输入单元格**：浅灰色 `#F2F2F2` (或仅用白色) — 蓝色*字体*是主要信号，填充是次要的
+  * **公式/计算单元格**：白色，无填充
+  * **关键输出** (IRR, MOIC, Exit Equity)：中蓝色 `#BDD7EE` 配黑色加粗文本
+* **这就是整个调色板。** 3 种蓝色 + 1 种灰色 + 白色。如果模板使用自己的颜色，请遵循模板。
+* 注意：上面的蓝色/黑色/紫色/绿色**字体**颜色用于区分输入、公式和链接。它们与此处的**填充**调色板是分开的 — 两者协同发挥作用。
+
+### 数字格式标准
+* **货币**：`$#,##0;($#,##0);"-"` 或 `$#,##0.0`，具体取决于模板
+* **百分比**：`0.0%` (一位小数)
+* **倍数**：`0.0"x"` (一位小数)
+* **MOIC/详细比率**：`0.00"x"` (两位小数以保精确)
+* **所有数字单元格**：右对齐
+
+---
+
+### 首先澄清要求
+
+在填写任何公式之前：
+
+* **检查模板结构** - 识别所有部分，了解时间轴（哪些列属于哪些周期），记下任何现有的公式
+* **询问用户是否有任何不清楚的地方** - 如果模板结构、计算方法或要求不明确，请在继续之前提出询问
+* **确认关键假设** - 任何关键输入、计算偏好或特定要求
+* **只有在了解了模板之后**，才能继续填写公式
+
+---
+
+## 模板分析阶段 - 首先执行此操作
+
+在填写任何公式之前，请彻底检查模板：
+
+1. **梳理结构** - 确定每个部分所在的位置以及它们之间的相互关系。记下哪些部分会输入到其他部分。
+
+2. **了解时间轴** - 哪些列代表哪些周期？是否有“交割”或“预测”列？预测期从哪里开始？
+
+3. **识别输入与公式单元格** - 模板通常使用颜色编码、边框或阴影来指示哪些单元格需要输入，哪些需要公式。请尊重这些惯例。
+
+4. **仔细阅读现有标签** - 行标签会准确告诉您预期的计算是什么。不要假设 - 阅读模板的要求。
+
+5. **检查现有公式** - 有些模板是部分填好的。除非有明确要求，否则不要覆盖正在工作的公式。
+
+6. **注意特定于模板的惯例** - 正负号惯例、小计结构、各部分的组织方式，以及不同的组件是否有单独的选项卡等。
+
+---
+
+## 填写公式 - 通用方法
+
+对于每个需要公式的单元格，请遵循此层级结构：
+
+### 第 1 步：检查模板
+* 该单元格是否已经有公式？如果是，验证其是否正确并继续下一步。
+* 是否有指示预期计算的注释或说明？
+* 行/列标签是否使计算变得一目了然？
+* 相邻单元格是否显示了您应该遵循的模式？
+
+### 第 2 步：检查用户的指示
+* 用户是否指定了特定的计算方法？
+* 是否有影响此公式的既定假设？
+* 是否提到了任何特殊要求？
+
+### 第 3 步：应用标准惯例
+* 如果模板和用户均未指定，请使用标准的 LBO 建模惯例
+* 记录您所做的任何假设
+* 如果确实不确定，请询问用户
+
+---
+
+## 常见问题区域
+
+以下计算模式经常在各类 LBO 模型中引发问题。遇到这些情况时请特别注意：
+
+### 平衡部分
+* 当两个部分必须相等时（例如，Sources = Uses），其中一个项目通常是“填补项”（平衡数字）
+* 确定哪个项目是填补项，并将其计算为差额
+
+### 税务计算
+* 税务公式应仅引用相关的收入行和税率
+* 不应引用无关的部分（例如，债务偿还表）
+* 考虑亏损是产生税盾 (Tax shield) 还是被直接忽略
+
+### 利息与循环引用
+* 如果利息引用受现金流影响的余额，则利息计算会产生循环引用
+* 使用**期初余额**（而不是平均值或期末余额）来打破循环引用
+* 模式：利息 → 现金流 → 偿还款 → 期末余额（如果利息使用期末余额，则会形成循环）
+
+### 债务偿还 / 现金流扫除
+* 当存在多层债务时，通常有一个优先顺序
+* 现金流扫除应遵守优先级瀑布
+* 余额不能变为负数 - 适当使用 MAX 或 MIN 函数
+
+### 回报计算 (IRR/MOIC)
+* 现金流必须有正确的正负号：投资 = 负，收益 = 正
+* 如果使用 XIRR，需要相应的日期
+* 如果使用 IRR，现金流应处于连续的周期内
+* MOIC = 总收益 / 总投资
+
+### 敏感性分析表
+* **使用奇数尺寸** (5×5 或 7×7) — 绝不要用 4×4 或 6×6。奇数尺寸可保证存在真正的中心单元格。
+* **中心单元格 = 基准情景**。围绕模型实际的假设对称地构建行和列轴的值（例如，如果基准进入倍数 = 10.0x，则轴 = `[8.0x, 9.0x, 10.0x, 11.0x, 12.0x]`）。中心单元格的 IRR/MOIC **必须**等于模型实际输出的 IRR/MOIC — 这是证明该表连接正确的依据。
+* **高亮中心单元格** — 中蓝色填充 (`#BDD7EE`) + 加粗字体，从而使基准情景在视觉上得以锚定。
+* Excel 的 DATA TABLE 功能可能无法在 openpyxl 中运行 — 而应编写引用行/列标题的显式公式
+* 每个单元格都应显示**不同**的值 — 如果全部相同，说明公式没有正确变化
+* 使用混合引用（例如，行输入用 `$A5`，列输入用 `B$4`）
+
+---
+
+## 验证清单 - 完成后运行
+
+### 运行公式验证
+```bash
+python /path/to/excel-author/scripts/recalc.py model.xlsx
+```
+必须返回成功且零错误。
+
+### 部分平衡
+- [ ] 任何必须平衡的部分（资金来源/运用，资产/负债）完全平衡
+- [ ] 填补项作为平衡数字被正确计算
+- [ ] 各部分之间应该匹配的金额保持一致
+
+### 利润/运营预测
+- [ ] 收入/顶线从驱动因素或增长率正确构建
+- [ ] 所有成本和费用项目计算得当
+- [ ] 小计和总计求和正确
+- [ ] 利润率和比率合理
+- [ ] 与假设的链接正确
+
+### 资产负债表（如适用）
+- [ ] 资产 = 负债 + 所有者权益（必须平衡）
+- [ ] 所有项目链接到相应的明细表或滚动表
+- [ ] 期初余额 = 上期期末余额
+- [ ] 包含检查行并显示为零
+
+### 现金流量表（如适用）
+- [ ] 以正确的利润数字开始
+- [ ] 恰当地加/减非现金项目
+- [ ] 营运资金变动的正负号正确
+- [ ] 期末现金 = 期初现金 + 净现金流
+- [ ] 现金余额在各报表之间保持一致
+
+### 支持明细表
+- [ ] 滚动明细表平衡（期初 + 变动 = 期末）
+- [ ] 明细表正确链接到主报表
+- [ ] 计算项目使用了适当的驱动因素
+- [ ] 所有周期计算一致
+
+### 债务/融资明细表（如适用）
+- [ ] 期初余额与资金来源或上期相符
+- [ ] 在相应的余额（通常是期初余额）上计算利息
+- [ ] 偿还遵守了资金可用性和优先级
+- [ ] 期末余额不能为负
+- [ ] 总计正确地对各债务层进行求和
+
+### 回报/输出分析
+- [ ] 退出/终值计算正确
+- [ ] 包含了所有相关的调整
+- [ ] 现金流符号正确（投资为负，收益为正）
+- [ ] IRR/MOIC 公式引用了完整的范围
+- [ ] 结果对于该情景来说是合理的
+
+### 敏感性分析表（如适用）
+- [ ] 网格尺寸为奇数 (5×5 或 7×7) — 存在真正的中心单元格
+- [ ] 行和列轴的值围绕基准情景对称 (`[基准-2Δ, 基准-Δ, 基准, 基准+Δ, 基准+2Δ]`)
+- [ ] 中心单元格输出等于模型的实际 IRR/MOIC — 确认该表连接正确
+- [ ] 中心单元格已被高亮（中蓝色填充 `#BDD7EE`，加粗字体）
+- [ ] 行和列标题包含适当的输入值
+- [ ] 每个数据单元格都包含公式（非硬编码）
+- [ ] 每个数据单元格显示不同的值
+- [ ] 值朝预期方向变动（退出倍数越高 → IRR 越高等）
+
+### 格式
+- [ ] 硬编码的输入为蓝色 (0000FF)
+- [ ] 计算出的公式为黑色 (000000)
+- [ ] 同一选项卡内的链接为紫色 (800080)
+- [ ] 跨选项卡的链接为绿色 (008000)
+- [ ] 所有数字均为右对齐
+- [ ] 全面应用了适当的数字格式
+- [ ] 没有单元格显示错误值 (#REF!, #DIV/0!, #VALUE!, #NAME?)
+
+### 逻辑合理性检查
+- [ ] 数字的量级合理
+- [ ] 趋势合理（如预期的增长、衰退、稳定）
+- [ ] 没有明显错误的值（应为正数的地方出现负数、不可能的百分比等）
+- [ ] 关键输出在该类型的分析合理范围之内
+
+---
+
+## 应避免的常见错误
+
+| 错误 | 出现的问题 | 如何修复 |
+|-------|-----------------|------------|
+| 硬编码计算值 | 输入更改时模型不更新 | 始终使用引用源单元格的公式 |
+| 复制后单元格引用错误 | 公式指向错误的单元格 | 验证所有链接，使用适当的 $ 锚定 |
+| 循环引用错误 | 模型无法计算 | 对于利息类计算使用期初余额，打破循环 |
+| 部分不平衡 | 应该匹配的总计不一致 | 确保其中一个项目是填补项（作为差额计算） |
+| 不可能出现的负余额 | 支付/使用了超过可用的金额 | 适当地使用 MAX(0, ...) 或 MIN 函数 |
+| IRR/回报错误 | 符号错误或范围不完整 | 检查现金流符号并确保公式覆盖所有周期 |
+| 敏感性分析表显示相同的值 | 公式未随输入变化 | 检查单元格引用 - 需要混合引用 ($A5, B$4) |
+| 滚动表不相符 | 期初 ≠ 上期期末 | 验证周期之间的链接 |
+| 正负号惯例不一致 | 加项变成减项，反之亦然 | 始终一致地遵循模板的惯例 |
+
+---
+
+## 与用户协作 — 按部分设置检查点
+
+* **如果模板结构不明确**，在继续之前询问用户
+* **如果用户的要求与模板冲突**，确认他们的偏好
+* **在完成每个主要部分之后**，暂停并与用户验证，然后再继续：
+  - **在完成资金来源与运用之后** → 展示平衡的表格，确认填补项正确无误，在构建运营模型之前获得认可
+  - **在完成运营模型 / 预测之后** → 展示预测的利润表，确认增长率和利润率看起来正确，在构建债务明细表之前获得认可
+  - **在完成债务明细表之后** → 展示期初/期末余额和利息，确认瀑布逻辑，在计算回报之前获得认可
+  - **在完成回报 (IRR/MOIC) 之后** → 展示现金流序列和输出，确认符号和范围，在构建敏感性分析表之前获得认可
+  - **在完成敏感性分析表之后** → 展示每个单元格的变化情况，确认基准情景落在预期的位置
+* **如果在验证期间发现错误**，在进入下一部分之前修复它们
+* **展示您的工作** - 在有帮助的时候解释关键公式或假设
+* **绝对不要在未检查各个部分的情况下展示已完成的模型** — 在出错的源头捕捉到一个错误的单元格引用，比从一个崩溃的 IRR 向后追溯要快得多
+
+---
+
+**这个 skill 通过在模板中填入正确的公式、适当的格式和经过验证的计算，来生成达到投行级别的 LBO 模型。该 skill 能够适应任何模板结构，同时确保财务上的准确性和专业的展示标准。**
+
+## 数据源 — 优先使用 MCP，网络作为备选
+
+下面许多段落提到“使用 S&P Kensho MCP / Daloopa MCP / FactSet MCP”。这些是来自最初 Cowork 插件环境的商业金融数据 MCP。在 Hermes 中：
+
+- **如果您配置了任何结构化金融数据 MCP**（Hermes 支持 MCP — 参见 `native-mcp` skill），在获取历史可比公司 (Comps)、过往交易 (Precedent transactions) 和财务报告时请优先使用它。
+- **否则**，请回退到：
+  - 针对美国SEC财务报告，对 SEC EDGAR (`https://www.sec.gov/cgi-bin/browse-edgar`) 使用 `web_search` / `web_extract`
+  - 访问公司投资者关系 (IR) 页面获取新闻稿和业绩演示文稿
+  - 使用 `browser_navigate` 访问交互式数据门户
+  - 用户提供的数据（当上下文中缺失时明确询问用户）
+- **绝对不要捏造数据**。如果某个倍数、过往交易或报告数据无法获取来源，请将该单元格标记为 `[UNSOURCED]` 并将其提示给用户。
+
+## 版权归属
+
+这个 skill 改编自 Anthropic 的 Claude for Financial Services 插件套件 (Apache-2.0)。Office-JS / Cowork 的实时 Excel 路径已被移除；此版本通过 `excel-author` skill 的规范以 headless openpyxl 为目标。原项目：https://github.com/anthropics/financial-services

package/extensions/skills/optional/finance/merger-model/SKILL.md

@@ -0,0 +1,144 @@
+---
+name: merger-model
+description: 在 Excel 中构建增厚/稀释（并购）模型 —— 备考利润表、协同效应、融资结构、EPS 影响。与 excel-author 配合使用。适用于 M&A 提案、董事会材料或交易评估。
+version: 1.0.0
+author: Anthropic (adapted by Nous Research)
+license: Apache-2.0
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [finance, m-and-a, merger, accretion-dilution, excel, openpyxl, modeling, investment-banking]
+    related_skills: [excel-author, pptx-author, dcf-model, 3-statement-model]
+---
+
+## 环境
+
+本技能假定使用 **headless openpyxl** —— 即在磁盘上生成 .xlsx 文件。
+遵循 `excel-author` 技能中关于单元格颜色、公式、命名范围和敏感性表的规范。
+在交付前进行重新计算：`python /path/to/excel-author/scripts/recalc.py ./out/model.xlsx`。
+
+# Merger Model
+
+为 M&A 交易构建增厚/稀释分析。对备考 EPS 影响、协同效应敏感性和购买价格分配进行建模。适用于评估潜在收购、为提案准备并购后果分析，或就交易条款提供建议。
+
+## 工作流
+
+### 步骤 1：收集输入
+
+**收购方：**
+- 公司名称、当前股价、流通股数
+- LTM 和 NTM EPS（GAAP 和调整后）
+- P/E 乘数
+- 税前债务成本、税率
+- 资产负债表上的现金、现有债务
+
+**目标公司：**
+- 公司名称、当前股价、流通股数（若为上市公司）
+- LTM 和 NTM EPS 或净收入
+- 企业价值或股权价值
+
+**交易条款：**
+- 每股报价（或相对于当前价格的溢价）
+- 支付方式比例：% 现金 vs. % 股票
+- 为现金部分融资而新发行的债务
+- 预期协同效应（收入和成本）及导入时间表
+- 交易费用和融资成本
+- 预计完成日期
+
+### 步骤 2：购买价格分析
+
+| 项目 | 值 |
+| ------ | ------- |
+| 每股报价 |  |
+| 相对当前价格溢价 |  |
+| 股权价值 |  |
+| 加：承担的净债务 |  |
+| 企业价值 |  |
+| 隐含 EV / EBITDA |  |
+| 隐含 P/E |  |
+
+### 步骤 3：资金来源与用途
+
+| 来源 | $ | 用途 | $ |
+| --------- | --- | ------ | --- |
+| 新增债务 |  | 股权购买价格 |  |
+| 手头现金 |  | 偿还目标公司债务 |  |
+| 新发行股权 |  | 交易费用 |  |
+|  |  | 融资费用 |  |
+| **合计** |  | **合计** |  |
+
+### 步骤 4：备考 EPS（增厚 / 稀释）
+
+逐年计算（第 1-3 年）：
+
+|  | 独立 | 备考 | 增厚/(稀释) |
+| --- | ----------- | ----------- | --------------------- |
+| 收购方净收入 |  |  |  |
+| 目标公司净收入 |  |  |  |
+| 协同效应（税后） |  |  |  |
+| 现金损失的利息收入（税后） |  |  |  |
+| 新增债务利息（税后） |  |  |  |
+| 无形资产摊销（税后） |  |  |  |
+| 备考净收入 |  |  |  |
+| 备考股份数 |  |  |  |
+| **备考 EPS** |  |  |  |
+| **增厚 / (稀释) %** |  |  |  |
+
+### 步骤 5：敏感性分析
+
+**增厚/稀释 vs. 协同效应与报价溢价：**
+
+|  | $0M 协同 | $25M 协同 | $50M 协同 | $75M 协同 | $100M 协同 |
+| --- | --------- | ---------- | ---------- | ---------- | ----------- |
+| 15% 溢价 |  |  |  |  |  |
+| 20% 溢价 |  |  |  |  |  |
+| 25% 溢价 |  |  |  |  |  |
+| 30% 溢价 |  |  |  |  |  |
+
+**增厚/稀释 vs. 现金/股票支付比例：**
+
+|  | 100% 现金 | 75/25 | 50/50 | 25/75 | 100% 股票 |
+| --- | ----------- | ------- | ------- | ------- | ------------ |
+| 第 1 年 |  |  |  |  |  |
+| 第 2 年 |  |  |  |  |  |
+
+### 步骤 6：盈亏平衡协同效应
+
+计算交易在第 1 年实现 EPS 中性所需的最低协同效应。
+
+### 步骤 7：输出
+
+- Excel 工作簿包含：
+  - 假设选项卡
+  - 资金来源与用途
+  - 备考利润表
+  - 增厚/稀释摘要
+  - 敏感性表
+  - 盈亏平衡分析
+- 用于提案书的一页纸并购后果摘要
+
+## 重要说明
+
+- 在相关处，务必同时显示 GAAP 和调整后（现金）EPS
+- 股票交易：使用收购方当前价格计算换股比率，注意新股带来的稀释
+- 包含购买价格分配 —— 商誉和无形资产摊销对 GAAP EPS 至关重要
+- 协同效应的导入至关重要 —— 第 1 年通常仅为常态化协同效应的 25-50%
+- 不要忘记所使用现金损失的利息收入，以及所筹集债务的新利息支出
+- 协同效应和利息调整的税率应与收购方的边际税率相匹配
+
+
+## 数据来源 —— 优先使用 MCP，回退至网络
+
+下文许多段落提到“使用 S&P Kensho MCP / Daloopa MCP / FactSet MCP”。这些是最初 Cowork 插件环境中的商业金融数据 MCP。在 Hermes 中：
+
+- **如果您配置了任何结构化金融数据 MCP**（Hermes 支持 MCP —— 参见 `native-mcp` 技能），请优先将其用于特定时间点的可比公司分析、过往交易和文件披露。
+- **否则**，回退至：
+  - 针对美国 SEC 文件披露，对 SEC EDGAR (`https://www.sec.gov/cgi-bin/browse-edgar`) 使用 `web_search` / `web_extract`
+  - 公司 IR 页面获取新闻稿、财报演示文稿
+  - `browser_navigate` 访问交互式数据门户
+  - 用户提供的数据（当上下文中缺乏时明确询问用户）
+- **绝不捏造数据**。如果无法获取某个乘数、过往交易或文件数据，将该单元格标记为 `[UNSOURCED]` 并提示用户。
+
+## 归属声明
+
+本技能改编自 Anthropic 的 Claude for Financial Services 插件套件（Apache-2.0）。移除了 Office-JS / Cowork 实时 Excel 路径；本版本通过 `excel-author` 技能的规范针对 headless openpyxl。原始版本：https://github.com/anthropics/financial-services

package/extensions/skills/optional/finance/pptx-author/SKILL.md

@@ -0,0 +1,173 @@
+---
+name: pptx-author
+description: 使用 python-pptx 无界面构建 PowerPoint 演示文稿。与 excel-author 配合使用，生成由模型支撑的演示文稿，其中每个数字都能追溯到工作簿的单元格。适用于融资路演演示文稿、投委会备忘录和财报纪要。
+version: 1.0.0
+author: Anthropic (adapted by Nous Research)
+license: Apache-2.0
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [powerpoint, pptx, python-pptx, presentation, finance]
+    related_skills: [excel-author, powerpoint]
+---
+
+# pptx-author
+
+使用 `python-pptx` 在磁盘上生成一个 .pptx 文件。适用于当你需要将演示文稿作为文件交付，而不是驱动实时 PowerPoint 会话的情况。
+
+改编自 [anthropics/financial-services](https://github.com/anthropics/financial-services) 中 Anthropic 的 `pptx-author` 和 `pitch-deck` 技能。原版中的 MCP / Office-JS 分支已被舍弃——本项目假定在无界面 Python 环境下运行。
+
+如需更广泛、已发布的 PowerPoint 创作技能（幻灯片、演讲者备注、嵌入对象、媒体），请参阅内置的 `powerpoint` 技能。本技能是一种轻量级模式，专为由模型支撑的演示文稿（融资路演演示文稿、投委会备忘录、财报纪要）而优化，其中的每一个数字都必须能追溯到源工作簿。
+
+## 输出 contract
+
+- 写入到 `./out/<name>.pptx`。如果 `./out/` 不存在，则创建它。
+- 在最终消息中返回相对路径。
+
+## 配置
+
+```bash
+pip install "python-pptx>=0.6"
+```
+
+## Core conventions
+
+### 每张幻灯片只包含一个核心观点
+标题即结论；正文用于提供支撑。标题仅为“Q3 Revenue”的幻灯片显得单薄；而“Revenue growth accelerated to 14% Y/Y in Q3”（Q3 收入同比增长加速至 14%）则有力得多。
+
+### 每个数字都能追溯到模型
+如果幻灯片上的某个数字来自 `./out/model.xlsx`，请在脚注中注明工作表和单元格。
+
+```
+Revenue: $1,250M  (Source: model.xlsx, Inputs!C3)
+```
+
+切勿凭记忆或摘要转录数字——打开工作簿，读取命名区域（named range），并尽可能通过编程方式将演示文稿中的数值与其绑定。
+
+### 挂载公司模板时请使用该模板
+如果存在 `./templates/firm-template.pptx`，请加载它，以便演示文稿继承品牌的颜色、字体和母版布局。
+
+```python
+from pptx import Presentation
+from pathlib import Path
+
+template = Path("./templates/firm-template.pptx")
+prs = Presentation(str(template)) if template.exists() else Presentation()
+```
+
+### 图表：从模型导出的 PNG 优于原生 pptx 图表
+当对保真度要求较高（模型的图表样式必须与演示文稿完全一致）时，请从源工作簿将图表渲染为 PNG 并嵌入该图片。原生的 `pptx.chart` 图表十分脆弱，且通常不符合公司规范。
+
+```python
+from pptx.util import Inches
+slide.shapes.add_picture("./out/charts/football_field.png",
+                         Inches(1), Inches(2),
+                         width=Inches(8))
+```
+
+### 不进行外部发送
+本技能仅负责写入文件。它绝不发送电子邮件、上传文件或发布内容。交付工作由编排层（Orchestration layers）处理。
+
+## Skeleton
+
+```python
+from pptx import Presentation
+from pptx.util import Inches, Pt
+from pptx.dml.color import RGBColor
+from pathlib import Path
+
+template = Path("./templates/firm-template.pptx")
+prs = Presentation(str(template)) if template.exists() else Presentation()
+
+# Title slide
+slide = prs.slides.add_slide(prs.slide_layouts[0])
+slide.shapes.title.text = "Project Aurora — Strategic Alternatives"
+slide.placeholders[1].text = "Preliminary Discussion Materials"
+
+# Valuation summary slide (title-only layout)
+slide = prs.slides.add_slide(prs.slide_layouts[5])
+slide.shapes.title.text = "Valuation implies $38–$52 per share across methodologies"
+
+# Add a table bound to model outputs
+rows, cols = 5, 4
+tbl_shape = slide.shapes.add_table(rows, cols,
+                                   Inches(0.5), Inches(1.5),
+                                   Inches(9), Inches(3))
+tbl = tbl_shape.table
+headers = ["Methodology", "Low ($)", "Mid ($)", "High ($)"]
+for c, h in enumerate(headers):
+    tbl.cell(0, c).text = h
+
+# In a real deck, read these from the model workbook with openpyxl
+data = [
+    ("Trading comps",     "35", "41", "48"),
+    ("Precedent M&A",     "39", "45", "52"),
+    ("DCF (base)",        "36", "43", "51"),
+    ("LBO (10% IRR)",     "33", "38", "44"),
+]
+for r, row in enumerate(data, start=1):
+    for c, val in enumerate(row):
+        tbl.cell(r, c).text = val
+
+# Embed a chart rendered from the model
+slide = prs.slides.add_slide(prs.slide_layouts[5])
+slide.shapes.title.text = "Football field — current price $42"
+slide.shapes.add_picture("./out/charts/football_field.png",
+                         Inches(1), Inches(1.8), width=Inches(8))
+
+Path("./out").mkdir(exist_ok=True)
+prs.save("./out/pitch-aurora.pptx")
+```
+
+## 将演示文稿数字绑定到源工作簿
+
+从你的 Excel 模型中读取命名区域或特定单元格，确保演示文稿中的数字永不偏移。
+
+```python
+from openpyxl import load_workbook
+
+wb = load_workbook("./out/model.xlsx", data_only=True)
+def nr(name):
+    """Resolve a named range to its current computed value."""
+    rng = wb.defined_names[name]
+    sheet, coord = next(rng.destinations)
+    return wb[sheet][coord].value
+
+revenue_fy24 = nr("RevenueFY24")
+implied_mid  = nr("ImpliedSharePriceBase")
+```
+
+然后使用这些值来构建演示文稿内容：
+```python
+slide.shapes.title.text = f"Implied share price of ${implied_mid:.2f} (base case)"
+```
+
+请记住在读取工作簿之前重新计算它——openpyxl 只能读取已被计算并保存的值。请先运行 `excel-author` 技能中的重算助手，或者通过真实的 Excel 会话进行打开/保存。
+
+## 融资路演演示文稿的幻灯片类型清单
+
+典型的投行融资路演演示文稿遵循以下结构。虽然并非强制规定，但这对于起草初稿非常有用：
+
+1. 封面 / 标题
+2. 免责声明
+3. 目录
+4. 概况
+5. 公司概况（标的）
+6. 市场 / 行业背景
+7. 估值摘要（反应区间图 football field）——最核心的幻灯片
+8. 交易可比公司明细
+9. 先例交易明细
+10. DCF 摘要
+11. 示意性 LBO / 赞助方案例
+12. 流程考量
+13. 附录
+
+## 何时不适用本技能
+
+- 用户处于实时 PowerPoint 会话中且有可用的 Office MCP 时——应改为驱动他们的实时文档。
+- 非财务类幻灯片（季度全员大会、营销演示文稿）——请使用更广泛的 `powerpoint` 技能。
+- 包含大量动画、切换效果或演讲者备注的演示文稿——请使用更广泛的 `powerpoint` 技能。
+
+## Attribution
+
+惯例改编自采用 Apache-2.0 许可的 Anthropic Claude for Financial Services 插件套件。原项目地址：https://github.com/anthropics/financial-services/tree/main/plugins/agent-plugins/pitch-agent/skills/pptx-author