前言¶
現場檢查往往留下大量照片和零散文字：問題點位、整改要求、時間地點混在聊天記錄或筆記裏。事後要交給業主、監理或歸檔時，常見做法是手工拼 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
