无头 Excel 工作簿生成器
在无 Office 应用的托管代理会话中生成规范化 Excel 文件。
技能将输出限定为本地 ./out/<name>.xlsx,并明确不驱动实时 Excel,降低了外部副作用;但要求运行 Bash/Python 和未固定版本的 openpyxl,未说明敏感数据处理、用户确认、权限边界、回滚或依赖安全,因此扣分。
输出路径、示例脚本和建模约定较清晰,快乐路径可理解;但没有测试、输入校验、失败处理、依赖安装说明或可诊断的异常反馈,静态评估不超过10分,因此扣分。
明确面向无 Office 应用的 managed-agent/CMA 场景,并规定何时改用实时 Excel 工具;但未定义输入范围、非适用边界、触发条件、中文支持或环境兼容性,扣分。
文档包含用途、输出契约、示例、约定和替代路径,且仓库提供 Apache-2.0 许可与基本 CI;但缺少技能级版本、变更记录、维护责任、安装/排错说明和已知限制,扣分。
能够直接生成可收集的 .xlsx 文件,并提供输入、公式、检查表等有用建模规范;但仅有最小示例,没有代表性结果验证、复杂工作簿覆盖或与手工替代方案的比较,静态上限为7分并扣分。
技能正文可审计,仓库 CI 能验证插件结构;但没有覆盖关键工作簿生成路径的提交测试或第三方执行证据,结论主要来自静态阅读,因此扣分。
- 运行 Bash/Python 及 openpyxl 前应由部署方固定并审查依赖版本,限制文件系统写入范围。
- 该技能未定义敏感财务数据的处理、脱敏、日志和失败清理策略。
- 生成的公式、格式和 Checks 结果仍需人工复核;仓库 CI 不等于工作簿内容正确性验证。
它能做什么 & 适用场景
xlsx-author 面向无头的 Managed Agent 或 CMA 会话,将 Excel 工作簿作为文件产物写入磁盘。它使用 Python 和 openpyxl 创建 .xlsx 文件,而不是操作已打开的 Excel 工作簿。技能要求输出到 ./out/<name>.xlsx,并规定输入、公式、跨表链接和检查项的建模约定。它适合需要交付可收集 Excel 文件的自动化流程,但不适用于必须编辑实时工作簿的场景。
创建 ./out/ 目录(如不存在);编写并运行 Python 脚本;使用 openpyxl 创建、设置工作表、写入输入值和公式;将工作簿保存为 ./out/<name>.xlsx。它还规定硬编码输入使用蓝色、公式使用黑色、跨表或跨文件链接使用绿色;要求计算单元格使用公式、外部引用值使用命名区域,并加入显示 TRUE/FALSE 的 Checks 工作表。
- 托管代理用户需要在没有打开 Office 应用的环境中生成财务模型文件。
- 需要把计算结果作为 .xlsx 文件交给编排层收集,而不是修改实时 Excel 工作簿的团队。
- 需要将输入集中放在 Inputs 工作表、并用公式驱动计算工作表的建模流程。
- 需要在交付前加入资产负债表、现金流或其他平衡检查的 Excel 文件生成任务。
优缺点一览
- 明确的文件输出契约,便于编排层收集产物。
- 提供输入、公式、跨表链接、命名区域和检查工作表的具体约定。
- 适合没有打开 Office 应用的无头运行环境。
- 强调每个计算单元格使用公式,并通过 TRUE/FALSE 检查暴露问题。
- 只能生成磁盘上的 .xlsx 文件,不能替代实时 Excel 工作簿编辑。
- 依赖 Python、Bash 和 openpyxl,来源未提供版本要求或锁定文件。
- 来源未提供测试套件或受支持平台的验证记录。
- 规定每个文件只包含一个模型,不能在未明确要求时追加到已有工作簿。
如何安装
该来源没有记录 xlsx-author 的独立安装命令。它位于 anthropics/financial-services 仓库的 KYC Screener 插件中;README 记录的集合安装方式是:在 Cowork 的 Settings → Plugins → Add plugin 中粘贴 https://github.com/anthropics/financial-services,然后选择所需代理或垂直插件;也可以上传 plugins/ 下目录的 zip。README 未提供该技能的单独安装步骤。
如何使用
在无头 Managed Agent 或 CMA 会话中触发该技能,并明确要求生成 Excel 文件,例如:“在无 Office 应用的托管代理会话中,创建一个包含 Inputs、计算表和 Checks 工作表的 Excel 模型,并将结果保存为 ./out/model.xlsx。”运行环境需能够执行 Bash 和 Python,并安装 openpyxl。最终应返回相对路径 ./out/model.xlsx。