最后更新: 2026-11-20
先说结论
没有任何扫描能告诉你一个技能无害。扫描能给你的是一份阅读清单:技能的哪些部分做了值得你在让智能体使用它之前看一眼的事。
把技能安装到本地智能体(比如 Claude Code、Codex 或 Cursor)之后,它的指令会引导你的智能体,它带的任何脚本都会以智能体的权限在你的机器上运行。所以该问的不是"它过关了吗",而是"它做的事和它声称的用途对得上吗"。
这篇文章讲怎样读 SourceWeft 技能页面上的扫描备注、每个标记的含义,用一个真实技能做示范,以及哪些检查仍然要你自己做。
技能能对你做什么
技能是一个带 SKILL.md 文件的文件夹,有时还有脚本、参考文件和资源文件。对风险有影响的有两点:
- 指令由模型执行。
SKILL.md里的文字可以让你的智能体读文件、运行命令,或者把数据发到别处。技能不需要脚本也能造成损害。 - 脚本就是代码。 如果技能带脚本,而你把它安装到本地智能体,这些脚本可以在你的电脑上运行。
想了解寻找和安装技能的一般步骤,见去哪里找智能体技能以及怎样安装。这篇文章只讲"检查"这一步。
SourceWeft 的扫描做了什么
技能提交到 SourceWeft 目录时,自动扫描会读取技能包里的文件并比对特征。这是静态的特征扫描:不会运行技能。对于不能当文本读取的文件,它只问一个问题:这是不是可执行代码。
结果有三种:
- 拒收。 如果扫描发现的特征本身就是攻击,这次提交不会被存储,并且会告诉提交者原因。这样的特征有三种:下载远程代码并直接交给 shell 执行(
curl | sh)、解码后运行编码过的命令(base64 … | sh),以及试图覆盖智能体指令的文字。 - 发布并附带备注。 描述技能"做了什么"、而不是说明它有恶意的标记,会被记录下来,并显示在技能页面的自动扫描备注(Automated scan notes)里。页面上写着:"Our automated scan flagged the following in this version. Flags are advisory — read the source before installing."(我们的自动扫描在此版本中发现了以下内容。标记仅供参考,安装前请阅读源码。)只带这类标记的技能会被发布并上架,不需要等人工处理。
- 等管理员处理。 带编译后二进制文件的技能,要等管理员处理后才会上架。扫描不认识的标记也会作为草稿等待。
第二种结果的意思是:标记是信息,不是裁决。很多正当的技能都会触发扫描能看到的行为。一个教你用某个 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,按它的代码注释所说,是有意"绝不放在技能目录里"。
每个标记都有具体的解释,每一条都用不了多久就能核对。标记的用处就在这里:它告诉你该读哪几行。换一个技能,同样的三个标记背后可能是更糟的解释,你只有读了才知道。
五分钟就能跑完的检查清单
- 看信任标签。 CLI 会打印四种之一。"Verified"表示 SourceWeft 管理员审核过。"Featured"表示是特色发布者,没有经过管理员审核。"Featured, Verified"表示是特色发布者,并且管理员也审核过。"Community"表示没有经过 SourceWeft 审核。"Featured"和"Community"这两种情况下,没有 SourceWeft 管理员审核过这个技能,所以审核要靠你自己。
- 安装前先运行
skills info。 它会打印来源仓库、确切的 commit、许可证、是否带脚本,以及扫描标记。 - 读
SKILL.md。 看它的指令是不是你自己也会给智能体的指令。 - 有脚本就读脚本。 先读和标记对应的那些。搜一搜主机名和环境变量名。
- 核对来源。 仓库是不是来自你预期的发布者?commit 是不是你看过的那个?
- 先用项目范围安装。
--scope project会安装到当前项目,而不是你的主目录,这样还在评估的技能不会对所有项目生效。
扫描做不到的事
- 它不运行技能。 它只比对文本里的特征。运行时才拼出命令的脚本可以绕开特征。
- 它比对的是文本,包括文档。
SKILL.md或参考文件里出现.env、process.env或"system prompt"这样的字样,即使什么都没有被读取或运行,也可能触发标记。有些标记只是文档里的一句话造成的;先打开对应的文件和行再下判断。 - 它读不了二进制文件。 它只能说某个文件看起来是代码。
- 它不了解你的环境。 读环境变量的技能,在一种环境里没问题,在另一种环境里可能就是问题。
- 它不审查发布者。 它读的是文件,不是人。
- 扫描干净不是保证。 它只表示扫描在它检查的特征里没有发现东西。
如果一个技能对你很重要,就去读它。扫描的作用是让你读得更快。
常见问题
智能体技能可以放心安装吗?
技能是第三方的指令,有些还带脚本。它适不适合你,取决于它做什么。读 SKILL.md 和脚本,用扫描备注决定先看哪里。
技能页面上的"Automated scan notes"是什么意思? 它列出自动特征扫描在这个版本的技能里发现了什么,比如某个脚本会发起网络请求。页面写明这些标记仅供参考,所以安装前要读源码。
有标记就说明技能有恶意吗? 不是。标记描述的是行为,很多正当的技能都会触发。对新提交来说,表明攻击本身的特征在提交时就会被拒收,不会存储。
没有标记的技能就没有风险吗? 不是。扫描检查的是文本里一组固定的特征,它判断不了技能的指令是否适合你。
目录里的技能有人审核吗? 只有标为"Verified"的技能经过 SourceWeft 管理员审核。其他技能由自动扫描处理,没有人工审核。
安装前能看到这些标记吗?
能。技能页面的"Automated scan notes"里有,npx @sourceweft/cli skills info <技能名> 也会在安装前输出这些信息。