OA/zentao-flow

Fork 0

Files

T

guoqibing e98660ce4e feat: 根目录文档、脚本、gitignore

2026-10-08 16:15:33 +08:00

4.4 KiB

Raw Blame History

pmassist-v3 Changelog

[v3.0.0] - 2026-03-30

基于 pmassist v2.1 全面升级

核心新增特性

1. FR 功能需求追踪体系（第 3.6 节）

背景：v2.x 的"需求内容"章节缺乏结构化编号，导致追踪困难。改进：

所有功能需求使用 FR-xxx 编号（主功能 FR-001 / 子场景 FR-001-1）
FR 记录包含：优先级、角色、触发条件（WHEN/IF）、需求（SHALL）、业务规则、AC 引用
session.yaml 新增 fr_count / ac_count / ac_coverage 统计字段

2. AC 验收标准管理（第 3.7 节）

背景：v2.x 缺乏结构化验收标准，PRD 无法直接驱动测试。改进：

AC 编号规则：AC-{FR编号后缀}-{序号}（如 AC-001-1）
格式固定为 Given / When / Then
每条 FR 至少要求：1条正常路径 + 1条异常路径
独立输出到 outputs/acceptance.md
主文档末尾维护 FR→AC 覆盖矩阵

3. AC 生成模式（会话恢复 F 模式）

背景：批量生成/补全验收标准的需求改进：

新增 F. AC 生成模式（Acceptance）
基于现有 FR 列表批量生成 Given/When/Then 验收标准
支持一键补全 AC 覆盖缺口

4. 端/渠道覆盖矩阵强化（PRD 第 6.1 节）

背景：多端产品需要明确各端覆盖情况改进：

端覆盖矩阵新增"涉及 FR"列，双向追踪
Check 阶段强制验证矩阵是否填写

5. 差异点清单增强（PRD 第 8 章）

背景：v2.x 差异清单维度不够改进：

新增"数据结构差异"和"权限差异"维度
新增"涉及 FR"列，与需求直接关联

6. 数据模型输出规范（第 9 节）

背景：实际 PRD 产出中 DDL 规范不统一改进：

标准化 CREATE TABLE 模板（含 del_flag/create_by/update_by 等标准字段）
标准化 ALTER TABLE 字段新增格式
PRD 中作为"建议数据结构"，FRD 中作为"规格要求"

7. 变更管理规范（第 10 节）

背景：PRD 迭代时变更追踪不够系统改进：

decision_log.md 表格新增"变更编号"（CHG-xxx）和"影响 FR"列
明确版本命名规范：v1.0 → v1.x → v1.x Final → v2.0

8. 智能内联问答（第 5.5 节）

背景：用户同一条消息中给出需求+部分答案时，AI 重复追问体验差改进：

直接消化已给出的答案，只追问真正不确定的 P0/P1 问题
session.yaml 新增 skip_flags 字段记录用户主动跳过的模块

9. PDCA Check 阶段增强（第 4 节）

背景：v2.x Check 缺乏对新增结构的验证 新增检查项：

FR 编号连续性
AC 覆盖率（每条 FR 至少 1 AC）
端覆盖矩阵是否填写
差异点清单是否完整

模板文件更新

文件	变更说明
`references/prd.md`	新增 FR 列表、FR→AC 矩阵、端覆盖矩阵、差异点新维度、数据模型章节、变更记录表
`references/frd.md`	新增 FR 编号格式、DDL 规范、FR→AC 矩阵、差异点清单、变更记录表
`references/dar.md`	新增 5-Whys 表格、代码根因定位表、可复用检查项清单
`references/acceptance_template.md`	新增（v3）：Given/When/Then 验收标准模板
`references/session_template.yaml`	新增（v3）：fr_count / ac_count / ac_coverage / skip_flags 字段
`scripts/init_session.py`	新增 `--enable-acceptance` 参数，自动创建 acceptance.md

向后兼容

✅ v2.x 会话可继续使用（缺少 FR/AC 统计字段时提示升级）
✅ 未使用 --enable-prototype 时，行为与 v2.x 完全一致
✅ 所有新增功能均为可选增强，不破坏现有工作流

升级指南（v2.x → v3.0）

在 session.yaml 中添加：

fr_count: 0
ac_count: 0
ac_coverage: "0/0"
skip_flags:
  prototype: false
  ac_batch: false
  diff_list: false

创建 outputs/acceptance.md（如需要）
在主文档中为现有功能需求补充 FR-xxx 编号和 AC 引用

[v2.1.0] - 2026-02-09

详见 pmassist 原版 CHANGELOG：新增会话恢复（Session Resumption）、5 种工作模式（A-E）

[v2.0.0] - 2026-02-09

详见 pmassist 原版 CHANGELOG：新增原型设计环节（Proto Round 1-3）

[v1.0.0] - 2026-02-08

详见 pmassist 原版 CHANGELOG：初始版本，WWH + PDCA 工作流程

4.4 KiB Raw Blame History Unescape Escape