沉淀需求池目录结构:索引/草稿/已完成/丢弃 + 登记格式(源于项目实践 2026-08-28)

This commit is contained in:
2026-08-28 11:14:28 +08:00
parent 160ab09030
commit 6dc4ab61e5
+15 -1
View File
@@ -50,6 +50,20 @@ whenToUse: 在 one_divine_lot 仓库中从事任何开发、规划、讨论、
> - **更新日期**:最近一次状态变更或内容更新的日期,随每次变更刷新。
> - **与入范围门槛的对应**:只有状态为「已定稿」的需求才可进入计划范围或迭代工作范围;起草 / 讨论中的需求停留在需求池。
> **需求池目录结构**:`05-需求池/` 内部按以下结构组织需求:
> ```
> 05-需求池/
> ├── 说明.md # 目录说明与约定
> ├── 需求池索引.md # 当前工作需求总览(状态流转记录)
> ├── 草稿/ # 需求收集:临时想法、未成形需求(状态=起草),成熟后转正到根目录
> ├── 已完成/ # 已完成需求的归档(每个需求一个文件,含需求摘要+讨论记录)
> └── 丢弃/ # 被拒绝/搁置需求的归档(记录需求+丢弃原因)
> ```
> - **根目录 = 当前需求工作目录**:正在讨论、已定稿、待实现的需求以文件形式放在根目录。
> - **草稿/ → 根目录**:需求从草稿"转正"为正式需求(状态进入讨论中/已定稿)时移入根目录。
> - **已完成/ 与 丢弃/**:需求实现后移入已完成;拒绝/搁置移入丢弃(记录原因)。两者均为归档,追加不改写。
> - **登记格式**:每条需求索引记录含「编号 / 标题 / 描述 / 来源 / 优先级 / 状态(起草/讨论中/已定稿)/ 更新日期 / 实现迭代 / 实现状态」。
> **关于粒度**:计划不是单一粒度。一个计划可以是"概念范围大一些的阶段航点",也可以是"可直接执行的小任务"。两者本质相同 —— 都是对目标的分解 —— 只是范围大小不同,统一归入 `02-计划/`,通过粒度标记区分。
### 文档之间的流转关系
@@ -79,7 +93,7 @@ whenToUse: 在 one_divine_lot 仓库中从事任何开发、规划、讨论、
1. 建立 `docs/` 五大强约束目录:`01-终极目标/``02-计划/``03-设计约束/``04-迭代记录/``05-需求池/`
2. 每个目录写入 `说明.md` 骨架:角色 / 强约束(初始定义)/ 待讨论细节,内容与本节框架一致。
3. `03-设计约束/` 下建立三个文档模块:`产品功能约束.md``技术方案约束.md``UI交互约束.md`,各含六列列表骨架(编号 / 约束说明 / 添加日期 / 生效状态 / 失效日期 / 最后一次变更描述)。
4. `05-需求池/` 下建立需求索引骨架每条需求含「编号 / 标题 / 描述 / 优先级 / 状态(起草 / 讨论中 / 已定稿)/ 更新日期 / 实现迭代 / 实现状态」字段。
4. `05-需求池/` 下建立需求池结构:`需求池索引.md`(需求索引骨架每条含「编号 / 标题 / 描述 / 来源 / 优先级 / 状态(起草 / 讨论中 / 已定稿)/ 更新日期 / 实现迭代 / 实现状态」字段+ `草稿/``已完成/``丢弃/` 三个子目录
5. 检查 `.agents/skills/divine-lot-dev/` 是否存在(skill 本身),不存在则提示先安装 skill。
**初始化原则**