SuperAPI AI 工具集

override-upstream

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

用途:把采用者仓库里的本地覆盖(override)升级为框架特性。输入为 .apache-magpie-overrides/<skill>.md 中的一个文件,技能协助用户判断该改动是否值得上游、设计框架级抽象、在 apache/magpie 中实现并开 PR。覆盖文件本身按 agentic overrides 约定是采用者本地、无 schema 的,便于快速编写但难以共享;上游化后该行为进入框架默认,采用者升级后即自动获得。

主要能力与用法:每次运行先在存在时读取 .apache-magpie-local/setup-override-upstream.md 与 .apache-magpie-overrides/setup-override-upstream.md 应用覆盖;并比较 .apache-magpie.local.lock 与 .apache-magpie.lock 检测快照漂移(method/URL 不一致需重装,ref 落后需同步,SHA-512 不匹配需先排查)。流程分为:预检(确认在采用者仓库、快照无漂移、定位框架克隆)、选择覆盖(每次一个)、阅读覆盖与框架技能、判断是否可上游(项目特定则停止;缺失特性/更好默认/重构步骤则继续)、设计框架级抽象(新增配置开关、修改默认、增加可选步骤或重构步骤)、在克隆中实现(git fetch origin && git checkout -b feat/<short-description> origin/main,运行 prek run --all-files)、开 PR(写入临时文件后用 gh pr create --repo apache/magpie --base main --head <user>:<branch> --title ... --body-file ... --label ...)、以及 PR 合并后的清理提示(setup upgrade 后删除覆盖文件并提交)。

限制:不修改 .apache-magpie/ 快照;所有改变状态的操作需用户明确确认;不自动删除覆盖文件;不适用于运行时应用覆盖、创建新覆盖或快照升级。资料未提供官方收费、价格与具体平台支持信息。