Communitygithub.com

bg-szy/TOP-SKILLS

Richtet Ruzzy ein und führt es aus – den coverage-gesteuerten Ruby-Fuzzer von Trail of Bits und den einzigen produktionsreifen Fuzzer für diese Sprache. Deckt Harness-Struktur, Fuzzing von reinem Ruby und nativen C-Erweiterungen in Gems sowie Sanitizer-Builds ab. Verwenden Sie ihn zum Fuzz-Testen einer Ruby-Bibliothek oder eines Gems, zum Testen einer Ruby-C-Erweiterung auf Speichersicherheit oder wenn Sie fragen, wie man Ruby überhaupt fuzzt.

Was ist TOP-SKILLS?

Ruzzy ist der einzige produktionsreife, coverage-gesteuerte Fuzzer für Ruby, der auf libFuzzer basiert und sowohl reines Ruby als auch Ruby-C-Erweiterungen mit umfassender Sanitizer-Unterstützung fuzzen kann. Das Skill richtet eine vollständige Fuzzing-Umgebung ein, einschließlich Installation mit spezifischen Compiler-Flags, und zeigt, wie man Harnesses schreibt – mit einem Tracer-Skript für reines Ruby oder einem einheitlichen Testtreiber für C-Erweiterungen. Es integriert AddressSanitizer und UndefinedBehaviorSanitizer zur Erkennung von Speicherkorruption und undefiniertem Verhalten und gibt detaillierte Anleitungen für den Kampagnenstart, das Reproduzieren von Abstürzen und die Interpretation der Ausgabe. Das Skill unterstützt Linux x86-64 und AArch64/ARM64 und bietet Docker-Lösungen für macOS und Windows sowie Verweise auf verwandte Technik-Skills wie Harness-Schreiben und Sanitizer-Konfiguration.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/skills/ruzzy

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Ruzzy

Ruzzy ist ein coverage-gesteuerter Fuzzer für Ruby, der auf libFuzzer basiert. Er ermöglicht das Fuzzen sowohl von reinem Ruby-Code als auch von Ruby-C-Erweiterungen mit Sanitizer-Unterstützung zur Erkennung von Speicherkorruption und undefiniertem Verhalten.

Wann verwenden

Ruzzy ist derzeit der einzige produktionsreife coverage-gesteuerte Fuzzer für Ruby.

Wählen Sie Ruzzy, wenn:

  • Sie Ruby-Anwendungen oder -Bibliotheken fuzzen möchten
  • Sie Ruby-C-Erweiterungen auf Speichersicherheitsprobleme testen möchten
  • Sie coverage-gesteuertes Fuzzing für Ruby-Code benötigen
  • Sie mit Ruby-Gems arbeiten, die native Erweiterungen haben

Schnellstart

Umgebung einrichten:

export ASAN_OPTIONS="allocator_may_return_null=1:detect_leaks=0:use_sigaltstack=0"

Test mit dem mitgelieferten Beispiel:

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby -e 'require "ruzzy"; Ruzzy.dummy'

Dies sollte schnell einen Absturz finden, der zeigt, dass Ruzzy korrekt funktioniert.

Installation

Plattformunterstützung

Ruzzy unterstützt Linux x86-64 und AArch64/ARM64. Verwenden Sie für macOS oder Windows das Dockerfile oder die Entwicklungsumgebung.

Voraussetzungen

  • Linux x86-64 oder AArch64/ARM64
  • Aktuelle Version von clang (getestet ab 14.0.0, neueste Version empfohlen)
  • Ruby mit installiertem gem

Installationsbefehl

Installieren Sie Ruzzy mit clang-Compiler-Flags:

MAKE="make --environment-overrides V=1" \
CC="/pfad/zu/clang" \
CXX="/pfad/zu/clang++" \
LDSHARED="/pfad/zu/clang -shared" \
LDSHAREDXX="/pfad/zu/clang++ -shared" \
    gem install ruzzy

