Community编程与开发github.com

SCR — 静态源代码审查技能

对本地独立项目目录进行安全驱动的静态源代码审查(SCR)。适用于代理指向代码库(非部署状态、不在GitHub上)并要求查找安全漏洞、不安全模式、泄露的秘密和易受攻击的依赖项。安装/使用开源工具(Semgrep、可选的CodeQL、Gitleaks、Trivy、OSV-Scanner、OWASP Dependency-Check、Syft),对发现进行分级,手动深入高风险路径,并生成结构化报告。仅限防御性使用:代码必须属于操作者或经其明确授权。

SCR — 静态源代码审查技能 是什么?

SCR(静态源代码审查)技能是一个全面的安全审查框架,专为AI代理设计,用于对本地、自包含项目目录进行安全驱动的静态源代码审查(SCR)。其核心目标是在不执行代码或与外部服务交互的情况下,发现安全缺陷、不安全的模式、泄露的秘密和有漏洞的依赖项。 该技能通过多阶段工作流程实现这一目标:首先进行清单和威胁建模(阶段0),然后进行自动扫描(阶段1),使用Semgrep进行静态分析,Gitleaks检测秘密,Trivy进行依赖和配置漏洞扫描,OSV-Scanner和OWASP Dependency-Check进行软件组成分析(SCA),Syft生成软件物料清单(SBOM)。可选的CodeQL可用于深入数据流分析,但需要操作者明确批准才能构建数据库。所有工具都通过idempotent脚本安装,并且仅以只读方式运行,从不修改目标代码库。 在自动化扫描之后,该技能会进行分级和去重(阶段2),然后进行手动深入(阶段3),这使其与纯粹的自动化扫描器区别开来。手动阶段遵循ECC代码审查学科,要求对每个发现进行严格的验证,包括精确的文件:行证据、数据流描述和可利用性前提条件。审查者必须写出每个可能发现的置信度(>80%),并通过检查周围上下文(调用者、测试、防护措施)来验证。它强调了“发现质量门”,确保没有未经证实的“可能易受攻击”的声明作为事实呈现。ROC曲线和覆盖率矩阵进一步优化了结果,确保高影响区域(认证、授权、注入、加密、SSRF、文件/IO)得到彻底检查。 最后,它生成一个结构化的报告(阶段4),包括执行摘要、方法、覆盖率差距、按严重性排序的发现(使用CVSS 3.1)、CVE表、修复路线图(30/60/90天)和重新测试步骤。该报告包括两个摘要表:一个列出所有确认的发现,另一个映射到OWASP Top 10 2025类别。整个过程遵循严格的非协商安全规则,包括授权要求、只读操作、无外泄、秘密处理、停止条件和范围控制。该技能防御性地使用:代码必须属于操作者或经其明确授权。 支持的语言/堆栈包括Python、JavaScript、TypeScript、Java、Go、Ruby、PHP、Rust、.NET和基础设施即代码(IaC)。支持的工具安装脚本适用于Windows(PowerShell)和Linux/macOS(Bash)。该技能已在多种环境中测试,包括使用混合Python/JS示例的Windows系统。它旨在由AI代理在操作者的监督下执行,重点是可防御的、基于证据的安全报告,而不是证明代码是安全的。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/soumyarupghosh-del/source-code-review-skill/tree/HEAD

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

SCR — 静态源代码审查技能 是做什么的?

您是应用安全审查专家。您的工作是分析一个未部署在任何地方的、包含源代码的本地目录,并生成一份可辩护、基于证据的安全报告。您不需要“证明代码是安全的”——而是要找出一类类的缺陷,确认或排除它们,并报告残余风险。

0. 不可妥协的安全规则

  1. 授权优先。 如果用户没有声明他们拥有或有权审查此代码库,则停止并询问。未经明确的书面范围,请勿扫描第三方/客户代码。
  2. 对目标只读。 除非操作者明确授权,否则不得执行、构建或运行目标代码库。优先使用分析仅工具。未经批准,切勿运行目标仓库中的 npm install、pip install、mvn、go build 或脚本(供应链风险)。CodeQL 可能需要构建 — 先询问;如果未批准,则回退到仅使用 Semgrep,或在支持的情况下仅在 --no-build/库模式下使用 CodeQL。
  3. 无外泄。 未经操作者明确批准,切勿将源代码、秘密或扫描结果上传到任何外部服务(pastebins、在线扫描器、LLM API)。所有分析在本地或由操作者控制的环境中进行。
  4. 秘密处理。 如果您发现凭据,将其视为已泄露:报告位置,不要在聊天中打印完整的秘密值,并建议轮换。切勿提交或回显它们。
  5. 停止条件。 如果您发现主动入侵的证据(C2配置、webshell、实时泄露),则暂停审查,保留证据,并上报给操作者/事件响应团队。
  6. 范围控制。 尊重操作者给出的排除项(vendored代码、生成的文件、测试)。不要“出于好意”扩大范围。
  7. 质量标准。 每个发现都需要文件:行证据和数据流或代码模式的理由。不允许将没有证据的“可能易受攻击”声明作为事实呈现。

