它到底是什么

/security-review 是 Claude Code 的一个内置捆绑 Skill（bundled skill），可在会话中直接用斜杠触发。它对当前 git 分支上的**待处理变更（pending changes）**执行以安全为核心的代码审查，识别具有真实利用路径的高置信度漏洞，并输出带有文件位置、严重等级、漏洞类别、利用场景和修复建议的结构化报告。

该 Skill 的底层 prompt 文件（security-review.md）由 Anthropic 在 anthropics/claude-code-security-review 仓库中维护并开源。

怎么触发 / 怎么使用

1. 会话内直接调用

/security-review

在 Claude Code 会话中输入后，Claude 会对当前分支与基线的 diff 展开分析，无需附加参数。

2. 追加自定义指令

Skill 接受 invocation 时传入的文本作为补充上下文：

/security-review 重点关注 API 认证逻辑，忽略前端校验

3. GitHub Actions 自动化（CI/CD 集成）

在 .github/workflows/security.yml 中添加：

name: Security Review

permissions:
  pull-requests: write
  contents: read

on:
  pull_request:

jobs:
  security:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.event.pull_request.head.sha || github.sha }}
          fetch-depth: 2

      - uses: anthropics/claude-code-security-review@main
        with:
          comment-pr: true
          claude-api-key: ${{ secrets.CLAUDE_API_KEY }}

GitHub Actions 模式会在 PR 打开时自动触发，并将发现以 inline 评论的形式写回 PR。

检查范围与分析方法

Skill 内部将分析分为三个阶段：

1. 仓库上下文研究 — 识别项目使用的安全框架、已有的安全模式、威胁模型
2. 对比分析 — 将新代码与现有安全模式进行横向对比
3. 漏洞评估 — 追踪数据流、定位注入点、检查反序列化路径

检查的漏洞类别

明确不检查的内容

• Denial of Service（DoS）/ 资源耗尽
• 磁盘上存储的 secrets（由独立工具处理）
• 速率限制问题
• 过时依赖库的已知漏洞（CVE 扫描）
• 客户端 JS/TS 的权限校验

置信度过滤

Skill 对每条发现打置信度分（1–10 内部量表），仅上报置信度 ≥ 8 的条目，低于阈值的发现由独立的误报过滤模块 findings_filter.py 过滤掉。参考区间：

输出格式

每条发现的 markdown 结构包含：

• 文件路径 + 行号
• 严重等级：HIGH / MEDIUM / LOW
• 漏洞类别
• 描述 + 利用场景
• 修复建议

保存 / 配置 / 集成

自定义 Skill prompt

将官方仓库中的 .claude/commands/security-review.md 复制到项目的 .claude/commands/ 目录后修改，即可覆盖默认行为（例如增加组织特定的过滤规则）：

mkdir -p .claude/commands
curl -o .claude/commands/security-review.md \
  https://raw.githubusercontent.com/anthropics/claude-code-security-review/main/.claude/commands/security-review.md

GitHub Actions 配置参数

跟同类原语对比

经典使用场景

• 提交前检查：在 git push 前运行 /security-review，拦截引入新接口时带入的注入漏洞
• PR 自动门控：在 CI 中启用 GitHub Actions 集成，对外部贡献者的 PR 自动扫描后再人工合并
• 新框架迁移：将认证逻辑从一个框架迁移到另一个框架时，用 /security-review 验证新实现是否引入了会话或 JWT 处理缺陷
• 自定义规则落地：将组织安全策略写入 .claude/commands/security-review.md，让 Skill 按团队标准过滤和上报

常见坑

1. 未在 git 仓库中运行：Skill 依赖 git diff 获取待分析内容，在非 git 目录下调用会报错或无输出。
2. GitHub Actions 对外部 PR 存在 prompt injection 风险：官方 README 明确标注该 Action 未针对 prompt injection 加固（原文：NOT hardened against prompt injection attacks）；据此推论，恶意代码提交者可能在代码注释等位置嵌入指令操控输出（注："代码注释"为具体攻击向量的推论，官方未明示）；官方建议将工作流配置为"仅在维护者审阅后才对外部贡献者运行"。
3. DoS / 速率限制类问题不会上报：这些类型被硬编码排除，若团队需要检查资源耗尽问题，需在自定义 prompt 中额外添加或使用其他专项工具。
4. 分析范围是 diff，不是全量代码库：只有当前分支的变更会被审查，历史遗留漏洞不在检测范围内。

来源

• Extend Claude with skills — code.claude.com
• anthropics/claude-code-security-review — GitHub
• security-review.md（Skill prompt 原文） — GitHub
• Automated Security Reviews in Claude Code — support.claude.com