文档

技能开发

技能是 Brazosd 中可复用的智能体能力单元。一个技能通常描述某类任务的业务知识、操作步骤、工具使用规则和风险边界。用户可以把技能链接到智能体上，让智能体在处理匹配任务时加载对应技能内容。

技能适合沉淀企业内部的专家经验。相比把所有规则都写进智能体提示词，技能可以按业务主题拆分、独立维护，并在多个智能体之间复用。

技能如何影响智能体

智能体运行时会看到已经链接的技能列表，包括技能 ID、名称和描述。当任务与某个技能的描述匹配时，智能体可以使用内置的 read_skill 工具读取技能正文。

这种机制可以减少默认上下文中的内容体积。智能体不需要在每次运行时加载所有技能正文，而是在需要时按技能 ID 读取对应内容。

链接技能会改变智能体后续运行中的行为。给智能体添加技能前，应该确认技能的适用范围、授权边界和工具使用方式都符合该智能体的职责。

一个技能包含名称、描述和正文。

名称应该清楚表达技能主题。描述应该帮助智能体判断什么时候需要读取这个技能。正文应该写清楚具体任务流程、输入输出约定、应该调用的工具、需要用户确认的动作，以及不能越过的业务边界。

技能正文不应该只写抽象原则。对于企业级专家智能体，更有价值的是把业务流程拆成可执行的步骤，并说明遇到异常、权限不足、信息缺失或外部系统失败时应该如何处理。

Brazosd 提供系统技能，用于描述平台内置能力和基础操作流程。系统技能由 Brazosd 初始化程序管理，用户不应该在控制台中编辑或删除。

组织也可以创建自己的技能。组织技能适合沉淀内部流程、行业知识、客户项目经验和私有工具使用规范。组织技能可以链接到组织拥有的智能体上，包括组织拥有的系统智能体。

技能直接编辑。修改会在相关智能体配置刷新后影响链接了该技能的智能体，因此在生产智能体中使用前，应该保持技能的职责范围和行为稳定。

技能可以作为组织内部资产复用。大范围链接技能前，应该避免在正文中包含只适用于单个客户、单个临时项目或不应暴露给所有使用该技能的智能体的信息。

对于强依赖企业私有数据的能力，可以保留为组织内部技能，并通过智能体云盘、云盘资料和 brazosd_ctrl 组合出面向业务的专家智能体。