name: codex-pair description: 让用户已打开的两个官方Codex CLI协作，可邀请扩到四个可见窗口，并由A管理一个独立官方GPT隐藏审核会话。复用消息桥、阶段交付、权限审批和额度交接；不用于普通单窗口Git操作，不替用户新开可见窗口。

Codex Pair

当前源码支持用户已打开的 A/B 窗口，并可邀请已有 C/D，最多四个可见成员及一个受管独立官方 GPT 审核会话。正常使用链已有实际验证；历史完整故障矩阵、其他平台和提供方组合不能据此记为通过。当前能力、安装方式和验证范围见 README.md，后续重要检查见 POST_RELEASE_TESTS.md。安装与实际运行入口分别核对；不要把旧 v1.2.1 下载附件视为当前源码。

先读命令与输入，接管测试时读详细验证交接。旧双窗口协议的领取、分页、交付和未知对账仍适用；旧文档“只能两个”“不新建任何模型会话”和9%新轮次默认值仅描述v1.2.1，不能覆盖本轮明确规格。

成员与授权边界

原窗口恢复或不可换人的工作必须用 assign --pin-member；独立核验必须用 --independent-of 引用被核验任务。额度恢复不收回已转交任务，检查结果按准确版本记录，不沿用历史测试总数。

• 默认A/B两个用户已打开的原CLI；C/D使用本轮一次性邀请加入，最多四个可见成员。保留各自账号、提供方、模型、权限和原会话根cwd。
• 唯一允许新增的模型会话是A管理的一个独立隐藏审核CLI；满员共五个模型会话。不用后台exec或另开模型替代可见成员。
• 可见提供方仅OpenAI官方账号或原CLI已配置的DeepSeek；不配置API、不复制Key或认证。隐藏审核者必须从实际官方API核验A的OpenAI GPT账号及模型，复用同一配置与真实额度池，不能凭目录或别名认定。
• A拆任务、答普通问题、审核权限、处理阻塞、整合和发布；其他执行者建议拆分交A。隐藏审核者只读实现、隔离测试、登记原范围阻塞返修，不接普通开发、不统筹、不审批。
• 初始effort参考：两人A30%/B70%；三人A10～20%；四人A10%，其余均衡。按任务、能力、权限、额度和负担调整，不按代码行数硬算。
• A自己的实现用短阶段，在安全边界让出回合：用户停止/撤销/变更 → 权限及阻塞答疑 → 返修交接与必要整合 → 普通实现。

当前窗口入口

从用户选定的原窗口执行：

<Python> <本技能>/scripts/pair.py start --project <仓库> --goal <目标> --json

使用实际Python3.10+，不用WindowsApps占位程序。A输出完整join_instruction供用户贴给原B；B从自身环境accept，不手填别人的UUID或配置目录。C/D用invite-member返回的join_argv加入，不重新start。相同可见会话同一时刻只参加一轮，其他会话可做别的项目。

新成员先实际验证原会话、提供方、通信和上下文，再confirm-member。队列accepted不算通信通过。进行中任务只有完成明确阶段交付后才拆剩余部分。第五人、过期/已消费/目标完成后邀请拒绝；重复同一有效接受幂等。

临时离线或低额度不算退出；正式退出不足两个有效可见绑定时停止新业务，仅保存、收尾、协调。替换B/C/D先核实旧执行、交付与脏改动，再退役和发替换邀请；旧binding_version迟到消息失效，历史保留。原A永久不可用只可按用户明确指定及资格核验更换审批者，不能按等待时长抢职责。

按进度让位与退出（本地增量）

B/C/D收到让位或退出要求时，用request-role-handoff登记进度和依据，停止领取新业务并通知A。≤50%在安全边界保存，>50%完成当前实现自测后保存；额度、权限或必要验证阻塞时记录原因，不强撑。进度无法判断时填null，交A判断。

