PhilRobinluo 在 WorkBuddy 中找到并安装
Skill slug：lls-local-excel-vba-data-processor
在 WorkBuddy 新会话粘贴：
请按 https://skillhub.cn/install/skillhub.md 检查 SkillHub，搜索 `lls-local-excel-vba-data-processor`；仅在 slug 完全一致时安装到 `~/.workbuddy/skills/`。安装后读取 `~/.workbuddy/skills/lls-local-excel-vba-data-processor/SKILL.md`，核对 name、version 和实际路径，然后新开会话触发该 Skill。
也可以打开左侧「技能」→「添加技能 / 查找技能」，搜索 lls-local-excel-vba-data-processor 后安装；界面文字可能随 WorkBuddy 版本变化。
罗老师 Excel VBA 本地数据处理
核心目标
帮助用户把重复的 Excel 操作变成可审计、可回滚、可复用的本地宏。
这个 Skill 的重点不是“快速吐出一段 VBA”，而是：
- 先理解表格结构和业务规则；
- 用脱敏样例验证规则；
- 生成有保护措施的 VBA；
- 明确运行、备份、日志和验收方法；
- 让真实数据始终保留在用户自己的电脑中。
适用场景
- 多张工作表批量合并或拆分；
- 按编号、姓名或组合键匹配数据；
- 清洗空格、日期、金额、重复记录和异常值；
- 生成分类汇总、月报或部门报表；
- 批量建立文件、工作表或打印区域；
- 处理人事、财务、客户等不适合上传的数据。
不适用场景
- 多人实时协作或需要数据库级并发；
- 超过 Excel 可稳定承载的数据规模；
- 用户需要绕过工作簿保护、访问控制或审计机制；
- 规则尚未明确，却要求直接在唯一原件上运行。
隐私优先规则
- 默认不要求上传真实工作簿；
- 优先使用字段名、三到十行脱敏样例和规则描述；
- 姓名、手机号、身份证号、银行卡号和客户编号使用占位符；
- 宏默认不联网、不发邮件、不调用外部 API；
- 任何文件写入位置都由用户明确指定；
- 第一次运行只处理副本。
开始前的最小信息
询问不超过五个关键问题：
- Excel 是 Windows 版还是 Mac 版，版本大致是什么？
- 输入工作簿、工作表和表头分别是什么？
- 唯一键是什么，重复时采用哪条？
- 希望得到什么输出，保存在哪里？
- 能否提供脱敏样例和三个验收案例？
如果用户不熟悉 Excel 术语，解释：
- 工作簿：一个 Excel 文件；
- 工作表：底部的一个标签页；
- 表头：第一行字段名称；
- 唯一键：能认出一条记录的编号或字段组合。
标准交付流程
第一步：把需求写成数据契约
使用下面结构确认：
输入文件：
输入工作表：
表头行：
唯一键：
处理规则：
输出工作表/文件：
遇到空值：
遇到重复：
错误记录放到：
没有确认的数据契约，不进入正式宏编写。
第二步：制作脱敏测试夹具
至少覆盖：
- 正常记录；
- 空值；
- 重复键；
- 格式错误；
- 找不到匹配项；
- 中文、英文、数字混合；
- 日期或金额边界。
真实数据量很大时，先用二十行以内样例验证。
第三步：选择实现方式
| 情况 | 优先方案 |
|---|---|
| 一次性小批量 | Power Query 或公式 |
| 多次重复、规则稳定 | VBA |
| 十万行以上或多文件复杂关联 | Python / 数据库，本 Skill 只做需求与迁移建议 |
| Mac 与 Windows 都要运行 | 避开仅 Windows 可用的 ActiveX、COM 和文件对话框 |
不要为了使用 VBA 而强行使用 VBA。
第四步：设计安全护栏
正式宏至少包含：
Option Explicit；- 关闭与恢复
ScreenUpdating、EnableEvents； - 统一错误处理；
- 输入工作表存在性检查；
- 表头检查；
- 最后一行、最后一列的可靠识别；
- 运行日志或错误清单；
- 不使用
Select、Activate依赖当前焦点； - 不覆盖原始数据；
- 结束时恢复 Excel 状态。
第五步：生成宏
代码注释必须解释业务目的和失败路径，而不是只翻译语句。
推荐结构：
Option Explicit
Public Sub RunLocalProcessing()
On Error GoTo FailHandler
' 记录 Excel 原状态，确保成功或失败后都能恢复。
Dim oldCalc As XlCalculation
oldCalc = Application.Calculation
Application.ScreenUpdating = False
Application.EnableEvents = False
Application.Calculation = xlCalculationManual
' 1. 校验输入
' 2. 读取到数组
' 3. 执行业务规则
' 4. 写入新工作表
' 5. 记录处理数量和异常
CleanExit:
Application.ScreenUpdating = True
Application.EnableEvents = True
Application.Calculation = oldCalc
Exit Sub
FailHandler:
MsgBox "处理停止：" & Err.Description, vbExclamation
Resume CleanExit
End Sub
第六步：提供运行说明
面向普通用户说明：
- 先另存为
.xlsm； - 复制原文件作为测试副本；
Alt + F11打开 VBA 编辑器；- 插入模块并粘贴代码；
- 修改顶部配置区；
- 回到 Excel 运行宏；
- 检查输出页和错误清单；
- 验收通过后再处理正式副本。
Mac 的快捷键和安全设置可能不同，要提示用户按界面进入“工具 → 宏”。
第七步：执行验收
至少核对：
- 输入记录数；
- 成功处理数；
- 跳过数；
- 错误数；
- 输出记录数；
- 金额或数量合计；
- 三个抽样记录；
- 原始工作表是否保持不变。
输出格式
## 需求与假设
## 数据契约
## 处理规则
## VBA 代码
## 安装与运行
## 测试数据
## 验收清单
## 回滚方法
## 隐私说明
完整门禁见 references/vba-safety-checklist.md。
性能规则
- 大批量数据优先一次读入数组、一次写回；
- 查找表优先使用 Dictionary，但 Mac 兼容场景采用 late binding；
- 避免逐单元格读写；
- 明确复杂度和预计数据量；
- 运行超过一分钟时显示进度或分批处理；
- 不在循环里频繁保存工作簿。
质量门禁
- 已确认 Excel 平台与版本；
- 已使用脱敏样例；
- 已定义唯一键、空值和重复规则；
- 宏不覆盖唯一原件；
- 代码包含错误处理与状态恢复；
- 输出包含错误清单或日志；
- 提供安装、运行、回滚和验收步骤；
- 没有真实路径、账号、密码或客户数据；
- 至少三个测试案例通过。
失败处理
- 表头缺失：停止并列出缺失字段；
- 工作表重名：生成带时间或序号的新名称；
- 唯一键重复：进入错误清单，不静默覆盖；
- 文件正在被占用：停止写入并提示关闭占用；
- Mac 不支持某组件：提供兼容替代；
- 数据规模超出 Excel：输出迁移建议，不继续堆叠宏。
使用入口
如果这个 Skill 帮你节省了时间，欢迎给总仓库点一个 Star；需要版本提醒时，请在 GitHub 订阅 Releases。