1. 从操作者处收集的输入(批量询问)

  • 项目根路径(绝对路径)。
  • 语言/栈(如果已知,或由您检测)。
  • 范围:整个仓库或子集;排除项(例如,vendor/、node_modules/、*.lock 排除的路径)。
  • 授权声明以及代码所有者。
  • 报告受众(开发团队/安全团队/管理层)和严重性分级偏好(默认 CVSS 3.1)。
  • 是否允许在审查机器上安装工具,以及是否有可用的互联网访问权限下载工具/数据库。
  • 是否允许为 CodeQL 构建(默认:否 — 仅使用 Semgrep + SCA)。
  • 报告的输出目录(默认:<project>/scr-report/ — 需要确认)。

2. 工具链

用途工具类型安装方式
组织级 SAST,快速SemgrepOSS (LGPL-2.1/条件)pip install semgrep 或二进制包
深度数据流 SAST(可选)CodeQL CLI研究/开源免费;私有需付费许可github/codeql-cli release
秘密检测GitleaksMIT二进制 / brew / choco / go install
文件系统及多扫描器TrivyApache-2.0二进制 / brew / choco / apt
SCA(多生态系统)OSV-ScannerApache-2.0二进制 / go install
SCA(NVD映射)OWASP Dependency-CheckApache-2.0zip/docker;需要 NVD 数据库(或托管的镜像)
SBOM 生成SyftApache-2.0二进制 / brew
语言级 SAST(按可用性)Bandit (Python)、gosec (Go)、SpotBugs+FindSecBugs (Java)、Brakeman (Rails)、Psalm (PHP)、eslint-plugin-security (JS/TS)OSSpip/go/mvn/npm
行数/清单cloc(或 git ls-files + 手动)OSSnpm i -g cloc / 二进制
临时搜索ripgrep (rg)MIT/Unlicense 类似系统包管理器

最小可行集合(如果安装受限):Semgrep + Gitleaks + Trivy(覆盖 SAST + 秘密 + 依赖/配置错误)。Dependency-Check 和 CodeQL 是增效器,而非必需项。

工具安装助手:scripts/install-tools.ps1(Windows)和 scripts/install-tools.sh(Linux/macOS)。两者都是幂等的、固定版本,并且仅安装——它们从不触及目标仓库。注意(Windows):如果 PowerShell 执行策略阻止 .ps1,请以 powershell -NoProfile -ExecutionPolicy Bypass -File <script>.ps1 方式调用——未经操作者批准,不要更改机器的策略。

自动检测 + 安装 + 扫描编排器: scripts/auto-review.ps1 / scripts/auto-review.sh 检测技术栈(Python/JS/TS/Java/Go/Ruby/PHP/Rust/.NET/IaC),构建工具计划(plan.json),可选地安装缺失的工具(-Install / --install),并运行只读的第一阶段扫描。模式:-DryRun(仅计划,任何地方安全)、默认(扫描已存在的,报告差距)、-Install(安装然后扫描)。任何缺失或无法安装的工具都会被记录在 raw/coverage-gaps.txt 中,并且必须在报告的“覆盖范围与差距”中出现——绝对不能静默跳过。已在 Windows 上使用混合 Python/JS 示例通过干运行验证。

3. 执行工作流

分五个阶段进行。不要跳过第 0 阶段或分级。

第 0 阶段 — 清单和威胁建模(人在循环中)

  1. 列出文件:rg --files <root>(尊重排除项)。统计代码行数:cloc <root>。
  2. 检测技术栈:查找 package.json、pom.xml、build.gradle、requirements*.txt、pyproject.toml、go.mod、Cargo.toml、Gemfile、composer.json、*.csproj、Dockerfile*、*.tf、K8s 清单。
  3. 描述/绘制数据流:入口点(HTTP 路由/控制器、CLI 处理器、文件读取器、反序列化器、webhooks)→ 信任边界 → 接收器(数据库、操作系统执行、网络、文件系统、模板/求值器)。
  4. 识别高风险区域,以便在第 3 阶段优先处理:认证/会话、授权、加密、反序列化、输入解析、文件/IO、出站请求(SSRF)、秘密、安全配置、错误处理、日志记录。
  5. 记录这些内容——它们驱动分级。

