# vibe-coder

**Repository Path**: kaikz/vibe-coder

## Basic Information

- **Project Name**: vibe-coder
- **Description**: VibeCoder — AI 驱动的项目初始化生成器，通过一次对话为项目生成完整的开发基础设施，包括每日开发 skill、AI 工具指导文件和文档模板。支持 Claude Code、Gemini CLI、Cursor 等主流 AI   编码工具，帮助团队建立结构化的开发节奏和知识积累。

- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VibeCoder

AI 驱动的项目初始化生成器。通过一次对话，为你的项目生成完整的开发基础设施：专属的每日开发 skill、AI 工具指导文件和文档目录结构。

## 它解决什么问题

使用 AI 编码工具（Claude Code、Gemini CLI、Cursor）开发项目时，最困难的部分不是写代码，而是：

- 如何让 AI 理解项目全貌？
- 如何规划开发节奏，避免 AI 偏离方向？
- 如何保证每次修改都经过验证？
- 如何积累项目知识，让 AI 越做越好？

VibeCoder 通过生成结构化的开发基础设施来解决这些问题。

## 工作原理

```
用户输入需求 → VibeCoder 引导对话 → 生成项目基础设施
```

### 生成的产物

| 产物 | 说明 |
|------|------|
| **dev-day skill** | 项目专属的每日开发循环 skill（6 阶段：读计划→建任务→实现→验证→审查→归档） |
| **CLAUDE.md** | Claude Code 的项目指导文件（技术栈、架构、约束、命令） |
| **GEMINI.md** | Gemini CLI 的项目指导文件 |
| **.cursorrules** | Cursor 的项目规则文件 |
| **文档目录** | 开发计划、设计文档、技术规范、复盘记录等目录和模板 |

### dev-day 每日开发循环

生成的 dev-day skill 遵循 6 阶段循环：

```
Phase 1: 读计划 → Phase 2: 建任务 → Phase 3: 实现
                                        ↓
Phase 6: 归档 ← Phase 5: 审查 ← Phase 4: 验证
```

- `/dev-day N` — 开始第 N 天的开发
- `/dev-day review` — 仅执行审查和归档

## 安装

### 前置条件

- 已安装 [Claude Code](https://claude.ai/code)、[Gemini CLI](https://github.com/google-gemini/gemini-cli) 或 [Cursor](https://cursor.sh)
- 有一个项目目录（空的或有基础骨架）

### 安装步骤

```bash
# 1. 克隆本仓库
git clone https://github.com/devil-kk/vibe-coder.git

# 2. 复制 skill 到你的项目
cp -r vibe-coder/skills/ your-project/.claude/skills/

# 3. 复制模板到你的项目
cp -r vibe-coder/templates/ your-project/.claude/templates/
```

## 使用

### 1. 初始化项目

在你的项目目录中，打开 Claude Code 并调用：

```
/vibe-coder-init
```

如果你有现成的需求文档：

```
/vibe-coder-init
> 我有一个 PRD 文档在 docs/prd.md，请基于它生成开发基础设施
```

### 2. VibeCoder 会引导你完成

1. **信息收集** — 项目名、功能、技术栈、开发周期
2. **架构规划** — 模块拆分 + 开发计划
3. **产物生成** — 自动生成所有文件

### 3. 开始开发

```
/dev-day 1
```

## 支持的技术栈

自动识别并映射开发命令：

| 技术栈 | 构建 | 测试 | 运行 |
|--------|------|------|------|
| Java / Spring Boot | `mvn compile` | `mvn test` | `mvn spring-boot:run` |
| Node / React / Vite | `pnpm build` | `pnpm test` | `pnpm dev` |
| Python / FastAPI | — | `pytest` | `uvicorn main:app` |
| Go | `go build ./...` | `go test ./...` | `go run .` |
| Rust | `cargo build` | `cargo test` | `cargo run` |
| Flutter / Dart | `flutter build` | `flutter test` | `flutter run` |

不在表中？VibeCoder 会在对话中询问你的具体命令。

## 支持的 AI 编码工具

| 工具 | 生成文件 | Skill 格式 |
|------|----------|-----------|
| Claude Code | `CLAUDE.md` | `.claude/skills/` |
| Gemini CLI | `GEMINI.md` | Gemini skill 格式 |
| Cursor | `.cursorrules` | Cursor rules 格式 |

可多选，同时生成多个工具的配置。

## 项目结构

```
vibe-coder/
├── README.md
├── LICENSE
├── skills/
│   └── vibe-coder-init/
│       └── SKILL.md                   # 初始化引导 skill
└── templates/
    ├── skills/
    │   └── dev-day.md.tpl             # 每日开发 skill 模板
    ├── guides/
    │   ├── claude-md.md.tpl           # CLAUDE.md 模板
    │   ├── gemini-md.md.tpl           # GEMINI.md 模板
    │   └── cursorrules.md.tpl         # .cursorrules 模板
    └── docs/
        ├── development-plan.md.tpl    # 开发计划模板
        ├── module-design.md.tpl       # 模块设计模板
        └── retrospective.md.tpl       # 复盘记录模板
```

## 灵感来源

VibeCoder 来源于个人开发多个项目的开发实践 — 一个通过 20 天结构化 vibe coding 完成的 AI 智能体任务编排平台。

## License

MIT