NSAuditor AI Agent Skill

技能简介

NSAuditor AI Agent Skill 是一个可安装的知识包，让任何 AI 编码助手「秒懂」NSAuditor AI 的安全审计能力。它把 NSAuditor 的 MCP 工具定义、数据结构和多步安全审计工作流，全部封装成 Agent 可直接加载的技能内容，无需每次对话手工补充上下文。

适用于 Claude Code、Claude Desktop、Cursor、Windsurf、VS Code Copilot 以及任何支持 MCP 的 Agent。装上之后，AI 助手就能自主编排复杂的安全合规审计任务，而不是每次都从头学习工具怎么用。

核心能力

1. MCP 工具知识内嵌：把 NSAuditor 的 MCP 工具清单、参数、返回结构完整教给 Agent，减少试错。
2. 数据结构理解：Agent 能读懂审计结果的字段含义，按需提取关键信息。
3. 多步审计编排：支持把「扫描 → 分析 → 归类 → 生成报告」串成自动工作流。
4. 合规矩阵查询：通过 compliance_matrix 获取当前的合规控制项三元组（覆盖、部分覆盖、不适用）。
5. 报告自动生成：Pro 版提供 report 子命令，把完成的一次运行转成客户端可读的 HTML 报告或 Jira 导入 CSV。
6. 进度可校验：新增 report.summary.findingsReceived / findingsRouted 字段，Agent 可自行校验 findingsRouted ≤ findingCount ≤ findingsReceived，从结果包本身判断完整性。
7. 证据契约绑定：企业版从 1.0.0 起，docs/contract-v1.md 中的证据契约具备约束力。
8. 跨 Agent 通用：同一份 SKILL.md 可在 Claude Code、Cursor、Windsurf、VS Code Copilot 中复用。
9. 版本感知教学：技能内容随 NSAuditor 版本更新，包含变更说明与「不应再做的事」的拒绝规则。
10. 计数口径修正：说明 Findings analyzed 统计的是 finding 而非 issue，避免 Agent 读出错误结论。

安装配置

方式一：npm 全局安装（推荐）

npm install -g nsauditor-ai-agent-skill

方式二：作为项目依赖安装

npm install nsauditor-ai-agent-skill --save-dev

方式三：直接引用 SKILL.md

技能包的核心是 SKILL.md 文件，可直接复制到你的 Agent 的技能目录：

# Claude Code 项目级技能目录示意
cp node_modules/nsauditor-ai-agent-skill/SKILL.md .claude/skills/nsauditor/

配套要求：需要同时安装 NSAuditor 企业版（1.0.0+）或社区版（0.2.49+），技能包本身只提供知识，不包含扫描引擎。

使用步骤

第一步：安装技能包

npm install -g nsauditor-ai-agent-skill

第二步：把 SKILL.md 注册到你的 Agent

不同客户端技能目录不同，Claude Code 通常在项目根 .claude/skills/，Codex 在 ~/.codex/。

第三步：在对话中直接提出审计需求

帮我审计这个 AWS 账户的 S3 存储桶配置，检查是否有审计日志缺口

Agent 会自动调用 NSAuditor 的 MCP 工具。

第四步：让 Agent 生成报告（Pro 版）

nsauditor-ai report --from  --format executive

可选 executive（客户端 HTML 报告）或 jira（Jira 导入 CSV）。

第五步：校验结果完整性

用返回包中的 findingsReceived / findingsRouted 字段自检，确认统计口径正确。

适用场景

1. 云账户安全审计：对 AWS、Azure 等云环境做配置合规扫描。
2. PCI DSS 合规检查：自动识别支付相关控制项（11.5.2 关键文件变更检测等）。
3. 审计报告交付：把技术扫描结果转成客户可读的管理层报告。
4. Jira 工单流转：将发现的问题直接导出为 Jira 可导入的 CSV，进入修复流程。
5. 合规矩阵核对：定期查询合规覆盖情况，跟踪覆盖率的变动。
6. 多环境批量审计：对多个云账户重复执行同一套审计编排。
7. 安全团队知识传承：把审计方法论固化成技能包，新成员装上即用。

适用人群

• 安全工程师：需要频繁执行云环境合规审计的人员。
• 合规专员：负责 PCI DSS、SOC 2 等标准符合性检查的岗位。
• DevSecOps 工程师：希望在 CI/CD 中集成安全审计的开发者。
• IT 审计师：为客户提供安全评估服务的第三方顾问。
• 云平台管理员：需要定期自查云资源配置的管理人员。

工作原理

NSAuditor AI Agent Skill 本质是一个「知识分发层」，不包含扫描引擎本身。它的工作方式是：

• SKILL.md 结构：技能文件按约定组织，包含工具清单、数据结构说明、工作流编排指引、以及随版本更新的「当前事实」区块。
• 事实渲染标记：文件中的 <!-- nsa:derived id="…" -->…<!-- /nsa:derived --> 标记之间的文本，是由企业版构建时从 package.json 和已发布框架数据渲染出来的事实（版本号、社区版下限、插件数量、矩阵变动）。Agent 应原样引用这些文本，标记本身只是保持内容最新的机制。
• MCP 工具桥接：技能包教 Agent 如何调用 NSAuditor 提供的 MCP 服务，工具的实际执行由 NSAuditor 引擎完成。
• 版本同步：每次 NSAuditor 发布新版本，技能包同步更新教学内容，包括新功能、修正口径，以及明确标注哪些做法是「拒绝规则」（例如 NTP 时钟证明已被撤回，不存在相关环境变量，也不在路线图上）。

官方链接

• npm：https://www.npmjs.com/package/nsauditor-ai-agent-skill
• 版本更新：见包内 CHANGELOG.md
• 证据契约：企业版 docs/contract-v1.md（自 EE 1.0.0 起生效）