53 lines
2.3 KiB
Markdown
53 lines
2.3 KiB
Markdown
---
|
||
name: xlsx-workflow
|
||
description: "XLSX workflow: edit spreadsheets, formulas, formatting, charts, validations; recalc and ensure zero-error checks. Triggers: xlsx workflow, Excel表格, 改公式, 数据透视表, 生成报表, 对账, #REF, #DIV/0."
|
||
---
|
||
|
||
# XLSX Workflow（Excel / 公式与校验）
|
||
|
||
## When to Use
|
||
|
||
- 批量清洗数据、生成报表、对账
|
||
- 需要编辑公式/格式/条件格式/数据验证
|
||
- 需要“零错误”校验（避免 `#REF!/#DIV/0!/#NAME?` 等）
|
||
|
||
## Inputs（required）
|
||
|
||
- Files: `.xlsx` 路径（以及是否有模板/受保护工作表）
|
||
- Goal: 哪些 sheet/范围需要修改（明确列名/单元格范围）
|
||
- Constraints: 是否允许改公式？是否必须保留原格式/保护/宏？
|
||
- Output: 产物路径（xlsx + 可选导出 csv/pdf）
|
||
- Environment: 可用工具（repo scripts、Python 依赖、`libreoffice --headless` 等）
|
||
|
||
## Capability Decision（do first）
|
||
|
||
1. 优先使用项目/环境已有的 **高保真工具链**（如果有）。
|
||
2. 否则走开源 fallback（需确认可接受的行为差异）：
|
||
- Python：`openpyxl`（结构化编辑；对公式重算能力有限/依赖 Excel 语义）
|
||
- 数据处理：`pandas`（适合表格化数据，但要小心丢格式）
|
||
|
||
## Procedure（default）
|
||
|
||
1. **Inspect**
|
||
- Sheet 列表、命名、表头、冻结窗格、数据验证规则
|
||
- 是否含外部链接、宏、受保护区域
|
||
2. **Operate**
|
||
- 数据改动优先：保持表头不变、范围可追踪、避免隐式类型转换
|
||
- 公式改动：先定义输入/输出列，写最小可验证样例
|
||
- 格式改动：与业务逻辑分离，避免“数据+格式”混改造成回滚困难
|
||
3. **Validate**
|
||
- 可用时做重新计算，并检查错误值：`#REF!/#DIV/0!/#NAME?/#VALUE!`
|
||
- 抽样核对：关键行/关键合计值/边界值
|
||
|
||
## Output Contract（stable）
|
||
|
||
- Summary：输入 → 输出（xlsx/csv/pdf）
|
||
- Changes：按 sheet 列出（数据/公式/格式/验证规则）
|
||
- Validation：重算/错误检查/抽样核对结果
|
||
- Notes：fallback 模式的限制（公式重算、宏、外部链接）
|
||
|
||
## Guardrails
|
||
|
||
- 表格数据可能含敏感信息：默认不在对话粘贴大表；用统计/摘要/行号定位
|
||
- 批量变更必须给出可复现的变换规则（便于审计与回滚）
|