前言¶
研发机上同时装着 Cursor、Claude Code、WorkBuddy、QoderWork 等 AI 助手时,配置目录分散、权限与行为难以统一审计,安全团队往往只能靠人工抽查或零散脚本。下面介绍 SkillHub 上的 AI智能体安全扫描工具(@user_239f6ce2/agent-security-scanner-huyiwanghe):在本机自动发现已安装的智能体,按多层规则做覆盖扫描,并生成可离线查看的 HTML 报告与 JSON 告警数据,也支持在同一台机器上安排周期性扫描。
这是什么¶
这是一款面向企业研发终端的 AI 智能体安全可视化检测 Skill,由社区发布者 user_239f6ce2 维护,当前版本 6.3.8,分类为 it-ops-security,SkillHub 标注 requires_api_key=false(不依赖额外 API Key)。
定位可以概括为:自动发现本机各类 AI 编程与智能助手,对配置、行为与运行框架做多层安全扫描,输出 HTML 可视化报告与告警明细,帮助看清单台研发机器上的 AI 风险面。
核心功能¶
以下能力来自 Skill 官方简介与 SkillHub 页面说明,安装后通过自然语言触发(见下文「典型用法」)由 Agent 调用 Skill 完成。
多智能体发现与适配
- 自动发现本机已安装的智能体;内置 50+ 智能体定义,并支持对未知智能体数据目录的通用自动发现。
- 官方列举的可扫描类型包括 WorkBuddy、MiniMax Code、QoderWork、QCLAW、Claude、Cursor 等(以 Skill 内置定义与实际本机安装为准)。
多层规则扫描
- 41 条加密规则,覆盖 L1 文件、L2 行为、L3 框架 层。
- 14 条传感器规则,覆盖 L4 运行时、L5 篡改、L6 供应链 层。
- 支持多智能体自动发现后的全量扫描,而非只针对单一产品目录。
报告与告警输出
- 生成自包含的 HTML 安全报告,便于阅读与归档。
- 同步产出 JSON 告警数据,便于对接后续处理或留存。
单机授权与定时扫描
- 内置单机 License 认证(面向单台机器使用场景)。
- 支持在同一台机器上配置 周期性 安全扫描(具体调度方式以 Skill 内说明与 Agent 执行为准)。
安装与启用¶
Skill 基于通用 SKILL.md 格式,通过 SkillHub 安装到当前 Agent 的 skills 目录后才会被识别。
方式一:让 AI 按官方提示安装
将 SkillHub 页面给出的提示词发给当前 AI 客户端即可,核心是引用安装文档并指定坐标:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_239f6ce2/agent-security-scanner-huyiwanghe`。
方式二:使用 SkillHub CLI
先确认是否已安装 CLI:
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装或仅 CLI(文档地址:https://skillhub.cn/install/skillhub.md)。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能无法被客户端加载。
skillhub install @user_239f6ce2/agent-security-scanner-huyiwanghe --dir <skills 目录>
常见客户端 skills 路径示例(以 SkillHub 安装文档为准):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/ - QoderWork:
~/.qoderwork/skills/ - workbuddy:
~/.workbuddy/skills/
安装后若客户端未立即加载新 Skill,按所用产品的说明重启或刷新 skills 目录。
典型用法¶
在已启用该 Skill 的 Agent 中,用与能力相关的自然语言即可触发扫描或查看结果。官方给出的触发方向包括:
- 中文:安全扫描、扫描智能体、安全检测、多智能体扫描、定时安全扫描、查看安全报告、查看告警
- 英文:agent security scan
可复现的表述示例(语义需与上述触发词一致,由 Agent 调用 Skill 执行):
- 对本机已安装的 AI 智能体做一次安全扫描,并生成 HTML 报告。
- 扫描智能体安全风险,输出告警报告(HTML + JSON)。
- 在本机配置定时安全扫描(周期性 agent security scan)。
经过上面的步骤,产物应为自包含 HTML 报告及 JSON 告警明细;具体路径与文件名以 Skill 执行结果为准。
适用场景与注意¶
适合谁
- 需要在研发终端上统一摸清「装了哪些 AI 助手、风险点在哪」的安全或研发效能团队。
- 希望在单机维度留存可读的 HTML 报告,并保留 JSON 告警以便后续处理的场景。
使用注意
- 扫描对象为本机已安装智能体及其数据目录,效果取决于本机实际安装产品与 Skill 内置/自动发现能力。
- 规则集为加密规则与传感器规则的组合,细节以 Skill 版本 6.3.8 为准;升级 Skill 后规则与报告格式可能变化,建议在变更后重新跑一轮基线扫描。
- 单机 License 与定时扫描均针对单台机器场景,分布式或多机统一纳管需自行规划报告汇总方式。
- SkillHub 页面数据(截至资料抓取):社区来源、评分 100000、下载 967 次;安装与运行环境需满足 Skill 对本地文件与运行时的访问要求。
结尾¶
AI智能体安全扫描工具把「多产品、多目录」的本机 AI 助手风险收成一份 HTML 报告和 JSON 告警,并支持周期性扫描,适合作为研发终端上的第一道可视化自检手段。
官方 Skill 地址:https://api.skillhub.cn/user_239f6ce2/agent-security-scanner-huyiwanghe
SkillHub 展示页:https://www.skillhub.cn/skills/user_239f6ce2/agent-security-scanner-huyiwanghe