前言¶
现场检查往往留下大量照片和零散文字：问题点位、整改要求、时间地点混在聊天记录或笔记里。事后要交给业主、监理或归档时，常见做法是手工拼 Word、套表格或逐页贴图，版式难统一，改一版就要重排。若希望输出可在浏览器直接打开的网页报告，又要把图片与条目对应清楚，单靠通用对话容易漏字段、结构也不稳定。
下面介绍 SkillHub 上的「现场检查报告辅助技能」（@engicool/site-inspection-report）。它在 Agent 侧按 SKILL 规范工作，目标是把检查过程中的图片和文字记录整理成图文并茂、结构化的 HTML 报告。
这是什么¶
一句话定位：在 Agent 中启用后，根据你提供的现场检查图文材料，生成可浏览的 HTML 现场检查报告。
出品与维护：SkillHub 分类为 office-efficiency，来源标注为 enterprise，发布者为「工程客」。当前页面版本为 v1.0.1，坐标 @engicool/site-inspection-report。标签标明 requires_api_key=false，即按商店说明无需额外配置 API Key。
解决的问题：官方简介写明——「生成图文并茂的现场检查网页报告；当用户需要将检查过程中的图片和文字记录整理成结构化 HTML 报告时使用」。
核心功能¶
依据 SkillHub 与 API 资料，可核实的能力如下：
- HTML 报告输出：产出结构化 HTML，便于在浏览器中查看与转发，而不是仅返回一段无版式的纯文本。
- 图文结合：面向检查场景中「图 + 文」并存的记录方式，将图片与文字说明组织进同一套报告结构（具体章节模板以安装后的
SKILL.md为准）。 - 办公效率类技能：归类在
office-efficiency，面向巡检、验收、安监等需要留痕、汇报的日常工作流。
商店侧统计（以已抓取资料为准）：评分 100000，下载 860，安装计数 0——安装数会随环境变化，以你本地是否成功装入 Agent 的 skills 目录为准。
安装与启用¶
SkillHub 技能页要求参照官方安装文档安装本技能。通用流程分三步：确认 CLI、安装到当前 Agent 的 skills 目录、重启或刷新 Agent 使技能生效。
1. 检查 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：
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
2. 安装本技能¶
安装时必须用 --dir 指向当前使用的 Agent skills 目录；默认装到 ./skills/ 时，多数客户端不会自动加载。
skillhub install @engicool/site-inspection-report --dir <你的 skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
将 <你的 skills 目录> 换成上表中与你环境对应的路径即可。Codex 若使用项目级目录，改为项目内的 .agents/skills/。
3. 启用¶
安装完成后，在 Cursor、Claude Code、Codex 等支持 Skills 的客户端中，按各自方式让 Agent 加载 skills 目录中的技能（通常需重启或新开会话）。本技能无需 API Key，一般不必额外配置文件。
典型用法¶
公开页面未提供逐字示例对话，用法可与官方简介对齐，按可复现思路操作：
- 准备材料：检查现场照片（路径或已放入工作区的文件）、文字记录（问题描述、位置、责任单位、整改期限等你在检查单里会写的字段）。
- 在 Agent 中说明意图：例如明确要求「使用现场检查报告相关技能，将以下图文整理成结构化 HTML 现场检查报告」，并附上图片与文字。
- 审阅与导出：Agent 按技能指引生成 HTML；你在浏览器中打开生成的文件，核对图文对应与章节结构，再交付或归档。
具体章节命名、必填项、样式约定以安装包内 SKILL.md 为准；若生成结果与现场模板不一致，可在同一会话中补充字段要求或参考 SKILL.md 调整提示。
适用场景与注意¶
适合谁
- 工程、物业、安监、环保等需要现场留痕并要网页形态报告的一线或内业人员。
- 已在 Cursor、Claude Code、Codex 等环境使用 Skills，希望减少手工排版时间的团队。
限制与注意
- 输出质量依赖你提供的图片清晰度与文字完整性；模糊照片或缺少关键字段时，报告只能作结构整理，不能替代实地复核。
- 安装路径错误是常见坑：务必
skillhub install ... --dir指向当前 Agent 的 skills 目录。 - 版本以 SkillHub 页面为准（当前 v1.0.1）；升级可用
skillhub的更新能力（参见 SkillHub 安装文档）。
结尾¶
「现场检查报告辅助技能」把检查过程中的图片和文字收敛为结构化 HTML 网页报告，适合需要图文并茂、便于浏览器查看的交付场景。无需 API Key，通过 SkillHub 安装到对应 Agent 的 skills 目录即可使用。
- SkillHub 技能页：https://www.skillhub.cn/skills/engicool/site-inspection-report
- API 条目：https://api.skillhub.cn/engicool/site-inspection-report
- 安装说明：https://skillhub.cn/install/skillhub.md
