docs(AGENTS.md): 添加进度同步规范，明确 roadmap 更新要求

2026-07-05 17:40:22 +08:00
parent 7574f9c24c
commit b8f4fe0fe3
1 changed files with 12 additions and 0 deletions
@@ -198,6 +198,18 @@ pub use vector_store::VectorStore;
 5. **风险评估** - 潜在风险、缓解措施
 6. **验收标准** - 可验证的完成条件

+### 进度同步规范 (docs/roadmap.md)
+
+完成一项实施后，必须检查 `docs/roadmap.md` 是否存在对应内容；若存在，必须同步标记为完成：
+
+- **Step / Phase 状态行**：对应 Step 加 ✅ 标记；Phase 章节末尾「状态」行从 ⏳ 改为 ✅ Phase X 全部交付物已完成
+- **里程碑表**：更新对应里程碑状态从 ⏳ 改为 ✅ + 完成日期
+- **依赖关系图（Mermaid）**：节点 `class` 从 `pending` / `core` 改为 `done`，必要时更新节点摘要
+- **文末「已完成 / 进行中阶段」列表**：追加一行 `- ✅ Phase X — 一句话要点`
+- **顶部「当前状态」**：补充新完成 Phase，更新「下一步」指向
+
+参考案例：2026-07-05 完成 Phase 7 SqliteStore 时同步更新 6 处（顶部状态 / Phase 章节 / 依赖图 / M3 / 下一步行动 / 已完成列表）。
+
 ---

 ## 项目特定规则