Worktree 隔离并行开发 — 两个 Feature 同时开工#

// scripts/parallel-features.ts
export const meta = {
  title: '并行 Feature 开发：头像上传 + 邮件重构',
  description: '在两个独立 Worktree 中并行开发用户头像上传组件和邮件通知模块重构'
}

const [resultA, resultB] = await parallel([
  {
    description: '开发用户头像上传组件',
    isolation: 'worktree',
    branch: 'feature/avatar-upload',
    prompt: `
在 feature/avatar-upload 分支上开发用户头像上传功能，改动范围仅限于以下目录：

## 需求
1. 在 components/AvatarUpload/ 下新建 AvatarUpload 组件
   - 支持拖拽上传和点击选择
   - 上传前用 canvas 裁剪为 200x200 正方形
   - 上传进度条显示百分比
   - 文件大小限制 5MB，仅允许 image/png, image/jpeg
2. 在 app/api/upload/route.ts 中新建 POST 端点
   - 接收 multipart/form-data
   - 存储到 public/uploads/avatars/
   - 返回 URL 路径

## 约束
- 不要修改 components/ 和 app/api/upload/ 之外的任何文件
- 使用 React 18 + TypeScript
- 上传 API 不要引入第三方存储服务，本地文件系统即可
- 组件状态用 useState + useRef，不需要状态管理库

完成后输出：改了哪些文件、每个文件的用途、如何测试（curl 命令或手动操作步骤）。
`
  },
  {
    description: '重构邮件通知模块',
    isolation: 'worktree',
    branch: 'feature/mail-refactor',
    prompt: `
在 feature/mail-refactor 分支上重构邮件通知模块，改动范围仅限于 lib/mail/ 和 emails/ 目录。

## 需求
1. 在 lib/mail/ 下抽象 MailService 接口
   - send(options: SendOptions): Promise<SendResult>
   - 接口方法不依赖具体实现
2. 实现 SendGridMailService 和 ResendMailService
   - 两个实现都满足 MailService 接口
   - 通过工厂函数 createMailService(provider) 创建实例
3. 把 emails/ 下的 Handlebars 模板替换为 React Email 组件
   - 新建 emails/WelcomeEmail.tsx
   - 新建 emails/PasswordReset.tsx

## 约束
- 不要修改 lib/mail/ 和 emails/ 之外的任何文件
- 接口定义和实现分离到不同文件
- React Email 组件使用 @react-email/components

完成后输出：改了哪些文件、MailService 接口设计理由、旧模板和新 React Email 模板的对比。
`
  }
])

log(`\n===== Agent 1 完成 =====`)
log(resultA.output)
log(`\n===== Agent 2 完成 =====`)
log(resultB.output)

import { NextRequest, NextResponse } from 'next/server'
import { writeFile, mkdir } from 'fs/promises'
import { join } from 'path'
import { v4 as uuid } from 'uuid'

export async function POST(req: NextRequest) {
  const formData = await req.formData()
  const file = formData.get('file') as File | null

  if (!file) return NextResponse.json({ error: '未找到文件' }, { status: 400 })

  const ext = file.name.split('.').pop() || 'png'
  const filename = `${uuid()}.${ext}`
  const uploadDir = join(process.cwd(), 'public', 'uploads', 'avatars')

  await mkdir(uploadDir, { recursive: true })
  await writeFile(join(uploadDir, filename), Buffer.from(await file.arrayBuffer()))

  return NextResponse.json({ url: `/uploads/avatars/${filename}` })
}

import sgMail from '@sendgrid/mail'
import type { MailService, SendOptions, SendResult } from '../types'

export class SendGridMailService implements MailService {
  constructor(apiKey: string) {
    sgMail.setApiKey(apiKey)
  }

  async send(options: SendOptions): Promise<SendResult> {
    const [response] = await sgMail.send({
      to: options.to,
      from: options.from || process.env.MAIL_FROM!,
      subject: options.subject,
      html: options.html
    })

    return {
      messageId: response.headers['x-message-id'] || '',
      accepted: [options.to]
    }
  }
}

import { Resend } from 'resend'
import type { MailService, SendOptions } from '../types'

export class ResendMailService implements MailService {
  private resend: Resend

  constructor(apiKey: string) {
    this.resend = new Resend(apiKey)
  }

  async send(options: SendOptions) {
    const { data, error } = await this.resend.emails.send({
      to: [options.to],
      from: options.from || process.env.MAIL_FROM!,
      subject: options.subject,
      html: options.html
    })

    if (error) throw new Error(error.message + ': ' + error.name)
    return { messageId: data!.id, accepted: [options.to] }
  }
}

import type { MailService } from './types'
import { SendGridMailService } from './providers/sendgrid'
import { ResendMailService } from './providers/resend'

export function createMailService(
  provider: 'sendgrid' | 'resend' = 'resend'
): MailService {
  const apiKey = process.env.MAIL_API_KEY
  if (!apiKey) throw new Error('MAIL_API_KEY 环境变量未设置')

  switch (provider) {
    case 'sendgrid': return new SendGridMailService(apiKey)
    case 'resend':  return new ResendMailService(apiKey)
  }
}