xfire — 多智能体对抗性安全审查

多个智能体。一个结论。零盲区。

xfire 将您的代码独立发送给 3 个 AI 智能体（Claude、Codex、Gemini），随后启动对抗性辩论机制，让它们相互质询彼此的发现。只有在经过指控、辩护和裁判裁定后仍被确认的问题，才会进入最终报告。

适用场景

当用户提出以下任一请求时，请调用 xfire：

• “对这个 PR 做安全审查”
• “找出这段代码中的漏洞”
• “审计这个仓库的安全问题”
• “运行一次安全扫描”
• “分析这个变更的潜在安全风险”
• “检查这个拉取请求是否存在漏洞”
• “进行代码安全审查”
• “对代码库做渗透测试”
• “为这次变更建立威胁模型”

请勿使用 xfire 进行：

• 一般代码质量或风格审查（请使用代码检查工具）
• 性能分析
• 依赖项许可证审计
• 非安全相关的功能测试

前置条件

• Python 3.11+
• 安装命令：pip install xfire
• 至少配置一个 AI 智能体的 CLI 工具或 API 密钥：

配置步骤

# 在当前仓库初始化配置
xfire init

# 测试智能体连接性
xfire test-llm

# 设置智能体凭证
xfire auth login --provider claude
xfire auth login --provider codex
xfire auth login --provider gemini

命令列表

核心分析功能

analyze-pr — 分析 GitHub 拉取请求

xfire analyze-pr --repo owner/repo --pr 123

analyze-diff — 分析本地变更或暂存的修改

xfire analyze-diff --staged --repo-dir .
xfire analyze-diff --patch changes.patch --repo-dir .
xfire analyze-diff --commit f1877d3 --repo-dir /path/to/repo
xfire analyze-diff --base main --head feature-branch
xfire analyze-diff --commit f1877d3 --thinking --repo-dir /path/to/repo

code-review — 全代码库安全审计

xfire code-review /path/to/repo

scan — 基线感知的增量扫描

xfire scan . --base main --head feature-branch
xfire scan . --since-last-scan
xfire scan . --last 5
xfire scan . --range abc123~1..abc123
xfire scan . --since 2026-01-01
xfire scan . --diff changes.patch

Skill: xfire 安全代码审查

Version: 0.1.2

Chunk: 2/3

baseline — 构建持久化的仓库基线上下文

xfire baseline /path/to/repo
xfire baseline . --force

输出

report — 从保存的 JSON 结果重新生成报告

xfire report --input xfire-results.json --format sarif

debates — 重播对抗性辩论对话记录

xfire debates --input xfire-results.json

设置与诊断

init — 初始化 xfire 配置

xfire init

在当前目录创建 .xfire/config.yaml。无参数。

config-check — 验证配置

xfire config-check --repo-dir .

test-llm — 测试代理连接性

xfire test-llm
xfire test-llm --agents claude --mode api
xfire test-llm --thinking --prompt "What is 2+2?"

auth login — 设置代理凭证

xfire auth login --provider claude
xfire auth login --provider codex
xfire auth login --provider gemini

auth status — 显示凭证状态

xfire auth status

无参数。显示所有服务提供商凭证状态的表格。

演示

demo — 运行固定用例或 UI 演示场景

xfire demo --ui
xfire demo --ui --scenario both_accept
xfire demo --fixture auth_bypass_regression

配置

xfire 会在仓库根目录查找 .xfire/config.yaml（可通过 XFIRE_CONFIG_PATH 覆盖）。

优先级顺序：CLI 参数 > 环境变量 > config.yaml > 默认值。

repo:
  purpose: ""                          # 描述你的应用功能
  intended_capabilities: []            # 预期能力
  sensitive_paths:                     # 需要额外审查的路径
    - auth/
    - payments/
    - migrations/

analysis:
  context_depth: deep                  # shallow | medium | deep
  max_related_files: 20
  include_test_files: true

agents:
  claude:
    enabled: true
    mode: cli                          # cli | api
    cli_command: claude
    model: claude-sonnet-4-20250514
    api_key_env: ANTHROPIC_API_KEY
    timeout: 600
  codex:
    enabled: true
    mode: cli
    cli_command: codex
    model: o3-mini
    api_key_env: OPENAI_API_KEY
    timeout: 300
  gemini:
    enabled: true
    mode: cli
    cli_command: gemini
    model: gemini-2.5-pro
    api_key_env: GOOGLE_API_KEY
    timeout: 300

  debate:
    role_assignment: evidence          # evidence | rotate | fixed
    fixed_roles:
      prosecutor: claude
      defense: codex
      judge: gemini
    defense_preference: [codex, claude, gemini]
    judge_preference: [codex, gemini, claude]
    max_rounds: 2
    require_evidence_citations: true
    min_agents_for_debate: 2

  skills:
    code_navigation: true
    data_flow_tracing: true
    git_archeology: true
    config_analysis: true
    dependency_analysis: true
    test_coverage_check: true

severity_gate:
  fail_on: high                        # CI 失败的最低严重级别
  min_confidence: 0.7
  require_debate: true

suppressions: []

fast_model:
  provider: claude
  model: claude-haiku-4-5-20251001
  api_key_env: ANTHROPIC_API_KEY
  cli_command: claude
  cli_args: [--output-format, json]
  timeout: 60

输出格式

CI/CD 集成

GitHub Actions

name: xfire 安全评审
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  security-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-python@v5
        with:
          python-version: "3.11"

      - run: pip install xfire

      - name: 运行 xfire 安全评审
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
        run: |
          xfire analyze-pr \
            --repo ${{ github.repository }} \
            --pr ${{ github.event.pull_request.number }} \
            --format sarif \
            --output results.sarif \
            --silent

      - name: 上传 SARIF
        if: always()
        uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: results.sarif

工作原理

1. 上下文构建 — 解析 PR 差异、仓库内容，收集相关文件、Git 历史、配置和依赖信息
2. 意图推断 — 使用快速模型（Haiku）理解仓库目的、信任边界和安全控制机制
3. 独立评审 — 将上下文并行发送给每个启用的 AI 代理（Claude、Codex、Gemini）
4. 发现提取 — 将各代理返回结果统一为结构化发现，包含严重性、置信度和 CWE 编号
5. 对抗辩论 — 每个发现进入“起诉 → 辩护 → 裁判”流程，代理就其有效性展开辩论
6. 最终裁决与去重 — 裁判发布最终判定；跨代理发现进行去重与合并
7. 报告生成 — 输出 Markdown、JSON 或 SARIF 格式的最终报告，并根据严重性设置 CI 失败阈值

环境变量

局限性

• 至少需要配置并可达一个 AI 代理（Claude、Codex 或 Gemini）
• CLI 模式要求对应代理命令行工具已安装且在 PATH 中
• 不能替代人工渗透测试或正式安全审计
• 发现结果依赖 AI 模型能力，可能存在误报或遗漏细微漏洞
• 大型仓库可能超出代理上下文限制；可使用 --max-files 限制范围
• 不扫描二进制文件、编译产物或容器镜像
• 对抗辩论质量随代理数量提升；单代理模式跳过对抗阶段