background-agents Managed Skills教程5分钟创建可复用Agent指令集的完整指南【免费下载链接】background-agentsAn open-source background agents coding system项目地址: https://gitcode.com/GitHub_Trending/ba/background-agentsbackground-agents 是一款开源的后台 Agent 编码系统其Managed Skills托管技能功能让你把部署流程、代码评审、事故响应等工作流沉淀为可复用的 Agent 指令集一次编写、所有会话共享再也不用在每条 Prompt 里重复粘贴相同指导。本教程用 5 个步骤带你从零创建、分配并管理自己的技能。 什么是 Managed SkillsManaged Skills 为 Agent 提供可复用的指令和配套文件适合标准化以下场景部署与预检流程代码评审规范事故响应手册项目特定的编码约定系统围绕三个核心概念设计理解它们后所有功能一目了然概念作用谁能使用Shared Skill共享技能存放可复用指令和配套文件实例内所有用户Assignment分配规则控制技能应用到哪些会话目标使用共享技能的任何人Personal Profile个人档案保存你偏好的技能子集仅档案所有者⚠️ 安全提示Managed Skills 是受信内容不是权限边界。技能可以指示 Agent 使用会话中已有的工具、凭据和网络访问权限启用前请先审查其中的指令和脚本。 快速上手5步创建第一个共享技能进入Settings Skills在Shared skills中点击New skill。填写规范名称、描述和指令内容写法见下一节。选择技能适用的仓库或环境——新技能默认All sessions (global)对全部会话生效。点击Validate预览生成的SKILL.md并检查内容大小与内容摘要。点击Create skill保存然后新建一个会话将技能选择器保持为All applicable即可自动包含所有匹配技能。整个流程无需任何代码改动验证和安装都会自动完成。✍️ 怎么写出让 Agent 看懂的技能创建时只需填写三个结构化字段平台会自动生成标准SKILL.md你无需手写该文件字段填写说明Canonical name规范名称必填。小写字母、数字和单个连字符组成如deploy-service。最长 64 字符创建后不可修改Description描述必填。简要说明 Agent 何时、为何使用该技能最长 1,024 字符Instructions指令工作流、规则、示例和预期结果使用 Markdown 编写 好的指令应让触发条件和预期结果清晰。建议包含When to use何时使用和Workflow分步工作流两节让每一步可执行、可验证。添加配套文件点击Add file可加入文本类参考资料、模板或脚本使用相对路径例如references/runbook.md事故手册scripts/preflight.sh预检脚本assets/review-template.md评审模板配套文件要求 UTF-8 纯文本不支持二进制和压缩包只有scripts/目录下的文件才能标记为可执行。文件也可以直接在编辑器中编写或从仓库导入。 分配技能全局 / 仓库 / 环境三级作用域分配规则决定技能什么时候可用任意一条匹配即生效多规则是叠加关系分配类型生效范围All sessions (global)所有会话包括无仓库会话Repository包含所选仓库的会话Environment从所选环境启动的会话可以同时勾选多个仓库和环境。环境会话可能同时命中全局、环境本身以及环境内仓库的分配。若删掉全部分配技能仍保留在目录中只是不再匹配任何新会话随时可以重新分配。 创建个人档案Profile一键选择你的偏好个人档案是过滤器而非覆盖器适合只想要其中几个技能的用户进入Settings Skills My profiles点击New profile。输入唯一档案名。勾选最多 20 个共享技能。点击Save profile。创建会话时档案只会保留同时启用且匹配目标的技能被禁用的条目会带(disabled)后缀提示。档案仅自己可见不会影响其他用户删除档案也不会删除其中的共享技能。️ 会话创建时的三种选择方式在新建会话页选好目标仓库/环境后打开模型和推理级别旁的技能选择器选项结果All applicable包含所有匹配且启用的技能默认None不带任何托管技能启动Personal profile仅包含档案中启用且匹配目标技能选择器旁的数字会实时预览将包含的技能数量若档案显示N ignored说明有 N 个条目被禁用或未分配给当前目标。自动化和集成未提供选择器时默认使用 All applicableAgent 派生的子会话会原样继承父会话的技能集。 检查 Agent 实际收到了什么会话创建时技能即被**固定pin**到特定版本。展开会话右侧边栏的Managed skills可以看到使用的选择方式All applicable / None / 档案名每个技能的规范名称和描述固定的修订版本号和摘要内容匹配原因如Global、Repository、Environment重启或恢复会话仍沿用同一版本不会自动获取新编辑——想要最新内容请新建会话。这正是可复现性的来源已运行或已创建的会话永远不会被后续编辑影响。 进阶从仓库导入技能技能通常已经在 Git 仓库里维护。通过Settings Skills Shared skills Import from repository可直接读取仓库中的SKILL.md及配套文件免手敲Repository实例可读的任意仓库Ref分支、标签或提交留空用默认分支Subdirectory仓库中技能所在子目录Name留空时默认取SKILL.md中的 name导入前会完整预览解析出的提交、每个文件大小、内容摘要和映射警告源仓库在预览后发生变化会拒绝保存。确认后再看一遍预览中的scripts/内容——导入等于把第三方指令引入全实例目录。导入会记录来源仓库、提交和摘要之后可随时重新导入拉取更新但不会自动同步。 限制速查表约束上限规范名称64 字符描述 / License / Compatibility1,024 / 200 / 500 字符配套文件数每技能99 个单文件大小256 KiB单个技能修订总量1 MiB档案或会话中的技能数20 个单会话托管技能总内容5 MiB配套文件路径必须是相对路径使用/不超过 10 级深度或 240 字节且不能占用SKILL.md。另外agent-browser、record-video、upload-screenshot、visual-verification、customize-opencode五个名称被沙箱运行时保留不可用于自定义技能。️ 常见问题排查现象原因与处理档案提示技能被忽略检查条目是否被禁用以及分配是否匹配会话的仓库/环境现有会话看不到最新修改技能在会话创建时固定新建会话才能获取新修订某托管技能缺失与仓库/内置技能同名冲突时平台保留发现的技能并丢弃托管技能仅告警会话照常启动。请重命名或改用新规范名保存被拒绝其他用户并发编辑了该技能重新加载最新版本再应用修改 关键文档与代码路径想深入了解内部机制可从以下路径入手官方使用文档docs/MANAGED_SKILLS.md完整设计文档数据模型、解析与固定机制docs/plans/managed-skills.md技能目录存储与 Markdown 生成packages/control-plane/src/skills/沙箱内技能拉取、校验与安装managed_skills.py共享类型定义skills.ts数据库迁移0061_managed_skills.sql从编写第一个deploy-service开始把团队的部署、评审和响应流程变成 Agent 的肌肉记忆——这就是 background-agents 的 Managed Skills 带给你的核心价值。【免费下载链接】background-agentsAn open-source background agents coding system项目地址: https://gitcode.com/GitHub_Trending/ba/background-agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 background-agents Managed Skills教程：5分钟创建可复用Agent指令集的完整指南
background-agents Managed Skills教程5分钟创建可复用Agent指令集的完整指南【免费下载链接】background-agentsAn open-source background agents coding system项目地址: https://gitcode.com/GitHub_Trending/ba/background-agentsbackground-agents 是一款开源的后台 Agent 编码系统其Managed Skills托管技能功能让你把部署流程、代码评审、事故响应等工作流沉淀为可复用的 Agent 指令集一次编写、所有会话共享再也不用在每条 Prompt 里重复粘贴相同指导。本教程用 5 个步骤带你从零创建、分配并管理自己的技能。 什么是 Managed SkillsManaged Skills 为 Agent 提供可复用的指令和配套文件适合标准化以下场景部署与预检流程代码评审规范事故响应手册项目特定的编码约定系统围绕三个核心概念设计理解它们后所有功能一目了然概念作用谁能使用Shared Skill共享技能存放可复用指令和配套文件实例内所有用户Assignment分配规则控制技能应用到哪些会话目标使用共享技能的任何人Personal Profile个人档案保存你偏好的技能子集仅档案所有者⚠️ 安全提示Managed Skills 是受信内容不是权限边界。技能可以指示 Agent 使用会话中已有的工具、凭据和网络访问权限启用前请先审查其中的指令和脚本。 快速上手5步创建第一个共享技能进入Settings Skills在Shared skills中点击New skill。填写规范名称、描述和指令内容写法见下一节。选择技能适用的仓库或环境——新技能默认All sessions (global)对全部会话生效。点击Validate预览生成的SKILL.md并检查内容大小与内容摘要。点击Create skill保存然后新建一个会话将技能选择器保持为All applicable即可自动包含所有匹配技能。整个流程无需任何代码改动验证和安装都会自动完成。✍️ 怎么写出让 Agent 看懂的技能创建时只需填写三个结构化字段平台会自动生成标准SKILL.md你无需手写该文件字段填写说明Canonical name规范名称必填。小写字母、数字和单个连字符组成如deploy-service。最长 64 字符创建后不可修改Description描述必填。简要说明 Agent 何时、为何使用该技能最长 1,024 字符Instructions指令工作流、规则、示例和预期结果使用 Markdown 编写 好的指令应让触发条件和预期结果清晰。建议包含When to use何时使用和Workflow分步工作流两节让每一步可执行、可验证。添加配套文件点击Add file可加入文本类参考资料、模板或脚本使用相对路径例如references/runbook.md事故手册scripts/preflight.sh预检脚本assets/review-template.md评审模板配套文件要求 UTF-8 纯文本不支持二进制和压缩包只有scripts/目录下的文件才能标记为可执行。文件也可以直接在编辑器中编写或从仓库导入。 分配技能全局 / 仓库 / 环境三级作用域分配规则决定技能什么时候可用任意一条匹配即生效多规则是叠加关系分配类型生效范围All sessions (global)所有会话包括无仓库会话Repository包含所选仓库的会话Environment从所选环境启动的会话可以同时勾选多个仓库和环境。环境会话可能同时命中全局、环境本身以及环境内仓库的分配。若删掉全部分配技能仍保留在目录中只是不再匹配任何新会话随时可以重新分配。 创建个人档案Profile一键选择你的偏好个人档案是过滤器而非覆盖器适合只想要其中几个技能的用户进入Settings Skills My profiles点击New profile。输入唯一档案名。勾选最多 20 个共享技能。点击Save profile。创建会话时档案只会保留同时启用且匹配目标的技能被禁用的条目会带(disabled)后缀提示。档案仅自己可见不会影响其他用户删除档案也不会删除其中的共享技能。️ 会话创建时的三种选择方式在新建会话页选好目标仓库/环境后打开模型和推理级别旁的技能选择器选项结果All applicable包含所有匹配且启用的技能默认None不带任何托管技能启动Personal profile仅包含档案中启用且匹配目标技能选择器旁的数字会实时预览将包含的技能数量若档案显示N ignored说明有 N 个条目被禁用或未分配给当前目标。自动化和集成未提供选择器时默认使用 All applicableAgent 派生的子会话会原样继承父会话的技能集。 检查 Agent 实际收到了什么会话创建时技能即被**固定pin**到特定版本。展开会话右侧边栏的Managed skills可以看到使用的选择方式All applicable / None / 档案名每个技能的规范名称和描述固定的修订版本号和摘要内容匹配原因如Global、Repository、Environment重启或恢复会话仍沿用同一版本不会自动获取新编辑——想要最新内容请新建会话。这正是可复现性的来源已运行或已创建的会话永远不会被后续编辑影响。 进阶从仓库导入技能技能通常已经在 Git 仓库里维护。通过Settings Skills Shared skills Import from repository可直接读取仓库中的SKILL.md及配套文件免手敲Repository实例可读的任意仓库Ref分支、标签或提交留空用默认分支Subdirectory仓库中技能所在子目录Name留空时默认取SKILL.md中的 name导入前会完整预览解析出的提交、每个文件大小、内容摘要和映射警告源仓库在预览后发生变化会拒绝保存。确认后再看一遍预览中的scripts/内容——导入等于把第三方指令引入全实例目录。导入会记录来源仓库、提交和摘要之后可随时重新导入拉取更新但不会自动同步。 限制速查表约束上限规范名称64 字符描述 / License / Compatibility1,024 / 200 / 500 字符配套文件数每技能99 个单文件大小256 KiB单个技能修订总量1 MiB档案或会话中的技能数20 个单会话托管技能总内容5 MiB配套文件路径必须是相对路径使用/不超过 10 级深度或 240 字节且不能占用SKILL.md。另外agent-browser、record-video、upload-screenshot、visual-verification、customize-opencode五个名称被沙箱运行时保留不可用于自定义技能。️ 常见问题排查现象原因与处理档案提示技能被忽略检查条目是否被禁用以及分配是否匹配会话的仓库/环境现有会话看不到最新修改技能在会话创建时固定新建会话才能获取新修订某托管技能缺失与仓库/内置技能同名冲突时平台保留发现的技能并丢弃托管技能仅告警会话照常启动。请重命名或改用新规范名保存被拒绝其他用户并发编辑了该技能重新加载最新版本再应用修改 关键文档与代码路径想深入了解内部机制可从以下路径入手官方使用文档docs/MANAGED_SKILLS.md完整设计文档数据模型、解析与固定机制docs/plans/managed-skills.md技能目录存储与 Markdown 生成packages/control-plane/src/skills/沙箱内技能拉取、校验与安装managed_skills.py共享类型定义skills.ts数据库迁移0061_managed_skills.sql从编写第一个deploy-service开始把团队的部署、评审和响应流程变成 Agent 的肌肉记忆——这就是 background-agents 的 Managed Skills 带给你的核心价值。【免费下载链接】background-agentsAn open-source background agents coding system项目地址: https://gitcode.com/GitHub_Trending/ba/background-agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考