agent-bom-vulnerability-intel

使用此技能，通过 agent-bom 现有的扫描器与标准证据模型（canonical evidence model）回答漏洞情报类问题。请勿在 agent 会话中临时构建 OSV、GHSA、NVD、EPSS 或 KEV 的独立客户端；所有请求必须经由 agent-bom 路由，以确保漏洞通告来源（advisory provenance）、别名映射、严重性判定门限（severity gates）、缓存行为、敏感信息脱敏（redaction）及输出模式（output schemas）保持一致。

运行模式（Modes）

优先选用能回答用户问题的最小化模式：

安全约束（Guardrails）

• 在扫描广泛文件系统路径或本地 agent 配置前，须主动征得用户确认。
• 禁止粘贴或泄露 NVD_API_KEY、GITHUB_TOKEN、软件包注册中心凭据、云平台凭据或任意环境变量值。
• 禁止向漏洞通告服务提供商发送完整源码文件、锁文件（lockfiles）、配置内容、密钥（secrets）或完整扫描报告。agent-bom 始终优先提取软件包标识符后再发起查询。
• 将未知版本或无法解析的版本视作覆盖缺口（coverage gap），而非“无漏洞”的确定结论。
• 保留漏洞通告来源信息。禁止将 OSV、GHSA、NVD、EPSS 和 KEV 的严重性评估合并为单一未标注的严重性等级。
• 除非用户明确要求执行修复工作流（remediation workflow），否则不得修改依赖关系或自动安装补丁。

典型工作流（Workflows）

说明数据边界（Explain the Boundary）

当用户询问“哪些数据会离开我的环境？”时，请在执行任何操作前先行说明：

本次查询将向公共漏洞通告数据库发送软件包标识符（名称、版本、生态体系/PURL）及 CVE ID。不会发送源代码、原始配置、密钥、环境变量值、凭据或完整扫描报告。若私有软件包名称敏感，请改用 offline-review 模式。

检查单个软件包（Check One Package）

agent-bom check flask==2.0.0 --ecosystem pypi

适用于快速初步研判（triage）和修复版本验证（fix-version checks）。若该软件包属于私有注册中心或内部项目，请先使用 explain-only 模式，并由操作员判断该标识符是否可对外查询。

扫描标准清单（Scan a Canonical Inventory）

agent-bom scan --inventory inventory.json --format json --output findings.json

适用于操作员拉取（operator-pull）适配器或发现类技能（discovery skill）已生成标准清单后的场景。该清单可在文件边界处终止；扫描动作本身是显式的操作员交接（operator handoff）。

导出用于 PR 门禁（Export for a PR Gate）

agent-bom scan --inventory inventory.json --format sarif --output agent-bom.sarif

仅当用户明确需要 GitHub 代码扫描（code-scanning）或 AppSec 类 PR 门禁证据时，才使用 SARIF 格式。本地分析与审计追踪（audit trails）请始终使用 JSON 格式。

离线审查（Offline Review）

若禁止调用外部漏洞通告接口，请启用项目对应的离线模式（offline mode）或缓存批准模式（cache-approved mode），并清晰说明：当前覆盖范围取决于本地可用的漏洞数据库。切勿将“离线无结果”等同于“已通过最新 OSV/GHSA/NVD 查询确认安全”。

输出规范（Output Rules）

• 当存在时，统一展示 CVE / GHSA / PYSEC 等别名。
• 若字段可用，须包含严重性来源（severity source）、修复版本（fix version）、EPSS 分数、KEV 状态、CWE 编号及完整的通告来源链（advisory source chain）。
• 严格区分“未发现漏洞”（no vulnerabilities found）与“数据不足，无法评估”（not enough data to evaluate）。
• 输出内容、日志、提示词（prompts）、SARIF 中的 location 字段以及所有导出报告中，均须排除原始凭据及含凭据的 URL。