docs:勾选 Plan §5 / §8 Phase 1.10-1.13 进度 + CLAUDE.md 新增「进度同步规范」

把 Plan 任务清单和进度追踪 checklist 同步到当前实际进度(1.10-1.13
均已完成 + 实测验证),并在 CLAUDE.md 写入"每完成 Phase 子项必须立即
更新 Plan 进度"的硬约束。

- Plan §5 Phase 1.10-1.13 任务清单 [ ] → [x]
- Plan §8 进度追踪同步:标注算法名 / 端到端实测结果(260→261 验证)
- CLAUDE.md 新增「进度同步规范」节,规定:
  - Plan §5 + §8 每完成子项立即勾选,与 commit 同 commit 内完成
  - 任务描述与实现有差异时同步修订(不允许 Plan 与代码长期不一致)
  - commit message 末尾备注"Plan 进度已勾选"
  - 理由:Plan 是项目记忆的唯一权威进度视图,新人 clone 后看 Plan
    §8 即可知整体进度;与 commit log 双写互为校验

Plan 进度已勾选
This commit is contained in:
joywayer
2026-06-22 02:30:31 +08:00
parent 0887088bb8
commit 87304552c3
2 changed files with 26 additions and 8 deletions
+18
View File
@@ -177,3 +177,21 @@ H5 页面通过特定的 JavaScript 协议初始化桥并注册自己的 handler
- 改动已通过最小验证(BuildProject 通过 / 关键路径手测通过 / 单测通过)→ 立即提议
- 工作树还有其它无关待提交内容 → 先帮用户分类、按职责拆 commit,**不混提**
- 用户未明确同意前不直接执行 `git commit`,但应当**清晰地告诉用户"现在适合提交了"**,并附上建议的 commit message
---
## 进度同步规范
**每完成一个 Phase 子项(如 1.10 / 1.11 / 1.12 ...)必须立即更新 `docs/Development-Plan.md` 的进度标记**,不允许"代码提交但 Plan 未同步"的滞后。具体:
- Plan §5 各 Phase 任务清单:完成的子项把 `- [ ]``- [x]`,附简短结果或耗时
- Plan §8 进度追踪 checklist:同步勾选 + 简短补充(如算法名 / 端到端测试结果)
- 时机:通常与该子项的 `git commit` 同一 commit 内完成,commit message 末尾备注"Plan 进度已勾选"
- 若改动跨多个 Phase 子项(极少见),逐项勾选不能漏
- 当任务清单中的描述与最终实现有差异(如新增子任务、合并子任务、改变实现策略)时,**同步修改任务描述**,不允许 Plan 文档与代码长期不一致
理由:
- Plan 是项目记忆的唯一权威进度视图,新人 clone 后只看 Plan §8 就能立刻知道整体进度
- 若代码已完成但 Plan 未勾选,新人会误判项目状态、做重复工作
- 若 Plan 描述与代码实现不一致,未来 Phase 验收 / 回归测试时会基于错误前提
- 与 commit message 双写互为校验:commit log 是细节,Plan 是全局视角