SuperAPI AI 工具集

magpie-setup-override-upstream

部署与运维

查看项目

更新于 10-15 18:45

技能介绍

用途:该技能把采用者仓库中的本地覆盖文件 .apache-magpie-overrides/<skill>.md 走完“评估是否值得上游 → 设计框架级抽象 → 在框架克隆中实现 → 提交 PR”的流程。覆盖机制本身无 schema、无锚点、无补丁工具,写起来快但难共享,上游化是当覆盖不再项目专属、更像缺失功能时的出口。

主要能力:列出覆盖文件并挑选一个;读取该覆盖与快照中对应的框架技能;判断变更属于项目专属、缺失功能、更好默认值还是步骤重构;设计框架侧改动形态(新增 <project-config>/ 配置开关、改默认值、新增可选步骤、重构现有步骤);在本地 apache/airflow-steward 克隆中实现并打开 PR。

用法:技能在采用者仓库预检,确认存在 .apache-magpie.lock 与覆盖目录且快照无漂移,否则建议先运行 /magpie-setup upgrade。定位框架克隆(如 ~/code/airflow-steward/),无则用 git clone git@github.com:apache/airflow-steward.git 创建。选型后读取覆盖与快照技能,判断可否上游化,设计抽象,然后在克隆中执行 git fetch origin && git checkout -b feat/<short-description> origin/main,运行 prek run --all-files,展示 git diff 并确认后提交,最后 push 并用 gh pr create --repo apache/airflow-steward 创建 PR,标签按 docs/labels-and-capabilities.md 选择 area:* 与 capability:*。

限制与规则:不是每个覆盖都应上游化,项目专属内容应保留在本地;只写入框架克隆,绝不修改只读快照 .apache-magpie/;所有改变状态的操作需用户明确确认;PR 与删除覆盖解耦,删除须在 PR 合并并运行 /magpie-setup upgrade 之后手动完成。漂移严重度:方法或 URL 不同需完整重装,ref 不同需同步,svn-zip SHA-512 不匹配则安全告警。该技能不用于运行时应用覆盖、不用于创建新覆盖、不用于升级快照、也不用于与覆盖无关的框架 PR。