archive-changelisted

# 变更归档 > SDLC 的最后一环：归档变更提案，更新 changelog，更新 README。 > **禁止跳过归档** —— 未归档的变更无法追溯。 ## 前置条件（MUST 全部满足） 1. **tasks.md 全部勾选**：`changes/proposals/<current>/tasks.md` 无 `- [ ]` 未完成项 2. **review.md 无未解决 MUST fix** 3. **部署验证通过**（或本地变更无需部署） 4. **当前分支为 feat-* / fix-* / hotfix-*** 任一不满足 → 禁止归档。 ## 执行步骤 ### 第 1 步：最终检查 ```bash # 检查 tasks.md grep -c "^- \[ \]" changes/proposals/<current>/tasks.md # 预期：0 # 检查 review.md 是否有 MUST fix grep -A 10 "MUST fix" changes/proposals/<current>/review.md # 预期：无未勾选 ``` ### 第 2 步：更新 changelog 写入 `changes/changelog/<version>.md`（如 `1.2.0.md`）： ```markdown ## [1.2.0] - 2026-08-15 ### Added - 新增用户登录接口（proposal: 2026-08-15-add-user-login） ### Changed - ... ### Fixed - ... ``` 条目 MUST 包含： - 类型（Added / Changed / Fixed / Security / Deprecated / Removed） - 简短描述 - 关联 proposal ID ### 第 3 步：更新 README（如有需要） 检查是否需要更新 README： - 新增 API → 更新 API 列表 - 新增功能 → 更新功能列表 - 修改启动方式 → 更新快速开始 - 依赖变更 → 更新技术栈 **MUST 更新 README 的情况**： - 影响用户使用方式的变更 - 新增模块 / 新增加载项 - 版本号变化 ### 第 4 步：归档提案 ```bash git mv changes/proposals/<id>/ changes/archive/<id>/ ``` ### 第 5 步：提交归档 ```bash git add changes/ README.md git commit -m "docs(changes): 归档变更 <id>，更新 changelog <version>" ``` ### 第 6 步：（可选）合并到 develop / master ```bash # 功能分支合并到 develop git checkout develop git merge --no-ff feat-<name> # hotfix 合并到 master + develop git checkout master git merge --no-ff hotfix-<version> git checkout develop git merge --no-ff hotfix-<version> ``` ## 产出物 - `changes/archive/<id>/`（完整提案目录） - 更新