skill-security-auditor

技能安全审计器

在安装前扫描并审计 AI Agent 技能的安全风险。对代码文件执行静态分析，以检测危险模式；扫描 Markdown 文件中的提示词注入；验证依赖供应链；检查文件系统边界；检测混淆行为。生成结构化的 PASS / WARN / FAIL 判定，并按严重程度归类发现项，提供可执行的修复指导。

关键词： 技能安全、AI 安全、提示词注入、代码审计、供应链、依赖扫描、数据外泄、凭据窃取、混淆检测、安装前安全

核心能力

• 代码执行风险检测 — 命令注入（os.system、subprocess shell=True、反引号）、eval/exec/compile、混淆（base64/hex/chr()）、网络外泄、凭据窃取（~/.ssh、~/.aws）、权限提升。
• 提示词注入检测 — 系统提示词覆盖、角色劫持、安全绕过、隐藏的零宽字符/HTML 注释指令、数据提取指令、过度权限请求。
• 供应链分析 — 已知存在漏洞的固定版本、仿冒包名、未固定版本、内联 pip/npm install、信誉较低的包。
• 文件系统与结构验证 — 超出范围的路径、隐藏文件/凭据文件、意外的二进制文件、逃逸的符号链接、超大负载。
• 判定与报告 — PASS / WARN / FAIL，包含按严重程度归类的发现项、修复建议，以及可用于 CI 门禁的严格模式。

使用场景

• 在安装前评估来自不可信来源的技能
• 为 CI/CD 流水线设置安装前安全门禁
• 审计技能目录或 Git 仓库中的恶意代码
• 将技能加入团队批准列表前进行审查
• 对已安装的技能进行事件后扫描

先行确认

审计前，请确认以下输入。若有任何信息未知或含糊不清，请先询问，不要自行假设：

• 目标路径 — 要扫描的技能文件或目录（所有扫描器的扫描对象）
• 扫描维度 — 代码执行 / 提示词注入 / 供应链（决定运行三个扫描器中的哪些）
• 严格模式 / 门禁阈值 — 是否任何 HIGH 级发现都会导致 FAIL（CI 门禁与建议性报告会产生不同判定）

停止规则：只询问最可能影响输出的 2-3 项。如果用户说“直接起草”，则继续，并在产物顶部列出你的假设。

工具

工具	用途	命令
code_scanner.py	扫描 Python 脚本中的 eval/exec、subprocess、网络外泄、凭据窃取、混淆和不安全导入	python scripts/code_scanner.py <target> --strict --json
prompt_injection_scanner.py	扫描 Markdown/文本中的提示词注入模式和隐藏指令	python scripts/prompt_injection_scanner.py <target> --strict --json
supply_chain_checker.py	检查导入项/requirements 中的仿冒包名、未固定版本和内联安装	python scripts/supply_chain_checker.py <target> --strict --json

所有工具都接受 target（文件或目录），并支持 --strict（任何 HIGH 级发现 → FAIL）和 --json。

参考资料

加载与任务匹配的参考资料——保持此文件精简，按需查阅详情：

• references/threat-model-and-patterns.md — 攻击向量威胁模型、信任边界、用于代码执行和提示词注入检测的完整正则表达式模式集，以及已知的规避技术。决定扫描内容或调整检测时请阅读。
• references/audit-output-and-workflow.md — 报告格式、判定标准（包括严格模式）、CI/CD 集成 YAML，以及手动审计清单。生成或解读审计结果时请阅读。
• references/quality-and-best-practices.md — 静态分析的局限性、常见陷阱、最佳实践、故障排除表和成功标准。发布或依赖审计结果前请阅读。

范围与限制

此技能涵盖：

• 对 Python、Bash、JavaScript 和 TypeScript 文件中的危险代码结构进行基于静态模式的检测
• 扫描技能包中所有 Markdown 文件的提示词注入
• 验证 requirements.txt 和 package.json 的依赖供应链
• 检查文件结构边界，包括符号链接、二进制文件、隐藏文件和超大载荷

此技能不涵盖：

• 运行时或动态分析——审计期间绝不会执行代码（运行时验证请参阅 skill-tester）
• 实时查询 CVE 数据库或实时漏洞信息源（主动 CVE 扫描请参阅 dependency-auditor）
• 网络分段、容器加固或云 IAM 策略等基础设施层面的安全控制（请参阅 ra-qm-team 中的 infrastructure-compliance-auditor）
• 针对 ISO 27001、SOC 2、GDPR 或其他监管标准的合规框架认证（请参阅 ra-qm-team 中的 information-security-manager-iso27001 和 gdpr-dsgvo-expert）

集成点

技能	集成方式	数据流
dependency-auditor	将审计结果用于标记依赖项的实时 CVE 扫描	安全审计报告 → dependency-auditor，用于实时漏洞查询
ci-cd-pipeline-builder	将审计工作流作为必需检查嵌入生成的 CI/CD 流水线	流水线模板 ← 此技能 CI/CD 部分中的审计任务 YAML
skill-tester	对通过静态分析的技能运行动态运行时测试	此技能的 PASS 判定 → skill-tester，用于行为验证
infrastructure-compliance-auditor	将审计范围从技能层扩展到基础设施层面的安全控制	技能审计结果 → 基础设施审计工具，用于审查全环境安全态势
env-secrets-manager	将凭据窃取检测结果与机密管理策略交叉核对	审计中的凭据访问标记 → env-secrets-manager，用于策略验证
pr-review-expert	将审计结果作为行内 PR 审查评论显示在标记的行上	审计报告中的行号引用 → PR 审查批注，便于开发者查看