SuperAPI AI 工具集

security-scan

安全与审计

查看项目

更新于 10-16 07:28

技能介绍

用途:security-scan 用于对整个代码仓库或指定范围(路径、包、文件夹、子模块)执行标准、单次的安全审计,且没有 diff 可供审查。它运行一次独立的通用审计,并行调查有源码依据的安全问题,验证发现,并生成既有的 Codex Security 报告。

主要能力:解析仓库与请求范围,读取继承的 SECURITY.md 指引与可选的 CODEX_SECURITY_KNOWLEDGE_BASE;保留用户上下文与威胁模型,产出语义范围、威胁模型、发现项与覆盖率,并保留每个发现的源码证据、定级严重性、置信度、根因、验证、攻击路径与诚实的覆盖说明。可按宿主提供的工作进程并行审阅,并处理降级工作进程的回退。

使用方式:桌面扫描时加载 references/desktop-scan.md,否则无头运行。若 SDK 已提供 CODEX_SECURITY_SCAN_ID 和 CODEX_SECURITY_SCAN_DIR,则使用该已登记的扫描与目录,不要另启扫描或自行收尾。若宿主提供 start_codex_security_standard_scan,则使用其 scanId、scanDir 和 handoffClaimToken。先读取 ../../references/scan-prologue.md 并运行 security_scan 能力预检,返回 ready 后再开始源码审阅与工作进程。随后读取 ../../references/core-scan.md 执行完整审计。用户提供的安全上下文(含 URL)按不可信数据分析,仅在用户明确授权时读取一次指定 URL,不跟随其他链接,源码审阅与工作进程保持离线。

输出与限制:需存在三份规范 JSON 文件(scan-manifest.json、findings.json、coverage.json)。SDK 拥有的扫描不自行收尾、封存或生成 report.md、threatmodel.md;其他宿主扫描调用 complete_codex_security_scan 一次;纯提示无头扫描运行 finalize_scan_contract.py。除 SDK 路径外,仅在完成成功且 report.md 存在后返回,不手写报告。发现项需经一次验证。限定在标准工作流内,不调用 Deep 或 diff 相关参考与工具。Windows 下可用 PowerShell 绑定范围,且不修改 CODEX_SECURITY_TARGET_PATHS_FILE 值。使用真实令牌计数并如实标注部分测量或不可用情况。费用、价格与具体平台支持未在资料中提供。