技能扫描仪

安全 社区

技能解读

当前原文的自动摘译,尚未人工审校。

脚本/scanskill.py

检测确定性模式的静态分析扫描器。输出结构化 JSON。返回包含结果、URL、结构信息和严重性计数的 JSON。该脚本会机械地捕获模式 - 您的工作是评估意图并过滤误报。

第一阶段:输入和发现

确定扫描目标: 如果用户提供了技能目录路径,则直接使用它 如果用户命名了一个技能,首先在.agents/skills/<name>/下查找它,然后在其他已建立的布局中查找,例如当存储库使用规范根技能树时,skills/<name>/,.claude/skills/<name>/,plugins/*/skills/<name>/,或其他具有明确现有技术的存储库管理的技能根如果用户说“扫描所有技能”,则发现所有*/SKILL.md 文件并扫描每个

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
安全
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@getsentry · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第一阶段:输入和发现

确定扫描目标: 如果用户提供了技能目录路径,则直接使用它 如果用户命名了一个技能,首先在`.agents/skills/<name>/`下查找它,然后在其他已建立的布局中查找,例如当存储库使用规范根技能树时的`skills/<name>/`,`.claude/skills/<name>/`,`plugins/*/skills/<name>/`,或其他具有明确现有技术的存储库管理的技能根如果用户说“扫描所有技能”,则发现所有`*/SKILL.md` 文件并扫描每个

02
第 2 阶段:自动静态扫描

运行捆绑的扫描器:解析 JSON 输出。该脚本会生成包含严重性级别、URL 分析和结构信息的结果。使用这些作为更深入分析的线索。后备:如果脚本失败,请使用参考文件中的 Grep 模式继续进行手动分析。

03
第三阶段:Frontmatter 验证

阅读 SKILL.md 并检查: 必填字段:`name` 和 `description` 必须存在 名称一致性:`name` 字段应与目录名称匹配 工具评估:审查 `allowed-tools` — Bash 合理吗?工具是否不受限制(`*`)?模型覆盖:特定模型是否强制?为什么?

04
第 4 阶段:即时注入分析

加载`references/prompt-injection-patterns.md`以获取上下文。查看“即时注射”类别中的扫描仪结果。对于每个发现: 阅读文件中的周围上下文 确定该模式是否正在执行注入(恶意)或讨论/检测注入(合法) 有关安全、测试或教育的技能通常引用注入模式 - 这是预期的

05
第五阶段:行为分析

此阶段仅限代理,无模式匹配。阅读完整的 SKILL.md 说明并评估: 说明与说明的一致性:说明是否与说明实际告诉代理执行的操作相符?指示代理读取 ~/.ssh 的被描述为“代码格式化程序”的技能未对齐配置/内存中毒:

06
第六阶段:脚本分析

如果技能有一个`scripts/`目录:加载`references/dangerous-code-patterns.md`以获取上下文完整阅读每个脚本文件(不要跳过任何)检查“恶意代码”类别中的扫描仪发现结果对于每个发现,评估:

07
第七阶段:供应链评估

检查扫描仪输出中的 URL 以及脚本中找到的任何其他 URL: 受信任的域:GitHub、PyPI、官方文档 — 正常 不受信任的域:未知域、个人网站、URL 缩短程序 — 供审核的标记 远程指令加载:任何获取要执行或解释为指令的内容的 URL 都是高风险 依赖项下载:在运行时下载并执行二进制文件或代码的脚本

08
第八阶段:权限分析

加载工具风险矩阵的`references/permission-analysis.md`。评估: 最小权限:技能说明中是否实际使用了所有授予的工具?工具合理性:技能主体是否参考了需要每种工具的操作?风险级别:使用参考中的层级系统对总体权限配置文件进行评级

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。