无头 Excel 工作簿生成器
在没有打开 Excel 的托管代理环境中生成可交付的 .xlsx 文件。
技能将输出限定为本地 ./out/<name>.xlsx,并未声明网络访问、外部写入或高权限操作,且要求不要覆盖现有工作簿,降低了外部影响风险。扣分原因是未要求用户确认、未说明输入数据流和敏感财务数据处理、未提供失败回滚或依赖安全措施;Apache-2.0及官方组织来源提供有限的归属证据,但不等于安全验证。
文档给出可复现的基本 Python/openpyxl 路径和明确输出契约,且说明了 headless 与 live Excel 的适用区别。扣分原因是没有依赖安装或版本固定、参数校验、异常处理、文件冲突处理、公式计算验证或诊断性失败反馈;静态审查无法验证运行可靠性,因此不超过10分。
目标场景、输入环境和输出文件类型较清楚,并明确指出有 Office Excel 工具时不应使用该技能。扣分原因是没有更细的触发条件、非适用范围、输入格式约束、中文工作流支持或中国大陆网络环境说明;其核心本地脚本功能不完全依赖海外服务。
结构清晰,包含输出契约、构建示例、格式约定和不应使用的场景;仓库提供 Apache-2.0、CI 校验和贡献说明。扣分原因是技能自身没有版本、变更记录、维护负责人或更新路径,也缺少依赖安装、故障排查、边界限制和更完整示例;仓库级 CI 未证明该技能关键路径。
技能能够覆盖 headless 生成基础 Excel 文件的核心任务,并规定了可收集的文件路径、输入/公式分层、检查表等建模惯例。扣分原因是示例仅展示简单工作簿,未验证公式结果、格式完整性、复杂模型或直接可用性,实际输出仍可能需要人工复核;静态审查下不超过7分。
存在明确代码示例、输出规则、仓库 revision 和相关 CI 配置,提供了一定审计线索。扣分原因是没有提交的针对 xlsx-author 的测试、真实执行结果、覆盖关键路径的 CI 或第三方复核;CI 主要校验插件清单而非技能行为,因此不超过5分。
- 运行前需确认 Python、openpyxl 和 Bash 可用,并自行固定或审查依赖版本。
- 技能未规定敏感财务数据的存储、权限和清理策略;不要将受限数据写入未审查的 ./out/ 目录。
- openpyxl 写入公式通常不等于已计算公式;交付前应在兼容的电子表格引擎中重新计算并检查结果、循环引用和错误值。
- 技能没有定义文件已存在、脚本失败或部分写入时的恢复流程;应由调用方实施安全的临时文件和回滚策略。
它能做什么 & 适用场景
xlsx-author 用于无头运行环境,将 Excel 工作簿作为文件产物写入磁盘,而不是操作已打开的 Office 工作簿。它要求将文件保存到 ./out/<name>.xlsx,并使用 openpyxl 创建和编辑工作簿。该技能适合托管代理或 CMA 会话,不适合必须直接操作实时 Excel 工作簿的场景。它还规定了输入、公式、跨表链接和余额检查等金融建模约定。
编写并运行一个简短的 Python 脚本,通过 openpyxl 创建或修改工作簿;创建 Inputs、计算表和 Checks 等工作表;将硬编码输入、公式和跨表或跨文件链接分别使用蓝色、黑色和绿色标识;避免在计算单元格中写入硬编码值;为被演示文稿或备忘录引用的数值创建命名区域;添加用于检查资产负债表平衡和现金流与现金衔接的 TRUE/FALSE 检查;最终将单个模型保存为 ./out/<name>.xlsx。
- 托管代理需要在没有打开 Office 应用的服务器环境中交付一个 Excel 财务模型时。
- 金融分析师需要将输入项、公式和跨表引用按统一颜色约定写入新工作簿时。
- 模型制作者需要在交付前加入资产负债表和现金流检查时。
- 自动化流程需要生成一个可由编排层收集的 .xlsx 文件产物时。
优缺点一览
- 明确支持没有打开 Office 应用的托管代理环境。
- 输出路径和最终交付格式有清晰约定。
- 包含财务模型常用的颜色、命名区域和检查表规范。
- 基于 openpyxl 生成文件,适合文件化自动化流程。
- 仅覆盖无头文件生成场景,不负责驱动实时 Excel 工作簿。
- 依赖 Python、Bash 和 openpyxl,源材料未提供版本要求。
- 源材料未说明测试套件、错误处理策略或复杂模板兼容范围。
- 一个文件只建立一个模型,除非明确要求,否则不得追加到现有工作簿。
如何安装
将仓库加入 Claude 插件市场:claude plugin marketplace add anthropics/financial-services;安装核心金融分析插件:claude plugin install financial-analysis@claude-for-financial-services。技能源文件位于 plugins/vertical-plugins/financial-analysis/skills/xlsx-author/SKILL.md。源材料未说明单独安装该技能的命令。
如何使用
在无头的 managed-agent 或 CMA 会话中提出类似请求:“请使用 xlsx-author 生成一个 Excel 财务模型,并将文件保存到 ./out/model.xlsx。”按要求运行 Python/openpyxl 脚本,确保输出路径为 ./out/<name>.xlsx,并在最终消息中返回该相对路径。源材料未规定专用触发命令或更具体的提示词格式。
对比同类
与 mcp__office__excel_* 工具相比,xlsx-author 面向无头环境并生成磁盘文件;当 Office 工具可用时,源材料建议使用它们来驱动用户的实时工作簿并设置审查检查点。