Index of every page on this site: llms.txt
All skills
cat-xierluo avatar

/magpie-optimizer

@5fb69a0
Run it yourself

用 Magpie 配置并优化 AI 工作效能:接入供应商、订阅与插件,配置模型路由组与意图规则,管理网关、可见性、共享 MCP 与搜索;盘点额度与套餐,诊断 Token 消耗与限流,把每次调整关联真实任务验收效果。

Use this Skill: https://skilld.dev/gh/cat-xierluo/legal-skills/magpie-optimizer

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

CHANGELOG.md

≈4.1k tokens on demand. Your agent reads this file only when SKILL.md points to it.

变更记录

[1.8.1] - 2026-11-21

新增

  • 新增 references/cross-device-sync.md:沉淀多台电脑共用 Magpie 配置的抽象同步方案,覆盖数据域取舍、WebDAV/S3/GitHub/一次性备份选择、信任边界、权威机与 follower 收敛、验收矩阵、超限 Skill 和常见网络/认证/路径故障分层;公开文档只使用占位端点,不包含个人环境信息。
  • SKILL 工作方式表新增跨设备同步入口。

[1.8.0] - 2026-11-01

新增

  • 增加输入开销与经济性排查:从网关分项核系统提示、工具、Skill、规则、文件、结果与对话,以质量、缓存和真实用量复核效果;Agent/Skill/编排规则的修改交对应维护方。补出站协议与断流的证据边界,不自动裁剪请求或改变在途任务。
  • 新增有界只读效率分析 CLI:流式读取具名日志,分列 HTTP 状态、含错误信号的结果、实际尝试、调用种类、输入分项、缓存与延迟;拒绝覆盖私有回执,坏行和覆盖截断不伪装完整。
  • references/gateway-resilience.md:分查推理、模型目录、认证、额度采样和进程生命周期;加入双插件认证争写循环的离线复现机制,以及 MiniMax 多入口的登录、目录与额度排障顺序。
  • scripts/gateway_guardian.sh:只读报告宿主 RSS、僵尸/孤立线索与过期缓存数量;默认 status,兼容旧子命令名,不杀进程、不重启服务、不删缓存、不截断日志,DRY_RUN=0 也不开放写操作。
  • SKILL 增加网关故障隔离和 MiniMax 排障入口。
  • 新增有界、只读的 magpie_resilience.py:按宿主 PID/启动时间分段观察 RSS 与认证文件元数据,不读取凭据内容、不启动 CLI/网络/后台任务;输出私有回执及实际覆盖,失败不伪装成零。
  • 增加宿主持续内存增长的分层取证参考:现场保全、共享宿主身份与事件对齐、候选/反证、离线复现和维护窗口边界;采样回执记录 UTC 时点,时长与预算继续采用单调时钟。
  • 补官方/旧 fork 绑定收敛、更新通道与通知偏好、探测节流的本地缓解矩阵及定向恢复边界;宿主取消/超时问题附上游可复现 issue。
  • 补 launchd 正常退出后无条件重拉的诊断与条件托管边界,明确只读 Guardian、任务感知维护和真正服务重启的区别;重载有运行 PID 的 job 不能当无中断配置操作。

修正

  • 纠正网关诊断与全局协作的职责:撤回本 Skill 中的 worker 任务卡模板、上下文继承参数和原生宿主配置清单;这些由 Personal Agent 等 Agent 管理/编排层及全局/项目规则维护,不复制为第二套派工协议。
  • 上下文观测保留独立 Skill 分项,兼容路由用量对象/列表;缺少缓存计数保留未知,避免误报零命中。
  • 撤回“进程可跨操作系统重启存活”“PPID=1 且无监听即可清理”“终止主进程属于无中断滚动重启”等不准确结论。
  • 不再以 registry 超时直接定因全部模型目录刷新;保留事件计数、内存观察与具体实现归因的证据边界。
  • 旧巡检脚本的缓存删除不受 dry-run 保护,重启分支也缺少完整归属核验;当前版本收束为只读报告。运行副本须按哈希单独核验采用,文档更新不等于后台副本生效。
  • 区分 provider/plugin 开关、静态备用目录/实时目录、额度未知/认证失效,以及分类器/worker 的实际调用;恢复验收保留观察窗口和未验证范围。
  • 内存专项复核补宿主取消/目录超时的隔离复现与父进程退役时限;明确历史异常增长不等于已定位 Bun 堆泄漏,并撤回把换代后的小宿主当作旧宿主自行回收的因果口径。

