yuanchen-home/cumcm-step-review/xlsx

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

读取、创建、修改和验证 XLSX，支持模板保留、公式重算和错误检查。

Install

npx vskill@latest install yuanchen-home/cumcm-step-review/xlsx

SKILL.md

Excel 工具

原则

  • 输入表格只读，输出写入 PROJECT_ROOT。
  • 普通结果汇总优先 CSV。
  • 题目指定 XLSX、需保留公式、多工作表或模板结构时才使用 XLSX。
  • 不覆盖题目原始附件和 Skill 文件。

读取与写入

python
import pandas as pd
# 第一行就是数据时必须显式使用 header=None。
data = pd.read_excel("data/input.xlsx", sheet_name=0, header=None)
assert len(data) == 7470, f"行数异常: {len(data)}"
result = pd.DataFrame({"方案": names, "目标值": values})
result.to_excel("results/结果.xlsx", index=False)

禁止依赖 pandas.read_excel() 默认的 header=0 猜测表头，否则第一行数据会被当成列名。未知表头结构或必须精确保留行时使用无隐式推断的读取工具：

python
from scripts.read_rows import read_excel_rows
rows = read_excel_rows(
    "data/input.xlsx",
    header=False,
    expected_rows=7470,
)
assert rows[0][0] == 399.6747

读取后必须核对首行、末行、原始工作表有效行数和题目声明的记录数；行数不符时立即报错，不得静默继续建模。

使用模板时用 openpyxl.load_workbook() 打开，写入指定单元格后另存新文件。不要删除未知工作表、命名区域、公式或验证规则。

公式重算

openpyxl 不计算公式。修改含公式的工作簿后使用 LibreOffice 隔离重算：

powershell
python scripts/recalc.py "<PROJECT_ROOT>/results/结果.xlsx" 60

工具会：

  1. 使用唯一临时 LibreOffice 配置；
  2. 把重算结果写入临时目录；
  3. 检查常见 Excel 错误；
  4. 仅在成功后原子替换目标文件；
  5. 超时、失败或未生成输出时保留原文件。

DOCX 与 XLSX 共用的 OOXML/LibreOffice 基础代码位于 ../docx/scripts/office/，本工具不再维护重复副本。

检查

  • 公式引用和范围正确。
  • 工作表名、列名、数据类型和单位正确。
  • 已显式声明是否有表头，首行、末行和预期数据行数均已核对。
  • 无 #VALUE!、#DIV/0!、#REF!、#NAME?、#NULL!、#NUM!、#N/A。
  • 结果与代码终端输出和论文表格一致。

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
294
Repository forks
11
7-day trend score
28

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/yuanchen-home/cumcm-step-review/xlsx/badge)](https://verified-skill.com/skills/yuanchen-home/cumcm-step-review/xlsx)

Something wrong with this skill or its page? Tell us.