Agent Skills
› xberg-io/xberg
xberg-io/xberg
GitHub指导如何编辑和生成 Alef bindings，涵盖配置 alef.toml、执行代码再生与验证、处理多语言绑定及文档生成，确保 Rust 源码变更后正确同步各语言接口。
Install All Skills
npx skills add xberg-io/xberg --all -g -y
Skills in Collection (82)
Showing top 50 of 82 by quality score. Use the install list command or open individual skills for the rest.
指导如何编辑和生成 Alef bindings，涵盖配置 alef.toml、执行代码再生与验证、处理多语言绑定及文档生成，确保 Rust 源码变更后正确同步各语言接口。
需要生成或更新多语言 FFI 绑定
修改 Rust 源码后需重新生成 bindings
排查 bindings 生成失败或版本不同步问题
npx skills add xberg-io/xberg --skill alef-generated-bindings -g -y
定义API服务器与MCP协议的技能，涵盖Axum路由、中间件、缓存及错误处理规范，用于指导代码修改与开发。
修改REST API路由或处理器
调整服务器启动配置或中间件
变更MCP工具或端点逻辑
涉及API服务层的代码重构
npx skills add xberg-io/xberg --skill api-server-mcp -g -y
管理基准测试工作流，确保Ground-truth完整性，诊断运行失败原因，规范评估指标与缓存处理。
执行提取基准测试
评估质量分数
管理基准测试夹具或真相数据
分析基准测试结果
npx skills add xberg-io/xberg --skill benchmark-workflow -g -y
管理文本分块、嵌入生成及RAG配置，支持多种切分策略与预设模型，集成ONNX静态嵌入。
调整文本分块大小或重叠率
配置或切换嵌入模型
优化RAG检索流程
npx skills add xberg-io/xberg --skill chunking-embeddings -g -y
说明配置加载优先级与发现机制，涵盖CLI与服务端模式下的参数覆盖顺序、多格式文件自动探测及JSON合并逻辑。
需要解析或调试配置加载顺序
处理不同来源配置的冲突与合并
npx skills add xberg-io/xberg --skill config-loading-precedence -g -y
定义 Rust Workspace 的 crate 结构、成员划分及多语言绑定规则，明确版本源与分发包配置。
需要创建或调整 Rust 工作区成员
配置跨语言 FFI/JNI 绑定
管理多语言 SDK 发布路径
npx skills add xberg-io/xberg --skill crate-structure -g -y
用于管理端到端测试的JSON格式固定数据（Fixtures），支持调用、输入、Mock及断言定义，自动映射至Python测试文件。
需要添加或修改E2E测试用例的数据配置
生成基于JSON结构的端到端测试脚本
npx skills add xberg-io/xberg --skill e2e-fixtures -g -y
描述文档提取管道的架构与模式，涵盖格式检测、提取器路由及后处理流程。支持多种文件格式，集成缓存、回退和并发策略，用于高效构建数据提取系统。
需要设计或实现文档/文件内容提取流水线
优化数据提取的性能、容错或并发处理能力
配置多格式文件的解析与转换逻辑
npx skills add xberg-io/xberg --skill extraction-pipeline-patterns -g -y
定义 Rust Cargo 特性标志的命名与语义规范，统一 tracing、otel、mcp 等共享关注点，确保跨库行为一致并管理依赖关系。
需要为 Rust 项目添加或修改 Cargo feature
统一多个库中的功能标志命名和默认值
处理互斥特性如 mimalloc 与 jemalloc 的配置
npx skills add xberg-io/xberg --skill feature-flag-conventions -g -y
定义 xberg crate 的 Cargo feature flag 策略，规范 ORT 不兼容目标（WASM/Android）的依赖隔离、纯 Rust 类型暴露及 Tract 推理替代方案。
配置 Cargo feature flags
解决 WASM 或 Android 平台的编译依赖问题
调试跨平台构建错误
npx skills add xberg-io/xberg --skill feature-flag-policy -g -y
定义多种文件格式（Office、PDF、压缩包等）的内容提取工作流，涵盖解析、OCR、元数据获取及安全预算控制逻辑。
需要解析 Office XML 文件内容
执行 PDF 文档文本或 OCR 提取
处理 ZIP/TAR 等归档文件元数据
npx skills add xberg-io/xberg --skill format-specific-extraction -g -y
处理文件MIME类型检测与路由，支持路径扩展、字节魔数及格式注册表，用于分发至对应提取器。
需要识别文件MIME类型
根据MIME类型路由到文档提取器
npx skills add xberg-io/xberg --skill mime-detection-routing -g -y
OCR处理流程与质量评估规范，涵盖多后端执行、缓存策略及精度校验。
需要执行或优化OCR识别流程
评估OCR结果质量与精度
配置OCR后端与缓存
npx skills add xberg-io/xberg --skill ocr-pipeline-and-quality -g -y
配置 PDF 处理后端（Native/Pdfium），涵盖渲染、OCR 及元数据提取。指导后端选择策略、资源管理及测试验证，确保功能正确性。
需要解析或渲染 PDF 文档
配置 PDF 处理引擎选项
处理 PDF OCR 或文本提取
npx skills add xberg-io/xberg --skill pdf-backends -g -y
规范 Rust 插件架构，定义文档提取、OCR 等插件类型及生命周期。包含优先级注册机制、WASM 兼容性处理及内部/外部接口隔离，指导开发者正确实现和注册插件。
实现新的插件后端
修改插件注册逻辑
调整插件优先级策略
解决 WASM 编译兼容性问题
npx skills add xberg-io/xberg --skill plugin-architecture-patterns -g -y
定义多仓库工作区中各组件的API所有权与边界，规范跨库修复、依赖发布顺序及API放置策略。
涉及跨仓库的代码修改或依赖更新
需要明确某个功能或API的所有权归属
处理多仓库间的兼容性变更
npx skills add xberg-io/xberg --skill polyrepo-boundaries -g -y
用于发布前审计代码就绪状态，涵盖CI、基准测试、文档同步及多平台制品验证，确保推送和发布流程合规。
准备推送代码前
执行发布流程时
npx skills add xberg-io/xberg --skill release-readiness -g -y
规范 xberg 版本发布流程，以 Cargo.toml 为唯一权威源。通过 task version:sync 同步绑定、集成及 Helm 图表版本，确保多语言包与核心锁定步发布，并提供自动 bump 和检查工具。
执行版本同步或发布
调整工作区版本号
修改集成组件版本依赖
npx skills add xberg-io/xberg --skill release-versioning -g -y
管理测试语料库，提供从GCS获取二进制fixture脚本及Rust辅助函数read_test_fixture。规范CI集成与构建陷阱，指导控制工作区搭建以隔离测试环境。
需要获取或刷新测试文档fixture
在Rust测试中读取测试文件
配置隔离的测试工作区
排查因缺少fixture导致的测试失败
npx skills add xberg-io/xberg --skill test-corpus -g -y
提供WASM构建约束规范，涵盖同步API要求、无Tokio运行时限制、HTML大小上限及特征标志配置，指导开发符合浏览器环境限制的WebAssembly模块。
诊断wasm32构建或运行时问题
检查WASM模块的功能限制与尺寸约束
实现内部同步提取器
npx skills add xberg-io/xberg --skill wasm-constraints -g -y
用于准备Xberg版本发布，同步根Cargo.toml权威版本至各语言绑定、集成包及Helm Chart，确保多平台发布前版本一致性与CI门禁通过。
执行版本发布流程
需要同步多语言包和Helm Chart的版本号
运行CI前的版本一致性检查
npx skills add xberg-io/xberg --skill xberg-release -g -y
定义 Xberg TypeScript 项目的工具链规范，涵盖 pnpm/npm 锁文件管理、Vitest 测试配置、napi-rs/wasm-pack 构建集成及代码格式化规则。
修改 TypeScript/JavaScript 项目配置
处理依赖管理与锁文件更新
运行或配置测试与构建流程
npx skills add xberg-io/xberg --skill xberg-typescript-toolchain -g -y
支持批量提取文件，具备共享配置、并发控制、单文件覆盖及错误恢复功能。适用于多文档一次性处理场景。
需要同时处理多个文件的提取任务
要求对批量操作进行并发限制或资源管控
需要对不同文件应用不同的提取配置
npx skills add xberg-io/xberg --skill batch-extraction -g -y
用于将提取的文本切分为适合LLM上下文窗口或RAG ingest的块。支持字符/Token大小、重叠配置及Markdown/YAML/Semantic等多种分块策略，提供内联和独立命令两种模式。
需要将长文档切分为小块以输入LLM
为向量数据库准备数据分块
使用特定策略（如语义、Markdown）进行文本分割
npx skills add xberg-io/xberg --skill chunking -g -y
提供文档关键词提取（YAKE/RAKE）、语言检测和向量嵌入生成的技能，涵盖CLI配置、算法参数及特征门控说明，支持RAG和搜索场景。
从文档中提取关键词
检测文档语言
生成用于RAG或搜索的嵌入向量
npx skills add xberg-io/xberg --skill extracting-keywords -g -y
用于从PDF、电子表格或图像中提取结构化表格数据。支持布局感知检测、多种表格模型选择及Markdown/JSON输出格式，适用于财务报表、发票等场景。
从PDF文档中提取表格数据
解析电子表格文件内容
从图片中识别并提取表格
npx skills add xberg-io/xberg --skill extracting-tables -g -y
提供基于Xberg CLI的OCR文本提取能力，支持扫描PDF、图片等无文本层文档。涵盖Tesseract、PaddleOCR及VLM后端选择，语言包配置及强制OCR参数，解决乱码或空内容问题。
从扫描件或照片中提取文本
PDF无文本层或内容乱码需强制OCR
需要多语言OCR支持
npx skills add xberg-io/xberg --skill extracting-with-ocr -g -y
提供文档提取输出格式选择指南，根据消费者类型（LLM、RAG、解析器等）推荐CLI参数组合，优化下游处理流程。
选择文档提取的输出格式
配置CLI参数以适配下游消费者
npx skills add xberg-io/xberg --skill picking-a-format -g -y
支持批量文件提取，具备并行控制、每文件配置覆盖及错误恢复功能。适用于一次性处理目录或通配符文档，通过共享配置和并发调度提高提取效率与容错性。
需要同时处理多个文件的提取任务
需要对不同文件应用不同的提取配置
在资源受限环境下控制并发数量
npx skills add xberg-io/xberg --skill xberg-batch-extraction -g -y
用于将提取的文本分割为适合LLM上下文窗口或RAG ingest的分块。支持字符/Token大小、重叠设置及多种分块策略（文本、Markdown、YAML、语义），提供内联提取和独立命令两种方式。
需要将长文档切分为小块以适配LLM上下文窗口
为向量数据库准备RAG所需的文本分块数据
npx skills add xberg-io/xberg --skill xberg-chunking -g -y
提供文档关键词提取（YAKE/RAKE）、语言检测及向量嵌入生成功能，支持通过CLI配置算法参数、阈值及特征门控，适用于RAG和搜索场景的数据预处理。
需要从文档中提取关键词或短语
需要检测文档的语言
需要为RAG生成文本嵌入
npx skills add xberg-io/xberg --skill xberg-extracting-keywords -g -y
从PDF、电子表格或图像中提取结构化表格数据，支持布局感知检测、多模型选择及Markdown/JSON输出格式。
从PDF提取财务报表或发票中的表格
将电子表格转换为结构化JSON或Markdown
npx skills add xberg-io/xberg --skill xberg-extracting-tables -g -y
用于从扫描件、图片或无文本层PDF中提取文字的OCR技能，支持多后端切换、语言包配置及强制OCR处理。
从扫描件或图片提取文本
PDF文本层为空或乱码时强制OCR
需要混合文档统一输出格式
npx skills add xberg-io/xberg --skill xberg-extracting-with-ocr -g -y
指导选择文档提取输出的格式（如text、json、markdown等），通过决策树匹配消费者类型与CLI参数，优化LLM、RAG或人类审阅场景。
需要选择文档输出格式
配置xberg CLI的参数组合
npx skills add xberg-io/xberg --skill xberg-picking-a-format -g -y
提供 Xberg 文档提取库的多语言使用指南，涵盖 Python、Node.js、Rust 等安装配置，支持文本/表格/OCR 提取及批量处理。
需要解析 PDF 或 Office 文档内容
执行扫描图片的 OCR 识别
从多种格式文件中提取元数据或表格
npx skills add xberg-io/xberg --skill xberg -g -y
用于批量提取多个文件内容，支持共享配置、并发控制、单文件覆盖及错误恢复。适用于一次性处理目录或通配符匹配的大量文档场景。
需要同时从多个文件中提取内容
对大批量文档进行并行处理
npx skills add xberg-io/xberg --skill batch-extraction -g -y
用于将提取的文本分割为适合LLM上下文窗口或RAG摄入的块。支持字符/Token大小、重叠设置及多种分块策略（文本、Markdown、YAML、语义）。
需要将长文档分割为小块以适配LLM上下文窗口
准备数据用于向量数据库或RAG系统
使用chunk命令对已有文本进行预处理
npx skills add xberg-io/xberg --skill chunking -g -y
提供文档关键词提取（YAKE/RAKE）、语言检测及向量嵌入生成能力，支持CLI配置与代码集成，用于RAG和搜索场景的数据预处理。
从文档中提取关键词
检测文档语言
生成文本向量嵌入
npx skills add xberg-io/xberg --skill extracting-keywords -g -y
从PDF、电子表格或图像中提取结构化表格数据。支持布局感知检测、多种表格模型选择及Markdown/JSON输出格式，适用于财务报表、发票等场景。
需要从PDF文档中提取表格
需要解析电子表格数据
需要从图片中识别表格结构
npx skills add xberg-io/xberg --skill extracting-tables -g -y
提供从扫描PDF、图片中提取文本的OCR能力，支持Tesseract、PaddleOCR及VLM后端，涵盖语言包配置与性能调优。
从扫描件或无文本层PDF提取文字
处理图像中的文本识别
解决PDF复制乱码问题
npx skills add xberg-io/xberg --skill extracting-with-ocr -g -y
指导根据下游消费者（如LLM、RAG索引器或人类）选择正确的输出格式组合，平衡结构保留与Token消耗。
选择文档提取后的输出格式
为LLM或RAG系统配置数据管道
npx skills add xberg-io/xberg --skill picking-a-format -g -y
支持批量并行提取多文件内容，具备共享配置、并发控制、单文件覆盖及错误恢复机制，适用于大规模文档处理场景。
需要同时处理多个文件的批量操作
要求对单个文件进行差异化配置覆盖
需要限制并发数以节省内存或资源
希望部分文件失败不影响整体任务完成
npx skills add xberg-io/xberg --skill xberg-batch-extraction -g -y
提供文本分块能力，支持字符/Token粒度及Markdown/YAML/Semantic策略，用于LLM上下文窗口或RAG数据摄入。
将长文本分割为适合LLM处理的片段
为向量数据库准备RAG检索数据
npx skills add xberg-io/xberg --skill xberg-chunking -g -y
用于从文档中提取关键词（支持YAKE/RAKE算法）、检测语言以及生成向量嵌入。涵盖配置选项、CLI命令及特征门控说明，辅助RAG和搜索场景。
需要提取文档关键词时
检测文档语言时
生成向量嵌入用于RAG或搜索时
npx skills add xberg-io/xberg --skill xberg-extracting-keywords -g -y
用于从PDF、表格或图片中提取结构化表格数据，支持布局感知检测及Markdown/JSON输出。
用户需要从非结构化文档（如PDF、扫描件）中提取表格数据
用户需要将财务、发票等表格转换为JSON或Markdown格式
npx skills add xberg-io/xberg --skill xberg-extracting-tables -g -y
用于从扫描件、照片或无文本层的PDF中提取文字的OCR技能。支持Tesseract、PaddleOCR及VLM后端，提供语言包配置与强制OCR选项，适用于文档数字化场景。
需要提取扫描PDF中的文字
处理拍照页面或截图的文本识别
PDF自动提取结果为空或乱码时强制OCR
npx skills add xberg-io/xberg --skill xberg-extracting-with-ocr -g -y
指导用户根据下游消费者（LLM、RAG、解析器等）选择合适的文档提取输出格式（如JSON、Markdown、HTML等），通过决策树推荐CLI参数组合。
选择文档提取输出格式
配置CLI格式参数
为LLM或RAG准备数据
npx skills add xberg-io/xberg --skill xberg-picking-a-format -g -y
提供Xberg文档智能库的多语言集成指南，支持从107种格式提取文本、表格及图像。涵盖安装、同步/异步调用、OCR配置、批量处理及错误处理，适用于Python、Node.js等开发场景。
需要解析PDF或Office文档内容
执行扫描图片的OCR识别
批量处理多文件提取任务
npx skills add xberg-io/xberg --skill xberg -g -y
用于批量提取多个文件内容，支持共享配置、并行处理、单文件覆盖及错误恢复。适用于目录或通配符文档的一次性处理，返回JSON结果并隔离单个文件失败。
需要批量处理多个文档文件
使用xberg batch命令进行并发提取
需要对不同文件应用不同的提取配置
npx skills add xberg-io/xberg --skill xberg-batch-extraction -g -y
提供文本分块能力，支持字符/Token大小、重叠及多种分块策略（Markdown/YAML/Semantic），用于LLM上下文或RAG数据预处理。
需要将长文本分割为适合LLM处理的片段
为向量数据库准备RAG入库数据
npx skills add xberg-io/xberg --skill xberg-chunking -g -y
