返回博客

安装智能体技能之前怎么检查:扫描标记能告诉你什么,不能告诉你什么

技能是一组指令,有时还带有会在你机器上运行的脚本。这篇文章讲怎样读技能的扫描标记、每个标记的含义,以及扫描替你做不了的检查。

SOSourceWeftNov 20, 20268 分钟阅读

最后更新: 2026-11-20

先说结论

没有任何扫描能告诉你一个技能无害。扫描能给你的是一份阅读清单:技能的哪些部分做了值得你在让智能体使用它之前看一眼的事。

把技能安装到本地智能体(比如 Claude Code、Codex 或 Cursor)之后,它的指令会引导你的智能体,它带的任何脚本都会以智能体的权限在你的机器上运行。所以该问的不是"它过关了吗",而是"它做的事和它声称的用途对得上吗"。

这篇文章讲怎样读 SourceWeft 技能页面上的扫描备注、每个标记的含义,用一个真实技能做示范,以及哪些检查仍然要你自己做。

技能能对你做什么

技能是一个带 SKILL.md 文件的文件夹,有时还有脚本、参考文件和资源文件。对风险有影响的有两点:

  • 指令由模型执行。 SKILL.md 里的文字可以让你的智能体读文件、运行命令,或者把数据发到别处。技能不需要脚本也能造成损害。
  • 脚本就是代码。 如果技能带脚本,而你把它安装到本地智能体,这些脚本可以在你的电脑上运行。

想了解寻找和安装技能的一般步骤,见去哪里找智能体技能以及怎样安装。这篇文章只讲"检查"这一步。

SourceWeft 的扫描做了什么

技能提交到 SourceWeft 目录时,自动扫描会读取技能包里的文件并比对特征。这是静态的特征扫描:不会运行技能。对于不能当文本读取的文件,它只问一个问题:这是不是可执行代码。

结果有三种:

  1. 拒收。 如果扫描发现的特征本身就是攻击,这次提交不会被存储,并且会告诉提交者原因。这样的特征有三种:下载远程代码并直接交给 shell 执行(curl | sh)、解码后运行编码过的命令(base64 … | sh),以及试图覆盖智能体指令的文字。
  2. 发布并附带备注。 描述技能"做了什么"、而不是说明它有恶意的标记,会被记录下来,并显示在技能页面的自动扫描备注(Automated scan notes)里。页面上写着:"Our automated scan flagged the following in this version. Flags are advisory — read the source before installing."(我们的自动扫描在此版本中发现了以下内容。标记仅供参考,安装前请阅读源码。)只带这类标记的技能会被发布并上架,不需要等人工处理。
  3. 等管理员处理。 带编译后二进制文件的技能,要等管理员处理后才会上架。扫描不认识的标记也会作为草稿等待。

第二种结果的意思是:标记是信息,不是裁决。很多正当的技能都会触发扫描能看到的行为。一个教你用某个 API 的技能,自然会提到凭据并发起网络请求。

因为带标记的技能可能在没有人逐个阅读的情况下上架,标记是给你看的。它告诉你该往哪里看。

各个标记,以及每个标记引出的问题

下面是技能页面上显示的标记文案。

页面上的标记发现了什么你要检查什么
Makes outbound network calls(发起出站网络请求)代码里引用了 HTTP 库或网络请求调用它连到哪里?SKILL.md 有没有说明原因?仅仅是一条 import 也可能触发这个标记。
Posts data to an external host(向外部主机发送数据)post(…) 调用、对某个 URL 的 fetch(…),或 curl -X POST它真的在发送数据吗?发送什么数据,发给谁?对 URL 的普通 fetch 也可能触发这个标记。这是最该仔细读的一条。
Reads environment variables(读取环境变量)脚本或指令读取环境变量读哪些变量?是它自己的设置,还是 API 密钥之类?
Reads credential files(读取凭据文件)读取类似凭据的文件的特征读哪些文件?技能的任务真的需要吗?
Reads another skill's files(读取其他技能的文件)指向另一个技能文件夹的路径为什么这个技能要依赖另一个?
Requests code-execution tools(请求代码执行工具)技能请求使用代码执行类工具具体是哪些命令,有没有限制?
Mentions the system prompt(提到系统提示词)文字里提到系统提示词只是说明文字,还是要求改变行为的指令?
Ships scripts its instructions never mention(带有指令里从未提到的脚本)SKILL.md 没有描述的脚本逐个读脚本,指令不会告诉你它们做什么。
A script reaches files outside the skill(脚本访问技能之外的文件)脚本使用技能文件夹之外的路径是哪些路径?缓存目录和你主目录里的内容不是一回事。
Ships an executable binary(带有可执行二进制文件)编译后或不透明的文件你读不了它。只有信任发布者时才安装。

命中这三种被拒收特征的新提交不会被存储,所以新上架的技能上不会出现这些标记。在这项检查出现之前就已加入的版本不在这句话的保证范围内,所以安装的东西仍然要自己读。

用一个真实技能做示范

技能 gke-kueue-troubleshooting 已发布在目录中,带三个标记。我们用已发布的 CLI(0.3.0 版)把它安装到一个空文件夹里,并读了它的脚本。这能展示标记在实际中是什么样子。技能上有标记,并不是对它作者的评价。

