# 文档-prd-修复程序 ## 目的自动**修复技能**，读取最新的审计/审查报告并对 PRD 文档应用修复。此技能弥合了“doc-prd-reviewer”/“doc-prd-audit”（识别问题）和纠正的 PRD 之间的差距，从而实现迭代改进周期。 **层**：2（PRD 质量改进） **上游**：PRD 文档、审核/审核报告（首选`PRD-NN.A_audit_report_vNNN.md`、`PRD-NN.R_review_report_vNNN.md` 遗留）、BRD（源要求） **下游**：修复 PRD，修复报告（`PRD-NN.F_fix_report_vNNN.md`） ** ** ## 何时使用此技能在以下情况下使用“doc-prd-fixer”： * **审核后** ：在 `doc-prd-reviewer` 识别问题后运行 * **迭代改进** ：审核的一部分 -> 修复 -> 审核周期 * **自动化管道**：用于质量关卡的 CI/CD 集成 * **批量修复** ：根据审核报告将修复应用于多个 PRD **请勿在以下情况下使用**： * 不存在审核/审核报告（首先运行 `doc-prd-audit` 或 `doc-prd-reviewer`） * 创建新的 PRD（使用 `doc-prd` 或 `doc-prd-autopilot`） * 只需要验证（使用 `doc-prd-validator`） ** ** ## 技能依赖技能|目的|使用时 ---|---|--- `doc-prd-审计` |标准化结果的首选来源 |输入（读取审计报告） `doc-prd-审稿人` |需要修复的遗留/替代问题源 |输入（阅读评审报告） `文档命名` |元素 ID 标准 |修复元素 ID `doc-prd` | PRD创建规则|创建缺失的部分 `doc-brd-审计` |上游 BRD 验证（统一质量门）|检查上游对齐情况 ** ** ## 工作流程概述流程图TD A[输入：PRD 路径] --> B[查找最新审核/审核报告] B --> C{找到报告？} C -->|否| D[首先运行 doc-prd-audit 或 doc-prd-reviewer] C -->|是| E[解析报告] E --> F[问题分类] 子图 FixPhases["修复阶段"] F --> F0[阶段 0：修复结构违规] F0 --> G[阶段 1: 创建丢失的文件] G --> H[第 2 阶段：修复损坏的链接] H --> I[阶段 3：修复元素 ID] I --> J[第 4 阶段：修复内容问题] J --> K[第 5 阶段：更新参考文献] K --> K2[阶段 6：处理上游漂移] 结束 K2 --> L[写入固定 PRD] L --> M[生成修复报告] M --> N{重新运行审核？} N -->|是| O[调用 doc-prd-reviewer] O --> P{分数 >= 阈值？} P -->|否，迭代次数 < max| F P -->|是|问[完成] N -->|否|问 ** ** ## 修复阶段 ### 第 0 阶段：修复结构违规（严重）修复不在嵌套文件夹中的 PRD。此阶段首先运行，因为所有后续阶段都依赖于正确的文件夹结构。 **嵌套文件夹规则**：所有 PRD 必须位于嵌套文件夹中，无论文档大小如何。 **所需结构**：珠三角类型 |所需地点 ---|--- 整体| `docs/02_PRD/PRD-NN_{slug}/PRD-NN_{slug}.md` 切片| `docs/02_PRD/PRD-NN_{slug}/PRD-NN.0_index.md`、`PRD-NN.1_*.md` 等 **修复操作**：问题代码 |问题 |修复行动 ---|---|--- REV-STR001 | PRD 不在嵌套文件夹中 |创建文件夹、移动文件、更新所有链接 REV-STR002 | PRD 文件夹名称与 PRD ID 不匹配 |重命名文件夹以匹配 REV-STR004 |嵌套文件夹的 BRD 链接路径不正确 |更新 `../01_BRD/` → `../../01_BRD/` **结构修复工作流程**： def fix_prd_struct(prd_path: str) -> 列表[修复]: """修复 PRD 结构违规。""" 修复=[] 文件名 = os.path.basename(prd_path) 父文件夹 = os.path.dirname(prd_path) # 从文件名中提取 PRD ID 和 slug match = re.match(r'PRD-(\d+)_([^/]+)\.md', 文件名) 如果不匹配： return [] # 无法自动修复无效文件名 prd_id = match.group(1) slug = match.group（2） Expected_folder = f"PRD-{prd_id}_{slug}" # 检查是否已经在嵌套文件夹中如果 os.path.basename(parent_folder) != Expected_folder: # 创建嵌套文件夹 new_folder = os.path.join(os.path.dirname(parent_folder), Expected_folder) os.makedirs（new_folder，exist_ok = True） # 移动文件 new_path = os.path.join(new_folder, 文件名) Shutil.move(prd_path, new_path) Fixs.append(f"已将 {prd_path} 移动到 {new_path}") # 更新移动文件中的 BRD 链接内容=路径(new_path).read_text() update_content = content.replace('../01_BRD/', '../../01_BRD/') 更新内容 = 更新内容.replace('../00_REF/', '../../00_REF/') 路径（新路径）.write_text（更新内容） Fixs.append(f“更新了嵌套文件夹结构的相对链接”) 返回修复 **移动后链接路径更新**：原始路径 |更新路径 ---|--- `../01_BRD/BRD-00_GLOSSARY.md` | `../../01_BRD/BRD-00_GLOSSARY.md` `../00_REF/domain/spec.md` | `../../00_REF/domain/spec.md` `PRD-00_GLOSSARY.md` | `../PRD-00_GLOSSARY.md` ** ** ### 第 1 阶段：创建丢失的文件创建被引用但不存在的文件。 **范围**：丢失文件 |行动|使用的模板 ---|---|--- `PRD-00_GLOSSARY.md` |创建 PRD 术语表 |词汇表模板 `PRD-NN_APPENDIX_*.md` |创建附录占位符 |附录模板参考文档 (`*_REF_*.md`) |创建占位符 |参考模板功能规格|使用 TODO 部分创建占位符 |特征模板 **PRD 术语表模板**： --- 标题：“PRD-00：产品术语表” 标签： - 珠三角 - 词汇表 - 参考自定义字段： document_type：术语表 artifact_type：PRD-参考层数：2 --- # PRD-00：产品术语表所有产品需求文档中使用的通用术语。 ## 产品条款 |术语 |定义 |背景 | |------|------------|---------| |特色|产品功能的离散单元|范围定义 | |用户故事 |以用户为中心的需求格式 |要求| |验收标准 |功能完成的条件|验证 | ## 技术术语 |术语 |定义 |背景 | |------|------------|---------| |应用程序接口 |应用程序编程接口|整合 | |用户界面|用户界面 |前端 | |用户体验 |用户体验 |设计| ## 域名术语 |术语 |定义 |背景 | |------|------------|---------| | [术语] | [定义] | [使用地点] | **功能占位符模板**： --- title: “功能规范：[功能名称]” 标签： - 珠三角 - 功能规格 - 参考自定义字段： document_type：功能规范状态：占位符创建者：doc-prd-fixer --- # 功能说明：[功能名称] > **状态**：占位符 - 需要完成 ## 1. 功能概述 [TODO：文档功能概述] ## 2. 用户故事 |故事ID |作为... |我想... |这样... | |----------|---------|--------------|------------| | US-XX-01 | [角色] | [行动] | [福利]| ## 3. 验收标准 [TODO：文件接受标准] ## 4. 依赖关系 [TODO：记录功能依赖性] --- *由 doc-prd-fixer 作为占位符创建。完成本文档以解决断开的链接问题。* ** ** ### 第 2 阶段：修复损坏的链接更新链接以指向正确的位置。 **修复操作**：问题代码 |问题 |修复行动 ---|---|--- REV-L001 |内部链接失效 |更新路径或创建目标文件 REV-L002 |外部链接无法访问 |添加警告评论，保留链接 REV-L003 |使用绝对路径|转换为相对路径 REV-L004 |损坏的 BRD 参考 |更新为正确的 BRD 路径 **路径解析逻辑**： def fix_link_path(prd_location: str, target_path: str) -> str: """根据PRD位置计算正确的相对路径。""" # 所有 PRD 都位于嵌套文件夹中（强制规则）： # 整体 PRD：docs/02_PRD/PRD-01_slug/PRD-01_slug.md # 分段 PRD：docs/02_PRD/PRD-01_slug/PRD-01.3_section.md # 两种类型都需要上两级才能达到01_BRD或00_REF 返回“../../”+计算相对路径（prd_位置，目标路径） **BRD 链接修复**（嵌套文件夹中的所有 PRD）：问题 |原文链接 |固定链接 ---|---|--- 移动到嵌套文件夹后 | `../01_BRD/BRD-01.md` | `../../01_BRD/BRD-01_slug/BRD-01_slug.md` 深度不正确 | `../../01_BRD/` | `../../01_BRD/`（已经正确） ** ** ### 第 3 阶段：修复元素 ID（阻塞）将无效的元素 ID 转换为正确的格式。 **元素代码违规现在被阻止** \- PRD 审核将失败，直到这些问题得到修复。 **转换规则**：图案|问题 |转换 ---|---|--- `PRD.NN.25.SS` |代码 25 对 PRD 无效 | `PRD.NN.01.SS`（功能要求） `PRD.NN.33.SS` |代码 33 对 PRD 无效 | `PRD.NN.22.SS`（功能项） `FR-XXX` |遗留模式| `PRD.NN.01.SS` `US-XXX` |遗留模式| `PRD.NN.05.SS` 'AC-XXX' |遗留模式| `PRD.NN.06.SS` **类型代码映射**（PRD 特定的有效代码：01-10、22、24、32）：无效代码 |有效代码 |元素类型 ---|---|--- 25 | 25 01 |功能需求 33 | 33 22 | 22特色项目 35 | 35 06 |验收标准 10 | 10 09|业务规则 12 | 12 11 | 11接口要求 **部分-元素类型代码映射（阻止强制执行）**：元素必须根据其部分使用正确的类型代码：部分|预期类型代码 |元素类型 ---|---|--- 5 | 08 |指标/关键绩效指标 7 | 09|用户故事 8 | 01 |功能需求 9 | 02 |质量属性 10 | 10 32 | 32架构主题 12 | 12 07|风险 14 | 14 06 |验收标准 **修复部分不匹配的操作 (PRD-E022)** ：当“PRD.NN.05.*” ID 出现在第 5 节（成功指标）中时，转换为“PRD.NN.08.*”： # 第 5 节指标必须使用类型代码 08，而不是 05 old_id = "PRD.01.05.01" # 错误：使用节号作为类型代码 new_id = "PRD.01.08.01" # 正确：使用公制类型代码 08 **正则表达式模式**： # 查找 PRD 类型代码无效的元素 ID invalid_prd_type_25 = r'PRD\.(\d{2})\.25\.(\d{2})' replacement_25 = r'PRD.\1.01.\2' invalid_prd_type_33 = r'PRD\.(\d{2})\.33\.(\d{2})' replacement_33 = r'PRD.\1.22.\2' # 查找遗留模式 Legacy_fr = r'###\s+FR-(\d+):' Legacy_us = r'###\s+US-(\d+):' Legacy_ac = r'###\s+AC-(\d+):' ** ** ### 第 4 阶段：修复内容问题解决占位符和不完整的内容。 **修复操作**：问题代码 |问题 |修复行动 ---|---|--- REV-P001 | `[TODO]` 占位符 |手动完成标记（无法自动修复） REV-P002 | `[TBD]` 占位符 |手动完成标记（无法自动修复） REV-P003 |模板日期`YYYY-MM-DD` |替换为当前日期 REV-P004 |模板名称 `[名称]` |替换为元数据作者或标志 REV-P005 |空部分|添加最少模板内容 REV-P006 |缺少用户故事格式 |手动审核标记 REV-DC001 |缺少 PRD 图标签（`c4-l2`、`dfd-l1`、`sequence-*`）|添加缺少的图表声明标签 REV-DC002 |序列图缺少显式异常/备用路径 |将 `alt/else` 分支添加到 Mermaid `sequenceDiagram` REV-DC003 |图表意图标头缺少必填字段 |添加“diagram_type”、“level”、“scope_boundary”、“upstream_refs”、“downstream_refs” **自动更换**：替换={ 'YYYY-MM-DDTHH:MM:SS': datetime.now().strftime('%Y-%m-%dT%H:%M:%S'), 'YYYY-MM-DD': datetime.now().strftime('%Y-%m-%d'), 'MM/DD/YYYY': datetime.now().strftime('%m/%d/%Y'), '[当前日期]': datetime.now().strftime('%Y-%m-%dT%H:%M:%S'), '[产品名称]': extract_product_name_from_metadata(), } **图修复安全规则**： * 对于“REV-DC*”问题，仅对图表声明块和 Mermaid 序列部分应用最少的编辑。 * 在解决图表合同结果时，不要修改非图表要求内容。 ** ** ### 第 5 阶段：更新参考文献确保可追溯性和交叉引用正确。 **修复操作**：问题 |修复行动 ---|--- 创建的文件缺少`@ref:` |添加参考标签跨珠三角路径错误 |更新以正确的相对路径缺少 BRD 可追溯性 |使用“@trace: BRD-NN”添加 BRD 引用缺少追溯条目 |添加到追溯矩阵 **可追溯性格式**： @trace：BRD-01.22.01 -> PRD-01.22.01 @ref：[BRD-01](../../../ai_dev_ssd_flow/PROJECT/fixtures/budget_alert/BRD-01.md) ** ** ### 第 6 阶段：处理上游漂移（自动合并）根据更改百分比阈值自动将上游 BRD 更改合并到 PRD 文档中。 **漂移检测工作流程**：流程图TD A[检测上游 BRD 变化] --> B[计算变化%] B --> C{变化分析} C -->|< 5%| D[第 1 层：自动合并] C -->|5-15%| E[第 2 层：自动合并 + 详细日志] C -->|> 15%| F[第 3 层：存档 + 重新生成] D --> D1[添加新要求] D1 --> D2[更新阈值] D2 --> D3[更新参考文献] D3 --> D4[增量补丁：1.0->1.0.1] E --> E1[添加新要求] E1 --> E2[更新阈值] E2 --> E3[更新参考文献] E3 --> E4[生成详细变更日志] E4 --> E5[小数增量：1.0->1.1] F --> F1[将当前标记为已存档] F1 --> F2[更新 frontmatter 状态] F2 --> F3[通过自动驾驶仪触发再生] F3 --> F4[主要增量：1.x->2.0] D4 --> G[更新漂移缓存] E5 --> G F4 --> G G --> H[添加到修复报告] ** ** #### 6.0.1 哈希验证修复 **FIX-H001：无效的哈希占位符** 触发器：哈希包含占位符而不是 SHA-256 修复： sha256sum <上游文件路径> |切-d''-f1 使用以下命令更新缓存：`sha256:<64_hex_output>` **FIX-H002：缺少哈希前缀** 触发器：64 个十六进制字符，但缺少 `sha256:` 前缀修复：在值前面添加 `sha256:` **FIX-H003：找不到上游文件** 触发器：无法计算哈希（文件丢失）修复：设置 `drift_Detected: true`，添加到手动审核代码|描述 |自动修复 |严重性 ---|---|---|--- 固定-H001 |将占位符哈希替换为实际的 SHA-256 |是的 |错误固定-H002 |添加缺少的 sha256: 前缀 |是的 |警告固定-H003 |找不到上游文件 |部分|错误 ** ** #### 6.1 变化百分比计算 defcalculate_change_percentage(upstream_old: str,upstream_new: str) -> dict: ”“” 计算上游 BRD 版本之间的变化百分比。返回： { 'total_change_pct': float, # 总体变化百分比 'additions_pct': float, # 添加新内容 'modifications_pct': float, # 修改现有内容 'deletions_pct': float, # 删除的内容（跟踪，未应用） 'change_type': str # '次要' | '中等' | ‘主要’ } ”“” old_lines = upload_old.strip().split('\n') new_lines = upload_new.strip().split('\n') # 使用 difflib 进行精确的变化检测导入差异库 diff = difflib.unified_diff(old_lines, new_lines) additions = sum(1 for line in diff if line.startswith('+') and not line.startswith('+++')) 删除 = sum(1 for line in diff if line.startswith('-') and not line.startswith('---')) 总行数 = max(len(旧行数), len(新行数)) Total_change_pct = ((添加 + 删除)/total_lines) * 100 如果total_lines > 0，否则为0 返回{ 'total_change_pct'：轮（total_change_pct，2）， 'additions_pct': round((additions/total_lines) * 100, 2) 如果total_lines > 0，否则为0， 'modifications_pct': round((min(添加、删除)/total_lines) * 100, 2) 如果total_lines > 0，否则为0， 'deletions_pct': round((删除/total_lines) * 100, 2) 如果total_lines > 0，否则为0， 'change_type': '次要' 如果total_change_pct < 5 否则'中等' 如果total_change_pct < 15 否则'主要' } ** ** #### 6.2 第 1 层：自动合并（< 5% 变化） **触发**：总变化百分比 < 5% **行动**：更改类型 |自动操作 |示例 ---|---|--- 添加新要求 |附加生成的 ID | `PRD.01.01.13` 阈值已更改 |查找和替换值 | `超时：30 -> 45` 参考更新 |更新 `@ref:` 路径 |路径修正版本增加 |更新版本参考| `v1.2 -> v1.3` **新要求的 ID 生成**： defgenerate_next_id（doc_type：str，doc_num：str，element_type：str，existing_ids：列表）-> str： ”“” 为新需求生成下一个顺序 ID。参数： doc_type：“PRD”、“BRD”等 doc_num：“01”、“02”等 element_type：“01”（功能）、“05”（用户故事）等。现有_ids：文档中现有ID的列表返回：下一个可用 ID（例如“PRD.01.01.13”） ”“” 模式= f“{doc_type}。{doc_num}。{element_type}。” 匹配 = [现有_ids 中的 id，如果 id.startswith(pattern)] 如果不匹配：返回f“{pattern}01” max_seq = max(int(id.split('.')[-1]) 用于匹配中的 id) 返回f“{模式}{str（max_seq + 1）.zfill（2）}” **PRD 的 ID 模式**：`PRD.NN.TT.SS` 其中： * `NN` = 文件编号（01、02 等） * `TT` = 类型代码（01=功能、05=用户故事、06=验收标准等） * `SS` = 序列号（01、02 等） **新需求的自动合并模板**： ### {GENERATED_ID}：{要求标题} **来源**：从 {upstream_brd} ({change_date}) 自动合并 **要求**：{requirement_text} **用户故事**： {用户故事} **验收标准**： {接受标准} **优先级**：{优先级} **版本更新**： * 增加补丁版本：`1.0` -> `1.0.1` * 更新 frontmatter 中的 `last_updated` * 添加变更日志条目 ** ** #### 6.3 第 2 层：自动合并详细日志（5-15% 变化） **触发器**：总变化百分比在 5% 到 15% 之间 **操作**：与第 1 层相同，加上：额外行动|描述 ---|--- 详细变更日志 |逐节更改日志影响分析|哪些下游工件受到影响（EARS、BDD）合并标记 | `` 注释版本历史 |详细的版本历史记录条目 **变更日志条目格式**： ## 变更日志 ### 版本 1.1 (2026-02-10T16:00:00) **上游同步**：自动合并上游 BRD 文档的 8.5% 更改 |改变 |来源 |部分|描述 | |--------|--------|---------|-------------| |添加| BRD-01.1_core.md | 3.5 | 3.5新的密钥身份验证要求 | |更新 | BRD-01.2_requirements.md | 4.2 |会话超时更改为 30->45 分钟 | |添加| BRD-01.3_quality_ops.md | 7.2 |新的性能要求| **添加新要求**： - PRD.01.01.13：密钥验证支持 - PRD.01.01.14：WebAuthn 回退机制 **更新阈值**： - PRD.01.02.05: session_idle_timeout: 30->45 分钟 **影响**：EARS-01、BDD-01、ADR-01 可能需要审查 **版本更新**： * 增加次要版本：`1.0` -> `1.1` * 更新 frontmatter 中的 `last_updated` * 添加详细的变更日志条目 ** ** #### 6.4 第 3 层：存档和重新生成（> 15% 变化） **触发**：总变化百分比 > 15% **行动**：步骤|行动|结果 ---|---|--- 1 |将当前版本标记为已存档 | frontmatter 状态更新 2 |创建存档副本 | `PRD-01_v1.0_archived.md` 3 |更新 frontmatter 状态 | `状态：已存档` 4 |触发自动驾驶仪再生 |新版本生成 5 |增加主要版本 | `1.x` -> `2.0` **存档 Frontmatter 更新**： --- 标题：“PRD-01：F1 身份和访问管理” 自定义字段：版本：“1.2” status: "archived" # 从 'current' 更改存档日期：“2026-02-10T16:00:00” archived_reason：“upstream_drift_major” superseded_by：“PRD-01_v2.0” 上游变化百分比：18.5 --- **存档文件命名**：文档/02_PRD/PRD-01_f1_iam/ ├── PRD-01.0_index.md # 当前（v2.0） ├── PRD-01.1_core.md # 当前（v2.0） ├── .存档/ │ ├── v1.2/ │ │ ├── PRD-01.0_index.md # 已存档 v1.2 │ │ ├── PRD-01.1_core.md │ │ └── ARCHIVE_MANIFEST.md # 归档元数据 **ARCHIVE_MANIFEST.md**： # 存档清单：PRD-01 v1.2 |领域|价值| |--------|--------| |存档版本 | 1.2 | 1.2 |存档日期 | 2026-02-10T16:00:00 | |原因 |上游漂移 > 15% (18.5%) | |取代 | v2.0 | |上游变化| BRD-01（重大修订）| ## 变更摘要 |上游文档 |变化% |关键变化| |--------------------|----------|-------------| | BRD-01.1_core.md | 18.5% |新的身份验证方法，修订的安全模型 | ## 下游影响再生后需要更新的文件： - EARS-01（源自 PRD-01） - BDD-01（测试场景） - ADR-01（架构决策） **无删除政策**： * 标记为已删除的上游内容**不会**从文档中删除 * 相反，标有“[DEPRECATED]”状态： ### PRD.01.01.05：旧版身份验证方法 [已弃用] > **状态**：已弃用（上游已于 2026-02-10T16:00:00 删除） > **原因**：被 PRD.01.01.13 取代（密码验证） > **操作**：保留以进行追溯；不实施 **原始要求**：{original_text} ** ** #### 6.5 漂移缓存更新处理漂移后，更新`.drift_cache.json`： { “文档版本”：“1.1”， “last_synced”：“2026-02-10T16:00:00”， "sync_status": "自动合并", “上游状态”：{ “../01_BRD/BRD-01.1_core.md”：{ "哈希": "sha256:a1b2c3d4e5f6...", “版本”：“2.3”， “最后修改”：“2026-02-10T15:30:00”， “更改_pct”：4.2， “sync_action”：“tier1_auto_merge” }, “../01_BRD/BRD-01.2_requirements.md”：{ “哈希”：“sha256：g7h8i9j0k1l2 ...”， “版本”：“1.5”， “最后修改”：“2026-02-10T14:00:00”， “change_pct”：8.7， “sync_action”：“tier2_auto_merge_detailed” } }, “合并历史记录”：[ { “日期”：“2026-02-10T16:00:00”， “等级”：1， “更改_pct”：4.2， “项目添加”：1， “items_updated”：2， "version_before": "1.0", “version_after”：“1.0.1” } ], “已弃用的项目”：[ { "id": "PRD.01.01.05", “deprecated_date”：“2026-02-10T16:00:00”， "reason": "上游移除", "replaced_by": "PRD.01.01.13" } ] } ** ** #### 6.6 修复报告：漂移部分 **修复报告中的漂移摘要**： ## 第 6 阶段：上游漂移解决 ### 漂移分析总结 |上游文档 |变化% |等级 |采取的行动| |--------------------|----------|------|--------------| | BRD-01.1_core.md | 4.2% | 1 |自动合并 | | BRD-01.2_requirements.md | 8.7% | 2 |自动合并（详细）| | BRD-01.3_quality_ops.md | 18.5% | 3 |已存档+重新生成| ### 第 1 层自动合并 (< 5%) |身份证 |类型 |来源 |描述 | |----|------|--------|-------------| | PRD.01.01.13 |添加| BRD-01.1:3.5 |密钥验证支持 | | PRD.01.02.05 |更新 | BRD-01.1:4.2 |会话超时 30->45 分钟 | ### 第 2 层自动合并 (5-15%) |身份证 |类型 |来源 |描述 | |----|------|--------|-------------| | PRD.01.01.14 |添加| BRD-01.2:5.3 | WebAuthn 后备机制 | | PRD.01.07.04 |添加| BRD-01.2:7.2 |新风险：凭证网络钓鱼 | ### 3 级档案 (> 15%) |文件|以前的版本 |新版本 |原因 | |----------|--------------------|-------------|--------| | PRD-01.2_requirements.md | 1.2 | 1.2 2.0 |上游变化18.5% | **存档位置**：`docs/02_PRD/PRD-01_f1_iam/.archive/v1.2/` ### 已弃用的项目（不删除） |身份证 |弃用日期 |原因 |替换为 | |----|-----------------|--------|-------------| | PRD.01.01.05 | 2026-02-10T16:00:00 |上游删除 | PRD.01.01.13 | ### 版本变更 |文件 |之前 |之后 |更改类型 | |------|--------|--------|-------------| | PRD-01.1_core.md | 1.0 | 1.0.1 |补丁（第 1 层）| | PRD-01.2_requirements.md | 1.0 | 1.1|未成年人（第 2 级）| | PRD-01.3_features.md | 1.2 | 1.2 2.0 |专业（第 3 级）| ** ** ## 命令用法 ### 基本用法 # 根据最新评论修复 PRD /doc-prd-修复程序 PRD-01 # 修复明确的审查报告（遗留） /doc-prd-fixer PRD-01 --review-report PRD-01.R_review_report_v001.md # 使用明确的审计报告修复（首选） /doc-prd-fixer PRD-01 --review-report PRD-01.A_audit_report_v001.md # 修复并重新运行审核 /doc-prd-fixer PRD-01 --重新验证 # 修复迭代限制 /doc-prd-fixer PRD-01 --revalidate --max-iterations 3 ### 选项选项 |默认 |描述 ---|---|--- `--审查报告` |最新 |要使用的特定审计/审查报告（首选`.A_audit_report`） `--重新验证` |假 |修复后运行审阅者 `--最大迭代次数` | 3 |最大修复审查周期 `--修复类型` |全部 |特定修复类型（以逗号分隔） `--创建缺失` |真实|创建缺失的参考文件 `--备份` |真实|修复前备份PRD `--试运行` |假 |预览修复而不应用 `--承认漂移` |假 |交互式漂移确认模式 `--更新漂移缓存` |真实|修复后更新 .drift_cache.json ### 修复类型类型 |描述 ---|--- `丢失的文件` |创建缺失的术语表、附录、功能文档 `损坏的链接` |修复链接路径 `element_ids` |转换无效/旧元素 ID `内容` |修复占位符、日期、名称 `参考文献` |更新可追溯性和交叉引用 ‘漂移’ |处理上游漂移检测问题 `全部` |所有修复类型（默认） ** ** ## 输出工件 ### 修复报告 **嵌套文件夹规则**：所有 PRD 都使用嵌套文件夹 (`PRD-NN_{slug}/`)，无论大小如何。修复报告与 PRD 文档一起存储在嵌套文件夹中。 **文件命名** : `PRD-NN.F_fix_report_vNNN.md` **位置**：在 PRD 嵌套文件夹内：`docs/02_PRD/PRD-NN_{slug}/` **结构**： --- 标题：“PRD-NN.F：修复报告 v001” 标签： - 珠三角 - 修复报告 - 质量保证自定义字段： document_type：修复报告工件类型：PRD-FIX 层数：2 父文档：PRD-NN 来源评论：PRD-NN.R_review_report_v001.md fix_date: "YYYY-MM-DDTHH:MM:SS" 修复工具：doc-prd-fixer 修复版本：“2.0” --- # PRD-NN 修复报告 v001 ## 总结 |公制|价值| |--------|--------| |来源评论 | PRD-NN.R_review_report_v001.md | |审查中的问题 | 12 | 12 |已解决的问题 | 10 | 10 |剩余问题 | 2（需要人工审核）| |文件已创建 | 2 | |文件修改 | 4 | ## 文件已创建 |文件 |类型 |地点 | |------|------|----------| | PRD-00_GLOSSARY.md |产品术语表 |文档/02_PRD/ | | PRD-01_附录_A.md |附录占位符 |文档/02_PRD/ | ## 应用的修复 | ＃|问题代码 |问题 |修复已应用 |文件 | |---|------------|--------|-------------|-----| | 1 | REV-L001 |损坏的词汇表链接 |创建 PRD-00_GLOSSARY.md | PRD-01.3_features.md | | 2 | REV-L004 |损坏的 BRD 参考 |更新路径为../01_BRD/BRD-01.md | PRD-01.1_core.md | | 3 | REV-N004 |元素类型 25 无效 |转换为 01 型 | PRD-01.1_core.md | | 4 | REV-L003 |使用绝对路径|转换为相对 | PRD-01.2_requirements.md | ## 需要人工审核的问题 | ＃|问题代码 |问题 |地点 |原因 | |---|------------|--------|----------|--------| | 1 | REV-P001 | [TODO] 占位符 | PRD-01.2：L45 |需要产品决策 | | 2 | REV-P006 |缺少用户故事格式 | PRD-01.2：L120 |故事需要细化| ## 修复后验证 |公制|之前 |之后 |达美航空 | |--------|--------|--------|--------| |评论分数 | 92 | 92 97 | 97 +5 | |错误 | 2 | 0 | -2 | |警告| 4 | 1 | -3 | ## 后续步骤 1. 填写PRD-01_APPENDIX_A.md占位符 2. 处理剩余的 [TODO] 占位符 3. 运行“/doc-prd-reviewer PRD-01”来验证修复 ** ** ## 与自动驾驶仪集成该技能由 Review -> Fix 周期中的 `doc-prd-autopilot` 调用：流程图LR 子图 Phase5[“第 5 阶段：审查和修复周期”] A[doc-prd-reviewer] --> B{分数 >= 90?} B -->|否| C[doc-prd-修复程序] C --> D{迭代 < 最大值？} D -->|是|一个 D -->|否| E[手动审核标志] B -->|是| F[通过] 结束 **自动驾驶仪集成点**：相|行动|技能 ---|---|--- 5a 阶段 |进行初步审查 | `doc-prd-审稿人` 5b 阶段 |如果发现问题，请应用修复程序 | `doc-prd-修复程序` 5c 阶段 |重新运行统一核心验证包装器 | `prd_core_wrapper_hook.sh` 5d 阶段 |重复直到通过或最大迭代 |循环 ** ** ## 错误处理 ### 恢复行动错误 |行动 ---|--- 未找到审计/审查报告 |提示先运行 `doc-prd-audit` 或 `doc-prd-reviewer` 无法创建文件（权限）|记录错误，继续其他修复无法解析报告 |中止并显示明确的错误消息超出最大迭代次数 |生成报告、标记以供手动审核未找到 BRD |记录警告，跳过依赖于 BRD 的修复 ### 备份策略在应用任何修复之前： 1. 在 `tmp/backup/PRD-NN_YYYYMMDD_HHMMSS/` 中创建备份 2.将所有PRD文件复制到备份位置 3. 对原始文件应用修复 4. 如果修复过程中出现错误，请从备份恢复 ** ** ## 相关技能技能|关系 ---|--- `doc-prd-审计` |首选组合审计报告输入 `doc-prd-审稿人` |提供审查报告（输入） `doc-prd-自动驾驶仪` |协调审核 -> 修复周期 `doc-prd-验证器` |结构验证 `文档命名` |元素 ID 标准 `doc-prd` | PRD创建规则 `doc-brd-审计` |上游 BRD 验证（统一质量门） ** ** ## 版本历史版本 |日期 |变化 ---|---|--- 2.4 | 2.4 2026-03-02 | **元素代码修复（阻塞）**：第 3 阶段元素 ID 修复现在阻塞；添加了节元素类型代码映射强制； PRD-E020/PRD-E022 违规行为需要修复才能通过审核 2.3 | 2.3 2026-03-01 | **2-Skill BRD 模型**：将 BRD 验证参考从“doc-brd-reviewer”更新为“doc-brd-audit”（统一质量门） 2.2 | 2.2 2026-02-26 |将 frontmatter 迁移到“元数据”模式；添加了“PRD-NN.A_audit_report_vNNN.md”（首选）与旧版“PRD-NN.R_review_report_vNNN.md”支持的兼容性 2.1 | 2.1 2026-02-11 | **结构合规性**：添加了用于嵌套文件夹规则实施的阶段 0 (REV-STR001-STR004)；修复了所有路径注释，以对整体和分段 PRD 使用嵌套文件夹；更新了强制嵌套结构的链接路径计算 2.0 | 2026-02-10T16:00:00 | **主要**：实施分层自动合并系统 - 第 1 层（<5%）：通过补丁版本增量自动合并添加/更新；第 2 层 (5-15%)：自动合并详细的变更日志和次要版本增量；第 3 层（>15%）：归档当前版本并通过主版本增量触发重新生成；无删除政策（标记为“已弃用”）；根据新要求自动生成 ID（PRD.NN.TT.SS 格式）；存档清单创建；增强了漂移缓存和合并历史记录 1.0 | 2026-02-10T15:00:00 |初始技能创造； 6 阶段修复工作流程；术语表和功能文件创建； PRD代码的元素ID转换（01-09、11、22、24）；修复了损坏的链接； BRD漂移检测；与自动驾驶仪集成审核->修复周期 ## 实施计划一致性 (IPLAN-004) * 将计划派生的输出视为有效的源模式，并验证实施计划范围/目标的意图保留。 * 验证上游自动驾驶仪优先级假设：`--iplan > --ref > --prompt`。 * 将计划上下文和工件输出之间的目标/范围冲突标记为需要澄清的阻塞问题。 * 不要引入旧的后备路径，例如“docs-v2.0/00_REF”。

Doc Prd 修复程序

包含技能