SuperAPI AI 工具集

pair-programming

编程与开发

查看项目

更新于 11-09 05:20

技能介绍

Pair Programming 是一个把单次请求转化为经过评审的代码改动的技能。用户是主导者,其余席位分别负责思考、实现和评审;用户负责需求简报、轮次数量、运行状态和最终报告。用户指令优先于该技能,但提交、推送和对外影响的限制除外。当某席位因技能或仓库规则停止或偏离时,需指出文件并引用规则。

设计标准

所有席位按以下顺序评判设计与差异:KISS 与 YAGNI,即只做所请求工作的最简方案,不做推测性抽象;无回归,范围外行为保持不变;最小影响面,即最小差异、最少触及文件与调用方;低耦合高内聚,在既有接缝处修改,不进入无关模块;遵循既有约定,复用代码库模式与代理规则中的惯例,仅在当前存在重复时提取共享抽象;测试行为而非实现,通过公共接口做黑盒测试,仅在系统边界使用 mock,不写变更检测式测试;可逆低影响且唯一可能的测试只是镜像代码的改动不新增测试。任何发现或反对意见须指明所服务标准。

席位

作者:Opus,高投入,整轮运行使用同一上下文,以保留设计选择理由。挑战者:Astra,高投入,所有轮次共用同一上下文。仲裁者:Fable,高投入,全新上下文,仅在死锁时介入。评审者:Sol,极高投入,全新上下文,从不看辩论,避免结论锚定。按宿主路由:T3 Code 用 delegate_task 启动各席位并用 t3_thread_send 续接;Claude Code 对 Opus 与 Fable 用原生子代理并以 SendMessage 续接,对 Astra 与 Sol 用 cli-runner。席位不可用则阻塞该步骤,须报告,不得替换其他模型。

每个席位简报包含五部分:目标、上下文(工作文件夹路径)、约束(设计标准、仅作者可编辑文件、禁止提交推送安装部署或对外发消息、仓库代理规则、不得再启动子代理、自行解决可发现事实)、完成条件、返回内容。

工作文件夹与状态

运行文件存放于 .ai-workflow/pair-programming/<slug>/(若仓库忽略 .ai-workflow/ 则放会话暂存区),包括 brief.md、design.md、review.md、report.md。state.md 保持最新:步骤、轮次、各席位线程或代理 ID、未决问题;压缩或重启后读取它并续接原席位。

流程

  1. 简报:读取请求,收集席位无法独自获取的信息,写入 brief.md(目标、范围与非目标、不变量、验收标准、已知事实与文件引用、未决问题)。可发现事实自行解决;仅用户可定的产品或范围决策须停下询问并附计划,展示简报摘要与席位后请求批准。

  2. 设计辩论:作者读简报与代码后写 design.md(改什么、在哪改、复用哪些模式、非目标、要加的测试及其证明的行为、考虑过的替代方案及失败标准)。挑战者寻找更简单或更低耦合的设计并对照代码与标准检查,返回 AGREE 或带编号的 OBJECT,每条关联标准与证据。作者逐条采纳修订或举证反驳,反驳回到挑战者。一轮即一次挑战者裁决,共识为无未决反对;达成共识或第 3 轮停止;达成共识则跳过第 3 步。辩论暴露仅用户可定的决策须停下询问。

  3. 仲裁(仅死锁):向仲裁者提供简报、最终 design.md 及每条未决反对与双方最终立场,其按标准逐条裁决并给一行理由,裁决为最终,作者据此更新 design.md。

  4. 实现:作者在同一上下文按 design.md 构建,不得范围蔓延,设计外改动须先回到用户。设计全部构建且相关检查通过即完成,修复由改动引起的失败并重跑受影响检查,返回改动文件与各检查命令及结果。

  5. 评审:评审者获取简报、设计、差异与检查结果,不改动文件,检查正确性、设计一致性与全部标准,返回 review.md(发现编号、严重度、文件行号、标准、证据)及 ready 或 changes required 裁决。

  6. 修复:作者读 review.md,修复认为有效且在范围内的发现并重跑检查,逐条标记已修复或拒绝并给一行理由;除非用户要求,否则不做二次评审。

报告

写 report.md 并回复:两三行共识设计及其来自共识或仲裁;改动文件;各检查命令及结果;各评审发现及修复或拒绝理由;未决问题、阻塞席位或无法运行的检查。检查命令未实际运行不得称通过。