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:
@@ -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 是全局视角
|
||||
|
||||
Reference in New Issue
Block a user