问题
docs/PLANS.md 规范的 work-log 命名 YYYY-MM-DD-NN-TYPE-DESCRIPTION.md,里面 NN 写的是"当日序号",但没说清楚是"全模块当日唯一"还是"同任务系列内递增",多人协作 / 同人多任务并行时缺去重机制。
实际遇到的场景
某项目下一个模块(比如 docs/product-specs/fullstack/{模块}/work-logs/):
- 开发者 A 同日早上做任务 P1,起
YYYY-MM-DD-02-fix-something.md(当日第二条)
- 开发者 B 同日下午做任务 P2(独立任务,跟 P1 无关),起
YYYY-MM-DD-02-impl-other.md(他本地看 git 没有当日记录,也起 NN=02)
- A 和 B 各自 PR 到 main,merge 后两个 work-log 同 NN 撞了(文件名不同所以 git 不报冲突,但语义上 NN=02 出现两次违反规范)
同人多任务也类似:今天起任务 P1(NN=01),下午又起独立任务 P2,P2 应该 NN=01 还是 NN=02?规范没说。
几种可能的方向(仅列出场景,不主张某种方案)
- NN 跟"任务系列"走(同任务的多条日志才递增)—— 需要明确"任务系列"边界
- NN 跟"模块当日"走(保持当前规范文字含义,但要加去重机制)
- 命名格式改变(加作者后缀 / 改时间戳 / 加短 hash 等)
- 文件名唯一性约束改成 `(NN, TYPE, DESC)` 三元组而非单 NN
每种都有各自利弊,需要 AHS 维护者拍板。
分类
- 目标:`templates/docs/PLANS.md`(work-log 命名规范)
- 类型:design
问题
docs/PLANS.md规范的 work-log 命名YYYY-MM-DD-NN-TYPE-DESCRIPTION.md,里面 NN 写的是"当日序号",但没说清楚是"全模块当日唯一"还是"同任务系列内递增",多人协作 / 同人多任务并行时缺去重机制。实际遇到的场景
某项目下一个模块(比如
docs/product-specs/fullstack/{模块}/work-logs/):YYYY-MM-DD-02-fix-something.md(当日第二条)YYYY-MM-DD-02-impl-other.md(他本地看 git 没有当日记录,也起 NN=02)同人多任务也类似:今天起任务 P1(NN=01),下午又起独立任务 P2,P2 应该 NN=01 还是 NN=02?规范没说。
几种可能的方向(仅列出场景,不主张某种方案)
每种都有各自利弊,需要 AHS 维护者拍板。
分类