沉淀实践约定：需求定稿三要素/状态流转责任/归档检查清单/草稿转正清理/语义迁移核对

2026-09-01 18:05:05 +08:00
parent 6dc4ab61e5
commit ece30fbf0d
1 changed files with 13 additions and 2 deletions
@@ -50,6 +50,10 @@ whenToUse: 在 one_divine_lot 仓库中从事任何开发、规划、讨论、
 > - **更新日期**：最近一次状态变更或内容更新的日期，随每次变更刷新。
 > - **与入范围门槛的对应**：只有状态为「已定稿」的需求才可进入计划范围或迭代工作范围；起草 / 讨论中的需求停留在需求池。

+> **需求状态流转责任**（2026-08-28 定）：状态流转由 **AI 提议 + 老师确认** 驱动 —— AI 负责整理需求、提出状态变更建议（起草→讨论中→已定稿），老师拍板确认后 AI 更新状态；回退同样需老师确认并记录理由。
+
+> **需求定稿标准（三要素）**（2026-08-28 定）：需求进入「已定稿」需同时满足 —— ① **边界清楚**（做什么 / 不做什么明确收敛）；② **核心逻辑明确**（关键决策点：数据模型 / 交互 / 技术方案都有讨论结论）；③ **老师确认**（老师明确表示需求可定稿）。三条全满足才可进入计划 / 迭代范围；R-002 为完整实践样本。
+
 > **需求池目录结构**：`05-需求池/` 内部按以下结构组织需求：
 > ```
 > 05-需求池/
@@ -64,6 +68,11 @@ whenToUse: 在 one_divine_lot 仓库中从事任何开发、规划、讨论、
 > - **已完成/ 与 丢弃/**：需求实现后移入已完成；拒绝/搁置移入丢弃（记录原因）。两者均为归档，追加不改写。
 > - **登记格式**：每条需求索引记录含「编号 / 标题 / 描述 / 来源 / 优先级 / 状态（起草/讨论中/已定稿）/ 更新日期 / 实现迭代 / 实现状态」。

+> **需求归档检查清单**（2026-09-01 定，源自 R-005/R-008 归档实践）：
+> 需求实现完成后归档，按序执行 —— ① **核实完成**：对应迭代复盘存在且标记「验收通过」，索引中实现状态为「已实现」；② **补归档头**：归档文件加「归档日期 / 需求状态：已完成 / 实现迭代 / 讨论记录索引」头部；③ **移入归档**：需求文件从根目录移入 `已完成/`；④ **更新索引**：主索引保留条目，实现状态改为「已实现（已归档）」，描述标注归档路径；⑤ **双向追溯**：迭代记录与需求池互相引用（迭代复盘关联需求编号，需求归档引用迭代复盘路径）。归档只追加不改写历史。
+
+> **草稿转正清理**（2026-09-01 定，源自 T-008 转正残留教训）：草稿转正为正式需求（T→R）时，**必须清理草稿残留的头部/模板内容**（如「状态：起草」「登记日期」旧头部），确保正式文件只有一套头部；转正后删除草稿文件，索引同步更新（草稿行状态 → 已转需求 R-xxx）。
+
 > **关于粒度**：计划不是单一粒度。一个计划可以是"概念范围大一些的阶段航点"，也可以是"可直接执行的小任务"。两者本质相同 —— 都是对目标的分解 —— 只是范围大小不同，统一归入 `02-计划/`，通过粒度标记区分。

 ### 文档之间的流转关系
@@ -118,6 +127,7 @@ whenToUse: 在 one_divine_lot 仓库中从事任何开发、规划、讨论、
 - **规范约束**：实现必须符合 `03-设计约束/` 的规范；无规范依据的实现需要先补规范或讨论豁免。
 - **记录诚实**：迭代记录只写事实，成功失败都记录，失败是复盘的原料。
 - **约束优先**：文档强约束 > 临时便利；违反约束的改动需要讨论并修订文档。
+- **语义迁移核对**（2026-09-01 定，源自迭代 06 addToStrategy Bug）：改造/迁移方法时，若方法语义发生变化（如「新增量」变「绝对目标量」、存储整体读写变单条生命周期），必须 —— ① 显式命名语义（如 `_applySharesForStrategy(target)` 注释标明参数为绝对目标）；② 逐调用点核对参数含义；③ 用真实 API 走一遍完整 CRUD 回归（不能只靠隔离单测，隔离测试可能掩盖语义混淆）。

 ## 6. skill 自我维护约定

@@ -146,6 +156,7 @@ whenToUse: 在 one_divine_lot 仓库中从事任何开发、规划、讨论、
 - [x] 迭代记录：组织结构（每次迭代一个子目录，含迭代目标 / 技术实现方案 / 验收标准；与需求池索引联动）
 - [ ] 迭代记录：验收标准的写法（标准线如何划定、验收方法、验收目标）
 - [ ] 迭代记录：记录粒度、编号规则、复盘模板
- [x] 需求池：登记格式（含状态字段：起草/讨论中/已定稿 + 更新日期，以及"实现迭代 / 实现状态"联动字段）、优先级规则、状态流转的具体定义
+- [x] 需求池：登记格式（含状态字段：起草/讨论中/已定稿 + 更新日期，以及"实现迭代 / 实现状态"联动字段）、状态流转的具体定义（AI 提议 + 老师确认，2026-08-28 定）
+- [ ] 需求池：优先级规则（P0-P2？MoSCoW？如何定级）
 - [x] 入范围门槛：只有确定的需求才可进入计划/迭代范围，未确定的需求停留在需求池
- [ ] 讨论本身的规范：讨论如何发起、如何收敛、如何判定"讨论完成"（含"需求确定"的判定标准）
+- [ ] 讨论本身的规范：讨论如何发起、如何收敛（需求定稿判定标准「三要素」已定：边界清楚 + 核心逻辑明确 + 老师确认，2026-08-28）