在技能页面的自动扫描备注里,我们查看的那个版本列出:

  • Makes outbound network calls
  • A script reaches files outside the skill
  • Reads environment variables

运行 npx @sourceweft/cli skills info @google/gke-kueue-troubleshooting,会用标识符显示同样的标记:

Scripts:    yes — this skill includes executable files
Scan flags: egress:fetch, script:out-of-bundle-path, secrets:env-access

我们读那个 commit 里的脚本时看到:

  • 出站网络请求: kueue_schema.py 会从 kueue.sigs.k8s.io 和 GitHub 的发布页下载文档和发布文件。目的地是一个项目文档站,并且可以用环境变量关闭这个行为。
  • 环境变量: 脚本读取的是技能自己的设置变量,比如缓存目录,以及一个关闭远程下载的开关。它还会读取标准的 XDG_CACHE_HOME 来确定缓存位置。
  • 技能之外的文件: 脚本把缓存写到每个用户各自的目录 ~/.cache/gke-kueue-troubleshooting,按它的代码注释所说,是有意"绝不放在技能目录里"。

每个标记都有具体的解释,每一条都用不了多久就能核对。标记的用处就在这里:它告诉你该读哪几行。换一个技能,同样的三个标记背后可能是更糟的解释,你只有读了才知道。

五分钟就能跑完的检查清单

  1. 看信任标签。 CLI 会打印四种之一。"Verified"表示 SourceWeft 管理员审核过。"Featured"表示是特色发布者,没有经过管理员审核。"Featured, Verified"表示是特色发布者,并且管理员也审核过。"Community"表示没有经过 SourceWeft 审核。"Featured"和"Community"这两种情况下,没有 SourceWeft 管理员审核过这个技能,所以审核要靠你自己。
  2. 安装前先运行 skills info。 它会打印来源仓库、确切的 commit、许可证、是否带脚本,以及扫描标记。
  3. 读 SKILL.md。 看它的指令是不是你自己也会给智能体的指令。
  4. 有脚本就读脚本。 先读和标记对应的那些。搜一搜主机名和环境变量名。
  5. 核对来源。 仓库是不是来自你预期的发布者?commit 是不是你看过的那个?
  6. 先用项目范围安装。 --scope project 会安装到当前项目,而不是你的主目录,这样还在评估的技能不会对所有项目生效。

扫描做不到的事

  • 它不运行技能。 它只比对文本里的特征。运行时才拼出命令的脚本可以绕开特征。
  • 它比对的是文本,包括文档。 SKILL.md 或参考文件里出现 .env、process.env 或"system prompt"这样的字样,即使什么都没有被读取或运行,也可能触发标记。有些标记只是文档里的一句话造成的;先打开对应的文件和行再下判断。
  • 它读不了二进制文件。 它只能说某个文件看起来是代码。
  • 它不了解你的环境。 读环境变量的技能,在一种环境里没问题,在另一种环境里可能就是问题。
  • 它不审查发布者。 它读的是文件,不是人。
  • 扫描干净不是保证。 它只表示扫描在它检查的特征里没有发现东西。

如果一个技能对你很重要,就去读它。扫描的作用是让你读得更快。

常见问题

智能体技能可以放心安装吗? 技能是第三方的指令,有些还带脚本。它适不适合你,取决于它做什么。读 SKILL.md 和脚本,用扫描备注决定先看哪里。

技能页面上的"Automated scan notes"是什么意思? 它列出自动特征扫描在这个版本的技能里发现了什么,比如某个脚本会发起网络请求。页面写明这些标记仅供参考,所以安装前要读源码。

有标记就说明技能有恶意吗? 不是。标记描述的是行为,很多正当的技能都会触发。对新提交来说,表明攻击本身的特征在提交时就会被拒收,不会存储。

没有标记的技能就没有风险吗? 不是。扫描检查的是文本里一组固定的特征,它判断不了技能的指令是否适合你。

目录里的技能有人审核吗? 只有标为"Verified"的技能经过 SourceWeft 管理员审核。其他技能由自动扫描处理,没有人工审核。

安装前能看到这些标记吗? 能。技能页面的"Automated scan notes"里有,npx @sourceweft/cli skills info <技能名> 也会在安装前输出这些信息。

相关文章

可分享链接

继续阅读

相关文章

全部文章

在 Claude Code 里安装技能和 MCP 服务器:从空文件夹开始的教程

从空文件夹开始,给 Claude Code 安装一个技能和一个 MCP 服务器:搜索、安装前先看详情、配置文件放在哪里,以及怎样检查和移除。所有命令都是实际运行的结果。

继续阅读

Claude 技能是什么?怎样找、怎样安装

用白话说明 Claude 技能(智能体技能)是什么、技能文件夹里有什么、去哪里找,以及两种安装方法:用命令安装,或手动复制文件夹。包含安装前要检查的事项。

继续阅读

什么是智能体技能目录?按类别浏览 26,423 个技能

智能体技能目录是什么,一个好的收录条目在你安装之前应该展示什么,以及怎样通过搜索、CLI 和每个技能的安装指南,在 15 个类别里浏览 26,423 个技能。数字读取于 2026 年 11 月 21 日。

继续阅读