前言¶
要在对话或自动化流程里判断人物的真实情绪，常见做法是自建视觉模型、接第三方情绪 API，再在业务代码里拼请求与报告格式。对已经用 Cursor、Claude Code 等带 Skills 能力的客户端的开发者，更省事的路径是把「微表情识别 + 情绪报告」封装成 Skill，由 Agent 按技能说明调用。
下面介绍 SkillHub 上的 Micro-Expression Recognition & Analysis Tool | 微观情绪识别分析工具（坐标 @user_bb47e3e3/emotion-analysis，当前版本 1.0.6）：它面向人物面部微表情做细致分析与识别，并输出情绪状态分析报告。
这是什么¶
一句话定位：面向 面部微表情 的识别与分析 Skill，用于生成 情绪状态分析报告，帮助从细微面部线索推断内心情绪活动。
- 出品与维护：社区来源（
community），发布者为user_bb47e3e3。 - 分类：
ai-agent。 - 平台：通过 SkillHub 技能页 分发；官方条目地址为 https://api.skillhub.cn/user_bb47e3e3/emotion-analysis。
官方中英文简介一致强调：对面部微表情进行细致分析识别，输出精准的情绪状态分析报告，揭示真实内心情绪活动。
核心功能¶
以下能力均来自 SkillHub 公开简介与元数据，不展开未在资料中出现的接口或模型名称。
- 微表情识别与分析：针对人物面部微表情做细致分析。
- 情绪状态报告：输出结构化的情绪状态分析报告（具体字段与格式以安装后的技能包说明为准）。
- Agent 集成形态：作为 Skill 供支持 Skills 的 AI 客户端加载，由 Agent 在对话中按技能指引完成分析任务。
技能标签标明 requires_api_key=true，使用前需要准备相应 API Key；公开页面未列出密钥环境变量名或配置文件路径，安装后应以技能包内文档为准。
安装与启用¶
SkillHub 推荐先让 Agent 按通用安装文档操作，再安装本技能坐标。
1. 安装 SkillHub CLI（若尚未安装）¶
检查是否已安装：
command -v skillhub && skillhub --version
未安装时可执行完整安装（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. 安装本技能¶
官方技能页给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_bb47e3e3/emotion-analysis。
在终端中，需将技能安装到当前 Agent 的 skills 目录（--dir 必填，否则默认落在 ./skills/ 可能无法被客户端识别）。常用路径示例：
| 客户端 | Skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令形式（将 <skills 目录> 替换为实际路径）：
skillhub install user_bb47e3e3/emotion-analysis --dir <skills 目录>
也可直接向 Agent 发送官方同款提示词：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_bb47e3e3/emotion-analysis`。
安装完成后，按所用客户端要求重启或刷新 Skills 列表。因标签要求 API Key，请在技能包说明或发布者文档中完成密钥配置后再做分析请求。
典型用法¶
公开 SkillHub 页面未提供独立的脚本示例或 HTTP 调用样例；标准路径是完成安装与 API Key 配置后，在 Agent 对话中启用该 Skill，并按技能包内 SKILL.md（及同目录附属说明）描述的方式提交待分析的人脸图像或相关素材，由 Agent 调用后端能力并返回情绪状态分析报告。
若 skillhub install 因网络或索引原因失败，可先通过技能页确认坐标与版本（当前 v1.0.6），再重试安装或改用页面提示的 Agent 安装流程。
适用场景与注意¶
适合谁
- 需要在 Agent 工作流里做面试辅助、客服质检、内容审核等场景的情绪线索分析，且希望把「微表情 + 报告」收敛到一个 Skill 的团队或个人开发者。
- 已使用 SkillHub / 支持 Skills 的客户端，希望减少自研视觉管线的工作量。
限制与注意
- API Key：
requires_api_key=true，未配置密钥时无法正常使用；具体申请方式与计费以技能包及发布者说明为准。 - 社区技能：来源为
community，集成前建议自行评估合规、隐私（人脸数据）与准确率要求。 - 公开统计（SkillHub 抓取数据）：评分 100000，下载 752，安装 2；数据会随平台更新变化。
- 能力边界：简介聚焦微表情与情绪报告，未在官方资料中承诺实时视频流、多人脸批量等能力，勿默认具备。
结尾¶
微观情绪识别分析工具把面部微表情分析与情绪状态报告封装为 SkillHub 上的 @user_bb47e3e3/emotion-analysis，适合在 Agent 场景里做「察言观色」类任务；安装走 skillhub.cn 安装文档，并记得处理 API Key。
