无头 Excel 工作簿生成器
在没有打开 Excel 的托管环境中生成可交付的 .xlsx 文件。
技能将作用域限定为无头模式,并规定输出到./out/<name>.xlsx,未声明网络访问、凭据处理或外部副作用,且要求不覆盖既有工作簿除非明确要求;但缺少敏感金融数据处理、用户确认、失败回滚和依赖安全说明,因此扣分。
步骤和示例内部一致,使用openpyxl并明确输入、公式、检查表等约定;但依赖未锁定、没有针对关键路径的测试或执行证据,也未规定异常输入、保存失败和公式错误的诊断反馈,因此受静态上限限制并扣分。
目标场景、输出形态和不适用的live Excel/Cowork模式均较清楚;但触发条件、输入边界、非模型类工作簿的适用范围以及中文环境支持未说明,故仅给中等分数。
文档结构清晰,包含输出契约、构建示例、格式约定和不适用条件;仓库提供Apache-2.0许可证、CI校验和官方组织来源,但该技能缺少版本、变更记录、维护责任、安装依赖和故障排查说明,因此扣分。
技能能直接指导生成可收集的xlsx文件,并提供可复用的openpyxl示例及模型约定;但没有验证代表性产物、完整业务结果或与手工/其他方案的比较,实际结果仍需人工审阅,因此静态评估下不超过7分。
源文件包含明确的输出契约、代码示例、仓库级插件校验和安全扫描工作流,提供有限可审计依据;但没有覆盖该技能关键路径的专门测试、产物样例或第三方执行证据,因此无法给更高分。
- 执行前应确认运行环境已安装兼容版本的openpyxl,并对生成的公式、格式、检查表和敏感数据暴露进行人工复核。
- 该技能没有定义失败时的清理或回滚行为;不要默认覆盖已有文件或将金融数据写入不受控目录。
- 仓库级CI并不证明该技能的xlsx生成路径已被测试。
它能做什么 & 适用场景
xlsx-author 用于在 managed-agent 或 CMA 等无头环境中创建 Excel 工作簿文件。它通过 Python 和 openpyxl 生成工作簿,并将结果写入 ./out/<name>.xlsx。该技能要求计算单元使用公式、输入集中在 Inputs 工作表,并建议加入 Checks 工作表进行平衡检查。若可使用 Office Excel 工具,应改用实时工作簿编辑方式。
创建 ./out/ 目录(如不存在);编写并运行简短的 Python 脚本;使用 openpyxl 创建、格式化和保存 .xlsx 工作簿;区分硬编码输入、公式和跨表或跨文件链接的颜色;将输入放在 Inputs 工作表;为引用自演示文稿或备忘录的数值设置命名范围;创建 Checks 工作表并显示 TRUE/FALSE 检查结果。
- 需要在没有打开 Office 应用的托管代理会话中交付 Excel 模型的投行或研究人员。
- 需要把输入、计算和检查分离到不同工作表的财务建模人员。
- 需要通过 Python 批量生成单个 Excel 文件作为文件制品的运营团队。
- 需要为演示文稿或备忘录中的关键数值建立命名范围的分析人员。
优缺点一览
- 明确规定输出路径 ./out/<name>.xlsx,便于编排系统收集文件。
- 提供输入、公式、链接、命名范围和检查表的具体建模规范。
- 适合没有打开 Office 应用的托管环境。
- 仅覆盖工作簿文件生成,不负责完整的财务建模逻辑或数据获取。
- 依赖 Python、openpyxl、Shell 和本地文件系统。
- 不适合已有实时 Excel 工作簿的编辑场景;来源未提供技能专属测试套件或平台验证记录。
如何安装
在 Cowork 中打开 Settings → Plugins → Add plugin,粘贴 https://github.com/anthropics/financial-services,然后从插件市场选择所需代理或垂直插件。README 未提供 xlsx-author 的独立安装命令;它列在 financial-analysis 核心插件中,并作为 Earnings Reviewer 的捆绑技能出现。
如何使用
在无头的 managed-agent/CMA 会话中提出类似“使用 xlsx-author 创建一个 Excel 工作簿,并将其保存为 ./out/model.xlsx”的请求。技能会使用 Python 和 openpyxl 生成文件,并在最终消息中返回相对路径。若可用 mcp__office__excel_* 工具,应使用实时工作簿工具。
对比同类
与 mcp__office__excel_* 的实时 Excel 编辑方式相比,xlsx-author 面向无头环境并生成文件制品;来源没有提供其他具体替代方案的比较信息。