Communitygithub.com

coroboros/skillward

在安装前拆解代理技能——完整的确定性扫描器集合,融合成一个离线判决。

skillward 是什么?

Skillward 是一个用于审查不受信任的 AI 代理技能(例如 Claude Code、Cursor 或 Codex 使用的技能)的工具兼技能。它通过运行一个完整的、确定性的扫描器集合(包括 skillspector、semgrep 等多个扫描器)来离线分析技能文件夹、技能目录或远程 HTTPS Git 仓库 URL,并将所有发现融合成一个单一的“通过/失败”判决。该技能的主要价值在于智能分析阶段:它不是简单地重新打印 JSON 报告,而是生成一份简洁、面向决策的总结,解释最严重的风险、证据的可信度以及是否存在任何扫描器错误,最终建议用户是安装、拒绝安装还是修复后重装。它支持通过 `cargo binstall`、`brew` 和 `npx` 安装 CLI 引擎,并通过 Docker 一次性拉取扫描器捆绑包。

兼容平台~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. 做出决定: 安装、不安装或修复后再安装。对于修复,要指出确切的更改。

保持简短且面向决策。发现已在报告中;判断才是工作。

相关技能