English | 中文
Make Excel work safe when the workbook is data, logic, output, and review surface at the same time.
Excel automation fails quietly. A script can write the right-looking cells while breaking formulas, dropping macros, trusting stale cached values, or overwriting a human edit. excel-collab turns every Excel task into a contract before the file is touched.
Use it when an agent must inspect, modify, compare, repair, or explain .xlsx, .xlsm, or workbook-derived data.
flowchart TD
T["Excel task"] --> C["Classify action and target"]
C --> A["Define workbook contract"]
A --> P["Check locks, formulas, macros, human edits"]
P --> E["Read / edit / derive / repair"]
E --> V["Read back and validate"]
V -->|"pass"| D["Deliver evidence"]
V -->|"fail"| R["Repair or roll back"]
Before writing, identify:
- the active workbook and active sheet;
- whether the task is read-only, edit, compare, generate, repair, or explain;
- the exact range or table being touched;
- whether formulas, formats, macros, validations, comments, or cached values matter;
- whether the workbook may be open or edited by a human;
- how the result will be validated after the write.
No write is complete until the workbook is read back or otherwise verified.
| Risk | Protection |
|---|---|
| Wrong workbook or sheet | Explicit active-workbook contract |
| Formula loss | Formula-aware reads and post-write checks |
| Macro loss | .xlsm preservation and no blind conversion |
| Stale values | Formula/cache checks when values matter |
| User edits | Lock/open-file checks and scoped diffs |
| Silent write failure | Readback validation before delivery |
Use excel-collab for this workbook. Identify the active workbook and sheet, classify the task, preserve formulas/macros where relevant, and validate by readback before delivering.
Do not use this skill for plain CSV analysis, simple tabular reasoning with no workbook fidelity requirement, or tasks where Excel is not the source, output, or review surface.
MIT.