메뉴
Build FalkorDB (Rust code plus its native GraphBLAS/RediSearch dependencies), and run formatting/lint checks. Use when asked to build or compile the project, set up native dependencies for the first time, fix a build/compile/lint error, or run cargo fmt/clippy.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | build |
| description | Build FalkorDB (Rust code plus its native GraphBLAS/RediSearch dependencies), and run formatting/lint checks. Use when asked to build or compile the project, set up native dependencies for the first time, fix a build/compile/lint error, or run cargo fmt/clippy. |
| allowed-tools | Bash |
FalkorDB-rs is a Redis module: the Rust crates link against two native C
libraries (GraphBLAS and RediSearch) that must be compiled and installed
before cargo build will succeed.
Only needed once per machine/container (skip if cargo build already works).
./graphblas.sh # clones, builds (static, PIC) and installs GraphBLAS v10.3.1 + LAGraph
./redisearch.sh # clones and builds RediSearch (static) into redisearch/RediSearch/bin
If a script fails, read it before retrying by hand — graphblas.sh documents
the exact cmake flags it uses (-DGRAPHBLAS_COMPACT=OFF,
-DCMAKE_POSITION_INDEPENDENT_CODE=ON, static build, shared install prefix)
and has a --skip-graphblas flag to reuse an already-installed
libgraphblas.a while iterating on the LAGraph step.
cargo build # debug build -> target/debug/libfalkordb.{so,dylib}
cargo build --release # release build -> target/release/libfalkordb.{so,dylib}
cargo fmt --all -- --check
CXX=clang++ cargo clippy --all-targets
CXX=clang++ is required for clippy (and any build invoking the GraphBLAS
FFI bindings under graph/src/graph/graphblas/, whose bindgen output is
graphblas/mod.rs) — without it, clippy fails trying to compile the C shims.rustfmt.toml (vertical function-parameter
layout). Run cargo fmt --all (no --check) to auto-fix.lint skill..github/workflows/rust-pr.yml) runs the same cargo fmt --all --check
and CXX=clang++ cargo clippy --all-targets (pinned to a specific
clang++ version in CI containers; any reasonably recent local clang++
works)..so, macOS .dylib) and
multi-arch Docker image publishing are handled entirely in CI — these need
GH-hosted secrets/registries and are not meant to be reproduced locally.If any step fails, report the errors clearly and help fix them.
Profile FalkorDB performance - generate samply flamegraphs and run the benchmark suite. Use when investigating a performance regression/bottleneck or comparing benchmark results. For code-coverage reports use the coverage skill.
Measure FalkorDB code coverage with LLVM source-based instrumentation across Rust unit tests, Python e2e/MVCC/concurrency tests, flow tests, and TCK - producing an lcov report. Use when asked to measure/report test coverage or reproduce the CI coverage job locally.
Debug FalkorDB crashes, hangs, panics, and incorrect query results - attach lldb/gdb to redis-server with the module loaded, understand panic/crash behavior, step through query execution, and triage failing CI runs. Use when investigating a crash, hang, wrong query result, or a red CI job.
Run and manage FalkorDB's cargo-fuzz pipeline for the query runtime (fuzz_target_runtime) - build the fuzz target, run/minimize the corpus, generate coverage, and reproduce a crash artifact. Use when asked to fuzz test the runtime, investigate a fuzzing crash/artifact, or update the fuzz corpus.
Run FalkorDB's test suites - Rust unit tests, Python e2e/function/MVCC/concurrency tests, openCypher TCK compliance tests, and flow tests. Use when asked to run, narrow down, or debug a failing test, or to decide which suite covers a change.
Run FalkorDB's stricter opt-in Clippy pass (pedantic/nursery/cargo lints) beyond the basic CI gate, optionally auto-fixing. Use when asked for a deep/strict lint pass or to auto-fix clippy warnings; for the standard fmt+clippy CI gate use the build skill.