xlsx-author

xlsx-author

当你以 无头模式（托管 Agent / CMA 模式）运行，并且需要将 Excel 工作簿作为 文件产物 交付，而不是通过 mcp__office__excel_* 编辑实时工作簿时，请使用此技能。

输出约定

• 写入 ./out/<name>.xlsx。如果 ./out/ 不存在，请创建它。
• 在最终消息中返回相对路径，以便编排层可以收集它。

如何构建工作簿

编写一个简短的 Python 脚本，并使用 Bash 运行它。使用 openpyxl：

from openpyxl import Workbook
from openpyxl.styles import Font, PatternFill

wb = Workbook()
ws = wb.active; ws.title = "Inputs"
ws["B2"] = "Revenue"; ws["C2"] = 1_250_000_000
ws["C2"].font = Font(color="0000FF")           # blue = hardcoded input
calc = wb.create_sheet("DCF")
calc["C5"] = "=Inputs!C2*(1+Inputs!C3)"        # black = formula
wb.save("./out/model.xlsx")

约定（与 audit-xls 保持一致）

• 蓝色 / 黑色 / 绿色。 蓝色 = 硬编码输入，黑色 = 公式，绿色 = 指向另一个工作表/文件的链接。
• 计算单元格中不得有硬编码。 每个计算单元格都是公式；每个输入都位于 Inputs 选项卡上。
• 命名区域 用于任何从演示文稿或备忘录中引用的值。
• 平衡检查。 包含一个 Checks 选项卡，用于勾稽（BS 平衡、CF 与现金勾稽等）并显示 TRUE/FALSE。
• 每个文件一个模型。 除非明确要求，否则不要追加到现有工作簿。

何时不要使用

如果 mcp__office__excel_* 工具可用（Cowork 插件模式），请改用这些工具 —— 它们会通过审查检查点来驱动用户的实时工作簿。此技能是无头运行时的文件生成回退方案。