Duet 是一种人机协作工作姿态：用户是导演，代理是执行者。它针对两种常见失败模式——评审瓶颈（代理做完一切，用户最后面对巨大 diff）与代码理解债（代理替用户默默决定架构、库、边界和命名，用户最终拥有自己看不懂的代码）。核心做法是：在每个真正的分叉出现时，用结构性语言把它变成可选项，让用户当场拍板。
角色反转：代理承担术语、工具、语法、管道和陌生代码阅读，把技术面压缩成少量人类可选项；用户负责范围、边界、品味、常被阅读的命名、架构以及任何不可逆决定。
三阶段循环：阶段一意图引导，任务开始时发一批最多 4 个单选问题，覆盖范围、目标、约束、模式等正交轴，每轴一个推荐项；若某轴只有一个可辩护值则删除该问题。阶段二执行中暴露分叉，每个分叉先跑 VS 门控问题协议生成候选，幸存者成为可辩护路径（2–4 个），用结构或品味语言表述，标注一个推荐项并附一句理由，视觉比较可附预览，相关决策批量合并。阶段三不可逆检查点，在 git push、git reset --hard、共享分支 rebase、rm、破坏性迁移、付费 API 调用、外部邮件、部署、超过 5 文件重写等之前必须询问确认。
分叉分类：公共函数/路由/数据库列/CLI 标志命名、库或框架选择、认证方案、存储引擎、同步与异步、错误表面、目录结构、模块拆分边界、布局密度、面向用户文案语气、不可逆动作等算分叉；局部变量名、导入顺序、语法、括号位置、匹配文件已有错误模式、仓库既有命名约定等不算，静默执行。
使用方式：从调用或触发短语开始，直到用户说“go ahead on your own now”“full autonomy”“/duet off”等退出。协议假设一个“询问用户”工具，字段与数值限制参考 Claude Code 的 AskUserQuestion；其他代理框架应映射其等价提问工具，形状（每轴单选加一个推荐）是关键，批量只是优化。
限制与反模式：不要用 multiSelect 做带默认覆盖语义的轴；不要叙述机械操作；不要用无结构框架的术语选项；不要批量处理有依赖关系的决策；不要不推荐任何项；不要先生成巨大 diff 再让用户批准。若用户连续橡皮图章，可粗化问题、提高分叉阈值。资料未提供具体安装命令、收费、价格或平台支持信息。