Erklärung der Umgebungsvariablen:

  • MAKE: Überschreibt make, um nachfolgende Umgebungsvariablen zu respektieren
  • CC, CXX, LDSHARED, LDSHAREDXX: Stellen sicher, dass die richtigen clang-Binärdateien für die neuesten Funktionen verwendet werden

Fehlerbehebung bei der Installation

Wenn die Installation fehlschlägt, aktivieren Sie die Debug-Ausgabe:

RUZZY_DEBUG=1 gem install --verbose ruzzy

Überprüfung

Überprüfen Sie die Installation, indem Sie das Beispiel aus dem Schnellstart ausführen.

Schreiben eines Harness

Fuzzing von reinem Ruby-Code

Reines Ruby-Fuzzing erfordert aufgrund der Implementierung des Ruby-Interpreters zwei Skripte.

Tracer-Skript (test_tracer.rb):

# frozen_string_literal: true

require 'ruzzy'

Ruzzy.trace('test_harness.rb')

Harness-Skript (test_harness.rb):

# frozen_string_literal: true

require 'ruzzy'

def fuzzing_target(input)
  # Ihr zu fuzzender Code hier
  if input.length == 4
    if input[0] == 'F'
      if input[1] == 'U'
        if input[2] == 'Z'
          if input[3] == 'Z'
            raise
          end
        end
      end
    end
  end
end

test_one_input = lambda do |data|
  fuzzing_target(data)
  return 0
end

Ruzzy.fuzz(test_one_input)

Ausführen mit:

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby test_tracer.rb

Fuzzing von Ruby-C-Erweiterungen

C-Erweiterungen können mit einer einzigen Harness-Datei gefuzzt werden, ohne Tracer.

Beispiel-Harness für msgpack (fuzz_msgpack.rb):

# frozen_string_literal: true

require 'msgpack'
require 'ruzzy'

test_one_input = lambda do |data|
  begin
    MessagePack.unpack(data)
  rescue Exception
    # Wir suchen nach Speicherkorruption, nicht nach Ruby-Ausnahmen
  end
  return 0
end

Ruzzy.fuzz(test_one_input)

Ausführen mit:

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby fuzz_msgpack.rb

Harness-Regeln

TunNicht tun
Ruby-Ausnahmen abfangen, wenn Sie C-Erweiterungen testenRuby-Ausnahmen den Fuzzer abstürzen lassen
return 0 aus der test_one_input-Lambda-FunktionAndere Werte zurückgeben
Harness deterministisch haltenZufälligkeit oder zeitbasierte Logik verwenden
Tracer-Skript für reines Ruby verwendenTracer für reinen Ruby-Code überspringen

Siehe auch: Detaillierte Techniken zum Schreiben von Harnesses, Muster für die Verarbeitung komplexer Eingaben und fortgeschrittene Strategien finden Sie im Technik-Skill fuzz-harness-writing.

Kompilierung

Installieren von Gems mit Sanitizern

Wenn Sie Ruby-Gems mit C-Erweiterungen zum Fuzzen installieren, kompilieren Sie mit Sanitizer-Flags:

MAKE="make --environment-overrides V=1" \
CC="/pfad/zu/clang" \
CXX="/pfad/zu/clang++" \
LDSHARED="/pfad/zu/clang -shared" \
LDSHAREDXX="/pfad/zu/clang++ -shared" \
CFLAGS="-fsanitize=address,fuzzer-no-link -fno-omit-frame-pointer -fno-common -fPIC -g" \
CXXFLAGS="-fsanitize=address,fuzzer-no-link -fno-omit-frame-pointer -fno-common -fPIC -g" \
    gem install <gem-name>

Build-Flags

FlagZweck
-fsanitize=address,fuzzer-no-linkAddressSanitizer und Fuzzer-Instrumentierung aktivieren
-fno-omit-frame-pointerVerbesserung der Stack-Trace-Qualität
-fno-commonBessere Kompatibilität mit Sanitizern
-fPICPositionsunabhängiger Code für Shared Libraries
-gDebug-Symbole einschließen

Ausführen von Kampagnen

Umgebungseinrichtung

