# 文档管理

## 规则（Rules）

# 文档管理规范

## 1. 不覆盖

修改前必须先读取当前版本，确认无冲突后再修改。

✅ 读取当前版本再修改
❌ 直接覆盖他人修改

## 2. 保留历史

历史版本应保留在archive目录下，禁止删除。

✅ 旧版本移到archive目录
❌ 直接删除旧版本

## 3. 命名规范

非PRD文档按 `{项目名}_{文档类型}_v{版本号}.md` 命名，PRD文档固定为 `需求分析文档(PRD).md`。

✅ `projectx_api_documentation_v1.0.md`
❌ `新建文档.md`、`最终版.md`

## 方法（Methods）

# 文档管理方法

## 步骤

### 1. 确定需求
分析项目章程，确定需要创建的文档类型。

### 2. 编写文档
按标准模板编写文档，遵循命名规范。

### 3. 归档文档
保存文档到对应目录。

### 4. 版本管理
更新时读取当前版本，修改后版本号递增。

## 技巧（Tips）

# 文档管理技巧

## 1. 版本号规范

使用语义化版本号 v1.0、v1.1、v2.0。

## 2. 常见问题

| 问题 | 原因 | 解决 |
|------|------|------|
| 文件冲突 | 多人同时修改 | 修改前先读取最新版本 |
| 版本丢失 | 未归档 | 旧版本移到archive目录 |
| 命名混乱 | 无命名规范 | 按 `{项目名}_{类型}_v{版本}.md` 命名 |