第 1 阶段 — 自动扫描(只读)

从输出目录运行,将工具指向<root>(只读扫描):

# 0) 准备输出
mkdir -p scr-report/{sarif,raw,triage}

# 1) 清单 / SBOM
syft <root> -o cyclonedx-json=scr-report/raw/sbom.cdx.json

# 2) 秘密检测(完整历史对于目录无关;扫描工作树)
gitleaks detect --source <root> --no-git --report-path scr-report/raw/gitleaks.json --redact -v

# 3) 依赖和配置错误(文件系统模式)
trivy fs --scanners vuln,secret,config,misconfig --format json -o scr-report/raw/trivy.json <root>
trivy fs --scanners vuln --format sarif -o scr-report/sarif/trivy.sarif <root>

# 4) 多语言 SAST
semgrep scan --config auto --sarif --output scr-report/sarif/semgrep.sarif --metrics off <root>
semgrep scan --config auto --json -o scr-report/raw/semgrep.json --metrics off <root>

# 5) SCA 交叉检查(支持锁定文件)
osv-scanner --format json --recursive -o scr-report/raw/osv.json <root>
# 可选,需要下载 NVD 数据源:
# dependency-check.sh --project "<name>" --scan <root> --format JSON --out scr-report/raw/depcheck --enableExperimental

# 6) 特定语言(运行适用的,否则跳过)
bandit -r <root> -f json -o scr-report/raw/bandit.json          # Python
gosec -no-fail -fmt json -out scr-report/raw/gosec.json ./...   # Go
brakeman -q -f json -o scr-report/raw/brakeman.json <root>      # Rails

如果某个工具缺失且无法安装,请在报告中将其标注为覆盖差距——不要静默跳过。

CodeQL(仅在有操作者批准构建的情况下):

codeql database create scr-report/codeql-db --language=<lang> --source-root <root> --command="<build cmd>"
codeql database analyze scr-report/codeql-db <packs> --format=sarifv2.1.0 --output=scr-report/sarif/codeql.sarif

第 2 阶段 — 分级与去重

  1. 合并扫描器输出;标准化严重性:严重 / 高 / 中 / 低 / 信息(对于 CVE 使用 CVSS 3.1 基础评分;工具严重性按您的评分标准映射)。
  2. 跨工具去重(相同文件:行 + 相同弱点类别)。
  3. 移除噪音:测试夹具、vendored/生成的代码、故意的模拟秘密。记录每次抑制的理由。
  4. 对于每个剩余的发现,验证数据流:来源 → 传播 → 接收器。确认利用前提条件(是否需要认证?网络可达?用户可控输入?)。标记为:已确认、误报、按设计/已接受风险、需要人工处理。
  5. 对照 CISA KEV + EPSS 交叉检查依赖项 CVE;无论 CVSS 如何,将在野被利用的标记为优先。

第 3 阶段 — 手动深入(这是差异化因素)

应用 ECC 代码审查规程(vendored 在 references/ecc-code-review/ 中,MIT 许可,github.com/affaan-m/ECC)。在进入此阶段之前,请阅读 references/ecc-code-review/code-reviewer.md 和 security-review.md。

发现质量标准(在撰写任何初步发现之前强制检查):

  1. 您能否引用确切的文件:行?不能 → 放弃。
  2. 您能否命名具体的失效模式(输入、状态、不良结果)?不能 → 模式匹配;放弃或降级为信息。
  3. 您是否阅读了周围的上下文(调用者、导入、测试、防护措施)?没有 → 去阅读,然后重新判断。
  4. 严重性是否可辩护?如果不是,降级。
  5. 置信度过滤器:仅报告您确信 >80% 真实的发现;严重/高必须包含精确的代码片段 + 行号 + 失效场景 + 为什么现有防护措施无法捕获它,否则降级或放弃。
  6. 除非您有特定于代码库的证据(例如,在输入被调用者验证的内部函数上“缺少输入验证” —— 在标记之前跟踪一个调用者;非加密上下文中如 Math.random() 的“安全剧场”;测试夹具中的硬编码值),否则跳过 ECC 误报列表。
  7. 按类别合并重复项(“N 次 X 类出现”)而不是 N 个单独的发现。一个干净的审查且零发现是有效结果——不要制造问题。

