多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

GitAgent继承与组合详解:extends、依赖挂载与子代理委托实现高效复用

GitAgent继承与组合详解:extends、依赖挂载与子代理委托实现高效复用 GitAgent继承与组合详解extends、依赖挂载与子代理委托实现高效复用【免费下载链接】opengapA framework-agnostic, git-native standard for defining AI agents项目地址: https://gitcode.com/gh_mirrors/git/opengap使用 GitAgent 构建 AI 代理时继承extends、依赖挂载dependencies与子代理委托delegation是三大核心复用机制。GitAgent 是一个 git 原生的 AI 代理框架——代理的身份、规则、记忆、工具全部以版本控制文件形式存放在 git 仓库中。本文面向新手用最少的配置带你打通这套代理即仓库的组合体系让你快速把多个代理能力拼装成一个可维护、可 Fork 的整体。为什么需要继承与组合单独维护一个代理很简单但真实团队会很快遇到三个问题痛点组合机制的解法多个代理共享同一套人格 规则extends 继承子代理声明父仓库配置自动深合并团队要共享一批工具 / 技能模块dependencies 挂载把公共仓库克隆并挂载进来主代理要分派任务给专职小代理delegation 委托声明子代理主代理按需调用这套机制的源码实现位于 src/loader.ts完整配置字段说明可参考 Documentation.md。方法一用 extends 一行继承父代理只需在 agent.yaml 中加一行详见 Documentation.md# agent.yaml extends: 父代理的git仓库地址运行后GitAgent 会自动把父仓库浅克隆到.gitagent/deps/缓存目录然后执行合并实现见 src/loader.ts 的resolveInheritance函数。合并规则非常好记深合并子代理优先嵌套对象逐项合并同名配置以子代理为准工具tools取并集父、子两边声明的工具都会加载规则RULES.md做联合父代理的行为约束会追加到系统提示词末尾两者同时生效典型用法团队维护一个base-agent公共人格仓库每个业务代理 Fork 后只写差异配置——改一处、全局生效还能用git log追溯每次人格变更。方法二dependencies 挂载共享资产当多个代理需要复用同一批工具定义或技能模块时用dependencies字段声明依赖字段结构见 src/loader.ts# agent.yaml dependencies: - name: shared-tools # 依赖名称 source: 共享仓库git地址 # 仓库来源 version: main # 分支或 tag mount: tools # 挂载目标加载器会在每次启动时把依赖仓库克隆到.gitagent/deps/name实现见 src/loader.ts 的resolveDependencies函数指定版本可锁定到某个 tag保证团队各代理加载的共享资产一致。⚠️ 小提示依赖目录位于.gitagent/下该目录会自动写入.gitignore不会污染你代理仓库的版本历史。方法三delegation 子代理委托 除了继承配置GitAgent 还支持运行时分工——主代理把子任务委托给专职子代理。声明子代理在 agents/ 目录放一个文件夹或一个 md子代理的自动发现逻辑在 src/agents.ts支持两种形式目录形式agents/name/agent.yaml本项目自带的 agents/assistant/agent.yaml 就是一个现成例子定义了一个通用作码助手文件形式agents/name.md用 YAML frontmatter 写明name和description配置委托模式在 agent.yaml 中声明委托策略三种模式定义见 src/loader.ts# agent.yaml delegation: mode: auto # auto | explicit | router模式行为auto主代理自动判断何时分派给子代理explicit仅在明确指令时才委托router由指定的路由代理router字段决定分派目标委托是怎么发生的加载器会把所有子代理以available_agents列表形式注入系统提示词见 src/agents.ts主代理随后通过cli工具执行类似下面的命令完成一次真实委托gitagent --dir agents/assistant -p 重构认证模块并说明改动也就是一个子代理 一次独立的 gitagent 会话天然隔离、各自拥有独立的记忆与工具集。三种机制怎么选✅机制一句话定位适用场景extends纵向继承配置与人格的子类团队统一基础人格业务代理叠加差异dependencies横向挂载共享工具/技能仓库跨代理复用同一批工具定义delegation运行时分工主子代理协作复杂任务拆给专职小代理并行推进三者可以叠加使用用extends继承基础人格 → 用dependencies挂载公共工具 → 用delegation把重活分给子代理即可搭出结构清晰、易于维护的代理体系。总结extends让你一行配置继承父代理子配置优先、工具取并集、规则做联合dependencies让你像声明包依赖一样挂载共享仓库并锁定版本delegation让你把agents/目录下的子代理变成可调度的专职同事GitAgent 的精髓正是代理即仓库Fork 一个代理就是继承一种人格git log就能查看记忆演化。建议从 README.md 的快速开始入手再对照 Documentation.md 中的完整agent.yaml字段表动手搭出你的第一个多代理体系 ️【免费下载链接】opengapA framework-agnostic, git-native standard for defining AI agents项目地址: https://gitcode.com/gh_mirrors/git/opengap创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表