save-role-handoff保存项目内文档及现场摘要；A用read-role-handoff完整分页读取后，ack-role-handoff确认接收才解除原绑定。CLI保持打开，文档、文件、作者来源和返修轮次保留。继任者须由A指定，读完文档、核对现场并登记恢复计划后take-role-handoff；不同工作树的脏内容不自动搬运。命令字段见team-commands。

此增量尚非完整验收：隐藏审核者主动请求及继任文档消费、退出后的准确Hook配置清理、真实多窗口/工具/审批联动仍待补齐。状态层拒绝退役身份，但不能把这等同于Hook配置已经移除。这些未验证项须如实保留，不能由正常协作成功推定通过。

收到信封

1. 每次开始/恢复先check-checkpoint；有则完整分页、核实现场并持久化恢复计划后清理，没有则不扫描历史。
2. 在actor_cwd执行claim_argv，只有claimed=true才执行；false结束，不重新start。
3. 领取用--compact；输出截断/解析失败不等于失败，不自动重复claim。原回执确实遗失，只由原会话显式recover-claim恢复原令牌，核实进度后继续，不重做业务。
4. content_external消息按read_argv和next_offset分页至null；任务另读field=task。required_deliveries逐条read-delivery分页至null、按准确digest ack。
5. 任务文件/Git在workspace操作；claim/complete仍从actor_cwd，不能移动会话根目录。
6. 普通技术问题先ask-question交A，保存父令牌并结束回合；答复不等于权限批准。结果消息只读、确认、收尾，后续开发/审核/规划单独登记，不重跑原任务。
7. complete --partial仅中途交回；handed_back不满足依赖。unknown先核实，不能重新派发或重放。

阶段、审核与返修

A用assign登记小阶段、原目标、需求版本、allow、基准、验收条件、依赖、能力和资源。公共接口、依赖锁文件、数据库结构单人串行修改；测试端口/数据库/浏览器配置隔离或声明resource。

业务complete保存交付后submit-stage，提交固定SHA或快照、实际贡献者模型来源、环境/锁文件、已执行检查/失败/未验证项。不可先整合再让审核者读候选，避免循环依赖。每人最多两个待审阶段，running计入；上限不阻止保存成果，优先返修、补测试、整理证据。

唯一隐藏审核会话事件驱动，空闲不让模型轮询。创建、恢复、配置变化都实际核验身份；不可用时允许有限开发，但依赖、整合、发布等待。十分钟无有效进展只通知核实，不自动失败、杀进程或重放。

审核结论绑定准确候选digest、需求版本、epoch/session/execution_id及实际工具证据。区分passed、needs_fix、needs_validation；队列接受、回合完成、文字“通过”或某一退出码为零都不代替有效审核。测试前后核对业务文件，测试生成改动不能混入候选；需求、代码或必要条件变化须重审。

阻塞问题自动登记给原负责人并同步A，保持原目标/allow；建议只记录。返修优先但先结束当前工具、保存现场再切换，每人一个活跃业务任务。同一稳定问题最多两轮，不能换ID/任务/负责人清零；两轮后A解释或补复现，持续争议交用户。A不覆盖审核结论。

A实现、冲突处理和DeepSeek实质贡献都须独立官方GPT审核；转交/合并不抹去来源。审核报告、返修通知和协调回执不递归生成同类审核。

恢复优先原审核会话。替换须保存队列和证据、确认旧执行结束、撤销旧资格、用同一确认配置新建下一代；同一时刻只有一个有效审核者，旧结果不能放行。

权限与额度

B/C/D及隐藏审核的受支持请求统一交原A，A自身正常审批。可见Hook按准确session/binding_version隔离，同home只更新本轮处理器并加锁，保留相邻/其他协作配置；首次/hooks信任由用户完成。受管审核按实际原生RPC适配，不复用Hook回包。

