技能开发

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

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

技能如何影响智能体

智能体运行时会看到每个已安装技能的名称、描述和 Cloud Drive 规范目录。当任务与某个描述匹配时，智能体必须先用普通 read 工具完整读取该目录下的 SKILL.md 入口，再执行任务专用动作；其余关联文件只在需要时用 read 和 ls 渐进读取。

这种机制可以减少默认上下文中的内容体积。智能体不需要在每次运行时加载所有技能正文；技能就是普通的 Cloud Drive 文件，只在任务相关时按需加载。

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

技能内容

一个技能是以 SKILL.md 为入口的目录。入口文件的 YAML front matter 包含名称和描述，其余部分包含技能指令；目录还可以包含被引用的资料、脚本、模板或素材。

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

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

系统技能和组织技能

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

组织也可以创建自己的技能。组织技能适合沉淀内部流程、行业知识、客户项目经验和私有工具使用规范。它们位于组织 Cloud Drive 的 .skills 目录，可以通过只读引用或独立克隆安装到组织拥有的智能体。

编辑技能

技能使用与普通文件完全相同的 read、write、edit、ls、grep、find、copy、mkdir、delete 和 tree 操作管理。Cloud Drive 编辑使用 compare-and-swap；发生并发修改时会返回冲突，不会静默覆盖。引用会跟随源技能更新，克隆则保持独立。

发布和复用

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

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