前言¶
园区、社区和单位的控烟管理，往往依赖人工巡查或事后调阅录像。摄像头已经覆盖重点区域，但要把「有人吸烟」从海量画面里筛出来，仍然费时，也难做到持续盯守。若希望 Agent 在运维与安全类任务里，能按统一技能说明去对接「吸烟行为检测」能力，而不是每次手写提示词拼凑流程，可以把 SkillHub 上的社区技能 @user_bb47e3e3/smoking-detection-analysis 装进当前 Agent 的 skills 目录。下面介绍该技能是什么、能做什么，以及如何安装启用。
这是什么¶
Intelligent Public Smoking Detection Skill | 公共场所吸烟行为智能检测技能 是 SkillHub 上由发布者 user_bb47e3e3 提供的社区技能（community），当前版本 1.0.5，分类为 it-ops-security。官方页面坐标为 @user_bb47e3e3/smoking-detection-analysis。
一句话定位：基于计算机视觉，在目标区域内自动检测吸烟行为；支持对视频流、图片、视频文件做实时检测，识别违规吸烟并触发违规预警，用于园区、社区、单位的控烟安全管理。
标签显示 requires_api_key=false，表示按 SkillHub 元数据，该技能不强制要求单独配置 API Key（具体运行仍取决于技能包内说明与后端推理服务部署方式）。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面单独展开接口文档的部分不臆测：
- 目标区域吸烟行为检测：在划定区域内识别吸烟相关行为。
- 多输入形态：支持视频流、静态图片、视频文件。
- 实时检测：面向需要持续接入画面的场景（如监控流）。
- 违规识别与预警：识别违规吸烟行为并触发违规预警，便于接入控烟安全管理流程。
安装与启用¶
SkillHub 建议 Agent 按通用安装文档操作，并对本技能使用完整坐标安装。
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
安装说明全文见：https://skillhub.cn/install/skillhub.md
2、安装到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；否则默认会装到 ./skills/，Agent 可能无法加载。
skillhub install user_bb47e3e3/smoking-detection-analysis --dir <skills 目录>
也可在对话中让 AI 按同一文档安装坐标 @user_bb47e3e3/smoking-detection-analysis。
常见客户端 skills 路径（以 SkillHub 文档为准）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安装后按你所用 Agent 的要求重启或刷新技能列表，使 SKILL.md 被加载。
典型用法¶
公开页面未附带可复制的推理 API 示例或配置字段表，典型用法应围绕「安装技能 → 在对话中按技能说明发起检测任务」：
- 完成上一节的
skillhub install，确认技能出现在 Agent 可用技能列表中。 - 在任务中明确输入类型（视频流 URL、图片路径、视频文件路径）与需要关注的区域或场景（园区出入口、禁烟标识区域等），让 Agent 按技能包内的
SKILL.md流程调用检测与预警逻辑。 - 将「违规预警」对接到你现有的告警或工单系统时，以技能包内约定的输出格式为准；官方简介仅说明会触发违规预警，未在抓取页面列出具体 webhook 或字段名。
搜索技能时可使用：
skillhub search smoking-detection
适用场景与注意¶
适合谁
- 负责 IT 运维与安全（
it-ops-security）的同事，需要在 Agent 工作流里标准化「控烟视觉检测」能力。 - 管理园区、社区、单位禁烟区，已有监控或录像输入，希望减少纯人工盯屏的场景。
使用注意
- 技能来源为 community，接入前建议在测试环境验证准确率、误报率与延迟，再用于正式告警。
- 计算机视觉检测效果受光照、遮挡、摄像头角度与模型训练域影响；官方简介未提供 benchmark，不宜自行假设指标。
- SkillHub 页面统计（以 2026-10-22 抓取为准）：评分 100000，下载 635，安装 0；与页面展示一致即可，勿混用未核实数字。
- 控烟与个人信息处理需符合当地法规；视频分析涉及隐私时，应做权限与留存策略评审。
结尾¶
Intelligent Public Smoking Detection Skill 把「公共场所吸烟行为检测、多源视频/图像输入、违规预警」收敛为可安装的 Agent 技能，便于在 Cursor、Claude Code、Codex 等环境中复用同一套说明，而不是每次临时描述检测流程。
- SkillHub 技能页：https://www.skillhub.cn/skills/user_bb47e3e3/smoking-detection-analysis
- 官方 API 入口（SkillHub 坐标页）：https://api.skillhub.cn/user_bb47e3e3/smoking-detection-analysis
- 安装文档：https://skillhub.cn/install/skillhub.md