[1.7.0] - 2026-10-27

新增

  • 新增 references/cli-command-reference.md:完整 magpie 命令面(供应商、订阅、插件、agent 指向、子 agent、路由组与规则、网关 key 与预算、模型呈现与定价、共享 MCP/指令/搜索、维护命令)与 magpie quota --json 字段读数合同;命令面与字段合同整理自 magpie-community/plugins 的 magpie-setup 与 magpie-quota(MIT),按 MIT 兼容方式并入并重写。
  • SKILL 工作方式表新增两条入口:查子命令写法/接入路径、查额度窗口与等待恢复,直接路由到命令参考与额度合同;纯命令语法与纯额度读数不再需要另装独立 Skill。

调整

  • description 扩展为覆盖配置与额度完整能力,避免与官方 magpie-setup / magpie-quota 触发面重叠时漏接。
  • 插件指南中「原生接入可用」的回退路径改为指向命令参考与接入验证步骤。

[1.6.0] - 2026-10-26

修复

  • 适配原生 CLI 持久化时段时区:计划显式绑定本机时区与预期回读,保留原规则时区漂移检查;隔离 CLI 验证修改与恢复。
  • 单供应商容量提示作为咨询级风险保留,不再单独阻断 --strict;结构与规则警告仍按严格门禁处理。
  • 盘点账号输出统一为单次扫描内的匿名标签,去除昵称、邮箱片段、域名和上游半遮罩;映射仅留内存,盘点结果仍保存在私有状态中。
  • 将配置复制指南移入 references,移除 Skill 内 README;复制示例拒绝覆盖既有私有配置并使用 0600 权限。
  • 公开参考删除个人调用统计,保留核验方法;明确画像由 Agent 解释、盘点与设计校验不会自动生成嵌套路由。
  • 设计校验器改用严格 JSON 解析,拒绝重复键;格式不符时停止语义检查并返回结构化错误。嵌套深度含入口最多 8 个组,叶子模型不计层数。
  • 画像 schema 增加约束内 expensive_models 清单,盘点脚本读取该规范字段并兼容历史私有格式。
  • 设计校验器对非字符串成员和暂停目标 fail-closed,不再输出 traceback;账号顺序输出恢复未知/空/已设置三态。
  • 根 README 与 Skill 发布分发套件索引对齐为 9 个成员、源码 v0.1.3;仓库根发布检查不再误报必需的 state/.gitignore。
  • 修正路由治理 §2.8 的代理探测与继承边界:双路失败不证明必须代理,空 choice 仍继承 全局;账号与 CLI 子进程的显式 choice 优先,回环例外与系统透明转发另核。
  • 改为先验证必须代理的 provider,再切全局直连;回退绑定本次字段与预期后态,避免断路 或覆盖并发修改。同步既有治理记录与历史观测证据边界,不改生产配置。
  • 原始 TASKS.md、DECISIONS.md 改为同目录本地维护记录,由 Skill 内 ignore 规则排除; 公开树不再发布摘要版。配置说明放入 references/configuration.md,列出五类 example 的私有副本、用途、 schema 与最小复制/校验路径。

