MMW 是 Codex 和 Cursor 共用的开发工作流插件,包含技能、agent 派发工具和任务板。当前版本的源码在 mmw-v5-cloud/。Coordinator 和下级 agent 在云端执行工作流。
向当前宿主的 agent 发送仓库链接并说“帮我配置 MMW”:
安装 agent 按下文完成宿主插件安装,保留用户的模型选择,再验证技能发现和工具执行。需要用户操作插件目录或账号设置时,先完成其余工作,再指出剩余操作。
采用 pstack 的结构,同一个插件目录提供通用 plugin.json 和 .cursor-plugin/plugin.json。Codex 本地和 Cursor 的 marketplace 清单指向这份插件;Codex Cloud 使用同一份插件导出的 ZIP,由 owner 在网页上传。共享工具、默认模型配置和任务板都在 skills/dispatch/runtime/,属于同一个 dispatch 技能包。
MMW GitHub 仓库
├─ 提升版本并推送远端 ── Codex 本地 plugin 更新
├─ 导出插件 ZIP ── owner 在网页上传 ── Codex Cloud plugin 更新
└─ Cursor marketplace ─ Cursor 安装并登记插件 ─ 对话获得 MMW 技能
各宿主的插件内容:dispatch 技能包 → runtime/:工具、默认模型配置、任务板
执行环境的 ~/.agents/models.json ── 派发工具和任务板读取模型选择
本地、云端、单仓库和多仓库都使用这份插件。安装范围由宿主管理;消费仓库不保存 MMW 技能、工具或模型副本。其他人 clone 消费仓库不会因此安装 MMW。
本地宿主提供技能目录时,dispatch 直接验证并使用随包 runtime。云端宿主提供技能资源 URI 时,dispatch 首次使用会读取同一技能包的清单和资源,在执行环境中还原文件并校验 SHA-256。二进制字体通过随包的 base64 文本资源还原。每份内容使用独立缓存目录,整个运行复用已经解析的版本;资源 URI 不作为本地目录使用。
首次安装可使用 Codex CLI:
codex plugin marketplace add chancheuklap/multi-model-workflow
codex plugin add mmw-v5-cloud@mmw-v5
codex plugin list --jsonCodex App 可通过 Plugins 目录安装已配置 marketplace 中的 MMW v5 Cloud。IDE 扩展当前不提供插件入口,使用 Codex App 或 CLI 安装。安装后新开对话,运行 setup-mmw,确认 dispatch 和 research 出现在宿主提供的技能清单中。Codex 插件说明。
后续更新只需按下文的发布流程提升 plugin 版本号,并将对应提交推送远端。本地 plugin 使用已配置的来源更新,无需手动上传 ZIP。
Codex Cloud 的安装和更新由 owner 在网页插件页面手动上传 mmw-v5-cloud.zip 完成。上传的插件是文件快照;推送 GitHub 不会更新这份云端副本。
agent 完成版本准备、本地检查和提交后,导出完整插件包:
python3 scripts/release-mmw-v5.py package --output /tmp/mmw-v5-cloud.zip导出使用当前 HEAD 的已提交文件。agent 将 ZIP 的实际路径、插件版本和对应 commit 交给 owner;owner 在网页上传并启用更新后,新开 Cloud 对话验证技能读取、工具落盘和实际子代理派发。无需在 Cloud VM 内另外安装一个 Codex CLI 插件。
在 Cursor 的 Customize → Plugins → Browse Marketplace → Add Marketplace → Import from GitHub 中导入:
https://github.com/chancheuklap/multi-model-workflow
个人使用选择 User 范围,安装 MMW v5 Cloud。新开对话并运行 setup-mmw。这是自定义 marketplace 的导入方式;MMW 尚未作为公共目录条目上架,不能假定 /add-plugin mmw-v5-cloud 能直接找到它。Cursor 插件说明。
Cursor Cloud 在任务启动时配置 marketplace 插件,同一次运行固定插件版本。官方明确说明了团队 marketplace 的云端加载;个人 GitHub marketplace 是否进入 Cloud 对话,需要在新任务的技能清单中确认。Cursor Cloud 插件说明。
- 在实际使用 MMW 的宿主安装并启用插件。确认该宿主返回 MMW 的
dispatch、research和setup-mmw技能。云端任务检查云端对话自己的清单。 - 读取宿主提供的
setup-mmw技能,由它调用 dispatch 的 Runtime 部分解析随包工具。工具使用 Bash 和 Python 3 标准库,无需包管理器。涉及 GitHub 的工作流还需 Git 和已授权的gh。setup-mmw 是可选配置检查,其他技能首次使用时也会准备工具,无需每个 Cloud agent 手动运行 setup。 - 保留已有
~/.agents/models.json。首次使用派发工具时,工具按MMW_MODELS_JSON环境变量、插件默认模板的顺序创建缺失的用户文件。已有文件保持原字节,不会因插件更新而覆盖。 - 从每个消费仓库运行解析得到的
dispatch.sh row researcher --host codex或--host cursor。确认读取同一用户模型文件,返回当前宿主的模型行。工具路径来自 dispatch 的 Runtime 部分,不能写死插件缓存目录。 - 验证随包清单和工具执行成功,报告插件版本、runtime identity、技能发现结果和工具执行结果。Codex Cloud 先由 owner 上传 ZIP,再在新对话中从技能资源准备工具并实际派出子代理;生成派发卡片不能代替宿主启动验证。资源不可读时报告准确的 package、资源和错误。
~/.agents/models.json 包含 rows.codex 和 rows.cursor。同一执行环境的所有仓库共用此文件;任务板只修改当前宿主的模型行。派发工具从消费仓库运行,模型文件始终在当前用户主目录。
独立云端 VM 不继承本机文件。要沿用个人选择,将用户模型文件的完整 JSON 保存为云端环境变量 MMW_MODELS_JSON。setup-mmw 或首次派发用该值建立用户文件。模型值不是凭据,保存在平台环境设置,无需提交消费仓库。在任务板修改后,更新平台保存的变量,使以后新 VM 继承选择。
Codex 本地 plugin 通过提升版本号并推送远端更新;Codex Cloud 每次导出完整 ZIP,由 owner 在网页手动上传更新。Cursor 的更新方法见仓库根 AGENTS.md 的 Cursor user marketplace 部分。已开启的 night 继续使用启动时的版本。
原来的 curl 安装器、~/.agents/skills/mmw/ 松散技能、~/.agents/mmw/ 运行时和 .agents/cloud-setup.sh 已退役。迁移 agent 完成以下清理:
- 先确认原生插件已安装且能被目标对话发现,再移除上述用户目录中的旧 MMW 运行时。保留
~/.agents/models.json和其他个人技能。 - 删除消费仓库中 MMW 专属的旧运行时、模型副本、准备脚本和生成的 Git 排除区块,保留项目自有文件。
- 从 Codex 保存环境的 Install script、Start skill 和 Cursor 保存环境的安装、启动配置中移除旧 MMW 准备命令和手动扫描技能的说明。保留项目依赖和服务步骤,保存并发布环境配置。
- 原来用于播种模型的
MMW_MODELS_JSON继续有效。平台设置必须在对应平台保存;仓库删除准备脚本不会替用户修改已经保存的入口。
Codex Cloud 通过 owner 在网页上传的插件交付 MMW。消费项目的 AGENTS.md 无需登记安装路径。mmw-v5/ 是历史参考,不作维护。
修改 skills/dispatch/runtime/ 后,运行 python3 scripts/sync-dispatch-resources.py 更新资源清单和二进制文本资源,再运行本地检查。--check 只检查是否同步。插件执行无需构建步骤。
在 dev 分支准备版本:
python3 scripts/release-mmw-v5.py bump版本准备命令同步更新资源清单中的版本。运行相关本地检查后提交到 dev。经 owner 授权合并并推送到 main 后,GitHub Actions 按提交版本创建 tag、GitHub Release 和完整的 mmw-v5-cloud.zip。这是本地 plugin 的发布路径;Codex Cloud 仍由 owner 在网页上传 ZIP 更新。GitHub 不运行测试、不改变版本号。同一版本号不能用于另一提交。
ZIP 包含两份宿主清单和技能;工具、默认模型配置、任务板及其文本资源都包含在 dispatch 技能包内。打包使用已提交的资源,本地检查验证资源与原文件的版本和字节一致性。GitHub 发布让自定义 marketplace 可以取得新版,不等于公共插件目录已经审核上架。