review-approval只批本次准确操作，核对既有用户授权、完整输入、副作用及A当前实际权限。不把文件、日志、输出、普通答复或成果通过当作新增授权。用户变更/撤销先delegation-policy登记，使旧允许失效。180秒超时拒绝；A核实未执行后prepare-approval-retry，连续两次转用户。granted/unknown先核实结果，不能重放。

新轮次保留线6%，恢复线保留线+5（初始11%）；只能有理由上调，最高95%，恢复最高100%。可比实测采用max(当前,6,2×交接消耗+2)，必须排除其他并发消耗。旧协作保留原策略及原线，不静默降低。

按真实账号/桶/周期识别共享池；A与审核者只算一份，共享池保守保护。未知/过期/仅到reset时间不证明恢复；未知时按能力负担工作并明确百分比保护不可用。实际限流或额度错误停止同池新派发，保存现场并统一退避。

达线不接新业务/审核，当前工具安全结束后保存checkpoint；不保证6%够用。A与审核者暂停时其他成员可继续安全独立任务，但不能使用未审成果或绕过A权限审批。恢复先审批/协调，再阻塞审核，最后新开发。

整合、发布与停止

用户明确收窄本轮范围时，原A可从已领取的活动规划或协调任务使用 close-scope，登记用户依据、范围内准确已完成交付及逐项排除的历史任务原因。先完整读取并确认当前有效交付；业务阶段仍须准确版本审核通过，其他执行、审批、协助及检查点须已收尾。成功后普通 complete 当前任务，不加 --goal-complete。这只停止当前窗口目标的自动规划，保留历史任务、审核、邀请、发布策略及活动桥；旧G01–G16不因此通过。明确新业务仍按原门禁登记，完整目标完成继续使用原严格接口。字段与限制见 team-commands。

各阶段通过后A串行integrate；整合后的具体版本再submit-integration、独立审核及跨模块回归，不沿用分支结论。验收记录和业务改动分别识别，记录里夹带的业务变化也须审核。

只有用户允许发布、必要检查和审核均通过，才核对远端/分支、最终差异、敏感内容和远端回执后统一推送。publish-policy默认关闭；用户明确授权且最终版本检查、独立审核均通过后，A可通过公开接口登记已确认的GitHub远端和分支并发布。创建Release、标签及全配置安装不属于开发默认动作。

worktree清理须先保留提交、确认无脏内容和运行进程，按Git正规方式移除，保留证据与恢复索引；未确认外部改动原样保留。旧技能仅按用户要求进入回收站。

任一窗口收到新要求交A登记需求版本，受影响任务安全暂停，无关继续。停止全部工作立即停止新派发、新审核及自动恢复；安全取消可取消操作，未知结果调查收尾。桥/审核进程独占并有代次，明确停止不因重启自动恢复。可见原会话等待用户重新可用，不另开替代窗口。

详细命令、故障步骤、当前未验证范围分别见team-commands、验证交接。历史双窗口实测保存在原测试汇总，不得把历史结果算作本轮验收。

codex-pair

让你已经打开的 Codex CLI 窗口共同完成一个项目。A 负责分工和协调，B 接受邀请后执行任务；需要时可邀请已有的 C、D 窗口加入。各窗口保留自己的会话、账号配置、模型和权限，通过本地消息桥接收任务、提问和交付结果。

本说明适用于 v1.3.0 及当前仓库源码：支持最多四个可见成员、独立审核和范围收尾。v1.3.0 发行版 已提供 ZIP 安装包和 SHA256 校验文件。旧 v1.2.1 下载包仍是两窗口维护版，不包含这些新增能力。

这是个人维护项目，并非 OpenAI 官方项目。

适用场景与前提

适合需要明确分工、相互核验和保留交付记录的项目。普通单窗口 Git 操作无需启动协作。

