前言¶
工程造价、审计或成本对比时，分部分项工程量清单计价表往往分散在多个 Excel 工作簿里：表头行不统一、合并单元格、列名写法各异（「综合单价」「单价」混用）。手工复制粘贴既慢，也容易漏表、漏行。下面介绍 SkillHub 社区 Skill「钟工造价屋分部分项清单清洗」（@user_de9e9350/boq-cleaner），在 Agent 对话中按文件夹批量扫描计价表，识别目标工作表、抽取固定字段、校验后合并为一张带数据来源的标准表。
这是什么¶
钟工造价屋分部分项清单清洗（坐标 @user_de9e9350/boq-cleaner，版本 1.0.1，分类 data-analysis，来源 community，发布者 user_de9e9350）面向「清洗、合并多个 Excel 中的分部分项工程量清单计价表数据」这一单一任务。Skill 采用通用 SKILL.md 格式，不需要 API Key（requires_api_key=false）。
在 SkillHub 上，该 Skill 评分为 100000，下载 1512 次（数据取自 SkillHub 页面元信息，截至编写时）。
核心功能¶
依据 Skill 文档，能力可概括为下面几条（均为文档已写明的行为，而非额外推断）：
- 批量扫描：在指定文件夹内处理
.xlsx、.xls，跳过~$等临时文件。 - 工作表识别：默认在工作表名称或前 10 行内容中查找特征词「分部分项」（可通过
sheet_key_word自定义，例如「清单」）。 - 八列必选：在前
header_rows行（默认 20 行）内识别序号、项目编码、项目名称、项目特征、计量单位、工程量、单价、合价；支持文档中的关键字别名（如「综合单价」「工程数量」等）。八列缺一即跳过该表。 - 行级过滤：按序号列判断有效清单行（整数、小数或可解析为正数的字符串等规则见 Skill 文档）。
- 清洗与校验：合并单元格向前填充、关键字段非空、工程量/单价/合价为非负数；可选验证合价是否等于工程量×单价。
- 合并输出：纵向合并所有有效表，增加「数据来源」列（工作簿名）；输出
.xlsx，含表头样式、数值格式、「清洗汇总」工作表；可选生成<输出文件>_log.txt日志。
依赖实现为 Python，文档写明使用 pandas、openpyxl。
安装与启用¶
安装 SkillHub CLI¶
若本机尚未安装 CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装说明 执行完整安装：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill¶
官方页面提供的安装提示为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_de9e9350/boq-cleaner。
CLI 搜索结果显示的安装命令为：
skillhub install boq-cleaner --namespace user_de9e9350 --dir <你的 Agent skills 目录>
--dir 必须指向当前 Agent 实际读取的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。常见路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后，按你所用客户端要求重启或刷新 Agent，使 Skill 生效。
典型用法¶
本 Skill 通过自然语言触发；文档给出的触发词包括：清洗清单、合并计价表、分部分项数据清洗、工程量清单整理、BOQ数据清洗。
基础请求¶
向 Agent 说明输入文件夹与输出文件路径即可。文档示例：
请使用boq-cleaner skill清洗并合并以下文件夹中的分部分项工程量清单：
输入：C:/Users/18357/Desktop/数据清洗Skill测试表格/
输出：C:/Users/18357/Desktop/清洗结果.xlsx
等价信息也可写成：
请帮我清洗和合并这些工程量清单文件：
输入文件夹：C:/Users/18357/Desktop/项目A/
输出文件：C:/Users/18357/Desktop/项目A-合并清单.xlsx
Agent 按 Skill 流程扫描目录、识别工作表、提取八列、清洗合并并写出结果文件。
可调参数（对话中说明即可）¶
| 参数 | 说明 | 默认值 |
|---|---|---|
input_folder |
Excel 所在文件夹 | 必填 |
output_file |
输出 .xlsx 路径 |
必填 |
sheet_key_word |
工作表匹配关键字 | 分部分项 |
header_rows |
表头搜索行数 | 20 |
高级选项（文档中的配置项）：skip_negative_values、fill_merged_cells、validate_formula、output_log 等，可在请求里写明是否启用。
自定义工作表示例¶
使用boq-cleaner skill处理这些文件，工作表关键字是"清单"，
输入：C:/Users/18357/Desktop/数据/
输出：C:/Users/18357/Desktop/结果.xlsx
适用场景与注意¶
适合谁：需要把多份计价表汇总成一张标准清单的造价、审计、成本分析人员；希望用对话指定目录、减少手工整理表头与行筛选的场景。
限制与注意（均来自 Skill 文档）：
- 仅支持
.xlsx/.xls；加密或损坏文件会被跳过并记入日志。 - 每个工作簿只取第一个匹配特征词的工作表；多 sheet 同名场景需事先拆分或调整文件结构。
- 表头必须在默认前 20 行内且八列齐全，否则整表跳过。
- 大批量文件时注意内存；处理前建议备份原件。
- 运行环境需能使用
pandas、openpyxl；排查问题时可查看是否生成清洗日志，文档亦提到可在~/.workbuddy/skills/boq-cleaner/查看部分运行产物（路径以 Skill 文档为准）。
结尾¶
「钟工造价屋分部分项清单清洗」把分部分项计价表从「多文件、多表头」整理成带数据来源与汇总页的单一 Excel，适合在 Agent 里用自然语言指定输入输出目录完成批处理。安装与详情见 SkillHub：
- 页面：https://www.skillhub.cn/skills/user_de9e9350/boq-cleaner
- API 入口：https://api.skillhub.cn/user_de9e9350/boq-cleaner