Setzen Sie vor dem Start einer Fuzzing-Kampagne ASAN_OPTIONS:

export ASAN_OPTIONS="allocator_may_return_null=1:detect_leaks=0:use_sigaltstack=0"

Erklärung der Optionen:

  1. allocator_may_return_null=1: Überspringt häufige, wenig folgenreiche Allokationsfehler (DoS)
  2. detect_leaks=0: Der Ruby-Interpreter verliert Daten – ignorieren Sie dies vorerst
  3. use_sigaltstack=0: Ruby empfiehlt, sigaltstack mit ASan zu deaktivieren

Grundlegender Aufruf

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby harness.rb

Hinweis: LD_PRELOAD wird für die Sanitizer-Injektion benötigt. Exportieren Sie es nicht, da es andere Programme stören kann.

Mit Korpus

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby harness.rb /pfad/zu/korpus

Übergeben von libFuzzer-Optionen

Alle libFuzzer-Optionen können als Argumente übergeben werden:

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby harness.rb /pfad/zu/korpus -max_len=1024 -timeout=10

Die vollständige Referenz finden Sie unter libFuzzer-Optionen.

Reproduzieren von Abstürzen

Führen Sie einen Absturzfall erneut aus, indem Sie die Absturzdatei übergeben:

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby harness.rb ./crash-253420c1158bc6382093d409ce2e9cff5806e980

Interpretieren der Ausgabe

AusgabeBedeutung
INFO: Running with entropic power scheduleFuzzing-Kampagne gestartet
ERROR: AddressSanitizer: heap-use-after-freeSpeicherkorruption erkannt
SUMMARY: libFuzzer: fuzz target exitedRuby-Ausnahme aufgetreten
artifact_prefix='./'; Test unit written to ./crash-*Absturz-Eingabe gespeichert
Base64: ...Base64-Kodierung der Absturz-Eingabe

Sanitizer-Integration

AddressSanitizer (ASan)

Ruzzy enthält eine vorkompilierte AddressSanitizer-Bibliothek:

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby harness.rb

ASan wird verwendet zur Erkennung von:

  • Heap-Pufferüberläufen
  • Stack-Pufferüberläufen
  • Use-after-free
  • Double-free
  • Speicherlecks (in Ruzzy standardmäßig deaktiviert)

UndefinedBehaviorSanitizer (UBSan)

Ruzzy enthält auch UBSan:

LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::UBSAN_PATH') \
    ruby harness.rb

UBSan wird verwendet zur Erkennung von:

  • Vorzeichenbehaftetem Integer-Überlauf
  • Nullzeiger-Dereferenzierungen
  • Fehlausgerichteten Speicherzugriffen
  • Division durch Null

Häufige Sanitizer-Probleme

ProblemLösung
Warnungen wegen Lecks im Ruby-InterpreterASAN_OPTIONS=detect_leaks=0 verwenden
Konflikte mit SigaltstackASAN_OPTIONS=use_sigaltstack=0 verwenden
Spam durch AllokationsfehlerASAN_OPTIONS=allocator_may_return_null=1 verwenden
LD_PRELOAD stört WerkzeugeNicht exportieren; inline mit ruby-Befehl setzen

Siehe auch: Detaillierte Konfiguration der Sanitizer, häufige Probleme und erweiterte Flags finden Sie in den Technik-Skills address-sanitizer und undefined-behavior-sanitizer.

Beispiele aus der Praxis

Beispiel: msgpack-ruby

Fuzzing des msgpack MessagePack-Parsers auf Speicherkorruption.

Installation mit Sanitizern:

MAKE="make --environment-overrides V=1" \
CC="/pfad/zu/clang" \
CXX="/pfad/zu/clang++" \
LDSHARED="/pfad/zu/clang -shared" \
LDSHAREDXX="/pfad/zu/clang++ -shared" \
CFLAGS="-fsanitize=address,fuzzer-no-link -fno-omit-frame-pointer -fno-common -fPIC -g" \
CXXFLAGS="-fsanitize=address,fuzzer-no-link -fno-omit-frame-pointer -fno-common -fPIC -g" \
    gem install msgpack

