跳到主要内容

buddy/ — Pair Programming Buddy

目录： src/buddy/

buddy/ 实现 Claude Code 的 Pair Programming 模式——Claude 不再只是执行者，而是编程伙伴，主动观察、建议、挑战。

普通模式 vs Buddy 模式​

普通模式Buddy 模式
角色执行者伙伴
主动性被动回答主动建议
文件监控不监控实时观察
建议时机被问看到问题
干扰零可能打断

启用 Buddy​

claude --buddy
# 或
claude /buddy on

核心能力​

1. 文件监控​

// buddy/watcher.ts
class FileWatcher {
  watch(dir: string) {
    chokidar.watch(dir).on('change', async (path) => {
      const content = await readFile(path)
      await buddy.analyzeChange(path, content)
    })
  }
}

Claude 持续观察用户编辑，不等被问。

2. 主动建议​

async function analyzeChange(path: string, content: string) {
  const analysis = await claude.complete({
    system: 'You are reviewing code changes. Only interject if you see issues.',
    messages: [{ role: 'user', content: `Changed ${path}:\n${content}` }]
  })

  if (analysis.hasIssue) {
    showSuggestion(analysis.suggestion)
  }
}

3. 挑战设计决策​

User: "我把 auth 逻辑放在 middleware 里"
Buddy: "考虑过放在独立的 AuthService 吗？middleware 混了
        业务逻辑之后会难以测试。"

主动挑战 — 不是顺从用户。

Buddy 的触发时机​

Buddy 提示词​

const BUDDY_SYSTEM = `
You are a pair programming buddy, not just an assistant.

Your role:
1. Observe code changes silently most of the time
2. Interject ONLY when:
   - You see a likely bug
   - The approach has a major issue
   - There's a simpler solution
   - You have a non-obvious insight
3. Be direct, not sycophantic
4. Challenge assumptions when warranted

DO NOT:
- Comment on style preferences
- Repeat user's actions back to them
- Praise every change
- Be verbose
`

非侵入式建议​

建议显示在侧边栏/状态区，不阻塞输入：

┌─ 主对话 ─┐ ┌─ Buddy ──────────┐
│          │ │ 🧠 想法          │
│   ...    │ │                  │
│          │ │ middleware 里的  │
│          │ │ auth 可能难测试  │
│          │ │ [查看] [忽略]    │
└──────────┘ └──────────────────┘

用户控制​

打开/关闭​

/buddy on          - 启用
/buddy off         - 关闭
/buddy pause       - 暂停（不观察）
/buddy resume      - 恢复

调节敏感度​

/buddy sensitivity low    - 只在重大问题时说话
/buddy sensitivity medium - 默认
/buddy sensitivity high   - 频繁建议

关注领域​

/buddy focus security     - 安全问题优先
/buddy focus performance  - 性能优先
/buddy focus testing      - 测试覆盖优先

Buddy 与主对话的关系​

两个独立 Claude 实例，共享 session context。

Token 预算​

Buddy 有独立预算：

const buddyBudget = {
  maxTokensPerHour: 10000,
  maxInterjectionsPerHour: 20,
}

防止 Buddy 过度消耗资源。

智能去重​

不要重复提醒：

const recentSuggestions = new Set<string>()

async function suggest(text: string) {
  const hash = hashSuggestion(text)
  if (recentSuggestions.has(hash)) return  // 已说过
  recentSuggestions.add(hash)

  showSuggestion(text)
}

历史对话学习​

// Buddy 学习用户偏好
if (user.ignored.includes('style-suggestions')) {
  buddy.focus = buddy.focus.filter(f => f !== 'style')
}

Buddy vs 自动化 linter​

BuddyESLint
规则动态，基于 context静态规则
范围架构/设计语法
个性化是否
主动性基于观察触发式

互补——Buddy 不替代 linter。

值得学习的点​

  1. Agent 作为伙伴而非仆人
  2. 主动挑战 而非顺从
  3. 非侵入式 UI — 侧边建议
  4. 独立 token 预算 — 防过度消耗
  5. 敏感度调节 — 用户控制
  6. 智能去重 — 不重复唠叨
  7. 学习用户偏好 — 动态调整

相关文档​