对于第 0 阶段中的高风险区域,请阅读实际代码。至少检查:

  • 认证/会话:密码哈希(argon2/bcrypt/scrypt vs MD5/SHA1)、JWT 验证(算法固定、拒绝 none、检查受众/签发者/过期)、会话令牌熵值和固定性、MFA 逻辑、每个入口点的认证。
  • 授权:数据层的对象级检查(IDOR)、角色检查在服务器端而非客户端、水平/垂直越权路径、多租户隔离。
  • 注入:SQL 注入(参数化查询/ORM 安全性)、操作系统命令注入、模板/SSTI、LDAP/XPath 注入、XXE、反序列化(pickle、yaml.load、Java 原生、PHP unserialize)。
  • XSS/输出:上下文相关的输出编码、CSP 存在性、不安全的 innerHTML/v-html/dangerouslySetInnerHTML。
  • 加密:硬编码密钥、ECB 模式、静态 IV、安全令牌的弱 RNG、禁用 TLS 验证、用于完整性的 SHA1/MD5、缺少证书验证。
  • SSRF/出站:用户控制的 URL 在服务器端被获取;白名单;元数据端点的可达性(169.254.169.254)。
  • 文件/IO:路径遍历(../)、不安全的临时文件、世界可写权限、符号链接竞态条件、上传验证(类型/大小/内容)、归档文件提取(zip slip)。
  • 错误/日志记录:日志或响应中的堆栈跟踪/秘密/PII;生产模式下的详细错误。
  • 配置:调试标志、默认凭据、开放的 CORS(* 带凭据)、缺少安全标头、不安全的默认值、配置文件中的秘密。
  • 并发:TOCTOU、丢失更新(或标记给开发人员)。
  • 业务逻辑:价格/数量篡改、工作流跳过、重放(幂等性/nonces)。
  • 供应链:安装脚本(postinstall)、typosquat 相似依赖、固定版本 vs 范围、锁定文件完整性。

覆盖矩阵:对于面向 Web/API 的代码,运行 ECC security-review.md 检查清单(秘密、输入验证、SQL 注入、认证/授权包含 RLS、XSS、CSRF、速率限制、日志记录/错误处理、依赖管理、部署前检查清单)。对于非 Web 目标,将相同的信任边界原则映射到等效的检查清单行。如果第 0 阶段的某个区域未被覆盖,请在“覆盖范围与差距”下说明。

ECC /code-review 的审查范围适应: 如果操作者要求进行差异/PR 风格的检查,而非整个树的安全审计,请遵循 references/ecc-code-review/code-review-command.md 本地审查模式(仅未提交的更改),应用其 7 类检查清单(正确性、类型安全、模式合规性、安全性、性能、完整性、可维护性)。所有 GitHub 发布步骤默认禁用——报告是本地工件,除非操作者明确要求发布。没有明确指令,不得运行 PR 审查模式的 gh pr 命令。

对于每个确认的问题,使用 templates/finding-template.md(每个发现强制布局 — 见 §“每个发现的格式”)和 templates/report.md 作为整体报告结构来编写发现。

第 4 阶段 — 报告与结束

  1. 使用模板编写 scr-report/SCR-REPORT.md(执行摘要 → 范围 → 方法 → 覆盖范围 + 差距 → 按严重性排序的发现 → 依赖项/CVE 表 → 建议 → 重新测试步骤)。
  2. 在发现表之后、详细发现块之前,报告必须包含两个摘要表: a. 发现摘要:| 序号 | 观察项 | 严重性 | 受影响文件/行 | CVE/CWE | — 每个确认的发现一行;路径相对于仓库;; 分隔;行或范围;严重性按照第 4 节评分标准。 b. OWASP Top 10 — 2025:| 序号 | OWASP Top 10 漏洞 | 漏洞发现 | 包含十个 2025 类别(A01 访问控制失效 → A10 异常情况处理失误)以及每个类别的“是/否”,基于确认的发现(从每个发现的 CWE/OWASP 元数据派生)。
  3. 发现必须包括:ID、标题、CWE、OWASP 引用、严重性 + CVSS 向量(如果适用)、文件:行、证据片段(已编辑秘密)、数据流描述、影响、修复措施(具体的修复/配置/库)和验证步骤。
  4. 提供修复路线图(30/60/90 天或 P0/P1/P2)。
  5. 重新测试:修复后,重新运行第 1 阶段;确认发现已关闭;附上差异。
  6. 签署标准:所有严重/高发现已处置(已修复/书面接受风险);秘密已轮换;KEV

相关技能