* 您最终必须交付一个 Excel 文件，一个或多个，具体取决于任务，但必须交付的文件必须包含 .xlsx 文件 * 确保整体可交付成果**简洁**，并且**除了用户请求的内容之外，不提供任何文件**，**特别是自述文件**，因为这会占用太多上下文。 ## Excel 文件创建：Python + openpyxl/pandas **✅ 创建 Excel 所需的技术堆栈：** * **运行时**：Python 3 * **主库**：openpyxl（用于 Excel 文件创建、样式、公式） * **数据处理**：pandas（用于数据操作，然后通过openpyxl导出） * **执行** : 使用 `ipython` 工具执行 Python 代码 **✅ 验证和数据透视表工具：** * **工具** ：KimiXlsx（用于验证、重新检查、数据透视等的统一 CLI 工具） * **执行** : 使用 `shell` 工具执行 CLI 命令 **🔧 执行环境：** * 使用 **`ipython`** 工具通过 openpyxl/pandas 创建 Excel * 使用**`shell`**工具来验证命令 **Python Excel 创建模式：** 从 openpyxl 导入工作簿从 openpyxl.styles 导入图案填充、字体、边框、侧面、对齐方式将 pandas 导入为 pd # 创建工作簿 wb = 工作簿() ws = wb.活动 ws.title = "数据" # 添加数据 ws['A1'] = "标题1" ws['B1'] = "标题2" # 应用样式 ws['A1'].font = 字体(bold=True, color="FFFFFF") ws['A1'].fill = PatternFill(start_color="333333", end_color="333333", fill_type="solid") # 保存 wb.save('输出.xlsx') 使用外部获取的数据创建 Excel 文件时： **来源引用（强制）：** * 所有外部数据必须在最终 Excel 中引用来源 * **🚨 这适用于所有外部工具**：`datasource`、`web_search`、API 调用或任何获取的数据 * 使用**两个单独的列**：`源名称` | `源网址` * 不要使用HYPERLINK功能（使用纯文本以避免公式错误） * **⛔ 禁止**：使用外部数据提供 Excel，但没有来源引用 * 示例：数据内容|来源名称 |来源网址 ---|---|--- 苹果营收|雅虎财经 | ... 中国GDP |世界银行 API |世界银行开放数据 * 如果每行引用不切实际，请创建专用的“来源”表 **1\. Python (openpyxl/pandas)** \- 用于 Excel 文件创建、样式、公式、图表 **2\. KimiXlsx CLI 工具** \- 用于验证、错误检查和数据透视表创建 KimiXlsx 工具有 **6 个命令**，可以使用 shell 工具调用： **可执行路径** : `/app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx` **基本命令** ：`/app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx <命令> [参数]` ** ** 1. **重新检查** ⚠️ RUN FIRST 是否存在公式错误 * 说明：该工具检测： * **公式错误** : #VALUE!、#DIV/0!、#REF!、#NAME?、#NULL!、#NUM!、#N/A * **零值单元格**：结果为 0 的公式单元格（通常表示引用错误） * **隐式数组公式** ：在 LibreOffice 中有效但在 MS Excel 中显示 #N/A 的公式（例如，`MATCH(TRUE(), range>0, 0)`） * **隐式数组公式检测** : * 像“MATCH(TRUE(), range>0, 0)”这样的模式需要 MS Excel 中的 CSE (Ctrl+Shift+Enter) * LibreOffice 自动处理这些，因此它们通过 LibreOffice 重新计算但在 Excel 中失败 * 当检测到时，使用替代方案重写公式： * ❌ `=MATCH(TRUE(), A1:A10>0, 0)` → 在 Excel 中显示 #N/A * ✅ `=SUMPRODUCT((A1:A10>0)*ROW(A1:A10))-ROW(A1)+1` → 适用于所有 Excel 版本 * ✅ 或者使用具有显式 TRUE/FALSE 值的辅助列 * 使用方法： /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 重新检查输出.xlsx 2. **参考检查**（别名：refcheck） * 描述：该工具用于检测 Excel 公式中潜在的引用错误和模式异常。它可以识别AI生成公式时常见的4个问题： **超出范围引用** \- 公式引用的范围远远超出实际数据行数。 **标题行引用** \- 第一行（通常是标题）错误地包含在计算中。 **聚合函数范围不足** \- SUM/AVERAGE 等函数仅覆盖 ≤2 个单元格。 **不一致的公式模式** \- 同一列中的某些公式偏离主要模式（“孤立”公式）。 * 使用方法： /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 参考检查输出.xlsx 3. **检查** * 描述：此命令**分析 Excel 文件结构**并输出描述所有工作表、表格、标题和数据范围的 JSON。在处理之前使用它来了解 Excel 文件的结构。 * 使用方法： # 解析并输出JSON /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 检查 input.xlsx --pretty ** ** 4. **数据透视** 🚨 需要数据透视表.md * 描述：**使用纯 OpenXML SDK 创建带有可选图表的数据透视表**。这是唯一支持的数据透视表创建方法。自动在数据透视表旁边创建图表（条形图/折线图/饼图）。 * **⚠️ 关键** ：在使用此命令之前，您必须阅读 `/app/.kimi/skills/kimi-xlsx/pivot-table.md` 以获取完整文档。 * 所需参数： * `input.xlsx` \- 输入 Excel 文件（位置） * `output.xlsx` \- 输出 Excel 文件（位置） * `--source "Sheet!A1:Z100"` \- 源数据范围 * `--location "Sheet!A3"` \- 放置数据透视表的位置 * `--values "Field:sum"` \- 具有聚合的值字段（sum/count/avg/max/min） * 可选参数： * `--rows "Field1,Field2"` \- 行字段 * `--cols "Field1"` \- 列字段 * `--filters "Field1"` \- 过滤/页面字段 * `--name "PivotName"` \- 数据透视表名称（默认值：数据透视表1） * `--style "monochrome"` \- 样式主题: `monochrome` (默认) 或 `finance` * `--chart "bar"` \- 图表类型：`bar`（默认）、`line` 或 `pie` * 使用方法： # 首先：检查以获取工作表名称和标题 /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 检查 data.xlsx --pretty # 然后：创建带有图表的数据透视表 /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 枢轴 \ 数据.xlsx 输出.xlsx \ --source "销售！A1:F100" \ --rows“产品，区域”\ --values "收入:总和,单位:计数" \ --位置“摘要！A3”\ --图表“条形图” ** ** 5. **图表验证** * 描述：**验证所有图表是否具有实际数据内容**。创建图表后使用它以确保它们不为空。 * 使用方法： /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 图表验证输出.xlsx * 退出代码： * `0` = 所有图表都有数据，可以安全交付 * `1` = 图表为空或损坏 - **必须修复** ** ** 6. **验证** ⚠️ 强制 - 必须在交付前运行 * 描述：**OpenXML 结构验证**。未通过此验证的文件**无法由 Microsoft Excel 打开**。您必须在传送任何 Excel 文件之前运行此命令。 * **它检查什么**： * OpenXML 架构合规性（Office 2013 标准） * 数据透视表和图表结构完整性 * 不兼容的函数（FILTER、UNIQUE、XLOOKUP 等 - Excel 2019 及更早版本不支持） * .rels文件路径格式（绝对路径会导致Excel崩溃） * 退出代码： * `0` = 验证已通过，可以安全交付 * 非零 = 验证失败 - **不交付**，重新生成文件 * 使用方法： /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 验证输出.xlsx * **如果验证失败**：不要尝试“修复”文件。使用更正的代码从头开始重新生成它。 ** ** ## 📋 Excel 创建工作流程（每表验证） **🚨 重要：创建后立即验证每个工作表，而不是在所有工作表完成后！** 对于工作簿中的每个工作表： 1. PLAN → 设计本表的结构、公式、参考资料 2.创建→为此表写入数据、公式、样式 3. 保存 → 保存工作簿 (wb.save()) 4.检查→运行重新检查+参考检查→修复直到0个错误 5. NEXT → 仅在当前工作表有 0 个错误后才继续到下一个工作表所有工作表通过后： 6. 验证 → 运行 `validate` 命令 → 修复直到退出代码 0 7. 交付 → 仅交付通过所有验证的文件 ### 每张检查命令 # 创建/修改每个工作表后，保存并运行： /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 重新检查输出.xlsx /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 参考检查输出.xlsx # 在创建下一张表之前修复所有错误！ ### 最终验证（所有工作表完成后） /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 验证输出.xlsx **为什么要进行单张验证？** * Sheet 1 中的错误传播到 Sheet 2、Sheet 3...导致级联故障 * 每张改正 3 个错误比最后改正 30 个错误更容易 * 跨表参考可以立即验证 **⚠️ 关键：Excel 公式始终是首选** 对于任何分析任务，使用 Excel 公式是**默认和首选方法**。只要可以使用公式，就必须使用它。 ✅ **正确** \- 使用 Excel 公式： ws['C2'] = '=A2+B2' # 总和 ws['D2'] = '=C2/B2*100' # 百分比 ws['E2'] = '=SUM(A2:A100)' # 聚合 ❌ **FORBIDDEN** \- 在 Python 中预先计算并粘贴静态值：结果 = 值_a + 值_b ws['C2'] = result # 不好：静态值，而不是公式 **仅在以下情况下使用静态值： * 数据从外部来源获取（网络搜索、API） * 值是永远不会改变的常数 * 公式会创建循环引用 **遵循此工作流程：**：表 1：计划（编写详细设计）→ 创建 → 保存 → 运行重新检查 → 运行参考检查 → 修复错误 → 零错误 ✓ 表 2：计划（编写详细设计）→ 创建 → 保存 → 运行重新检查 → 运行参考检查 → 修复错误 → 零错误 ✓ 表 3：计划（编写详细设计）→ 创建 → 保存 → 运行重新检查 → 运行参考检查 → 修复错误 → 零错误 ✓ ... **🚨 重要：复查结果为最终结果 - 无例外** `recheck` 命令检测公式错误（#VALUE!、#DIV/0!、#REF!、#NAME?、#N/A 等）和零值单元格。您必须严格遵守以下规则： 1. **对错误零容忍**：如果“recheck”报告任何错误，您必须在交付前修复它们。没有例外。 2. **不要假设错误会“自动解决”**： * ❌错误：“当用户在 Excel 中打开文件时，这些错误将会消失” * ❌ 错误：“Excel 将自动重新计算并修复这些错误” * ✅ 正确：修复 `recheck` 报告的所有错误，直到 error_count = 0 3. **检测到的错误=需要修复的错误**： * 如果 `recheck` 显示 `error_count: 5`，则您有 5 个错误需要修复 * 如果 `recheck` 显示 `zero_value_count: 3`，则您有 3 个可疑单元格需要验证 * 只有当`error_count: 0`时才可以进行下一步 4. **要避免的常见错误**： * ❌“#REF! 错误是因为 openpyxl 不计算公式” - 错误，修复它！ * ❌“#VALUE！在 Excel 中打开时将解析”- 错误，请修复它！ * ❌“预计为零值”- 验证每一项，许多都是参考错误！ 5. **交付门**：具有任何“重新检查”错误的文件无法交付给用户。 **禁止的模式** ❌： 1. 创建工作表 1 → 创建工作表 2 → 创建工作表 3 → 最后运行一次重新检查 ❌错误：错误不断累积，调试变得更加困难 ✅ 正确：在每张纸之后检查，在移至下一张纸之前修复 2. 跳过任何工作表的计划 ❌ 错误：导致 80% 以上的参考错误 ✅ 正确：在创建每个工作表之前规划其结构 3. 重新检查显示错误 → 忽略并继续交付 ❌ 绝对禁止 - 错误必须被修复，而不是被忽略！ 4. 重新检查显示错误 → 继续创建下一张表 ❌ 错误：工作表 1 中的错误将级联到工作表 2、3... ✅ 正确：在创建下一个工作表之前修复当前工作表中的所有错误 **语法**：`=VLOOKUP(lookup_value, table_array, col_index_num, FALSE)` — 查找列必须位于 table_array 的最左边 **最佳实践**：使用 FALSE 进行精确匹配；用 `$A$2:$D$100` 锁定范围；用 `IFERROR(...,"N/A")` 包裹起来；跨工作表：`Sheet2!$A$2:$C$100` **错误**：#N/A=未找到； #REF!=col_index 超出列。 **Alt** ：查找列不是最左边时的索引/匹配 ws['D2'] = '=IFERROR(VLOOKUP(A2,$G$2:$I$50,3,FALSE),"N/A")' ## 🚨 关键：创建数据透视表需要读取数据透视表.md **何时触发**：检测以下任何用户意图： * 用户明确请求“数据透视表”、“数据透视表”、“透视数据表” * 任务需要按类别汇总数据 * 关键词：总结、聚合、分组依据、分类、细分、统计、分布、计数依据、总计依据 * 数据集有50+行需要分组 * 需要交叉表或多维分析 **⚠️ 强制操作**：当检测到数据透视表需求时，您必须： 1. **首先阅读** `/app/.kimi/skills/kimi-xlsx/pivot-table.md` 2. 遵循该文档中的执行顺序和工作流程 3.使用`pivot`命令（不是手动代码构建） **为什么需要这样做**： * 数据透视表创建使用纯 OpenXML SDK（C# 工具） * `pivot` 命令提供稳定、经过测试的实现 * openpyxl 中不支持和禁止手动枢轴构造 * 图表类型（条形图/折线图/饼图）是使用数据透视表自动创建的 **快速参考**（详细信息参见pivot-table.md）： # 第 1 步：检查数据结构 /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 检查 data.xlsx --pretty # 步骤 2：创建带有图表的数据透视表 /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 枢轴 \ 数据.xlsx 输出.xlsx \ --source "工作表!A1:F100" \ --行“类别”\ --values“收入：总和”\ --位置“摘要！A3”\ --图表“条形图” # 第 3 步：验证 /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx 验证输出.xlsx **⛔ 禁止**： * 使用 openpyxl 代码手动创建数据透视表 * 跳过“检查”步骤 * 在创建数据透视表之前不读取数据透视表.md * **🚨 切勿使用 openpyxl** 修改数据透视输出文件 ** \- openpyxl 会损坏数据透视缓存路径！ **⚠️ 关键：数据透视表的工作流程顺序** 如果您需要向包含数据透视表的文件添加额外的工作表（封面、摘要等）： 1. **首先**：使用 openpyxl 创建所有工作表（数据表、封面表、样式等） 2. **然后** ：运行 `pivot` 命令作为 **最后一步** 3. **从不**：再次使用 openpyxl 打开数据透视输出文件 - 这会损坏文件！ ✅ 正确顺序： openpyxl 创建 base.xlsx（带有封面、数据表） → 数据透视命令：base.xlsx → Final.xlsx（添加数据透视表） → 验证final.xlsx → 交付final.xlsx（不要再次修改） ❌ 错误的顺序（会损坏文件）： hub命令创建pivot.xlsx → openpyxl 打开pivot.xlsx 以添加封面← 损坏文件！ → 文件无法在 MS Excel 中打开 **🚨 禁止功能（与旧版 Excel 版本不兼容）** ： Excel 2019 及更早版本**不支持**以下函数。使用这些函数的文件将在旧版 Excel 中**无法打开**。请改用传统的替代品。 ❌ 禁止功能 | ✅ 替代方案 ---|--- `过滤器()` |使用自动筛选或 SUMIF/COUNTIF/INDEX-MATCH `UNIQUE()` |使用删除重复项功能，或使用 COUNTIF 辅助列 `排序()`、`排序()` |使用Excel的排序功能（数据→排序） `XLOOKUP()` |使用 `INDEX()` \+ `MATCH()` 组合 `XMATCH()` |使用“MATCH()” `序列()` |使用 ROW() 或手动填充 `让()` |在辅助单元中定义中间计算 `LAMBDA()` |使用命名范围或 VBA `RANDARRAY()` |使用带有向下填充的“RAND()” `数组公式()` |仅限 Google 表格 - 使用 Ctrl+Shift+Enter 数组公式 `查询()` |仅限 Google 表格 - 使用 SUMIF/COUNTIF/PivotTable `导入范围()` |仅限 Google 表格 - 手动复制数据 **为什么这些被禁止**： * 这些是 Excel 365/2021+ 动态数组函数或 Google Sheets 函数 * 较旧的 Excel 版本（2019、2016 等）无法解析这些公式 * 在旧版 Excel 中打开该文件时会崩溃或显示错误 * `validate` 命令将使用这些函数检测并拒绝文件 **示例 - 将 FILTER 转换为 INDEX-MATCH** ： ❌ 错误：=FILTER(A2:C100, B2:B100="Active") ✅ 正确：对数据范围使用自动筛选，或创建数据透视表 **⚠️ 差一预防**：保存之前，验证每个公式引用了正确的单元格。运行“引用检查”工具。常见错误：引用标题、错误的行/列偏移。如果结果为 0 或意外 → 首先检查参考文献。 **💰财务价值**：以最小单位存储（15000000而不是1.5M）。使用Excel格式显示：`"¥#,##0"`。切勿在公式中使用需要转换的换算单位。

基米 Xlsx

包含技能