Communitygithub.com

coroboros/skillward

在安裝前拆解代理技能——完整確定性掃描器組合,融合成一個離線判決。

skillward 是什麼?

skillward 是一款針對 AI 代理技能的完整離線掃描工具,能夠對單一資料夾、技能目錄或遠端 HTTPS Git URL 進行全面安全性與合規性檢查。它整合了多個確定性掃描器,將結果融合為單一判決報告,避免手動驗證可能遺漏的風險。該工具支援多種安裝途徑(Cargo、Homebrew、npm),並需要透過 Docker 下載掃描器套件。掃描後會產出 JSON 格式報告,分析時應重點關注判決結果、真實風險說明、掃描器錯誤狀況,以及具體的安裝建議(安裝、不安裝、修復後再安裝)。適用於 Claude Code、Cursor、Codex 等代理平台,幫助開發者在安裝第三方技能前先進行離線驗證。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add coroboros/skillward

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

skillward 是做什麼的?

審查一個不受信任的代理技能——一個資料夾、一個技能目錄,或一個遠端 HTTPS Git URL——透過執行完整的確定性掃描器組合並將結果融合為一個離線判決。CLI 負責偵測;此技能增加了一個智慧的步驟:讀取報告並說明其含義。

安裝

CLI 是核心引擎。安裝一次:

cargo binstall skillward     # 預編譯的二進位檔
brew install coroboros/tap/skillward
npx @coroboros/skillward     # Node 工具鏈

然後拉取掃描器套件(一次性,需要 Docker):

skillward install

如果 skillward 不在 PATH 中,請停止並告訴使用者使用上述其中一個命令進行安裝——請勿自行進行掃描。手工檢查會遺漏組合掃描器能夠捕捉到的內容,因此會報告錯誤的完全安全結果。

使用

執行 skillward --help 以查看完整選項。預設掃描,搭配 JSON 報告以便分類處理:

skillward <target> --format json -o report.json

<target> 是一個技能資料夾、一個技能目錄,或一個 https:// Git 倉庫 URL。退出碼 20 表示發現的結果達到 --fail-on 閾值(預設為 high);退出碼 0 表示安全或低於該閾值。

分析

掃描後,讀取 report.json 並進行分類處理——而不是重複陳述發現結果:

  1. 以判決結果開頭。 PASS 或 FAIL,最嚴重的嚴重等級,以及發現結果是否相互佐證(多個工具一致表示高可信度)。
  2. 用平實的語言解釋主要發現結果的真實風險——攻擊者能夠獲得什麼,引用特定檔案和規則(例如「每次執行時洩露 AWS 憑證——setup.sh:7,被 skillspector 和 semgrep 標記」)。
  3. 注意任何 tool_errors ——掃描器未執行意味著畫面不完整;請說明這一點,而不是暗示完全安全。
  4. 做出決定: 安裝、不安裝,或修復後重新安裝。對於修復,請明確說明具體的更改。

保持簡潔且以決策為導向。發現結果在報告中;判斷是您的工作。

相關技能