变更

  • 新增智能路由设计:按用户已配置的 provider、账号池、模型能力与任务角色生成个性化路由草案;沉淀角色分层、资源映射、意图规则、子 Agent/辅助调用边界与设计检查矩阵,不写入任何个人模型或账号。
  • 路由设计示例改为单一入口嵌套多个角色组:外层 order + turn 负责角色层编排,内层组负责同层成员回退;补充 compact、轻任务、普通任务、困难升级与项目级终审的规则顺序示例。
  • 从私有维护仓库迁入 legal-skills 公开目录;原始任务与决策记录迁入 Skill 同目录本地维护并由 ignore 排除, 公开层保留通用入口、参考、脚本、示例/schema、许可证与变更记录。
  • 本机画像、集成信息、路由策略与可执行 policy 放在 config/*.local.* 私有层; 观察、盘点、计划、回执与快照放在 state/,均由随包 ignore 规则排除。
  • 通用入口补公开主页;示例命令的网关端口改为 <port>,具体模型组示例改为泛化占位。

[1.5.0] - 2026-10-25

新增

  • 子 Agent 指名覆盖观测(references/subagent-override.md):记录 Codex 宿主上 spawn_agent(model=...) 的普通请求几乎总被写到统一默认组、ChatGPT backend 封印是 例外路径,以及 subagent.to/subagent.kept 的判读方法。统计口径区分组展开、 具体模型指名不一致和 provider 前缀差异,要求本地证据绑定实际读取截止时间。
  • references/subagent-models.md 修正优先级口径:agent TOML 是持久指定入口;spawn 参数 不能当可靠机制,模型敏感任务必须回执实际 served model。同步修正 references/inventory.md 中「子 Agent 自动重入主入口意图分流」的相反口径。

[1.4.0] - 2026-10-25

新增

  • 路由治理参考补出口代理的两层边界(references/routing-governance.md §2.8):全局 direct 与空值(继续跟随环境变量与系统代理)不同;provider 级代理在 onLAN 判定前 返回,不受全局值影响;账号层登录态刷新走账号自己的代理。给出「先探测哪些出口真的 需要代理」「全局值影响登录类厂商 CLI 子进程与进程内签到请求」「provider 级代理可能 无 CLI 写入口」三条边界与「先改全局、后加 provider 代理」的可回退顺序。

变更

  • 原 §2.8、§2.9 顺移为 §2.9、§2.10;同步 references/preflight.md 的 交叉引用;证据边界补记 0.1.1371 的 netproxy、provider/proxy、settings 核对结果 与「登录类子进程与进程内签到未逐项实测」的未核实项。

[1.3.0] - 2026-10-24

新增

  • 面向公开发布补齐自包含入门与接入能力:本地私有配置层、盘点/入门/操作/插件/隐私参考、 provider 接入边界与路由模板。
  • 新增只读体检、盘点、公开发布检查和配置示例验证脚本,并补充离线回归。
  • 新增 profile、inventory、integration、可执行 policy 与 route design 的示例/schema。

修复

  • 明确 magpie_route.py inspect 与 magpie_inventory.py scan 的输出字段边界,避免同名 schema 被误读为同一快照。
  • 明确可执行 policy 与高层 route design 的边界,防止把设计模板直接喂给 plan。
  • 公开检查补齐私有层泄漏、坏 UTF-8、符号路径、secret 样例与版本一致性门禁。

[1.2.0] - 2026-10-22

新增

  • 路由治理参考补三处实测坑(references/routing-governance.md):
    • 本机解析到回环的厂商域名会让全局代理被绕过;0.1.1307 源码解释 loopback 例外、解析、 onLAN 直连与 provider 级代理 choice 的先后,排障时先核解析来源。
    • 区分规则命中、目标不可用与分类器回退:unready/then/instead、 classified.error/fallback、tries/served 分别断言,不把落点偏离直接归因于配置顺序。
    • 强模型入组会被兜底消耗;顺序结论限定于 order 的新 turn 重选路径,末位只是降低概率, 硬性不消耗用移除或 pause。记录 0.1.1307 没有“规则未命中移出回退”的开关。
    • 能力层必须显式接进唯一入口,并区分「组存在」与「外层会选到」;同一 provider/model 与固定 effort 经能力组和免费池重复进入会被折叠到首次出现位置,共享会改变默认落点。 单一候选休息会移到队尾并可能被探测,关闭或移除才无候选承接。
    • 嵌套组的内外层 routing/rules 相互独立;外层 order 不会改写内层 smart。经外层请求 的会话保持由外层 affinity 控制,内层 stays 仅在直接请求内层组时生效;变更后需分别核对 直接请求与外层请求的两层 tries。

[1.1.0] - 2026-10-21

新增

  • 路由治理参考(references/routing-governance.md):面向「只用组内一个入口」的统一入口落地。 含四类常见失败的定位表(额度耗尽/排队拒绝/掉登录/组被停用)、六个实测坑 (disabled 无 CLI 开关、provider fallback 每次调用整体替换、fallback 可指向组、 普通模型可逗号并列但组目标需单独设置、stays 存为 affinity、GUI 与 CLI 同写配置)、 条件式建组/拆组判据、pattern 成员与三层 order 口径、smart/rotate/weight/manual 路由语义、规则顺序与 classifier 依赖、计点层有界溢出和可回读止损、免费窗口迁移验收、 失败判据与最小回滚、嵌套组逐层验收,以及真实请求看 served model 的验证方法。 客户端边界另记录 model_catalog_json 静态快照的刷新义务,以及标题、摘要、输入预测、自动审批、记忆/压缩等辅助调用与路由组的 独立核验方法;未核实项明确标 NOT_VERIFIED。

[1.0.2] - 2026-10-21

新增

  • 子 Agent 模型指定参考(Codex/DSH):Codex 双入口与三级优先级(agent TOML 指定 > [agents] default_subagent_model > 主会话模型)、ChatGPT backend 任务封印坑;DSH 请求级 agentOptions、工具行配置级固定与继承父模型三层。
  • 记录网关不分主/子角色的边界:统一与单独配置的仲裁都发生在客户端配置合并,子 Agent 按意图自动分流仍归 smart-split。

[1.0.1] - 2026-10-16

改进

  • 增加跨harness通用smart-split维护合同,按任务意图、时段和默认顺序选择优先模型,不要求客户端预先绑定角色模型。
  • 增加按用户确认的成本边界和客户端接入方式审查配置的规则,避免从组名推断设计错误。
  • 区分强模型优先与强模型硬隔离、分类器失败与语义验收失败,明确当前有限变更脚本的适用边界。

[1.0.0] - 2026-10-16

改进

  • 从公开仓库的忽略测试目录迁入 private-skills 独立仓库,以 magpie-optimizer 为唯一名称。
  • 按根目录技能版本规范建立首个私有入库版本,保留完整测试版历史;运行逻辑沿用0.2.1。
  • 通用源码和维护文档入库;个人用量、配置计划、密钥和运行证据仍保存在仓库外。

[0.2.1] - 2026-10-16

改进

  • 按用户要求直接迁移到 magpie-optimizer,移除旧名称兼容目录和安装入口;更新当前指引与配置写入锁名。
  • 历史版本记录和私有验收证据继续保留,日常发现和调用仅使用新入口。

[0.2.0] - 2026-10-16

新增

  • 更名 magpie-optimizer,扩展为个人 AI 工作效能入口;保留 magpie-routing 兼容调用。
  • 只读请求采集、较长等待、分页覆盖和首尾检查,按来源/会话/模型汇总;保留局部上下文与工具缓存的独立口径。
  • 带事实、假设、行动和验证指标的诊断,不以占比阈值直接判定浪费。
  • 既有分组有限变更、精确中间/最终后态恢复、逐条回读和漂移拒绝。
  • 真实任务产物与验收哈希关联、重复任务/请求拒绝、每份验收成果的描述性比较。

修复

  • 处理 Magpie 将 stays 保存为 affinity 的实际字段映射。
  • 拒绝跨页重叠、虚假完整覆盖、未知来源归为网关及同一任务重复计入成果数。
  • 窗口与计数矛盾时保留元数据告警,避免把异常比率当真实溢出。

待办事项

  • 跨真实可比任务验证实际优化收益;当前效果比较工具只给描述性证据,不宣称因果收益。
  • 持续监控和自动业务派发仍按具名授权另行接入。

[0.1.0] - 2026-10-15

新增

  • 基于 Magpie CLI 的供应商、分组、启用状态和套餐额度盘点,输出字段白名单及私有文件。
  • 按质量底线、额度期限、时段、并发、缓存与返工成本规划 token 使用,区分免费池、执行池与深度任务池。
  • 新分组的可读配置计划、哈希及新鲜度检查、CLI 写入与逐条持久化回读;拒绝同名替换和配置漂移。
  • 既有分组与供应商的原生命令操作合同、失败恢复边界及隔离测试。

待办事项

  • 第一版脚本不自动编辑已有对象;真实平台推理、计费及多轮 Agent 稳定性分别保留验证边界。

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts18d3 checks · Risk SAFE
  • Gen Agent Trust Hub18d

    This skill provides a robust and security-conscious framework for managing AI model routing and telemetry via the Magpie CLI. It includes extensive defensive measures such as local-loopback-only network enforcement, restricted file permissions (0600), comprehensive credential redaction logic, and a self-auditing suite to prevent secret leakage.

  • Socket18d

    No alerts

  • Snyk18d

    Risk: LOW · No issues

Signed by skilld at 5fb69a0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated yesterday
Other metadata
metadata
{
  "version": "1.8.1",
  "author": "杨卫薪律师(微信ywxlaw)",
  "homepage": "https://github.com/cat-xierluo/legal-skills"
}

README badge

README badge for cat-xierluo/legal-skills/magpie-optimizer