安装 Agent 技能前,先核对扫描版本
教程演示如何通过 SourceWeft CLI 查找并安装本地 Agent 技能。CLI 从扫描时记录的提交下载文件,逐一校验 SHA-256,发现差异就中止安装。
AI 深度解读
安装一个 agent skill,除了看它能做什么,还要确认下载到本机的文件,确实是目录扫描过的那一份。SourceWeft CLI 给出的办法是:固定源仓库的 commit,逐文件校验 SHA-256,再保存安装记录,方便以后检查改动。
这篇教程的价值在于把安装流程变得可追溯。但「文件一致」和「可以放心运行」是两件事。对经常给 Claude Code、Codex 或 Cursor 装技能的程序员,这条边界比安装命令更值得记住。
校验通过,到底证明了什么
SourceWeft 目录为每个 skill 记录源仓库、扫描时的精确 commit,以及各文件的 SHA-256。CLI 从对应 commit 下载文件,逐个比较哈希;只要发现不一致,就不安装任何文件。
哈希可以理解为文件内容的指纹。它解决的问题是:扫描时看到的内容,和你实际拿到的内容是否相同。
校验通过,只能证明安装文件与扫描记录一致,不能证明文件无害。
假如扫描时的脚本就有问题,下载后保持一致,也不会让它变安全。因此,文件校验负责核对内容,阅读技能和扫描说明负责判断是否适合使用。
作者称,教程里的命令都在 2026-11-20,用已发布的 CLI 0.3.0,在空目录运行过。环境需要 Node.js 和终端,不需要 SourceWeft 账号。这是特定版本的操作实测,不能据此推断扫描器能识别多少风险。
安装前,先把详情里的几行看明白
先用 npx @sourceweft/cli skills search "pdf forms" 搜索。结果包含安装名、简短说明,以及是否附带脚本的 scripts 标记。
例如,@github/pdftk-server、@claude-office-skills/pdf-form-filler-0a843e12 和 @jwynia/pdf-generator 都是安装名,后续命令使用这个名称。
接着执行 npx @sourceweft/cli skills info @google/gke-kueue-troubleshooting。作者建议依次看 Source、Trust、Scripts 和 Scan flags。
Source 指向仓库及 commit。本例版本为 e96f2070b42c11e184e662cfe1fda8b20c9e2140,对应 google/skills 仓库里的 skills/cloud/gke-kueue-troubleshooting。固定 commit,才能明确知道安装的是哪份内容。
Trust 说明是否经过 SourceWeft 管理员审核。Featured 和 Community 都表示没有管理员审核;文件仍会做哈希校验。别把精选发布者当成审核结论。
Scripts 显示是否包含可执行文件。示例是 yes,表示 agent 可能运行其中的代码。Scan flags 则列出 egress:fetch、script:out-of-bundle-path、secrets:env-access。原文没有展开这些标记的判定规则,不能仅凭名称认定它们有害或无害。
另外,本例许可证是 not stated。对于准备放进团队工作流的技能,这也是需要继续核实的信息。
安装到哪里,以及以后怎么发现改动
执行 npx @sourceweft/cli skills install @google/gke-kueue-troubleshooting 后,CLI 会再次展示详情并要求确认。有脚本时,会明确询问是否安装 agent 可能运行的脚本。
在脚本或 CI 这种非交互环境里,它会停止,返回非零状态且不写文件,提示:Error: Confirmation required. Re-run with --yes to proceed without asking.。--yes 是跳过询问的开关,适合已经读过详情的情况。
默认安装目标是 Claude Code,目录为 ~/.claude/skills/<name>/。改用 Codex,可以执行 npx @sourceweft/cli skills install @github/pdftk-server --agent codex。
npx @sourceweft/cli skills agents 会列出支持的 agent 及目录,例如 claude-code 对应 ~/.claude/skills,cursor 对应 ~/.cursor/skills,codex 对应 ~/.agents/skills。列表还包含 Gemini CLI、Windsurf 和 GitHub Copilot。增加 --scope project,则安装到当前项目的目录。
想先检查落盘内容,可以指定一个空目录:
npx @sourceweft/cli skills install @google/gke-kueue-troubleshooting --dir ./out --yes
这里要看 --dir ./out:文件会进入 ./out/gke-kueue-troubleshooting/。它只改变安装位置,并不提供脚本运行隔离。
CLI 还会写入 .sourceweft.json,记录目录服务地址、安装名、版本、源仓库、commit、许可证和文件哈希。作者称,用独立脚本重算全部 24 个文件的 SHA-256,均与记录一致,也可以用 shasum -a 256 自行比较。
不过,原文一处说写入的 24 个文件包含 CLI 新增记录文件,详情里又显示 Files: 24。这两个计数是否采用相同口径,没有交代清楚。
后续检查使用:
npx @sourceweft/cli skills doctor
关键是 doctor:它比较磁盘内容与本地安装记录。针对上述自定义目录,原文说明检查时带了 --dir ./out。
作者刚安装完得到 OK — 1 installed skill(s), no problems found.;向 scripts/snapshot.py 追加一行后,再检查就收到文件已编辑的提示。编辑和额外文件记为 note,缺失文件记为问题,但工具无法判断是谁改的。
skills list 也会显示 modified。重新安装遇到已修改目录会停止,要求显式使用 --force;加上后才恢复记录对应的文件,并输出 Updated …。
更新前可运行 npx @sourceweft/cli skills update --dry-run,查看计划,再运行 npx @sourceweft/cli skills update。删除则用 npx @sourceweft/cli skills remove @google/gke-kueue-troubleshooting。新版可能增加脚本,仍需重新阅读详情;工具也不会持续监视上游变化。
我的判断
我认可这套流程把来源、安装内容和本地改动串了起来。相比手动复制文件,它多了明确版本、逐文件校验和改动检查,出问题时更容易追查。
但它没有替你完成技能审查。原文给出了安装校验和修改检测的操作结果,没有提供扫描准确率、漏报率,也没有与其他安装工具做对照。不能从这些测试推导出「使用 SourceWeft 更安全」的全面结论。
还有一个适用边界:示例涉及 GKE 排障,不能因为安装步骤通用于 Codex 或 Cursor,就认为技能本身适合前端项目。工具支持哪些 agent,与技能需要什么环境,是两个独立条件。
作者同时是 SourceWeft 维护者,并披露文章由 AI 辅助起草、本人审核。这不否定实测,但读者应把它视为产品维护者的操作教程,而非独立安全评测。
能拿来做什么
- 给日常 AI 编程环境装新技能时,先看
skills info中的源 commit、脚本、扫描标记和许可证,再决定是否安装,别只凭名称和推荐标识判断。 - 想检查技能文件时,先用
--dir放进空目录,阅读技能说明和脚本,再选择 agent 或项目安装位置。 - 在脚本或 CI 中使用 CLI 时,把详情审阅放到执行
--yes之前;更新先看--dry-run,并检查新版是否增加了脚本。 - 调整已安装技能后,用
skills doctor和skills list确认改动状态;遇到覆盖提示时先检查差异,再决定是否使用--force。