执行 Git 操作(提交、分支、合并、变基、冲突解决与恢复)时强制套用安全规则。
文档
xlsx
试用生成、修改并校验 Excel 工作簿,公式真实可算、数字格式正确、无公式错误。
它能做什么
覆盖表格文件的完整处理流程:读取已有的 .xlsx/.xlsm/.xltx/.csv/.tsv,用 openpyxl 新建或修改,用 pandas 批量导入导出数据,以及在表格格式之间转换。公式以公式形式写入而非 Python 算好的数值,随后通过 scripts/recalc.py 调用 LibreOffice 重算,返回 JSON 报告公式总数、错误数量和出错单元格。文档还整理了 openpyxl 的常见坑(公式与缓存值需分两次读取、合并单元格、keep_vba、跨表引用加引号)以及财务模型的配色、数字格式和假设单元格规范。
什么时候用它
- 修复格式混乱或已损坏的现有工作簿,同时保留原有公式和格式约定
- 搭建带输入区、情景开关和统一预测公式的财务模型
- 同时读取工作簿的公式和缓存值,核对它实际算的是什么
- 把 CSV/TSV 转成带格式的 .xlsx,或把工作表数据导出到 pandas
技能文档
XLSX creation, editing, and analysis
| Task | Approach |
|---|---|
| Create or edit with formulas/formatting | openpyxl — see gotchas below |
| Bulk data in or out | pandas (read_excel, to_excel) |
| Quick look at a sheet | markitdown file.xlsx — ## SheetName per sheet; reads .xlsm too. No cell coordinates, so don't plan edits from it |
| Read a model (formulas and values) | two load_workbook passes — see gotchas |
openpyxl,pandas, andmarkitdownare preinstalled — do not runpip installfirst; write the script and import directly. Only if an import fails (or themarkitdowncommand is missing):pip installthe missing package.
Script paths below are relative to this skill's directory.
Requirements for every output
- Professional font (Arial, Times New Roman) throughout, unless the user says otherwise.
- Zero formula errors. Never ship while
recalc.pyreportserrors_found; the one exception is undernot_computedbelow. If you think an error predates you, prove it: load the original withdata_only=Trueand look at that cell. An error you introduced looks exactly like one you inherited. - Use formulas, never hardcoded results. Write
sheet['B10'] = '=SUM(B2:B9)', not the Python-computed total. The sheet must recalculate when its inputs change. - Follow the user's spec literally. Exact tab names, exact column headers, and the formula they spelled out. A redesign that computes something else fails, however elegant.
- Document every assumption and hardcoded number where the reader will see it — a cell comment, or an adjacent cell at a table's end. Cite a real source when one exists (
Source: Company 10-K, FY2024, Page 45, Revenue Note, [SEC EDGAR URL]); when the number came from the user, say so plainly. - A workbook you create for someone to fill in needs a short legend naming which cells to edit, and one example row of realistic values showing the expected format. Never add such a row to a file you were asked to edit.
- Editing an existing file: match its conventions exactly. They override every guideline here. Find its designated input cells first — a distinct font color, fill, or shading marks them — write only there, and leave every existing formula untouched.
Recalculate (mandatory whenever the file contains formulas)
openpyxl writes formulas as strings with no cached values. Until you recalculate, every
formula cell reads back as None to anything reading cached values — pandas,
load_workbook(data_only=True), and most previewers.
python scripts/recalc.py output.xlsx [timeout_seconds] # default 30
LibreOffice computes the formulas on a copy, only their values go into your file, and you get JSON:
status (success | errors_found), total_formulas, total_errors, and an
error_summary naming up to 100 cells per error type (locations_truncated says how many it
withheld — trust total_errors, not the length of the list). Fix what it names and run it
again. JSON with an error key instead of a status means nothing was recalculated, and
only that case exits non-zero — errors_found exits 0, so never treat a clean exit as a clean
workbook.
A green recalc proves your formulas evaluate, not that they are right. An off-by-one range or a reference to the wrong row yields a clean, error-free file with wrong numbers. Write 2–3 formulas first and check they pull the values you expect, before building out a grid.
not_computed lists formulas LibreOffice cannot evaluate, even on success: a function it lacks
(_xlfn.XLOOKUP, _xlfn.LET…) or a link to another workbook (='[1]Returns Analysis'!$B$2). They
keep what they held: after an openpyxl save, nothing until Excel opens it. For their numbers sooner,
read the original with data_only=True; keep the formulas. A sound formula depending on a listed one,
directly or not, reports #NAME? too: leave it and tell the user. A cell that tests one
(IFERROR(B1,0)) gets LibreOffice's fallback, and a kept value may be stale: say so. After editing
sheet XML, delete each changed formula's ``: a mistake that keeps its value is listed, not reported.
Choosing formulas that survive verification
LibreOffice implements fewer functions than Excel, and a formula it cannot evaluate has no value until Excel opens the file.
- Prefer Excel-2007-era functions —
SUMIFS,INDEX,MATCH,IFERROR,SUMPRODUCT— which need no prefix. - Six post-2007 functions work, but only with an
_xlfn.prefix, because openpyxl writes your formula into the XML verbatim and Excel stores post-2007 names prefixed (its UI hides the prefix):_xlfn.TEXTJOIN,_xlfn.CONCAT,_xlfn.IFS,_xlfn.SWITCH,_xlfn.MAXIFS,_xlfn.MINIFS. Written bare, each yields#NAME?. - Never use
XLOOKUP,XMATCH,SORT,FILTER,UNIQUE, orSEQUENCE. The runtime's LibreOffice cannot evaluate them, and one that can fills only the top-left cell of their result, since an openpyxl-written file has no spill metadata. UseINDEX/MATCHfor lookups, and sort, filter, and de-duplicate in Python before writing the cells. - A missing
)is reported asunbalanced brackets. Too few arguments (=ROUND(A1)) is not: LibreOffice returns a value, and Excel may offer to repair the file.
openpyxl gotchas
- Reading a model takes two loads.
data_only=Trueyields cached values with the formulas gone; the default yields formula strings with no values. One pass cannot give you both. data_only=Trueis destructive if you save. That workbook has no formulas left, so saving replaces every one with a literal — permanently.data_only=Trueon a file openpyxl just wrote returnsNoneeverywhere — runrecalc.pyfirst. (A formula whose result is""also reads back asNone.)- Merged cells: write the top-left anchor only. Every other cell in the range is a
MergedCellwhose.valueis read-only. .xlsmloses its macros unless you passkeep_vba=Truetoload_workbook.- A sheet name containing a space must be quoted in a cross-sheet reference:
='Assumptions Inputs'!$B$5. Unquoted, it evaluates to#VALUE!. - Saving an upload drops its text boxes, shapes and slicers. First search
xl/drawings/for<xdr:sp(with the space) and look for anxl/slicers/part; if found, tell the user or edit the sheet XML directly. - Nothing mends a malformed workbook: an unclosed quote in a number format (
'0.00 "USD'), a defined name starting with=, or duplicate or empty table headers are saved as written, and Excel may offer to repair the file. - Partly bold or italic cell text is flattened unless
load_workbook(rich_text=True); such a.valueis then aCellRichText, not astr. - Every new formula needs its own
number_format(date, %, currency): nothing infers it, so a date shows as45337and 30% as0.3. - On every new chart set
chart.roundedCorners = False,.overlay = Falseon its legend and on each title you gave it (chart.legend,chart.title,chart.x_axis.title…), and, if it has axes (not pie or doughnut),chart.x_axis.delete = Falseandchart.y_axis.delete = False, or Excel may draw the title or legend over the plot, round the frame, or draw no axes. - With a
DateAxis, setchart.y_axis.crossAx = 500, or Excel may offer to repair the file.
Financial models
Unless the user says otherwise, or the existing file already does something else.
Color: blue text (0,0,255) for hardcoded inputs and scenario levers · black for formulas ·
green (0,128,0) for links to another sheet · red (255,0,0) for links to another file ·
yellow fill (255,255,0) for key assumptions and cells the user should fill in.
Numbers: currency $#,##0, with the unit named in the header (Revenue ($mm)) · zeros
render as -, including in percentages ($#,##0;($#,##0);-) · negatives in parentheses ·
percentages 0.0%, stored as fractions (0.15 renders 15.0%; storing 15 renders
1500.0%) · valuation multiples 0.0x · years as text ("2024", never 2,024).
Structure: every assumption in its own labeled cell, referenced by the formulas that use it
(=B5*(1+$B$6), never =B5*1.05) · formulas consistent across every projection period, since a
lone edited cell mid-row is the commonest silent error · guard denominators that can be zero.
Dependencies
openpyxl, pandas, markitdown (pip, preinstalled — install only if an import fails or the command is missing) · LibreOffice (soffice, auto-configured for sandboxed environments via scripts/office/soffice.py)
常见问题
- 它会检查公式是否真的能算对吗?
- 会。scripts/recalc.py 在副本上运行 LibreOffice,返回 status、total_formulas、total_errors 和列出出错单元格的 error_summary。文档特别提醒:退出码为 0 不代表工作簿没问题,errors_found 同样返回 0;而且重算通过只说明公式能求值,不代表引用范围写对了。
- 哪些 Excel 函数不能用?
- XLOOKUP、XMATCH、SORT、FILTER、UNIQUE、SEQUENCE 都不能用,运行环境的 LibreOffice 无法计算。TEXTJOIN、CONCAT、IFS、SWITCH、MAXIFS、MINIFS 这类 2007 之后的函数必须加 _xlfn. 前缀才生效。SUMIFS、INDEX、MATCH、IFERROR、SUMPRODUCT 等 2007 时代的函数无需前缀。
- 需要先安装依赖吗?
- openpyxl、pandas、markitdown 已预装,脚本直接 import 即可;只有导入失败或找不到 markitdown 命令时才需要 pip install。重算依赖 LibreOffice(soffice),沙箱环境已通过脚本自动配置。
- 修改文件会丢失宏或图形吗?
- .xlsm 的宏只有在 load_workbook 时传 keep_vba=True 才会保留。保存会丢掉文本框、形状和切片器,所以文档建议先检查 xl/drawings/ 和 xl/slicers/,发现后告知用户或直接改工作表 XML。
相关技能
通过上下文收集、逐节撰写和读者测试三个阶段,把零散想法变成一份成稿文档。
pptx
官方用脚本生成、修改和读取 .pptx / .potx 文件,覆盖从新建演示文稿到解析幻灯片内容的完整流程。
基于 OpenAI 官方开发者文档给出带引用的回答,Codex 相关问题优先查 Codex 手册。
按语言和框架给出具体的安全实践建议,既能写出默认安全的代码,也能产出按严重程度排序的漏洞报告。
Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions; use `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after exp
Anthropic 的更多技能
浏览全部技能通过上下文收集、逐节撰写和读者测试三个阶段,把零散想法变成一份成稿文档。
docx
官方用脚本和 XML 级编辑来创建、读取、修改和批注 .docx 与 .dotx 文件。
用 Python 和命令行工具读取、提取、合并、拆分、旋转、加水印、加密和生成 PDF。
pptx
官方用脚本生成、修改和读取 .pptx / .potx 文件,覆盖从新建演示文稿到解析幻灯片内容的完整流程。
把一句创作需求先写成生成艺术宣言,再落成带参数面板、可复现的 p5.js 作品。
起草、测试并迭代 agent skill,通过对照基线和量化评测验证效果。