v1.1.3 Codex 与 Claude Code 的任务委派

评审、实现、测试
交给另一个 Agent。

Runweft 通过 MCP 给 Codex 和 Claude Code 加上任务委派。
在当前对话里把工作交给你配置好的 Agent,
在本机或另一台机器上执行,完成后取回报告、代码和附件。

装其中一个就能用 Codex Claude Code
示意:任务在哪里执行
当前项目your-project/你 + 主 Agent
Runweft经 Hub 派到本机
⌘代码评审Codex
本机 · 共享目录
✳功能实现Claude Code
本机 · 独立 worktree
报告 · 代码 · 附件
示意:评审直接读当前目录,能看到未提交的改动;实现放进独立 worktree。报告和代码回来后,由你决定是否合入。
在现有的 Codex / Claude Code 对话里发起 本机执行,或派到另一台机器 取回成果,不自动合并或推送

典型用法

这些事,
可以派出去做。

主 Agent 是你正在对话的 Codex 或 Claude Code,负责拆任务、审结果。
动手的是 Hub 里配置的 Agent:一项职责,加上执行它的工具。
Hub 是 Runweft 管理机器、Agent 和任务的服务。

提交前,换个模型评审

在 Claude Code 里改完代码,让 Codex 直接读当前目录,评审还没提交的改动,按要求只写报告、不改文件。只装了一种工具,就让它自己再开一个评审。

本机共享目录 · 看得到未提交的改动

实现小功能,不动当前目录

比如“给导出接口加分页并补测试”。任务在独立 worktree(从已提交版本建出的单独目录)里完成,代码以 Git 提交取回,你审过再合入。

本机独立 worktree · 从已提交版本开始

耗时任务,换台机器跑

全量测试、Linux 构建这类活,可以派给接在同一个 Hub 上的另一台机器。它从你指定的提交建好目录再开跑,报告和附件回到当前对话。

远端独立 worktree · 先把机器接入 Hub

做完之后

报告、代码、附件,
都回到你手里。

主 Agent 读回报告,替你总结要处理的问题;代码取回到你的仓库,审过再决定是否合入。
想看过程,打开 Hub 任务页,原生会话和审批也从那里进入。

成果怎么取回
输入和输出附件开工前把文件送到执行机器,完成后按清单取回
可审查的 Git 提交远端成果经 Hub 传回,不需要先推到代码托管平台
Hub 任务页每一轮的状态和报告,代码、附件是否已取回

一次委派的经过

从一句话,到拿回成果。

发出第一条委派
  1. 01

    在对话里说任务

    告诉主 Agent 要做什么。它从 Hub 里挑合适的 Agent,必要时把任务拆开,再派出去。

  2. 02

    准备工作目录

    共享目录直接用当前项目;独立 worktree 先从已提交的版本建好目录、放好输入文件,再启动执行工具。

  3. 03

    执行,随时可查

    主 Agent 等待并读取进度,需要时处理审批或中断。过程也能在 Hub 任务页查看。

  4. 04

    取回,你来决定

    报告回到当前对话,代码和附件取回本机,审过再合入。要接着改就发下一轮,会话和目录都还在。

开始接入

接入交给 Agent,
你只确认三件事。

告诉它连哪个 Hub;第一次用,就在本机启动一个。
在浏览器里创建身份并确认,token 自己保存,不发给模型。
装好后在项目目录重开客户端,发出第一条委派。

复制这段话,发给 Codex 或 Claude Code
帮我接入 Runweft。用 npm 全局安装 runweft@1.1.3,读取包里自带的 Runweft Skill,按它的说明完成接入;以后升级和卸载也都用 npm。动手前先检查我已有的安装和配置,其他 MCP、Skill 和模型设置保持不变,要替换内容不同的 Runweft Skill 时先备份并问我。如果我给了 Hub 地址就连接它,没给就先问我是否在本机启动一个。身份由我在浏览器里创建或导入并确认,不要向我索要 token。然后登记这台机器和我已登录的 Codex 或 Claude Code,创建一个只写报告、不改代码的代码评审 Agent。最后装好 Runweft MCP,提醒我在项目目录重开客户端,并告诉我重开后发什么来完成第一次委派。

Agent 会先检查你已有的安装。其他 MCP、Skill 和模型设置保持原样;要替换内容不同的 Runweft Skill,会先备份再问你。模型登录仍走 Codex / Claude Code 自己的流程。

重开之后

在项目里发出第一条委派。

在项目目录重新打开 Codex 或 Claude Code,发出这句。主 Agent 会把评审交给代码评审 Agent,等它完成并读回报告。
读到报告才算接入成功;MCP 连上还不算。

