前言¶
要在 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
