background-agents Managed Skills进阶指南全局、仓库级、环境级分配与个人Profile【免费下载链接】background-agentsAn open-source background agents coding system项目地址: https://gitcode.com/GitHub_Trending/ba/background-agentsbackground-agentsOpen-Inspect是一个开源的背景智能体编码系统open-source background agents coding system它可以在后台沙箱中替你的仓库干活跑任务、提 PR、跑定时自动化。它的Managed Skills功能让你把部署流程、代码评审规范、故障响应手册这类重复指令沉淀成可复用的共享技能并按全局、仓库级、环境级三种粒度分配给不同会话再用个人 Profile一键选中自己常用的技能组合。本文将带你从零掌握这套技能管理体系。一、什么是 Managed Skills为什么需要它 在没有 Managed Skills 之前团队要把同样的工作流提示词复制到每个仓库、每个会话里维护成本高且容易漂移。Managed Skills 提供了统一目录catalog概念作用谁能用共享技能Shared skill存放可复用的指令、脚本、参考文件整个部署实例的所有用户分配Assignment决定技能对哪些会话目标生效使用共享技能的每个人个人 Profile保存你偏好的共享技能子集仅 Profile 所有者⚠️ 官方提醒技能属于可信内容而非权限边界——技能可以引导智能体使用会话中已有的工具、凭据与网络访问。启用前请审查其指令与脚本详见 docs/MANAGED_SKILLS.md。上图为 Open-Inspect 主界面左侧是会话列表右侧新会话框底部可以切换模型与技能选择all skills (6)二、快速上手6 步创建第一个共享技能 进入Settings Skills在Shared skills页点击New skill填写规范名小写字母、数字、连字符如deploy-service创建后不可修改、描述和Markdown 指令选择技能生效的仓库或环境——默认是All sessions (global)全局点击Validate预览生成的SKILL.md确认无误后点击Create skill新建会话时保持技能选择器为All applicable该技能即自动生效。几个实用细节支持文件可添加references/runbook.md、assets/review-template.md、scripts/preflight.sh等 UTF-8 文本文件仅scripts/下的文件可标记为可执行从仓库导入如果技能本就在 Git 里用Import from repository可直接读取SKILL.md及其配套文件并记录来源仓库、分支、提交与内容摘要方便后续重新导入升级并发保护别人正在编辑同一技能时你的保存会被拒绝避免互相覆盖。技能编辑界面相关实现见 packages/web/src/components/settings/skills-settings/skill-editor.tsx。三、三级分配模型全局、仓库级、环境级 分配Assignment决定技能何时可用。一个技能只要任意一条分配命中会话目标就会生效可以同时挂多个仓库和多个环境分配类型生效范围典型场景All sessions全局所有会话包括无仓库会话提交规范、安全红线Repository仓库级包含所选仓库的会话某服务的部署流程Environment环境级从所选环境启动的会话多仓联动的生产环境操作两条进阶规则值得注意环境会话是叠加匹配从某环境启动的会话可以同时命中全局分配、该环境的分配、以及环境内各仓库的分配无仓库会话只能命中全局分配清空所有分配后技能留在目录中但不再自动生效。分配变更只影响新会话——已有会话在创建时就固定pin了确切的技能版本后续编辑不会改变运行中的会话。解析逻辑的核心实现见 packages/control-plane/src/session/skill-resolution.ts数据层在 packages/control-plane/src/db/skills.ts表结构参考 terraform/d1/migrations/0061_managed_skills.sql。四、个人 Profile打造你的专属技能清单 团队技能是公共资源Profile 是你的私人精选进入Settings Skills My profiles点击New profile起一个唯一名字勾选最多20 个共享技能点击Save profile。关键点Profile 是过滤器不是覆盖器创建会话时只有已启用 被分配到当前目标的 Profile 技能才会真正进入会话被禁用的条目会带(disabled)后缀展示不匹配目标的条目显示为N ignored这让你的一个 Profile 能跨多个仓库复用完全私密Profile 只属于你本人不影响其他用户也不改变技能本身的分配删除 Profile 不会删除其中的共享技能。Profile 数据存储逻辑见 packages/control-plane/src/db/skill-profiles.ts。五、创建会话时如何选择技能 新会话页面选好目标仓库/仓库集/环境后在模型和推理档位旁边的技能选择器中有三种模式选项效果All applicable默认包含所有已启用且分配命中的技能None不带任何受管技能启动某个 Profile只包含该 Profile 中已启用且命中的技能选择器旁会实时预览将包含的技能数量。补充两点自动化与集成Slack、Linear、GitHub 等没有选择器时默认使用All applicable智能体派生的子会话会原样继承父会话固定的技能集合保证子任务与父任务环境一致。选择器组件见 packages/web/src/components/session-skill-selector.tsx。会话创建时系统会一次性解析并固定技能版本随后沙箱在 OpenCode 启动前完成校验与原子安装安装器见 packages/sandbox-runtime/src/sandbox_runtime/managed_skills.py若所选内容无法获取或安装会话会启动失败而不是静默降级。六、事后核查这个会话到底用了哪些技能 打开会话右侧边栏展开Managed skills区域可以看到完整溯源信息本次选择模式All applicable / None / Profile 名称每个技能的规范名、描述、固定版本号与内容摘要命中原因Global/Repository/Environment。这是只读视图从这里编辑目录中的技能只影响未来的会话。重启或恢复会话仍使用当初固定的版本想要最新内容需新建会话。侧边栏组件见 packages/web/src/components/sidebar/managed-skills-section.tsx。七、限制与命名规则速查 ⚖️约束项上限规范名长度64 字符描述1,024 字符每个技能版本的附属文件数99单个文件大小256 KiB单个技能版本总大小1 MiBProfile 或会话内技能数20会话内技能内容总量5 MiB命名规则速记只用小写字母、数字和单个连字符名称全局唯一agent-browser、record-video、upload-screenshot、visual-verification、customize-opencode等名称被沙箱运行时保留不可用于受管技能。遇到名称冲突时系统会保留仓库/用户侧发现的同名技能、丢弃受管技能并记录告警其余技能照常安装。八、常见问题排查Troubleshooting ️Profile 提示N ignored检查条目是否被禁用以及技能分配是否覆盖当前会话的仓库/环境。改动没出现在已有会话技能在会话创建时即固定新建会话才能拿到新版本、新分配或新启用的技能。某技能因名称冲突缺失重命名或移除仓库内同名技能或新建一个不同规范名的受管技能并更新分配与 Profile。九、延伸阅读 官方功能文档docs/MANAGED_SKILLS.md完整设计方案数据模型、API、沙箱安装时序docs/plans/managed-skills.md系统工作原理docs/HOW_IT_WORKS.md技能目录前端packages/web/src/components/settings/skills-settings/skills-catalog.tsx会话技能持久化packages/control-plane/src/db/session-skills.ts总结用共享技能沉淀团队工作流用全局/仓库/环境三级分配精准控制生效范围用个人 Profile一键切换常用组合——三步就能让 background-agents 的智能体在任意会话中保持统一、可追溯、可复现的专业水准。【免费下载链接】background-agentsAn open-source background agents coding system项目地址: https://gitcode.com/GitHub_Trending/ba/background-agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考