Merge commit 'ac794a6a7051497ff60b947642d44f0f8c04d6c6' into lsp-server

This commit is contained in:
csh
2026-01-08 15:56:37 +08:00
113 changed files with 254751 additions and 176 deletions
@@ -0,0 +1,56 @@
---
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 WorkflowExcel / 公式与校验)
## When to Use
- 批量清洗数据、生成报表、对账
- 需要编辑公式/格式/条件格式/数据验证
- 需要“零错误”校验(避免 `#REF!/#DIV/0!/#NAME?` 等)
## Inputsrequired
- Files: `.xlsx` 路径(以及是否有模板/受保护工作表)
- Goal: 哪些 sheet/范围需要修改(明确列名/单元格范围)
- Constraints: 是否允许改公式?是否必须保留原格式/保护/宏?
- Output: 产物路径(xlsx + 可选导出 csv/pdf
- Environment: 可用工具(repo scripts、Python 依赖、`libreoffice --headless`
等)
## Capability Decisiondo first
1. 优先使用项目/环境已有的 **高保真工具链**(如果有)。
2. 否则走开源 fallback(需确认可接受的行为差异):
- Python`openpyxl`(结构化编辑;对公式重算能力有限/依赖 Excel 语义)
- 数据处理:`pandas`(适合表格化数据,但要小心丢格式)
## Proceduredefault
1. **Inspect**
- Sheet 列表、命名、表头、冻结窗格、数据验证规则
- 是否含外部链接、宏、受保护区域
2. **Operate**
- 数据改动优先:保持表头不变、范围可追踪、避免隐式类型转换
- 公式改动:先定义输入/输出列,写最小可验证样例
- 格式改动:与业务逻辑分离,避免“数据+格式”混改造成回滚困难
3. **Validate**
- 可用时做重新计算,并检查错误值:`#REF!/#DIV/0!/#NAME?/#VALUE!`
- 抽样核对:关键行/关键合计值/边界值
## Output Contractstable
- Summary:输入 → 输出(xlsx/csv/pdf
- Changes:按 sheet 列出(数据/公式/格式/验证规则)
- Validation:重算/错误检查/抽样核对结果
- Notesfallback 模式的限制(公式重算、宏、外部链接)
## Guardrails
- 表格数据可能含敏感信息:默认不在对话粘贴大表;用统计/摘要/行号定位
- 批量变更必须给出可复现的变换规则(便于审计与回滚)