怎样确认任务完成
在重开的会话里发送
用 Runweft 里的代码评审 Agent 审查这个项目,在本机共享目录执行,这样它能看到我还没提交的改动。如果没有未提交的改动,就审查最近一次提交;如果这里不是 Git 项目,先问我要审查哪些代码。只读审查,不要修改任何文件。等任务完成后读回报告,按严重程度列出需要我处理的问题。

手动安装 / v1.1.3

只装程序,
一条 npm 命令。

所有支持的平台都用这一条,npm 会自动选平台依赖。
配套的 HAPI 和 Skill 已经在包里。
装好之后,接入照样可以交给上面那段提示。

支持的平台

macOSApple Silicon
macOSIntel
Linuxx64 · glibc
Linuxarm64 · glibc

安装需要 Node.js 20+ 和 npm。执行任务还需要已登录的 Codex 或 Claude Code;用到 Git 的任务需要 Git 2.31+。

在终端运行
npm install -g runweft@1.1.3 --registry=https://registry.npmjs.org/ --include=optional &&
runweft --version

新终端里找不到 runweft?确认 npm 全局目录下的 bin 在 PATH 里。怎么检查

Hub 放在哪里

先在本机起步,
需要时接上团队。

Hub 负责身份、机器、Agent 和任务,每次委派都要经过它。
第一次用,让 Agent 在本机启动一个;
团队已有 Hub,直接连它的地址。

Hub 部署说明
LOCAL HUB

一台电脑就能开始

Agent 在你的电脑上启动 Hub,引导你在浏览器创建身份,再登记这台机器和工具。它和团队 Hub 是同一套服务,同样要身份和登记,不是离线模式。

TEAM HUB

多台机器,同一个 Hub

各台机器连到同一个 Hub,任务就能派到合适的那台,在独立 worktree 里执行,成果经 Hub 取回。执行能力可以分享给空间成员,你的私有 Agent 和任务不会因此公开。

常见问题

动手之前,
先看看这些。

Codex 和 Claude Code 都要装吗?

不用,装好并登录你在用的那一个就行。两个都有时,也可以跨工具委派,比如在 Claude Code 里发起、交给 Codex 执行。由哪个工具执行,取决于 Hub 中这个 Agent 绑定的 runtime,也就是某台机器上登记过的 Codex 或 Claude Code。

接入时要把 token 发给 Agent 吗?

不要。身份在浏览器里由你创建或导入,确认后凭据直接加密送到本机,不经过模型。token 副本请自己保存好:全部丢失后原身份无法找回,重新领取的身份也不会带上原来的空间和配置。

项目一定要用 Git 吗?未提交的改动会带过去吗?

共享目录模式不需要 Git,读的就是当前目录,包括未提交的改动。独立 worktree 和所有远端任务要求项目是 Git 仓库,从已提交的版本开始;未提交的文件、本机装好的依赖和模型凭据都不会自动带过去,依赖由执行的 Agent 自己安装。

让它“只读评审”,就一定不会改文件吗?

“只读”是写给执行 Agent 的要求,不是技术限制。执行时沿用那台机器上 Codex / Claude Code 的原生权限,Runweft 不另加沙箱。不想让任务碰当前目录,就改用独立 worktree。

任务做完,代码会自动合入或推送吗?

不会。Runweft 把代码成果取回到你的仓库,并保留 worktree;审查、merge 或 cherry-pick、处理冲突和推送,由你和主 Agent 决定。

能接着上一个任务继续吗?被委派的 Agent 还能再往下派吗?

能继续。每轮结束会关闭执行进程,但会话和 worktree 都保留,下一轮优先在原现场接着做。被委派的 Agent 里不启用 Runweft MCP,不会层层再派;Codex / Claude Code 自带的子代理功能照常可用。

配置和数据存在哪里?

Runweft 默认用 ~/.runweft,运行 runweft paths 可以看到实际位置。Codex / Claude Code 的配置和会话仍在原来的位置。安装 MCP 前会备份相关配置,其他 MCP 和原生设置保持不变。

怎么升级、卸载?

都用 npm。升级前先结束正在跑的任务、停掉服务,装好新版本后让 Agent 更新 MCP 入口和包里的 Skill,再重启检查。卸载时先移除 Runweft MCP、停掉服务,再执行 npm uninstall -g runweft;你的数据、模型凭据和其他设置都会保留。

从一次代码评审开始。

把接入提示交给 Agent,重开客户端后发出第一条委派。

让 Agent 帮你接入