插件架构与注册模式
为文档智能框架设计可扩展插件系统的架构指南：定义插件类型、注册机制与优先级规则。
证据显示：项目有MIT许可证，提供SECURITY.md详细说明安全威胁模型、缓解措施（如Decompression bombs、oversized files等）以及报告漏洞的流程。技能本身不请求额外权限或进行外部操作。但分发渠道未验证（publisher unknown），技能内容未明确提及用户确认或数据流透明性；依赖众多且部分有网络功能（如url-ingestion），但安全文档声明不进行网络请求。扣分因为：技能文件未提及权限最小化或用户确认，依赖安全与外部效果的详尽说明不足；未发现恶意但它没有明确的安全保证。
证据显示：Cargo.toml和README显示项目有大量功能、健全的构建配置，以及丰富的测试文件（如e2e/node/tests）暗示有测试覆盖。但技能文件仅提供代码片段和文档，无独立验证或执行证据；未找到针对该技能关键路径的测试。扣分因为：静态审查无法确认实际行为，错误处理和失败消息不够详细。
证据显示：技能专注于插件架构模式，清晰描述了插件类型、优先级系统和注册方式，目标受众为Rust开发者，与文档智能框架相关。但技能声明为'critical'优先级，可能触发范围过宽；未明确限定非适用场景（如非Rust环境）和触发条件。关于中文支持和大陆网络可达性未提及。扣分因为：边界与触发条件证据有限。
证据显示：README提供了详细的安装、使用和功能列表，LICENSE为MIT，Cargo.toml有版本号（1.1.0）和作者信息。技能本身没有版本或更新日志，但仓库有SECURITY.md和CONTRIBUTING.md。扣分因为：技能文件缺少自身的版本、变更日志和已知限制；维护责任未在技能文件中明确。
证据显示：技能提供了清晰的目标（实现插件架构）和示例代码，看起来能完成核心任务。但未提供实际运行输出或对比基准，其价值声明（如'critical'）未得到验证。扣分因为：静态审查无法验证输出直接可用性，且与其他替代方案的成本效益未明确。
证据显示：仓库有CI工作流（如benchmarks.yaml、ci-docker.yaml）和测试文件（如e2e/node/tests），以及benchmark harness，这提供了一些可验证信号。但技能本身没有测试，关键声明（如插件系统的功能）未在该文件中复现。扣分因为：仅静态审查，没有执行测试或交叉验证。
- 技能内容较浅，仅提供代码片段和模式，缺乏完整文档和验证；实际使用需依赖仓库其他文件。
- 依赖众多，部分功能需要网络（如URL抓取、在线LLM），请确认使用环境允许网络访问并注意安全边界。
- 未提供中文文档或明确支持，且某些功能依赖海外服务，中国大陆用户可能需要额外配置或无法访问。
- 发布者未经验证，建议在关键环境中自行审查和测试。
这个 Skill 能做什么，适合哪些场景？
这个技能是一份关于如何为基于 Rust 的文档智能框架（如 Xberg）设计插件系统的架构指南。它定义了四种核心插件类型：文档提取器、OCR 后端、后处理器和验证器，每种都规定了对应的 Trait 和位置。核心内容包括通过优先级系统选择最合适的提取器、通过注册表进行插件注册、支持基于 feature 的条件注册，以及要求所有插件实现 Send + Sync。该文档强调遵循异步 trait 和 kebab-case 命名等规则，以确保插件的一致性和可维护性。它面向希望扩展或构建类似文档处理系统的开发者，提供清晰的实现模式和注册流程。
提供插件架构的详细说明，包括插件类型定义、Trait 实现示例（DocumentExtractor）、优先级分配（0-100 范围，默认 50）、注册到全局注册表的方法（get_document_extractor_registry）、通过 #[cfg(feature = "...")] 进行条件编译，以及 PostProcessor 的阶段处理（Early/Middle/Late）。还包含关键规则，如插件必须 Send + Sync、异步 trait 的使用、初始化流程等。
- Rust 开发者需要为文档提取工具添加自定义格式的提取器，可参考 DocumentExtractor 实现示例。
- 维护一个文档处理库的开发者想要设计插件系统，可学习如何定义不同类型的插件及其 trait。
- 需要让第三方开发者扩展自己软件功能的工程师，可借鉴这种通过注册表和优先级管理的插件机制。
- 团队在开发大型 Rust 项目，希望统一插件的并发和初始化行为，可遵循 Send + Sync 和 ensure_initialized 规则。
- 为文档处理应用添加可选格式支持（如 DOCX）时，可参考 feature 门控的注册方式。
这个 Skill 有哪些优点和局限？
- 清晰的插件类型分类和优先级系统，便于选择最优实现。
- 提供了完整的代码示例，包括 trait 实现和注册流程。
- 强调了关键规则如 Send + Sync 和 feature 门控，确保安全和性能。
- 后处理器支持分阶段执行且故障隔离，提高整体稳定性。
- 文档主要针对 Rust，对使用其他语言的开发者帮助有限。
- 没有提供测试套件或验证示例，可能难以确认实现是否正确。
- 未说明插件如何热加载或动态发现，仅支持编译时注册。
- 未展示优先级冲突时的具体处理方式，可能需自行设计。
如何安装这个 Skill？
该技能来自 xberg-io/xberg 仓库中 .ai-rulez/skills/plugin-architecture-patterns/SKILL.md，属于包含 47 个技能的 monorepo 集合。安装方式是克隆或下载整个仓库，并将 .ai-rulez/skills/plugin-architecture-patterns/ 文件夹复制到你的 Agent 技能目录（例如 ~/.claude/skills/ 或项目 .ai-rulez/skills/ 下）。具体安装步骤未在文档中详述，但通常只需将 SKILL.md 文件放置于合适位置。
如何使用这个 Skill？
在支持 Agent Skills 的环境中，可以直接引用该技能。例如，在 Claude Code 中，可以提示“参考插件架构模式技能来设计一个可扩展的插件系统”。文档提供了详细的代码示例，可以直接复制到你的 Rust 项目中，但需要确保你的项目已经引入了 async_trait 等依赖。若需要更多指导，可参考仓库中的 README 了解 Xberg 项目的整体结构，但注意不要混淆其他技能的功能。