无界面 Excel 工作簿生成器
在没有打开 Office 的托管代理环境中生成可交付的 Excel 文件。
技能限定为本地生成 ./out/<name>.xlsx,未要求外部连接器或高权限操作,且说明 Cowork 模式应使用另一工具;但没有用户确认、敏感数据处理、回滚、失败清理或依赖安全说明,因此扣分。
输出路径、openpyxl 示例和基础建模约定清晰,正常路径可理解;但无测试、输入校验、异常处理、依赖安装/版本固定或可诊断失败反馈,按静态校准限制得分。
明确面向无 Office 应用的 headless/CMA 场景,并声明 Cowork 非适用场景;但未定义输入、复杂工作簿边界、触发条件、中文支持或更多环境兼容性,因此扣分。
文档结构简洁,包含输出契约、示例、约定和不适用条件;仓库提供 Apache-2.0 和官方来源,但技能自身缺少版本、变更记录、维护责任、安装说明、FAQ 和已知限制,因此扣分。
能够直接指导生成一个基础 xlsx 文件,包含公式、样式和输出位置,核心价值明确;但示例非常有限,未覆盖真实 month-end close 工作簿、校验执行或复杂输入,仍需较多人工审阅,因此未给满分。
技能内容可审计,仓库有插件验证和安全扫描 CI;但这些 CI 未覆盖 xlsx-author 的关键执行路径,也没有提交的测试套件或第三方执行证据,因此仅给有限分数。
- 使用前需确认运行环境已安装兼容版本的 Python 和 openpyxl;技能未提供安装或版本固定说明。
- 技能会写入本地 ./out/ 目录,但未说明文件覆盖、失败残留或恢复策略。
- 颜色、命名区域和 Checks 约定仅为说明性要求,未提供自动审计或公式结果验证。
- 不应将示例视为完整的月末结账流程;财务结果仍需人工复核。
它能做什么 & 适用场景
xlsx-author 用于在无界面托管代理或 CMA 环境中创建 Excel 工作簿文件。它通过 Python 和 openpyxl 写入工作簿,并将结果保存到磁盘,而不是操作实时 Excel 工作簿。技能要求输出文件位于 ./out/<name>.xlsx,并在最终消息中返回相对路径。它还规定了输入、公式、跨表链接、命名范围和检查页等建模约定。
创建 ./out/ 目录(如不存在),编写并运行 Python 脚本,使用 openpyxl 创建或修改一个 Excel 工作簿,并将其保存为 ./out/<name>.xlsx。工作簿可包含 Inputs、计算页和 Checks 页;硬编码输入使用蓝色字体,公式使用黑色字体,跨表或跨文件链接使用绿色字体。计算单元格必须使用公式,引用演示文稿或备忘录的数值应使用命名范围,并应加入资产负债表、现金流和其他适用的平衡检查。
- 托管代理用户需要生成一个 Excel 财务模型文件,但当前没有打开的 Office 应用。
- 财务分析人员需要通过 Python 和 openpyxl 创建包含输入页、计算页和检查页的新工作簿。
- 建模人员需要将硬编码输入、公式和跨表链接用统一颜色区分,以便后续审阅。
- 交付流程需要把生成的 .xlsx 文件作为磁盘文件交给编排系统收集。
优缺点一览
- 适合没有打开 Office 应用的托管代理环境。
- 输出路径和文件交付契约明确。
- 提供输入、公式、链接和检查页的具体建模规范。
- 基于 Python 和 openpyxl,适合脚本化生成工作簿。
- 依赖 Python、Bash、文件系统写入权限和 openpyxl。
- 仅提供技能说明和示例,没有测试套件或受支持平台清单。
- 不适用于已有实时 Excel 工作簿的交互式编辑场景。
- 源材料没有说明公式计算引擎、复杂格式兼容性或错误恢复行为。
如何安装
该技能位于仓库的 plugins/agent-plugins/month-end-closer/skills/xlsx-author/SKILL.md。README 未说明单独安装此技能的命令;可在 Cowork 的 Settings → Plugins → Add plugin 中粘贴 https://github.com/anthropics/financial-services,然后选择所需代理或垂直插件。仓库整体采用 Apache-2.0 许可证。
如何使用
在无界面托管代理或 CMA 会话中提出需要生成 Excel 文件的任务,例如:“创建一个包含 Inputs、计算页和 Checks 页的 Excel 工作簿,并将其保存为 ./out/model.xlsx。”技能要求使用 Bash 运行 Python 脚本,并使用 openpyxl 生成文件;完成后在最终消息中返回相对路径 ./out/<name>.xlsx。如果 mcp__office__excel_* 工具可用,应使用实时 Excel 工作流而不是此文件生成方式。
对比同类
该技能明确将自身与 mcp__office__excel_* 实时 Excel 工具区分:前者生成磁盘上的 .xlsx 文件,后者用于操作用户的实时工作簿。