前言¶
建设工程现场会积累大量质量检验记录：联检纪要、质监站检查单、整改回复、通病案例说明等，常见形态是 Word、PDF 或 Excel 原件。若要把其中的条目沉淀成可检索、可复用的知识库，往往离不开人工打开文件、对照表头抄写、再粘贴进统一表格，字段多、格式杂时尤其费时，也容易漏项或填错列。
下面介绍 SkillHub 社区 Skill「知识点抽取工具」（坐标 @user_5c6938ae/1111-v2，当前版本 1.0.1）。它在 Agent 侧提供一套固定流程：解析原始检验记录、做字段映射与分类，并把结果写入 knowledge_base.xlsx，减轻「检查记录 → 知识库行」的重复劳动。
这是什么¶
「知识点抽取工具」是面向 knowledge-management（知识管理）场景的 Agent Skill，由社区发布者 user_5c6938ae 维护，来源标注为 community。Skill 页面标注 requires_api_key=false，即按官方标签说明，不依赖额外 API Key 配置即可使用（具体仍取决于你所用 Agent 与运行环境）。
一句话定位：将建设工程质量检验记录的原始文件自动提取并结构化，填入 knowledge_base.xlsx 知识库表格。
官方入口：
- SkillHub 展示页：https://www.skillhub.cn/skills/user_5c6938ae/1111-v2
- 技能坐标页：https://api.skillhub.cn/user_5c6938ae/1111-v2
核心功能¶
以下能力均来自 Skill 官方简介与 SkillHub 页面描述，可按环节理解其分工。
多格式文档解析¶
支持从以下扩展名的原始文件中读取内容：
.doc/.docx.pdf.xlsx
适用于不同单位、不同年代导出的检验记录，而不局限于单一模板。
字段映射与结构化¶
将文档中的非结构化或半结构化内容，映射到知识库表格所需字段。简介中明确包含 field mapping（字段映射），即 Agent 按 Skill 约定识别「该填哪一列、对应原文哪一段」。
AI 辅助分类¶
简介写明包含 AI-powered classification。在录入知识库前，对条目做分类或归类（例如按检查类型、问题性质等），便于后续在 Excel 中筛选与统计。具体分类维度以 Skill 内 SKILL.md 约定为准；安装后可在技能目录中查看完整说明。
写入 Excel 知识库¶
输出目标为 knowledge_base.xlsx。流程包含 Excel writing：把抽取、映射、分类后的结果写入该表格，形成可继续编辑、导入其他系统的结构化知识库。
触发词（何时应启用本 Skill）¶
官方建议在用户意图接近下列表述时启用本 Skill，便于 Agent 自动选中技能：
- 质量检验记录整理
- 知识库录入
- 检查记录转知识库
- 质量联检录入
- 质监站检查整理
- 整改回复提取
- 检验记录知识化
- 质量通病案例提取
安装与启用¶
SkillHub 给出的安装方式，是让 Agent 参照通用安装文档，并安装指定坐标技能。
1. 准备 SkillHub CLI（如尚未安装）¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（文档推荐方式）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装说明全文：https://skillhub.cn/install/skillhub.md
2. 安装本 Skill 到当前 Agent 的 skills 目录¶
SkillHub 强调：安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
对本 Skill，官方页面给出的安装提示为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_5c6938ae/1111-v2`。
对应 CLI 形式示例（将 <skills 目录> 换成你环境中的路径）：
skillhub install user_5c6938ae/1111-v2 --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档，供对照）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安装完成后，按你所用客户端要求重启或刷新 Agent，使新 Skill 生效。
3. Cursor / Claude Code / Codex 的差异¶
三者的差异主要体现在 skills 目录位置 与 是否在项目级 .agents/skills/ 安装，安装命令本身均为 skillhub install ... --dir <目录>。SkillHub 页面未单独列出各客户端的不同安装包；未在官方资料中出现的客户端专用步骤，本文不展开。
典型用法¶
官方未在展示页提供逐步截图或样例工程，可复现的用法如下。
- 将待整理的检验记录原件（
.doc/.docx/.pdf/.xlsx）放在 Agent 可访问的工作区或指明路径。 - 在对话中用自然语言说明目标，并尽量带上官方触发词，例如：「把这些质监站检查记录整理进知识库」「检查记录转知识库，输出到 knowledge_base.xlsx」。
- Agent 应加载
@user_5c6938ae/1111-v2，按 Skill 流程完成解析、字段映射、分类与写入。 - 核对生成的
knowledge_base.xlsx：列名、行数、关键字段是否与原件一致；必要时在 Excel 中做人工校对。
若需确认字段定义、表头结构或批处理约定，安装后请直接阅读技能包内的 SKILL.md（SkillHub 坐标：@user_5c6938ae/1111-v2）。
适用场景与注意¶
适合谁¶
- 施工单位、监理或项目管理部门，需要把历史联检、整改、通病案例从散落的 Office/PDF 文件汇总到一张知识库表。
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的 Agent，希望用对话驱动「录入」而不是纯手工复制粘贴。
- 知识管理分类为 knowledge-management，与检索、归档、案例库建设类需求一致。
使用注意¶
- 原件质量：扫描版 PDF、版式复杂的 Word 会影响解析效果；若 Skill 内对 OCR 或模板有要求，以
SKILL.md为准。 - 输出文件：默认目标文件名为
knowledge_base.xlsx；若工作区已有同名文件，操作前建议备份，避免覆盖未保存的编辑。 - 社区来源：发布来源为 community，版本 1.0.1；升级或行为变更请以 SkillHub 上该坐标页的版本信息为准。
- 统计信息：SkillHub 抓取资料显示评分为 100000、下载约 776 次、安装计数 1；页面数据会变动，以安装时 SkillHub 展示为准。
结尾¶
「知识点抽取工具」把建设工程质量检验记录从 .doc / .docx / .pdf / .xlsx 拉到统一的 knowledge_base.xlsx，覆盖解析、字段映射、AI 分类与 Excel 写入等环节，适合用触发词在 Agent 里一键发起「知识库录入」类任务。安装与优先源配置见 https://skillhub.cn/install/skillhub.md ，技能页见 https://www.skillhub.cn/skills/user_5c6938ae/1111-v2 。
