前言¶
要在 Agent 裏做中醫面診，常見做法是手寫 HTTP 客戶端、自己解析返回 JSON，再把字段說明寫進系統提示。視頻還要區分本地上傳和網絡地址，接口約定一旦變動，對話裏的調用方式也要跟着改。
下面介紹 SkillHub 上的 TCM Facial Diagnosis Analysis Tool | 中醫面診分析工具（座標 @user_bb47e3e3/face-analysis）。它把「上傳本地 MP4 或提交網絡視頻 URL → 調用服務端面部診斷 API → 得到結構化中醫面診結果」收斂成一套 Agent Skill，由社區發佈者 user_bb47e3e3 維護，當前版本 1.0.7，分類爲 professional，來源爲 community。頁面標註 requires_api_key=false，表示按 SkillHub 說明安裝後，不依賴額外 API Key 配置即可走既定流程（具體以技能包內說明爲準）。
這是什麼¶
一句話定位：面向 Agent 的中醫面診分析 Skill，通過服務端 API 處理面部視頻，並返回結構化的中醫面診結果。
維護與分發：在 SkillHub 技能頁 發佈；技能元數據地址爲 https://api.skillhub.cn/user_bb47e3e3/face-analysis。
解決的問題：讓編碼助手或對話 Agent 在對話中穩定地完成面診相關調用，而不必每次從零拼裝請求與結果說明。
核心功能¶
以下能力均來自 SkillHub 頁面與已抓取元數據，未在資料中出現的細節不展開。
- 本地 MP4 視頻：支持上傳本地 MP4，由服務端完成面部診斷分析。
- 網絡視頻 URL：支持傳入網絡視頻地址，同樣走服務端 API。
- 結構化面診結果：返回內容爲結構化的中醫面診結果（具體字段以安裝後的
SKILL.md及技能包內文檔爲準）。 - 無需 API Key 標籤：Skill 標籤爲
requires_api_key=false，與「需自行申請第三方 Key」類技能區分開。
安裝與啓用¶
SkillHub 官方推薦兩種方式：用 CLI 安裝，或把安裝提示詞發給當前 AI 讓其按通用安裝文檔操作。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 skillhub：
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、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。文檔中給出的常見路徑如下：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
以 Cursor 爲例，安裝命令爲：
skillhub install @user_bb47e3e3/face-analysis --dir ~/.cursor/skills/
3、通過對話讓 AI 安裝¶
SkillHub 頁面提供的提示詞爲：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_bb47e3e3/face-analysis`。
將上述內容發給支持 Skill 的 Agent 即可；Agent 會按安裝文檔選擇對應目錄並完成安裝。安裝後若 Agent 需要重啓或重新加載技能，按其產品說明操作。
典型用法¶
公開頁面未附帶獨立 REST 示例；用法應遵循技能包內的 SKILL.md（通用 Agent Skill 格式）。在資料可覈實的範圍內，可按下面思路在對話中復現：
- 確認
@user_bb47e3e3/face-analysis已安裝到當前 Agent 的 skills 目錄。 - 向 Agent 說明要進行中醫面診分析，並提供 本地 MP4 路徑 或 可訪問的視頻 URL。
- 由 Agent 按 Skill 指引調用服務端 API，並將返回的 結構化中醫面診結果 整理成可讀說明或下游 JSON。
示例提示（示意，不含未公開的接口參數）：
使用已安裝的 face-analysis 技能，對本地文件 /path/to/face.mp4 做中醫面診分析，把結構化結果用條目列出來。
或：
用這個技能分析網絡視頻 https://example.com/demo.mp4 的面診結果。
經過上面的步驟，核心輸入始終是 MP4 文件或視頻 URL，輸出爲結構化面診結果；具體請求字段與響應結構以技能包文檔爲準。
適用場景與注意¶
適合誰
- 在中醫、康養、健康諮詢類 Agent 產品中，需要把「看臉/看面色」類能力接到對話裏，又不想自建整套面診後端對接的團隊。
- 已有 MP4 採集或遠程視頻鏈接，希望快速驗證「視頻 → 結構化面診文案/數據」鏈路的開發者。
限制與注意
- 輸入格式以簡介爲準：MP4 與 網絡視頻 URL；其他容器或格式是否支持，需查看技能包說明或實測。
- 診斷在 服務端 API 完成，網絡延遲、視頻清晰度、人臉是否正對鏡頭會影響可用性；頁面未給出 SLA，生產環境需自行評估。
- 面診結果僅供輔助參考，不能替代執業醫師診斷；對外產品需做合規與免責聲明。
- SkillHub 統計（抓取時）：評分 100000，下載 811，安裝 8；數據會隨時間變化，以 技能頁 爲準。
- 升級版本時可用
skillhub對同一座標執行更新，並再次指定--dir爲當前 Agent 的 skills 目錄。
結尾¶
TCM Facial Diagnosis Analysis Tool | 中醫面診分析工具 把 MP4 與視頻 URL 兩種輸入統一成 Agent 可調用的面診流程，並強調結構化中醫面診輸出；配合 SkillHub 安裝方式，可在 Cursor、Claude Code、Codex 等環境中按各自 skills 目錄落地。
官方與索引地址：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_bb47e3e3/face-analysis
- 技能 API 元數據：https://api.skillhub.cn/user_bb47e3e3/face-analysis
- 安裝說明：https://skillhub.cn/install/skillhub.md
