返回部落格

安裝代理程式技能之前怎麼檢查:掃描標記能告訴你什麼,不能告訴你什麼

技能是一組指令,有時還帶有會在你機器上執行的腳本。這篇文章講怎樣讀技能的掃描標記、每個標記的含義,以及掃描替你做不了的檢查。

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 教學:用一行指令安裝 skills 與 MCP(從零到能用)

從空資料夾開始,一步一步在 Claude Code 裡安裝技能(skills)與 MCP 伺服器:搜尋、安裝前先看詳情、設定檔寫在哪裡、怎麼確認裝好了。所有指令都是實際執行過的結果。

繼續閱讀

Claude skills(技能)是什麼?怎麼找、怎麼安裝

用白話說明 Claude skills(agent skills)是什麼、一個技能資料夾長什麼樣子、去哪裡找,以及兩種安裝方法:用指令安裝,或手動複製資料夾。附上安裝前要先看的幾件事。

繼續閱讀

什麼是代理程式技能目錄?按類別瀏覽 26,423 個技能

代理程式技能目錄是什麼,一個好的收錄條目在你安裝之前應該展示什麼,以及怎樣透過搜尋、CLI 和每個技能的安裝指南,在 15 個類別裡瀏覽 26,423 個技能。數字讀取於 2026 年 11 月 21 日。

繼續閱讀