---
alwaysApply: true
description: 强制文档同步规范：每次变更代码（如新增功能、修改接口、调整架构等）必须同步更新 README.md 和 docs 目录下的相关文档。
---

# 文档同步规范（必须遵守）

## 通用原则

- **代码即文档，文档随代码**：文档不是静态的，它必须真实反映当前代码的状态。
- **及时性**：在提交代码变更的同时（或紧随其后），必须完成相关文档的更新。
- **准确性**：确保文档中的示例代码、接口说明、安装步骤与实际代码完全一致。

## 更新范围

- **README.md**：
  - 如果变更涉及核心功能点（Features）、安装步骤（Installation）、快速开始（Quick Start）或 API 端点（API Endpoints），必须同步更新。
  - 变更涉及技术栈调整或项目结构变化时需更新。
- **docs/ 目录文档**：
  - **接口变更**：若修改了 API，需同步更新 [技术设计文档](docs/技术设计文档.md) 中的接口部分。
  - **功能新增/调整**：需在 [产品需求文档](docs/产品需求文档.md) 和 [技术栈与模块](docs/技术栈与模块.md) 中体现。
  - **架构/模式变更**：需更新 [技术设计文档](docs/技术设计文档.md)。
  - **代码规范**：若引入了新的编码模式或工具，需更新 [代码规范文档](docs/代码规范文档.md)。
  - **版本记录**：所有非琐碎的变更必须在 [版本记录.md](docs/版本记录.md) 中添加记录。

## 检查清单

1. [ ] 是否有新增的 API 端点？（更新 README 和技术设计文档）
2. [ ] 是否修改了现有的业务逻辑或数据结构？（更新技术设计文档）
3. [ ] 是否有新增的功能模块？（更新产品需求文档和技术栈说明）
4. [ ] 是否调整了开发环境或依赖？（更新 README）
5. [ ] 是否在 [版本记录.md](docs/版本记录.md) 中记录了本次变更？