技能介绍

无头模式下的 Excel 交付难题

当 Agent 以无头（managed-agent / CMA）模式运行时，通常没有交互式的 UI 来操作实时工作簿。如果依赖 mcp__office__excel_* 这类工具来生成报表，往往会遇到环境不支持或流程被打断的问题。此时，我们需要一种更轻量、更确定性的方案：直接在后台生成一个符合规范的 .xlsx 文件，并作为文件产物（file artifact）返回给编排层，而不是让用户去手动保存或二次处理。

核心能力与关键步骤

该技能的核心在于通过 openpyxl 编写短小的 Python 脚本，利用 Bash 执行并产出结构化的 Excel 工作簿。具体工作流程如下：

输出契约明确：脚本会先将文件写入 ./out/ 目录（若不存在则自动创建），并在最终消息中返回相对路径，方便上层编排系统直接收集和分发。
审计级配色规范：严格遵循 蓝/黑/绿 三色法则。蓝色代表硬编码的输入参数，黑色代表公式，绿色代表跨表或跨文件的引用链接，让审阅者一目了然。
计算逻辑零硬编码：所有计算单元格必须包含公式，所有输入数据统一放置在 Inputs 标签页中。对于在演示文稿或备忘录中引用的值，需使用命名区域（Named ranges）。
内置平衡检查：工作簿必须包含 Checks 标签页，用于验证资产负债表（BS）平衡、现金流（CF）与现金核对等关键逻辑，并直接输出 TRUE 或 FALSE 供自动化判断。
单模型单文件：遵循「一个模型对应一个文件」的原则，除非明确要求，否则绝不向现有工作簿追加内容，避免数据污染。

适用边界与安全注意

虽然该技能能完美解决无头模式下的文件生成问题，但它并非万能替代。如果你的环境已经安装了 Cowork 插件（即 mcp__office__excel_* 工具可用），请优先使用 MCP 工具，因为它们支持带有检查点（review checkpoints）的实时工作簿操作，更适合需要人工干预的场景。

此外，简诗 AI 的安全边界要求：技能不会自动安装依赖、修改系统权限或创建持久化任务。涉及发送、发布、删除、付款等外部写入操作时，必须先展示影响范围并获取用户明确确认。命令和代码默认仅作为参考，只有在用户明确要求且目标范围清晰时才会执行。