Vibe Flow

基于Claude的自动化编程工具，使用多个AI代理在独立的Git工作树中并行完成复杂功能开发。

📦 一键安装

curl -fsSL https://raw.githubusercontent.com/QiuYi111/vibe/main/install.sh | bash

或手动安装：

npm install -g @jingyi_qiu/vibe-flow

✨ 主要功能

• 并行Git工作树：每个代理在独立分支中工作，互不干扰
• 多代理协作：架构师规划 → 工厂执行 → 代码审查 → 自动合并
• 自动修复：根据审查反馈自动重试，无需人工干预
• 生产级可靠性：超时保护、数据验证、优雅退出
• 交互式调试：基于tmux的任务监控和实时介入
• SuperClaude集成：使用 /sc:index-repo、/sc:workflow、/sc:implement 命令

🚀 快速使用

1. 安装依赖

# 系统会自动检测并安装：
# - Node.js 18+
# - Claude CLI
# - SuperClaude
# - jq (JSON工具)
# - tmux (可选，用于任务监控)

2. 配置认证

claude  # 配置Claude认证

3. 开始使用

# 进入你的项目
cd your-project

# 创建需求文件
echo "实现用户登录功能" > REQUIREMENTS.md

# 运行自动化开发
vibe

# 高级配置
MAX_PARALLEL_AGENTS=4 MAX_RETRIES=5 vibe

系统架构

TypeScript重构版本 (v1.0.0)

已从Bash重构为TypeScript，解决了关键问题：

关键修复

• ✅ 进程死锁预防：

  • 从原生 spawn 迁移到 execa
  • 5分钟超时防止无限等待
  • 10MB缓冲区限制防止溢出
  • CI: 'true' 强制非交互模式

• ✅ 数据验证：

  • 所有AI输出使用Zod运行时验证
  • 无效JSON的详细错误信息
  • 类型安全的数据流

• ✅ 优雅退出：

  • SIGINT/SIGTERM信号处理
  • 退出时自动清理工作树
  • 无孤儿进程或目录

重要优化

• ✅ 指数退避重试：1s → 2s → 4s → ... → 60s
• ✅ 代码质量：ESLint + Prettier配置
• ✅ 并发控制：使用 p-limit 管理

目录结构

src/
├── cli.ts              # 程序入口
├── config.ts           # 配置加载器
├── logger.ts           # 统一日志
├── types.ts            # TypeScript类型定义
├── core/               # 核心逻辑
│   ├── librarian.ts    # 上下文生成
│   ├── architect.ts    # 任务规划
│   ├── factory.ts      # 并行执行
│   ├── review.ts       # 代码审查代理
│   ├── mergeManager.ts # 分支合并
│   ├── integration.ts  # 集成测试
│   └── cto.ts          # 最终审批
├── git/                # Git操作
│   ├── gitWorktree.ts  # 工作树管理
│   └── gitBranch.ts    # 分支操作
├── utils/              # 工具函数
│   ├── childProcess.ts # 进程执行(execa)
│   ├── jsonExtractor.ts# JSON解析(Zod)
│   ├── cleanup.ts      # 信号处理
│   └── file.ts         # 文件操作
└── schemas/            # Zod模式
    └── taskPlan.ts     # 任务计划验证

工作流程

┌──────────────┐
│ 管理员        │ 生成项目索引
└──────┬───────┘
       │
┌──────▼───────┐
│ 架构师        │ 创建任务计划(Zod验证)
└──────┬───────┘
       │
┌──────▼───────┐
│ 工厂          │ 并行执行任务(p-limit)
│              │ • 每个任务在独立工作树中
│              │ • 自动修复重试(指数退避)
│              │ • 审查反馈循环
└──────┬───────┘
       │
┌──────▼───────┐
│ 合并          │ 合并所有分支
└──────┬───────┘
       │
┌──────▼───────┐
│ 集成测试      │ 运行集成测试
└──────┬───────┘
       │
┌──────▼───────┐
│ CTO审查       │ 最终审批
└──────┬───────┘
       │
┌──────▼───────┐
│ 报告          │ 生成总结
└──────────────┘

配置

环境变量：

• MAX_PARALLEL_AGENTS - 并发代理数量(默认: 2)
• MAX_RETRIES - 最大重试次数(默认: 3)

开发

安装开发环境

git clone https://github.com/QiuYi111/vibe.git
cd vibe/vibe-flow
npm install

脚本命令

npm run build        # 编译TypeScript
npm run dev          # 开发模式运行
npm run lint         # 检查代码质量
npm run lint:fix     # 自动修复代码问题
npm run format       # 格式化代码
npm run format:check # 检查代码格式

项目质量

• TypeScript: 启用严格模式
• 代码检查: ESLint + TypeScript插件
• 代码格式: Prettier (120字符, 4空格, 单引号)
• 类型安全: Zod运行时验证

为什么选择TypeScript?

原始Bash版本(v0.1.7)存在关键问题：

| 问题 | Bash | TypeScript | |------|------|------------| | 进程挂起 | ❌ 无超时 | ✅ 5分钟超时 | | 缓冲区溢出 | ❌ 无限制 | ✅ 10MB限制 | | 无效JSON | ❌ 运行崩溃 | ✅ Zod验证 | | 孤儿进程 | ❌ 手动清理 | ✅ 自动清理 | | 类型安全 | ❌ 无 | ✅ 完全严格模式 | | 重试策略 | 🟡 固定1秒 | ✅ 指数退避 |

重构进度: 80% → 98% 生产就绪: ⭐⭐⭐⭐½ (4.5/5)

开源协议

MIT

技术支持

基于 Claude 和 SuperClaude 命令。