# claude

**Repository Path**: zhongeating/claude

## Basic Information

- **Project Name**: claude
- **Description**: Claude code 的 SPEC 规范编程模板
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-05
- **Last Updated**: 2026-03-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude 项目

> 本项目使用规范编程方法，基于 Vibe Coding 最佳实践。

## 引用来源

本文档规范参考自 [为什么你的 Vibe Coding 做得一团糟](https://mp.weixin.qq.com/s/xQvSuhGXvawPsW_cWXxnbA)，原文作者：**klöss** (@kloss_xyz)。

---

## 目录结构

```
claude/                          # 项目根目录
├── README.md                     # 本文件
├── CLAUDE.md                     # AI 项目通用配置
├── .claude/                      # Claude Code 本地配置
│   └── settings.local.json       # 本地设置
├── spec-templates/               # 规范文档模板库（创建新项目时复制）
│   ├── SPEC.md                   # Vibe Coding 规范指南
│   ├── CLAUDE.md                # AI 配置模板
│   ├── progress.txt             # 进度跟踪模板
│   ├── lessons.md               # 错误教训模板
│   ├── 01_PRD.md               # 产品需求文档模板
│   ├── 02_APP_FLOW.md          # 用户流程模板
│   ├── 03_TECH_STACK.md        # 技术栈模板
│   ├── 04_FRONTEND_GUIDELINES.md  # 前端设计模板
│   ├── 05_BACKEND_STRUCTURE.md    # 后端结构模板
│   └── 06_IMPLEMENTATION_PLAN.md  # 实施计划模板
└── apps/                         # 各个应用项目
    └── template/                 # 完整项目模板（可直接复制使用）
        ├── SPEC.md               # 规范编程指南
        ├── CLAUDE.md             # AI 配置
        ├── 01_PRD.md            # 产品需求
        ├── 02_APP_FLOW.md       # 用户流程
        ├── 03_TECH_STACK.md     # 技术栈
        ├── 04_FRONTEND_GUIDELINES.md  # 前端规范
        ├── 05_BACKEND_STRUCTURE.md    # 后端结构
        ├── 06_IMPLEMENTATION_PLAN.md  # 实施计划
        ├── progress.txt         # 进度跟踪
        └── lessons.md            # 错误教训
```

---

## spec-templates vs apps/template 区别

| 目录 | 用途 |
|------|------|
| `spec-templates/` | **模板库** - 只有空的模板文件，创建新项目时从这里复制 |
| `apps/template/` | **示例项目** - 展示规范文档的实际写法，有完整示例内容 |

---

## 快速开始

### 1. 创建新应用项目

两种方式：

**方式一**：复制完整项目模板（推荐）
```bash
cp -r apps/template/ apps/my-new-app/
```

**方式二**：从模板库创建
```bash
# 从 spec-templates/ 复制需要的模板文件到新项目目录
```

### 2. 配置新项目

编辑新项目的 `CLAUDE.md`，填写：
- 项目名称
- 技术栈
- 设计系统
- 特定规则

### 3. 开始开发

```
在 apps/my-new-app/ 创建新项目，我要做一个食谱分享应用
```

---

## 常用提示词模板

### 1. 创建新项目
```
在 apps/[项目名]/ 创建新项目
描述：[项目描述]
```

### 2. 开始开发
```
开始开发 apps/[项目名]/
首先运行审问，确认需求后生成规范文档
```

### 3. 继续开发
```
继续 apps/[项目名]/ 的开发
当前进度参考 progress.txt
下一步：实现 [具体功能]
```

---

## 核心规则

1. **文档隔离** - 每个应用项目独立管理自己的文档
2. **文档第一** - 永远先创建规范文档再编码
3. **进度跟踪** - 每次完成后更新 progress.txt
4. **自我改进** - 每次纠正后更新 lessons.md
5. **安全第一** - 永远不要提交 .env 到 git，永远不要在前端暴露 API 密钥