无界面 Excel 工作簿生成器
在没有打开 Excel 的托管代理环境中,按审计规范生成可交付的 .xlsx 文件。
技能将输出限定为 ./out/<name>.xlsx,未要求网络、凭据或外部系统,并明确不应追加现有工作簿;因此具备一定范围控制。扣分在于未要求用户确认、未说明敏感财务数据处理、未提供覆盖/回滚机制,且 openpyxl 依赖未锁定。
步骤和示例基本一致:使用 Python、Bash 与 openpyxl 创建并保存工作簿,且说明 Cowork 模式下应改用 Excel 工具。扣分在于依赖可用性未验证、未定义输入异常或保存失败处理、未提供诊断性错误反馈;静态审查不支持超过10分。
目标场景、输出路径、headless 与 live-workbook 的边界以及不适用条件均有明确说明。扣分在于未定义输入格式、失败边界、触发语义或中文用户支持;也未说明大陆网络环境下的适配。
文档结构清楚,包含输出契约、构建示例、格式约定和使用边界;仓库提供 Apache-2.0、官方 Anthropic 来源、CI 校验和贡献说明。扣分在于技能自身没有版本、变更记录、维护责任、安装/依赖安装说明、FAQ、限制细节或更新路径。
技能直接覆盖无 Office 应用时生成可收集的 .xlsx 文件,并给出可运行形态的最小示例和财务模型约定,核心价值明确。扣分在于没有验证生成结果、公式计算或检查表完整性的机制,示例输出仍需人工审阅,且相对手工脚本或其他工具的收益证据有限;静态上限为7分。
仓库有插件校验和秘密扫描的真实 CI 配置,且技能文本提供了具体代码路径,支持有限审计。扣分在于没有针对 xlsx-author 关键路径的提交测试、样例产物、第三方执行记录或跨来源复核;静态上限为5分。
- 使用前应固定并验证 Python 与 openpyxl 版本,避免环境差异导致不可复现。
- 技能不会自动证明公式已计算、余额检查已通过或工作簿符合业务模板;交付前需要人工打开和审阅。
- 写入 ./out/ 的覆盖行为、失败后的残留文件和恢复方式未定义;处理敏感财务数据时应由调用方提供隔离、访问控制和清理策略。
- 未说明中文文本、区域格式、日期和公式本地化处理,中文用户应先验证输出兼容性。
它能做什么 & 适用场景
xlsx-author 用于无界面运行环境,将 Excel 工作簿作为文件产物写入磁盘,而不是操作实时 Excel 工作簿。它要求输出到 ./out/<name>.xlsx,并使用 openpyxl 创建和保存文件。技能规定了输入、公式、跨表链接的颜色约定,以及 Inputs、Checks 等工作表规范。它适合需要生成金融模型或其他结构化工作簿文件、但没有可用 Office 应用的托管代理会话。
创建 ./out/ 目录(如不存在),编写并运行一个简短的 Python 脚本,使用 openpyxl 创建工作簿、工作表、单元格、公式和样式,并将结果保存为 ./out/<name>.xlsx。它要求硬编码输入使用蓝色、公式使用黑色、跨工作表或文件链接使用绿色;计算单元格不得包含硬编码值,输入应放在 Inputs 工作表,并为引用于演示文稿或备忘录的数值设置命名区域。它还要求加入 Checks 工作表,显示资产负债表平衡、现金流与现金等检查结果。
- 托管代理用户需要在没有打开 Office 应用的环境中交付一个 Excel 财务模型文件。
- 金融分析师需要把输入、计算公式和检查项分离到结构化工作簿中。
- 模型构建者需要生成带有硬编码、公式和跨表链接颜色标记的工作簿。
- 审计或复核人员需要一个包含 TRUE/FALSE 平衡检查的模型文件。
- 自动化流程需要把生成的 .xlsx 文件作为磁盘产物交给后续编排层收集。
优缺点一览
- 明确规定了可收集的 .xlsx 文件输出路径。
- 支持完全无界面的工作簿生成。
- 提供输入、公式、链接、命名区域和检查表规范,便于复核。
- 使用常见的 Python openpyxl 库创建工作簿。
- 依赖 Python、Bash 和 openpyxl,来源未说明版本要求。
- 来源没有提供测试套件、错误处理或生成失败时的恢复流程。
- 仅适用于文件产物生成;若有可用的 mcp__office__excel_* 工具,应改用实时工作簿操作方式。
- 来源没有说明复杂公式、外部链接或 Excel 兼容性的测试范围。
如何安装
将仓库添加到 Claude Cowork:Settings → Plugins → Add plugin,然后粘贴 https://github.com/anthropics/financial-services,并选择相应插件;或在 Claude Code 中运行:claude plugin marketplace add anthropics/financial-services。README 没有提供单独安装 xlsx-author 技能的命令;该技能位于 plugins/agent-plugins/statement-auditor/skills/xlsx-author/SKILL.md。
如何使用
在 headless、managed-agent 或 CMA 会话中提出需要生成 Excel 文件的请求,例如:“请生成一个包含 Inputs、计算表和 Checks 工作表的 .xlsx 财务模型,并保存为 ./out/model.xlsx。”实际触发方式和输入格式未在 SKILL.md 中进一步规定。最终应返回相对路径 ./out/<name>.xlsx。
对比同类
SKILL.md 将其与 mcp__office__excel_* 的实时 Excel 工作簿操作方式区分开来:xlsx-author 面向无界面文件生成,而这些工具用于 Cowork 插件模式下的实时工作簿编辑。