基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
技术实践2026-11-21 22:51

安装 Agent 技能前,先核对扫描版本

dev.to · AI#Agent#完整性校验#供应链安全
Editor brief · 编辑速览

教程演示如何通过 SourceWeft CLI 查找并安装本地 Agent 技能。CLI 从扫描时记录的提交下载文件,逐一校验 SHA-256,发现差异就中止安装。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

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。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
用工具轨迹和最终状态测试智能体
下一篇
Gemini 4 Neon 与 Carbon 将在 12 月价格反转

资讯速览

dev.to · AI · 2026-11-21 22:51

AI 评分 8.0 / 10

相关标签

#Agent#完整性校验#供应链安全

继续阅读

  • 先定角色母图,再批量生成 GIF
  • 用工具轨迹和最终状态测试智能体
  • Gemini 4 Neon 与 Carbon 将在 12 月价格反转
  • Jira 安全 Agent 用代码给漏洞打分
  • 让 AI 在改代码前梳理回归范围