拓冰网站定制 
AI Agent Skills需要什么样的安全扫描器Skill Scanner完全指南一站式检测提示注入与数据外泄【免费下载链接】skill-scannerSecurity Scanner for Agent Skills项目地址: https://gitcode.com/gh_mirrors/sk/skill-scanner使用 AI Agent智能体时AI Agent Skills智能体技能正成为新的攻击面——一个看似无害的SKILL.md文件背后可能藏着提示注入、数据外泄甚至恶意代码。Skill Scanner正是一款专为 Agent Skills 打造的安全扫描器它以一站式的方式检测提示注入、数据外泄、命令注入等威胁无需部署复杂环境几分钟即可完成第一个技能包扫描。本文将带你从零了解什么样的技能包才需要扫描、Skill Scanner 内置了哪些检测引擎、如何快速安装与配置以及如何把它接入 CI/CD 实现自动化安全门禁。为什么 AI Agent Skills 需要安全扫描Agent Skill 是一个本地文件包通常长这样my-skill/ ├── SKILL.md # 元数据 给 Agent 的行为指令 ├── scripts/ │ └── main.py # 可执行脚本 └── prompts/ └── system.mdSKILL.md里既有 YAML 元数据也有写给 Agent 看的 Markdown 指令。当 Agent自动读取并执行这些内容时风险就产生了提示注入指令层被恶意篡改诱导 Agent 违背原始规则数据外泄读取~/.aws/credentials、环境变量密钥后悄悄发往外部服务器命令/代码注入eval、远程脚本执行等危险原语混入脚本️混淆与隐藏载荷Base64 编码、二进制文件、Unicode 走私等手法官方对技能包的安全边界有完整论述可参考 docs/concepts/security-model.md。⚠️ 关键认知Skill Scanner 是尽力而为的检测工具。扫描无发现 ≠ 绝对安全高风险场景仍需人工复核。Skill Scanner 的检测能力多引擎分层扫描Skill Scanner 的核心设计理念是纵深防御Defense-in-Depth多个检测引擎各有强弱项叠加后形成分层覆盖。它支持 OpenAI Codex Skills 与 Cursor Agent Skills 等符合 Agent Skills 规范的格式。内置检测引擎一览引擎检测方式是否需要 API Key主要目标StaticYAML 签名 YARA 模式匹配否全文件确定性模式Bytecode.pyc完整性校验否Python 字节码PipelineShell 命令链污点分析否管道执行风险BehavioralPython AST 数据流分析否多步代码行为如读文件→外发Correlation有界 source/sink 结构化关联否跨源汇聚的攻击链LLM大模型语义意图分析是上下文级威胁推理Meta二次研判、误报过滤是降低误报、优先级排序VirusTotal哈希信誉查询是二进制恶意软件两阶段执行模型第一阶段所有确定性引擎独立运行第二阶段LLM 与 Meta 引擎基于第一阶段发现做语义研判从而减少误报。各引擎的详细说明见 docs/architecture/analyzers/index.md。发现结果对齐标准威胁分类法每条发现都会映射到Cisco AI Security FrameworkAITech / AISubtech 编码并支持 OWASP、MITRE ATLAS、NIST AML 等跨框架映射方便与安全团队已有流程对接。完整映射表见 docs/architecture/threat-taxonomy.md。5分钟上手Skill Scanner 安装与配置步骤一键安装 Skill Scanner要求 CPython 3.11–3.14。推荐使用 uv 或 pip# 使用 uv推荐 uv pip install cisco-ai-skill-scanner # 或 pip pip install cisco-ai-skill-scanner如需启用云厂商 LLMBedrock / Gemini / Azure OpenAI 等可加装对应 extras详见 docs/user-guide/installation-and-configuration.md。第一次扫描从新手友好的向导开始不确定用哪些参数直接运行不带任何参数的命令会启动交互式向导逐步引导你选择扫描目标、分析引擎、扫描策略和输出格式skill-scanner常用扫描命令速查# 扫描单个技能默认运行核心引擎static bytecode pipeline correlation skill-scanner scan /path/to/skill # 启用行为分析AST 数据流抓读敏感文件→外发这类多步行为 skill-scanner scan /path/to/skill --use-behavioral # 启用 LLM 语义分析 Meta 误报过滤需配置 SKILL_SCANNER_LLM_API_KEY skill-scanner scan /path/to/skill --use-llm --enable-meta # 批量递归扫描目录 skill-scanner scan-all /path/to/skills --recursive用项目自带的测试技能试跑一下效果立现安全技能simple-math输出 0 条发现而恶意技能multi-file-exfiltration在开启行为分析后一次性报出11 条发现3 条 CRITICAL覆盖 HTTP 外发、读取 AWS 凭据、窃取环境变量、eval注入等多种威胁。更多演示见 docs/getting-started/quick-start.md。扫描策略怎么选5种预设对应不同场景Skill Scanner 用**扫描策略Scan Policy**在不改代码的前提下调节检测敏感度内置 5 个预设预设姿态典型用途strict最高敏感度审计与威胁狩猎balanced默认均衡通用 CI 场景low-noise降噪版 balanced日常扫描、关注告警量quiet进一步降噪审核人力有限的团队permissive低噪音可信内部技能官方给出了按角色的推荐配置表例如安装第三方技能前审核推荐balanced LLM 评审CI 门禁自家技能推荐low-noise完整实测数据见 docs/user-guide/recommended-settings.md。核心建议只有一条HIGH 级别拦截、MEDIUM 级别进人工复核队列——既保证门禁有效又不会漏掉需要人工判断的中风险项。自定义策略从生成到 TUI 可视化配置# 生成一份可编辑的策略文件 skill-scanner generate-policy -o my_org_policy.yaml # 交互式 TUI 配置器 skill-scanner configure-policy # 扫描时套用自定义策略 skill-scanner scan /path/to/skill --policy my_org_policy.yaml策略文件支持按需覆盖默认值缺省键自动继承可调整的文件数量上限、分析阈值、引擎开关等说明见 docs/user-guide/custom-policy-configuration.md 与 docs/reference/policy-quick-reference.md。接入 CI/CD让技能扫描成为自动化安全门禁GitHub Actions 复用工作流Skill Scanner 提供可复用的 GitHub Actions 工作流每次 push 或 PR 自动扫描技能目录结果通过 SARIF 输出到 GitHub Code Scanning直接在 PR 上显示行内标注# .github/workflows/scan-skills.yml jobs: scan: uses: cisco-ai-defense/skill-scanner/.github/workflows/scan-skills.ymlmain with: skill_path: .cursor/skills配置细节见 docs/github-actions.md。Pre-commit 钩子提交前拦截风险配合 pre-commit 框架每次 commit 前自动扫描有变更的技能# .pre-commit-config.yaml repos: - repo: https://gitcode.com/gh_mirrors/sk/skill-scanner rev: v1.0.0 hooks: - id: skill-scanner也可直接安装内置钩子skill-scanner-pre-commit --install输出格式从终端到 SARIF 全场景覆盖格式适用场景summary/table终端快速查看json程序化处理、CI 逻辑markdown团队报告html自包含交互式报告可折叠关联组、污点流图sarifGitHub Code Scanning 等平台集成CI 门禁的经典用法——发现 HIGH 及以上发现即让构建失败skill-scanner scan-all ./skills --fail-on-severity high --format sarif --output results.sarif进阶能力LLM 评审、跨技能分析与自定义规则共识模式--llm-consensus-runs 3让 LLM 分析运行多次仅保留多数一致保留的发现提升稳定性跨技能重叠检测scan-all --check-overlap识别多个技能间的描述重叠与数据接力风险skill_scanner/core/analyzers/cross_skill_scanner.py宽容模式--lenient可扫描 Claude Code.claude/commands/*.md等非标准格式自定义规则编写 YAML 签名、YARA 规则或 Python 检查项扩展检测能力方法见 docs/architecture/analyzers/writing-custom-rules.mdPython SDKfrom skill_scanner import SkillScanner即可在代码中集成扫描逻辑示例见 examples/programmatic_usage.py总结如何为 Agent Skills 选对安全扫描器回顾本文一个合格的 AI Agent Skills 安全扫描器应具备✅多引擎分层检测——确定性签名 数据流分析 LLM 语义研判Skill Scanner 提供 8 个引擎✅标准威胁分类映射——发现结果可对接企业安全框架✅可调扫描策略——按场景平衡检出率与误报✅CI/CD 与 pre-commit 集成——SARIF 输出 退出码门禁✅可扩展规则体系——自定义 YAML/YARA/Python 规则如果你正在构建或审核 Agent Skills不妨从skill-scanner scan /path/to/skill --use-behavioral这一条命令开始体验一下提示注入与数据外泄检测的实际效果。 再次提醒无发现不等于无风险请将扫描结果与人工代码评审结合使用构建纵深防御体系。【免费下载链接】skill-scannerSecurity Scanner for Agent Skills项目地址: https://gitcode.com/gh_mirrors/sk/skill-scanner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AI Agent Skills需要什么样的安全扫描器？Skill Scanner完全指南：一站式检测提示注入与数据外泄
AI Agent Skills需要什么样的安全扫描器Skill Scanner完全指南一站式检测提示注入与数据外泄【免费下载链接】skill-scannerSecurity Scanner for Agent Skills项目地址: https://gitcode.com/gh_mirrors/sk/skill-scanner使用 AI Agent智能体时AI Agent Skills智能体技能正成为新的攻击面——一个看似无害的SKILL.md文件背后可能藏着提示注入、数据外泄甚至恶意代码。Skill Scanner正是一款专为 Agent Skills 打造的安全扫描器它以一站式的方式检测提示注入、数据外泄、命令注入等威胁无需部署复杂环境几分钟即可完成第一个技能包扫描。本文将带你从零了解什么样的技能包才需要扫描、Skill Scanner 内置了哪些检测引擎、如何快速安装与配置以及如何把它接入 CI/CD 实现自动化安全门禁。为什么 AI Agent Skills 需要安全扫描Agent Skill 是一个本地文件包通常长这样my-skill/ ├── SKILL.md # 元数据 给 Agent 的行为指令 ├── scripts/ │ └── main.py # 可执行脚本 └── prompts/ └── system.mdSKILL.md里既有 YAML 元数据也有写给 Agent 看的 Markdown 指令。当 Agent自动读取并执行这些内容时风险就产生了提示注入指令层被恶意篡改诱导 Agent 违背原始规则数据外泄读取~/.aws/credentials、环境变量密钥后悄悄发往外部服务器命令/代码注入eval、远程脚本执行等危险原语混入脚本️混淆与隐藏载荷Base64 编码、二进制文件、Unicode 走私等手法官方对技能包的安全边界有完整论述可参考 docs/concepts/security-model.md。⚠️ 关键认知Skill Scanner 是尽力而为的检测工具。扫描无发现 ≠ 绝对安全高风险场景仍需人工复核。Skill Scanner 的检测能力多引擎分层扫描Skill Scanner 的核心设计理念是纵深防御Defense-in-Depth多个检测引擎各有强弱项叠加后形成分层覆盖。它支持 OpenAI Codex Skills 与 Cursor Agent Skills 等符合 Agent Skills 规范的格式。内置检测引擎一览引擎检测方式是否需要 API Key主要目标StaticYAML 签名 YARA 模式匹配否全文件确定性模式Bytecode.pyc完整性校验否Python 字节码PipelineShell 命令链污点分析否管道执行风险BehavioralPython AST 数据流分析否多步代码行为如读文件→外发Correlation有界 source/sink 结构化关联否跨源汇聚的攻击链LLM大模型语义意图分析是上下文级威胁推理Meta二次研判、误报过滤是降低误报、优先级排序VirusTotal哈希信誉查询是二进制恶意软件两阶段执行模型第一阶段所有确定性引擎独立运行第二阶段LLM 与 Meta 引擎基于第一阶段发现做语义研判从而减少误报。各引擎的详细说明见 docs/architecture/analyzers/index.md。发现结果对齐标准威胁分类法每条发现都会映射到Cisco AI Security FrameworkAITech / AISubtech 编码并支持 OWASP、MITRE ATLAS、NIST AML 等跨框架映射方便与安全团队已有流程对接。完整映射表见 docs/architecture/threat-taxonomy.md。5分钟上手Skill Scanner 安装与配置步骤一键安装 Skill Scanner要求 CPython 3.11–3.14。推荐使用 uv 或 pip# 使用 uv推荐 uv pip install cisco-ai-skill-scanner # 或 pip pip install cisco-ai-skill-scanner如需启用云厂商 LLMBedrock / Gemini / Azure OpenAI 等可加装对应 extras详见 docs/user-guide/installation-and-configuration.md。第一次扫描从新手友好的向导开始不确定用哪些参数直接运行不带任何参数的命令会启动交互式向导逐步引导你选择扫描目标、分析引擎、扫描策略和输出格式skill-scanner常用扫描命令速查# 扫描单个技能默认运行核心引擎static bytecode pipeline correlation skill-scanner scan /path/to/skill # 启用行为分析AST 数据流抓读敏感文件→外发这类多步行为 skill-scanner scan /path/to/skill --use-behavioral # 启用 LLM 语义分析 Meta 误报过滤需配置 SKILL_SCANNER_LLM_API_KEY skill-scanner scan /path/to/skill --use-llm --enable-meta # 批量递归扫描目录 skill-scanner scan-all /path/to/skills --recursive用项目自带的测试技能试跑一下效果立现安全技能simple-math输出 0 条发现而恶意技能multi-file-exfiltration在开启行为分析后一次性报出11 条发现3 条 CRITICAL覆盖 HTTP 外发、读取 AWS 凭据、窃取环境变量、eval注入等多种威胁。更多演示见 docs/getting-started/quick-start.md。扫描策略怎么选5种预设对应不同场景Skill Scanner 用**扫描策略Scan Policy**在不改代码的前提下调节检测敏感度内置 5 个预设预设姿态典型用途strict最高敏感度审计与威胁狩猎balanced默认均衡通用 CI 场景low-noise降噪版 balanced日常扫描、关注告警量quiet进一步降噪审核人力有限的团队permissive低噪音可信内部技能官方给出了按角色的推荐配置表例如安装第三方技能前审核推荐balanced LLM 评审CI 门禁自家技能推荐low-noise完整实测数据见 docs/user-guide/recommended-settings.md。核心建议只有一条HIGH 级别拦截、MEDIUM 级别进人工复核队列——既保证门禁有效又不会漏掉需要人工判断的中风险项。自定义策略从生成到 TUI 可视化配置# 生成一份可编辑的策略文件 skill-scanner generate-policy -o my_org_policy.yaml # 交互式 TUI 配置器 skill-scanner configure-policy # 扫描时套用自定义策略 skill-scanner scan /path/to/skill --policy my_org_policy.yaml策略文件支持按需覆盖默认值缺省键自动继承可调整的文件数量上限、分析阈值、引擎开关等说明见 docs/user-guide/custom-policy-configuration.md 与 docs/reference/policy-quick-reference.md。接入 CI/CD让技能扫描成为自动化安全门禁GitHub Actions 复用工作流Skill Scanner 提供可复用的 GitHub Actions 工作流每次 push 或 PR 自动扫描技能目录结果通过 SARIF 输出到 GitHub Code Scanning直接在 PR 上显示行内标注# .github/workflows/scan-skills.yml jobs: scan: uses: cisco-ai-defense/skill-scanner/.github/workflows/scan-skills.ymlmain with: skill_path: .cursor/skills配置细节见 docs/github-actions.md。Pre-commit 钩子提交前拦截风险配合 pre-commit 框架每次 commit 前自动扫描有变更的技能# .pre-commit-config.yaml repos: - repo: https://gitcode.com/gh_mirrors/sk/skill-scanner rev: v1.0.0 hooks: - id: skill-scanner也可直接安装内置钩子skill-scanner-pre-commit --install输出格式从终端到 SARIF 全场景覆盖格式适用场景summary/table终端快速查看json程序化处理、CI 逻辑markdown团队报告html自包含交互式报告可折叠关联组、污点流图sarifGitHub Code Scanning 等平台集成CI 门禁的经典用法——发现 HIGH 及以上发现即让构建失败skill-scanner scan-all ./skills --fail-on-severity high --format sarif --output results.sarif进阶能力LLM 评审、跨技能分析与自定义规则共识模式--llm-consensus-runs 3让 LLM 分析运行多次仅保留多数一致保留的发现提升稳定性跨技能重叠检测scan-all --check-overlap识别多个技能间的描述重叠与数据接力风险skill_scanner/core/analyzers/cross_skill_scanner.py宽容模式--lenient可扫描 Claude Code.claude/commands/*.md等非标准格式自定义规则编写 YAML 签名、YARA 规则或 Python 检查项扩展检测能力方法见 docs/architecture/analyzers/writing-custom-rules.mdPython SDKfrom skill_scanner import SkillScanner即可在代码中集成扫描逻辑示例见 examples/programmatic_usage.py总结如何为 Agent Skills 选对安全扫描器回顾本文一个合格的 AI Agent Skills 安全扫描器应具备✅多引擎分层检测——确定性签名 数据流分析 LLM 语义研判Skill Scanner 提供 8 个引擎✅标准威胁分类映射——发现结果可对接企业安全框架✅可调扫描策略——按场景平衡检出率与误报✅CI/CD 与 pre-commit 集成——SARIF 输出 退出码门禁✅可扩展规则体系——自定义 YAML/YARA/Python 规则如果你正在构建或审核 Agent Skills不妨从skill-scanner scan /path/to/skill --use-behavioral这一条命令开始体验一下提示注入与数据外泄检测的实际效果。 再次提醒无发现不等于无风险请将扫描结果与人工代码评审结合使用构建纵深防御体系。【免费下载链接】skill-scannerSecurity Scanner for Agent Skills项目地址: https://gitcode.com/gh_mirrors/sk/skill-scanner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考