Tool、Skill、Sub-Agent 散成一地？PluginDescriptor 一次打成业务插件

「Regnexe Python 实战系列」第 3 篇（共 10 篇），对应仓库examples/readme/03_plugin_packaging.py。上一篇：02. Skill 和 Sub-Agent 到底差在哪？一个借工具，一个有私有工具。

痛点：能力一多，就散成一地变量

前两篇里，我们已经有了 Tool、Skill、Sub-Agent。问题也随之出现：

get_weather estimate_trip_cost travel_advisor expense_estimator

这些能力如果一直散落在构建代码里，很快就会变成“看得见能跑，但没人敢改”的状态。

regnexe-py 的底层抽象是PluginDescriptor：一个插件里可以装多个 CapabilityDescriptor，每个能力都有稳定 id。

实战代码：一个插件打包三种能力

示例里的核心代码是这段：

trip_plugin=(PluginDescriptor.builder().plugin_id("trip-plugin").version("1.0").name("Trip Plugin").description("Bundles a tool, a skill, and a sub-agent for trip planning").tool(get_weather)# -> trip-plugin.get_weather.skill_config(travel_advisor)# -> trip-plugin.travel_advisor.sub_agent_config(expense_estimator)# -> trip-plugin.expense_estimator.build())

这段代码做了两件事：

• 把三种不同能力统一包装成 CapabilityDescriptor
• 自动生成完整能力 id：plugin_id.name

所以get_weather不再只是一个裸函数，而是trip-plugin.get_weather这个业务插件里的能力。

踩坑提醒：Skill 要写完整能力 id

示例里travel_advisor的工具列表是这样写的：

travel_advisor={"name":"travel_advisor","tools":["trip-plugin.get_weather"],}

这里必须是trip-plugin.get_weather，不是get_weather。

原因很简单：Skill 借的是完整能力 id。插件化以后，同名工具可能来自不同插件，只写裸名称会失去边界。

怎么接进 Agent

手动构造好的PluginDescriptor可以直接交给with_plugin(...)：

agent=(RegnexeAgentBuilder().with_default_model(Vendor.DEEPSEEK,"deepseek-v4-flash").with_plugin(trip_plugin).with_event_listener(ConsoleEventListener()).build())

这样第 3 篇只需要关心“怎么把能力打成一个插件”，不用提前理解 Marketplace。至于能力市场怎么替换、怎么接数据库，后面第 6 篇再单独展开。

小结

PluginDescriptor.builder()适合这些场景：

• 能力定义来自数据库或配置中心，需要运行时拼装
• 一个业务插件里混合 Tool、Skill、Sub-Agent
• 你想手动控制插件 id、版本、名称和描述
• 需要把能力从“代码变量”升级成“可管理资产”

一句话：PluginDescriptor 是 regnexe-py 能力体系的底层真相。

📌 上一篇：02. Skill 和 Sub-Agent 到底差在哪？一个借工具，一个有私有工具 ｜ 下一篇：04. 一个 Python 类，一次注册，搞定 2 个工具 + 1 个 Skill + 1 个 Sub-Agent
📌 项目地址：https://github.com/flower-trees/regnexe-py