软件项目的风险，不一定来自自己写的代码。一个版本过旧的依赖、一次不兼容的升级，甚至一个来源不明的安装包，都可能给项目的稳定性和安全性带来影响。随着 AI Agent 逐渐参与软件开发，如何让 Agent 正确识别依赖风险、核验证据，并在明确权限边界内给出处置建议，成为一个值得关注的工程问题。为此，我们推出了 Dependency Auditor（依赖审计技能）v0.1.0，并将其加入 Keying Agent Skills 开源技能仓库。
01｜Dependency Auditor 是什么
Dependency Auditor 是一个面向软件依赖与供应链风险的 Agent Skill。与传统的依赖扫描工具不同，它本身不是独立运行的漏洞扫描器，而是一套提供给 AI Agent 使用的标准化审计方法与工作流。它指导 Agent 从依赖声明、锁定版本、实际安装状态及构建环境出发，逐步核查依赖是否存在潜在问题，并根据证据生成结构化审计结论。它的目标不仅是发现风险，更是帮助开发者理解：
哪些依赖值得关注？
当前版本与锁定版本是否一致？
已公开漏洞是否真正影响当前项目？
升级是否会引入新的兼容性问题？
如何在控制变更成本的前提下处理风险？
02｜核心能力
依赖清单与版本核对
检查项目中的依赖声明文件、锁文件及安装环境，区分声明的版本约束、实际解析版本和运行环境中的版本。支持围绕 Python 与 npm 项目开展依赖核对，并关注直接依赖、间接依赖以及不同工作区的差异。
安全风险与漏洞证据核验
在可访问可信安全公告或漏洞数据库的情况下，核对漏洞编号、影响版本范围、修复版本及适用条件。技能强调：漏洞评分不等于项目实际风险。风险判断还需要结合依赖的真实使用方式、执行可达性和运行平台。缺少实时安全数据时，必须明确标注尚未完成核验，避免给出未经证实的安全结论。
兼容性与升级影响分析
针对依赖升级需求，从版本约束、平台环境、间接依赖关系和迁移成本等方面评估潜在影响。帮助开发者制定更稳妥的升级、替换或隔离方案，而不是直接执行大规模依赖更新。
许可证与供应链来源检查
辅助识别依赖许可证及软件包来源方面的风险。对于许可证兼容性问题，结合依赖类型、项目分发方式和具体许可条款进行分析，不简单地把不同许可证组合判定为冲突。
03｜标准化七步审计流程
Dependency Auditor 将审计过程拆分为七个阶段：
确认范围：明确生态、工作区及审计重点。
盘点证据：收集依赖文件、锁文件、SBOM 等信息。
核对版本：比对声明、解析结果与实际安装状态。
查证风险：根据可信公告核验相关漏洞信息。
评估影响：结合使用环境判断实际影响与兼容性风险。
制定建议：给出升级、替换、隔离或保持现状的依据。
生成报告：记录发现、证据、可信度、处置建议及剩余风险。
这一流程强调可追溯性和可复核性，避免只有结论、没有依据的分析方式。
04｜让 Agent 的分析结果更可信
Dependency Auditor 采用四级证据状态：
| 状态 | 含义 |
|---|---|
| Verified | 已有直接证据支持 |
| Likely | 有多项依据，但仍需验证 |
| Needs Verification | 存在待核验的合理疑点 |
| Unknown | 当前证据不足，无法判断 |
对于无法访问的环境、尚未执行的检查或缺失的漏洞公告，Agent 必须如实说明。没有发现明确问题，并不意味着项目不存在任何风险。审计的价值不仅是发现问题，更在于知道哪些结论能够被证实。
05｜默认只读，明确权限边界
安全不仅是审计对象，也是 Skill 自身必须遵守的原则。Dependency Auditor 默认采用分析模式，优先执行读取、检索和规划，不自动修改项目文件或锁文件。当用户明确要求只读审计时，禁止安装、升级、写入和提交等操作。对于可能影响开发环境的操作，必须满足用户授权、工具权限和必要的安全条件。同时，技能要求对私有软件源凭据等敏感信息进行脱敏，避免将敏感配置直接暴露在审计报告中。
06｜如何使用？
从 GitHub 获取 Keying Agent Skills 仓库后，将完整的 skill-dependency-auditor 目录复制到目标 Agent 宿主支持的 Skills 目录。安装示例：
cp -r skills/development/skill-dependency-auditor /path/to/agent/skills/实际安装路径以 Agent 宿主产品的要求为准。安装完成后，可以使用如下自然语言任务进行调用：
“帮我审计这个 Python 项目的依赖风险，只分析，不修改。”
“检查 package.json 与锁文件中的版本是否一致。”
“评估升级某个依赖可能产生的兼容性影响。”
“整理当前项目的软件依赖与许可证风险。”