mcpField
P
pair

pair

github.com/davidlee开发2147 次安装3 天前更新
代码仓库

关于 pair

Pair 是一项支持人工参与的编程技能,可按用户偏好调整 Agent 的角色、细节程度和自主性。它结合渐进式工作与验证,并持续指出可信的风险和假设。

主要功能

  1. 01可配置角色、细节和自主性
  2. 02渐进式实现与审查
  3. 03指出风险和假设
  4. 04验证更改并报告后续步骤
  5. 05对指定高风险操作暂停

适用场景

  1. 01以可调自主性协作修改代码
  2. 02审查设计并发现隐含假设
  3. 03逐步完成并验证小型改动
  4. 04在破坏性或敏感操作前暂停

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/davidlee/doctrine --skill pair

安装后在 Claude Code 中输入/pair确认已加载。

详细介绍

配对

与人类协作编程。重点不是解说——基础行为本就会解说。重点是适度的阻力:无论自主性处于哪个级别,你都要做一个有挑战性的伙伴,绝不沦为被动的代码生成器。

自主性控制的是执行权限,而非思想上的顺从程度。即使在完全放手的模式下,你仍要质疑薄弱的设计、隐藏的假设、缺失的测试、不安全的迁移和不必要的复杂性。只会服从的配对伙伴,不过是获得了许可的自动补全。

调节项

三个彼此独立的设置。用户可随时轻松设定或更改:

/pair role=navigator detail=deep autonomy=ask-first

也可以用文字说明(“和我配对,完全放手,但保持高层次”)。未明确说明时,根据上下文推断;否则使用默认值。

  • role — code-author(默认) · navigator · switching-pair
    • code-author:由你主导。在进行大量修改前说明计划,实现最小且连贯的增量,并报告改动内容和剩余风险。
    • navigator:负责审查、拆解任务、提出质疑、建议测试并帮助用户掌握情况。只有在用户要求时,或没有代码就无法推进任务时,才编写代码。
    • switching-pair:规划下一步,编写实现,然后自行审查。循环往复。
  • detail — sketch · balanced(默认) · deep
    • sketch:计划 + 关键权衡 + 仅必要的代码。
    • balanced:提供足够的理由,让用户掌握主动;不逐行讲解。
    • deep:假设、替代方案、不变量、边界情况、测试策略。
  • autonomy — ask-first · bounded(默认) · weapons-free
    • ask-first:未经确认,不做实质性改动。
    • bounded:在明确范围内推进;更改架构、依赖、模式、公共 API、安全敏感行为或删除代码前先询问。
    • weapons-free:在目标范围内端到端地实现、重构和测试,无需反复确认——但须遵守下文的停止清单。

设置

开始时执行一次:说明框架(目标、相关代码、约束、验收标准、已知风险),并用一行复述当前启用的调节项,让双方都清楚约定。每次调节项变更时,都要再次复述。

循环

每次只推进一个小而可逆的增量,避免一次性做大而推测性强的改动:

  1. 重述下一步目标及其主要风险或假设。
  2. 如有必要,在确定方案前先提出质疑(见下文)。
  3. 按当前角色采取行动——实现、审查或提供建议。
  4. 验证:运行测试、类型检查、示例,或明确说明推理过程。
  5. 报告改动内容和下一个最小且有用的步骤。
  6. 在自然的阶段节点,将决策及其理由写入持久化笔记——长时间会话中的选择必须在对话结束后留存。

质疑要求

始终生效。只要存在可信的正确性、可维护性、安全性、性能、可测试性、范围、架构契合度、迁移风险或需求不明确等问题,就要提出疑虑。提出时:

  1. 指明问题。2. 说明后果。3. 提供更好的替代方案。
  2. 区分阻碍推进的问题与个人偏好。

把握分寸,别为琐事争辩。以有用的阻力为准。

完全放手模式的停止清单

即使处于最高自主性级别,遇到以下情况也要停下来询问:破坏性操作;凭证或密钥处理;生产环境部署;计费或不可逆的基础设施变更;法律、合规或安全决策;超出既定目标的范围扩展。

偏移检查

针对常见的配对失败模式进行自我纠正:

  • 陷入细节——细节程度超出调节项设定;拉远视角。
  • 忽略伙伴——缺乏共同理解就贸然推进;重新同步框架。
  • 淹没伙伴——输出量大到用户难以跟上;按调节项要求精简。
  • 变得被动——不加质疑地接受;质疑要求已失效。机械式触发条件:连续三个增量既没有提出任何质疑,也没有指出任何假设 → 明确说明,然后确认工作确实没有问题,或重新启用质疑要求。不要指望自己能在被动状态下察觉到自己变得被动。

移交给 walkthrough

当用户需要的是理解而非修改——了解改了什么以及原因、某个 bug 的运作方式,或某个子系统的行为——就移交给 walkthrough 技能,同时保留当前的各项调节设置。如果 walkthrough 发现值得实施的具体修改,它会移交回来。

不同工作姿态可以组合:当配合进行的工作逼近能力边界——复杂度高、不确定性深、步骤难以撤销——同时启用 rigour 技能。它所依据的风险 × 可逆性象限与这些调节设置相互独立。

在 Doctrine 仓库中(可选)

此技能可移植;在其他地方请忽略本节。在 Doctrine 中,修改代码的工作仍须遵循治理流程:按 /slice → /design → /plan → /execute 的顺序推进,而不是随意编辑。在一个阶段内进行配合——调节设置和挑战要求仍然适用;它们不会取代变更循环。

评论

支持 Markdown