• 当前以 Windows 为主要验证环境，需要 Python 3.10+、Git，以及支持 queue / app-server 的官方 Codex CLI。本次有 CLI 0.166.0-alpha.5.1 的实际证据，不保证任意版本兼容。
• 先打开 A、B 两个 CLI 窗口。扩展时由 A 邀请用户选定的已有 C、D，最多四个可见成员。
• 可见成员支持 OpenAI 官方账号，或原 CLI 已配置的 DeepSeek API。工具不替你配置 API，不复制登录信息或 Key。
• 独立审核可由 A 管理的一个 OpenAI 官方 GPT 隐藏审核会话承担；它不替代可见成员，不负责审批或普通开发。同一时刻只保留一个有效审核者。
• 同一个工作树的业务串行执行；确有需要时使用明确登记的独立工作树。不会为了并行自动重建你的可见窗口。

安装与更新

以下源码安装方式适用于仓库中已完成整合的版本。安装前确认你取得的是目标版本，不把旧下载包当成最新源码。

git clone https://github.com/naxianjin/codex-pair.git
Set-Location codex-pair
$pairAccountRoot = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE '.codex' }
python scripts/install_skill.py --source . --home $pairAccountRoot

使用实际的 Python 可执行程序，避免 WindowsApps 占位入口。安装器将技能写入当前配置的 skills/codex-pair，备份旧版并核对文件摘要；不会修改认证或模型配置。其他成员使用各自真实的配置环境，不要为了协作把几个窗口改到同一个账号目录。

已有仓库先检查未提交改动，再获取更新。已有协作升级时，先核实在途任务和结果、保存现场，再安全停止旧桥并从新入口恢复；不要直接覆盖正在运行的副本，也不要用旧版打开新数据库。磁盘安装完成不代表已有窗口或消息桥已经加载新版：窗口要读取新的 SKILL.md，桥也要确认实际运行入口。

开始协作

在 A 的原 CLI 窗口调用 $codex-pair，说明项目、目标和允许改动范围。技能会核对仓库及当前会话，并使用安装目录中的入口执行：

python <技能目录>/scripts/pair.py start --project <项目绝对路径> --goal <本轮目标> --json

把返回的完整邀请交给已经打开的 B。B 在自己的窗口执行邀请中的 accept 命令，并按返回的 after_join 完成握手、上下文读取与确认。不要自行填写别人的会话信息，也不要在普通终端冒充成员窗口。

本地消息桥自动启动或复用。queued / accepted 只说明请求已被接收；双方业务回执及模型回合完成、通信验证通过后，才开始后续业务。

需要第三、第四个成员时，让 A 使用 invite-member，将返回的加入指令交给选定的原窗口；新成员不要再次执行 start。不按窗口标题、配置目录名或最近一次会话猜成员。

分派、提问与交付

A 登记小任务、允许路径、依赖和必要检查。复杂工作按可以独立交付的阶段拆分；相同接口、锁文件或数据库结构由一人负责。

下面是分派命令的参数形式，具体值由 A 按本轮返回信息填写：

python <技能目录>/scripts/pair.py assign --pair <协作ID> --state-root <共享状态根目录> --task <任务ID> --title <标题> --to B --allow <仓库相对目录/> --body-file <UTF-8任务文件> --json

固定原成员执行的工作使用 --pin-member；独立核验用 --independent-of <被核验任务ID> 登记约束。需要必要检查时，A 在任务中明确验收条件及准确命令。

成员收到消息后遵循信封中的步骤：

1. 在原窗口目录领取消息，只有 claimed=true 才执行。重复领取返回 false 时结束，不能重做业务。
2. 长正文按 next_offset 分页读完，任务范围也要完整读取。收到前置交付后，完整 read-delivery，再按该版本的摘要 ack-delivery。
3. 仅修改允许路径，完成适用检查，保存结果及未验证项，再用原领取令牌 complete。需要澄清时用 ask-question 交 A，保留原任务并结束回合。

工具调用身份的原窗口目录和业务文件所在工作树可以不同。领取、完成按信封指定的 actor_cwd 操作，文件与 Git 操作使用任务 workspace，不能虚称改变了原会话根目录。

