Skip to content

[design] PLANS.md work-log 命名: YYYY-MM-DD-NN 的 NN 在多任务并行时会撞号 #12

@DM-llm

Description

@DM-llm

问题

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?规范没说。

几种可能的方向(仅列出场景,不主张某种方案)

  1. NN 跟"任务系列"走(同任务的多条日志才递增)—— 需要明确"任务系列"边界
  2. NN 跟"模块当日"走(保持当前规范文字含义,但要加去重机制)
  3. 命名格式改变(加作者后缀 / 改时间戳 / 加短 hash 等)
  4. 文件名唯一性约束改成 `(NN, TYPE, DESC)` 三元组而非单 NN

每种都有各自利弊,需要 AHS 维护者拍板。

分类

  • 目标:`templates/docs/PLANS.md`(work-log 命名规范)
  • 类型:design

Metadata

Metadata

Assignees

No one assigned

    Labels

    design需要设计讨论

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions