用途：把 Magpie 技能或工具在运行中出现的非预期缺陷（损坏的辅助脚本、重命名后遗留的路径、嵌套层级读错、令人困惑的硬失败等）转化为对 apache/magpie 的修复 PR，使后续使用者都能获得修复。它只处理框架自身缺陷，不处理本地配置错误，也不用于推广有意的本地覆盖（那是 setup-override-upstream）。
主要能力与流程：Step 0 预检，确认存在具体缺陷并先解决快照漂移（对比 .apache-magpie.local.lock 与 .apache-magpie.lock，漂移时建议先升级，因为缺陷可能已在 main 修复）；Step 1 逐条列举缺陷的症状、涉及的框架文件与证据；Step 2 分类为 framework-bug、local-misconfig、already-fixed-upstream 或 uncertain，本地问题走本地修复，不确定则改为提变更建议 issue；Step 3 用 gh search issues / gh search prs 检索 apache/magpie 去重，已有未合并修复则只告知用户不重复提交；Step 4 设计最小修复；Step 5 在框架克隆中建分支、加回归测试、运行 prek run --all-files、提交并推送、创建 PR；Step 6 输出每条缺陷的结果汇总。
关键规则：一个缺陷一个 PR，绝不合并；只提框架缺陷；先查重；所有改变状态的操作（clone、branch、commit、push、gh pr create、gh issue create）都需用户明确确认；写入框架克隆而非只读快照 .apache-magpie/；PR 正文用 --body-file 临时文件；提交使用 Conventional-Commits 前缀与 Generated-by: 尾注，不使用 Co-Authored-By:。
前提与限制：需要 gh 已认证、拥有 apache/magpie 的 fork、本地存在独立的框架克隆，并能访问 github.com。gh search 不支持 --state all，省略 --state 即搜索全部。若推送因工作流权限被拒，需同步 fork 或 rebase。用户可在 .apache-magpie-overrides/user.md 中设置 contributions.suggest_upstream_fixes: false 关闭会话结束时的主动提示。具体收费、价格与平台信息暂未提供。