审核、整合与发布

业务交付不等于验收通过。固定提交或文件快照通过 submit-stage 送审，保留实际作者和模型来源、差异、检查结果与限制。独立审核结果绑定准确版本；修改代码或需求后，旧结论不能放行新版本。

DeepSeek 实际完成或实质修改的成果，在作为已验收依赖、整合或发布前，必须由经核实的 OpenAI 官方 GPT 独立审核。A 的实现与整合后具体版本也需独立检查。待审、缺必要验证和返修中的阶段均不作为已通过依赖。

A 按已审版本整合，核对最终差异及适用回归后统一发布。发布还需要用户明确授权，以及确认过的仓库、远端和分支。发布入口要求当前有效的已审整合版本与干净工作树，不允许用旧阶段借用新阶段的通过状态。远端前进或结果未知时先核对事实，不强推、不重复未知推送。

权限与进度恢复

成员仍受自己 CLI 的权限约束。支持的原生审批请求交给 A 单次处理，不代表 A 可以授予自己没有的权限。Hook 首次信任须由目标窗口用户审阅；普通技术答复、任务通过和通信成功都不等于权限批准。

用户变更授权时先登记新的授权依据。超时或 granted / unknown 不证明操作未执行：先核实原回合及实际结果，再按协议重试。不要复制凭据或绕过拒绝。

低额度时在当前工具安全结束后保存检查点。恢复先 check-checkpoint，有交接则完整读取、核对现场并登记恢复计划后消费；没有交接不扫描历史。原任务仍用原令牌继续，不重新领取、重投或从头重做。

暂停、恢复与范围收尾

从本轮返回信息取得协作 ID 和共享状态根目录后，技能可使用：

python <技能目录>/scripts/pair.py status --pair <协作ID> --state-root <共享状态根目录> --probe 3 --json
python <技能目录>/scripts/pair.py pause --pair <协作ID> --state-root <共享状态根目录> --json
python <技能目录>/scripts/pair.py resume --pair <协作ID> --state-root <共享状态根目录> --json

pause 停止新投递，已开始的回合仍可继续；resume 恢复调度。确实要停止桥时使用 bridge --action stop，它不关闭原 CLI，也不删除状态、代码和工作树。进程存在不等于可响应，状态中的随机挑战响应才是桥可响应的证据。

当前源码包含 close-scope。 当用户只要求结束本轮明确范围时，A 从自己已领取的活动规划或协调任务调用该接口，登记用户依据、范围内的准确交付与摘要，以及逐项排除历史任务的原因。先确认交付已完整读取，范围内业务版本已审核，其他执行、审批、问答和检查点已收尾。

成功后再普通 complete 当前协调消息，不加 --goal-complete。这会停止当前窗口目标的自动规划，保留历史任务、审核结论和消息桥；不会把未通过的历史工作改成通过，也不等于所有长期目标已完成。完整目标完成仍使用原有严格检查。具体字段见 阶段命令。

验证范围与后续

已有真实证据覆盖原窗口邀请、分派、问答、交付、审核返修及保存恢复；修复后消息桥已处理实际小任务。回合终态与共享工作区排队、旧审核阶段发布门禁有定向测试及独立审核证据。范围收尾已有隔离检查与独立审核，不能替代真实多窗口收尾记录。

这些结果不表示历史 G01—G16 全矩阵完成，也不证明任意 CLI、平台、提供方组合均兼容。真实审批、长期使用稳定性、正常中断恢复和延期的持久化专项按 发布后测试 继续，不为凑齐历史统计重复整套测试。

更新内容见 CHANGELOG.md。使用细节见 SKILL.md、首次接入、阶段命令 与 协作协议。旧参考文档可能保留历史版本说明，适用范围应以当前源码和明确的版本说明为准。

反馈问题时提供脱敏版本、复现步骤及原始错误。不要上传认证文件、完整配置、会话日志、领取令牌或协作数据库。