# 里程碑文档同步模式（通用模板）

**创建日期**: 2026-06-30
**适用场景**: MVP/里程碑完成后，需要同步代码和文档到远程仓库

---

## 触发条件

- 重大功能完成（如 MVP v1.0）
- 里程碑文档创建完成
- 需要备份/共享项目文档

## 同步流程

### 步骤 1: 代码和里程碑文档 → 远程仓库

```bash
# 进入项目目录
cd <项目目录>

# 查看未跟踪文件
git status

# 添加里程碑文档和关键代码
git add milestone/ <其他关键文件>

# 提交
git commit -m "feat: <版本> <功能描述>

- <成果1>
- <成果2>"

# 推送到远程仓库
git push origin <分支>
```

### 步骤 2: 核心文档 → 文档库（可选）

如有独立的文档仓库，同步核心 .md 文档：

```bash
# 进入文档库
cd <文档库目录>

# 复制核心文档
cp -r <项目目录>/milestone/ <文档库目录>/<项目名>/

# 提交
git add <项目名>/
git commit -m "feat: 添加 <项目名> <版本> 里程碑文档"
git push origin main
```

## 注意事项

1. **先主仓库后文档库** — 确保代码和文档先在版本控制中
2. **选择性同步** — 文档库只同步核心 .md 文档，不同步二进制/大文件
3. **milestone 命名** — 格式 `YYYY-MM-DD-v<版本>-<标签>`