Harness (fuzz_msgpack.rb):

# frozen_string_literal: true

require 'msgpack'
require 'ruzzy'

test_one_input = lambda do |data|
  begin
    MessagePack.unpack(data)
  rescue Exception
    # Wir suchen nach Speicherkorruption, nicht nach Ruby-Ausnahmen
  end
  return 0
end

Ruzzy.fuzz(test_one_input)

Ausführen:

export ASAN_OPTIONS="allocator_may_return_null=1:detect_leaks=0:use_sigaltstack=0"
LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby fuzz_msgpack.rb

Beispiel: Reines Ruby-Ziel

Fuzzing von reinem Ruby-Code mit einem benutzerdefinierten Parser.

Tracer (test_tracer.rb):

# frozen_string_literal: true

require 'ruzzy'

Ruzzy.trace('test_harness.rb')

Harness (test_harness.rb):

# frozen_string_literal: true

require 'ruzzy'
require_relative 'my_parser'

test_one_input = lambda do |data|
  begin
    MyParser.parse(data)
  rescue StandardError
    # Erwartete Ausnahmen aufgrund fehlerhafter Eingaben
  end
  return 0
end

Ruzzy.fuzz(test_one_input)

Ausführen:

export ASAN_OPTIONS="allocator_may_return_null=1:detect_leaks=0:use_sigaltstack=0"
LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    ruby test_tracer.rb

Fehlerbehebung

ProblemUrsacheLösung
Installation schlägt fehlFalsche clang-Version oder -Pfadclang-Pfad überprüfen, clang 14.0.0+ verwenden
cannot open shared object fileLD_PRELOAD nicht gesetztLD_PRELOAD inline mit ruby-Befehl setzen
Fuzzer beendet sofortFehlendes Korpus-VerzeichnisKorpus-Verzeichnis erstellen oder als Argument übergeben
Kein Coverage-FortschrittReines Ruby benötigt TracerTracer-Skript für reinen Ruby-Code verwenden
Spam durch LecksucheRuby-Interpreter lecktASAN_OPTIONS=detect_leaks=0 setzen
Debug bei Installation erforderlichKompilierungsfehlerRUZZY_DEBUG=1 gem install --verbose ruzzy verwenden

Verwandte Skills

Technik-Skills

SkillVerwendungszweck
fuzz-harness-writingDetaillierte Anleitung zum Schreiben effektiver Harnesses
address-sanitizerErkennung von Speicherfehlern während des Fuzzings
undefined-behavior-sanitizerErkennung von undefiniertem Verhalten in C-Erweiterungen
libfuzzerVerstehen der libFuzzer-Optionen (Ruzzy basiert auf libFuzzer)

Verwandte Fuzzer

SkillWann in Betracht ziehen
libfuzzerWenn Sie Ruby-C-Erweiterungscode direkt in C/C++ fuzzen
aflppAlternativer Ansatz zum Fuzzen von Ruby durch Instrumentierung des Ruby-Interpreters

Ressourcen

Wichtige externe Ressourcen

Einführung von Ruzzy, einem coverage-gesteuerten Ruby-Fuzzer Offizieller Blogbeitrag von Trail of Bits, der Ruzzy ankündigt, mit Motivation, Architektur und ersten Ergebnissen.

Ruzzy GitHub-Repository Quellcode, zusätzliche Beispiele und Entwicklungsanleitungen.

libFuzzer-Dokumentation Da Ruzzy auf libFuzzer basiert, ist das Verständnis der libFuzzer-Optionen und des Verhaltens wertvoll.

Fuzzing von Ruby-C-Erweiterungen Detaillierte Anleitung zum Fuzzen von C-Erweiterungen mit Compiler-Flags und Beispielen.

Fuzzing von reinem Ruby-Code Detaillierte Anleitung zum Tracer-Muster, das für reines Ruby-Fuzzing erforderlich ist.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

Verwandte Skills