Content to Excel
Overview
把散落在对话、报告、代码或清单中的内容，整合成一份结构清晰、可直接使用的 .xlsx 表格文件。默认输出基础表格：首行表头 + 数据行，不做多余样式。目标是让内容「可交付、可继续编辑」，而不是追求花哨的排版。
何时使用
在以下情况使用本 skill：
- 对话中已有 markdown 表格 / 列表 / 数据，用户希望落成文件
- 分析报告、对比结论、调研结果需要表格化交付
- 代码统计、项目清单、文件清单、任务清单等数据需要导出成表
- 用户明确说“导出 Excel / 生成表格 / 转成 xlsx / 做成一个表”
在以下情况不使用本 skill：
- 用户只是想看，不需要生成文件 → 直接在回复里给表格即可
- 需要复杂样式、公式、图表、多 Sheet 联动、条件格式的专业报表 → 使用
tencent-docs-sheet-generation或tencent-docs-sheetagent - 用户已提供现成的 Excel 文件，要做就地编辑 → 使用表格编辑类 skill
工作流程
Step 1 — 明确内容与范围
从上下文（本次对话、报告、代码、用户粘贴内容）中确定要导出的数据。若内容分散，先汇总成一份候选数据集；不确定要包含哪些字段时，按“一个对象一行、一个属性一列”的原则先给出结构，再执行。
Step 2 — 设计表结构
在执行前先确定：
- 列（字段）：列名简洁、语义明确，例如“项目名称 / 状态 / 完成日期 / 说明”
- 行（记录）：每行代表一个独立对象
- 数据类型：数字列存为数字型（不要用文本），日期统一格式（如
YYYY-MM-DD） - Sheet 划分：单一主题默认一个 Sheet；内容明显分属不同类别时再拆分，并在文档中说明
把设计好的结构简要告知用户（尤其是列名），再生成文件。
Step 3 — 生成文件
使用 Python 生成 .xlsx。优先 openpyxl（可控、无额外依赖），也可用 pandas.to_excel。具体代码模板见 references/excel-recipes.md。
保存路径规则：
- 用户指定了路径 → 按用户指定
- 未指定 → 保存到当前工作目录，文件名用内容语义命名（如
项目清单.xlsx、分析结果.xlsx），不要用output.xlsx这类无意义名称
Step 4 — 校验与交付
- 确认文件已写入、可打开（文件大小 > 0）
- 用
present_files把生成的文件交给用户 - 在回复中用一两句话说明：文件路径、包含几个 Sheet、多少行数据、列结构
输出规范（基础表格）
默认遵循以下约定，除非用户另有要求：
- 格式：
.xlsx（用户要求.csv时才用 csv） - 首个 Sheet 的第一行是表头
- 表头与数据之间不插入空行
- 数值列保持数字类型，便于用户在 Excel 中直接计算
- 不添加合并单元格、不添加背景色 / 边框等样式（保持“基础表格”）
- 空值统一留空，不要写
null/N/A
Resources
references/excel-recipes.md
常用代码模板（写入 xlsx、多 Sheet、pandas 写法、数字与日期处理、CSV 导出、编码注意事项）。生成文件前按需查阅，避免每次重复摸索 API。
