# 文档地址修复程序 ## 目的自动**修复技能**，读取最新的审计/审查报告并将修复应用于 ADR（架构决策记录）文档。此技能弥合了“doc-adr-reviewer”/“doc-adr-audit”（用于识别问题）和纠正的 ADR 之间的差距，从而实现迭代改进周期。 **层**：5（ADR 质量改进） **上游**：ADR 文档、审核/审核报告（首选`ADR-NN.A_audit_report_vNNN.md`、`ADR-NN.R_review_report_vNNN.md` 遗留）、BDD（用于行为对齐）、BRD（用于主题对齐） **下游**：修复ADR，修复报告（`ADR-NN.F_fix_report_vNNN.md`） ** ** ## 何时使用此技能在以下情况下使用“doc-adr-fixer”： * **审核后** ：在 `doc-adr-reviewer` 识别问题后运行 * **迭代改进** ：审核的一部分 -> 修复 -> 审核周期 * **自动化管道**：用于质量关卡的 CI/CD 集成 * **批量修复** ：根据审核报告对多个 ADR 应用修复 **请勿在以下情况下使用**： * 不存在审核/审核报告（首先运行 `doc-adr-audit` 或 `doc-adr-reviewer`） * 创建新的 ADR（使用 `doc-adr` 或 `doc-adr-autopilot`） * 只需要验证（使用 `doc-adr-validator`） ** ** ## 技能依赖技能|目的|使用时 ---|---|--- `doc-adr-审计` |标准化结果的首选来源 |输入（读取审计报告） `doc-adr-审阅者` |需要修复的遗留/替代问题源 |输入（阅读评审报告） `文档命名` |元素 ID 标准 |修复元素 ID `doc-adr` | ADR 创建规则 |创建缺失的部分 `doc-bdd` | BDD对齐参考|验证行为可追溯性 ** ** ## 工作流程概述流程图TD A[输入：ADR 路径] --> B[查找最新审计/审核报告] B --> C{找到报告？} C -->|否| D[首先运行 doc-adr-audit 或 doc-adr-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[写入固定 ADR] L --> M[生成修复报告] M --> N{重新运行审核？} N -->|是| O[调用 doc-adr-reviewer] O --> P{分数 >= 阈值？} P -->|否，迭代次数 < max| F P -->|是|问[完成] N -->|否|问 ** ** ## 修复阶段 ### 第 0 阶段：修复结构违规（严重）修复了不在嵌套文件夹中的 ADR 文档。此阶段首先运行，因为所有后续阶段都依赖于正确的文件夹结构。 **嵌套文件夹规则**：所有 ADR 文档都必须位于嵌套文件夹中，无论文档大小如何。 **所需结构**：美国存托凭证类型 |所需地点 ---|--- 整体| `docs/05_ADR/ADR-NN_{slug}/ADR-NN_{slug}.md` **修复操作**：问题代码 |问题 |修复行动 ---|---|--- REV-STR001 | ADR 不在嵌套文件夹中 |创建文件夹、移动文件、更新所有链接 REV-STR002 | ADR 文件夹名称与 ADR ID 不匹配 |重命名文件夹以匹配 REV-STR003 |应将 >25KB 的整体 ADR 进行分段 |手动审核标记 **结构修复工作流程**： def fix_adr_struct(adr_path: str) -> 列表[修复]: """修复 ADR 结构违规。""" 修复=[] 文件名 = os.path.basename(adr_path) 父文件夹 = os.path.dirname(adr_path) # 从文件名中提取 ADR ID 和 slug match = re.match(r'ADR-(\d+)_([^/]+)\.md', 文件名) 如果不匹配： return [] # 无法自动修复无效文件名 adr_id = 匹配.组(1) slug = match.group（2） Expected_folder = f“ADR-{adr_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(adr_path, new_path) Fixs.append(f"已将 {adr_path} 移动到 {new_path}") # 更新移动文件中的上游链接内容=路径(new_path).read_text() update_content = content.replace('../04_BDD/', '../../04_BDD/') 更新内容 = 更新内容.replace('../03_EARS/', '../../03_EARS/') 更新内容 = 更新内容.replace('../01_BRD/', '../../01_BRD/') 路径（新路径）.write_text（更新内容） Fixs.append(f“更新了嵌套文件夹结构的相对链接”) 返回修复 **移动后链接路径更新**：原始路径 |更新路径 ---|--- `../04_BDD/BDD-01_slug/BDD-01.md` | `../../04_BDD/BDD-01_slug/BDD-01.md` `../01_BRD/BRD-01_slug/BRD-01.md` | `../../01_BRD/BRD-01_slug/BRD-01.md` ** ** ### 第 1 阶段：创建丢失的文件创建被引用但不存在的文件。 **范围**：丢失文件 |行动|使用的模板 ---|---|--- `ADR-00_INDEX.md` |创建ADR指数 |索引模板 `ARCH_*.md` |创建占位符架构文档 |拱形模板参考文档 (`*_REF_*.md`) |创建占位符 |参考模板 **ADR 指数模板**： --- 标题：“ADR-00：架构决策记录索引” 标签： - 地址 - 索引 - 参考自定义字段：文档类型：索引 artifact_type：ADR-参考层数：5 --- # ADR-00：架构决策记录索引该项目所有架构决策记录的主索引。 ## 积极决策 |美国存托凭证编号 |标题 |状态 |日期 |影响 | |--------|--------|--------|------|--------| | ADR-01 | [标题] |已接受 |年-月-日 |高/中/低| ## 取代的决定 |美国存托凭证编号 |标题 |取代 |日期 | |--------|--------|----------------|-----| | [无]| | | | ## 决策类别 |类别 | ADR ID |描述 | |----------|---------|-------------| |基础设施| |基础设施相关决策 | |安全| |安全架构决策| |整合 | |外部整合决策| |数据| |数据管理决策| --- *由 doc-adr-fixer 维护。添加新 ADR 时更新。* **架构占位符模板**： --- title: “架构文档：[组件名称]” 标签： - 建筑 - 参考自定义字段：文档类型：架构状态：占位符创建者：doc-adr-fixer --- # 架构文档：[组件名称] > **状态**：占位符 - 需要完成 ## 1. 概述 [TODO：文档架构概述] ## 2. 组件 |组件|描述 |责任| |------------|-------------|----------------| | [姓名] | [说明] | [它的作用] | ## 3. 接口 [TODO：文档组件接口] ## 4. 设计决策 [TODO：相关 ADR 的链接] --- *由 doc-adr-fixer 作为占位符创建。完成本文档以解决断开的链接问题。* ** ** ### 第 2 阶段：修复损坏的链接更新链接以指向正确的位置。 **修复操作**：问题代码 |问题 |修复行动 ---|---|--- REV-L001 |内部链接失效 |更新路径或创建目标文件 REV-L002 |外部链接无法访问 |添加警告评论，保留链接 REV-L003 |使用绝对路径|转换为相对路径 REV-L004 |缺少 BDD 追踪链接 |添加对应BDD场景的链接 **路径解析逻辑**： def fix_link_path(adr_location: str, target_path: str) -> str: """根据 ADR 位置计算正确的相对路径。""" # 整体 ADR：docs/05_ADR/ADR-01.md # 分段 ADR：docs/05_ADR/ADR-01_slug/ADR-01.3_section.md 如果 is_sectioned_adr(adr_location): # 需要再升一级返回“../”+计算相对路径（adr_location，目标路径）其他：返回计算相对路径（adr_location，目标路径） **跨层链接修复**：来源 |目标|链接模式 ---|---|--- 美国存托凭证 |业务驱动开发 | `../04_BDD/BDD-NN.feature` 美国存托凭证 | BRD | `../01_BRD/BRD-NN.md` 美国存托凭证 |系统| `../06_SYS/SYS-NN.md` ** ** ### 第 3 阶段：修复元素 ID 将无效的元素 ID 转换为正确的格式。 **转换规则**：图案|问题 |转换 ---|---|--- `ADR.NN.01.SS` |代码 01 对于 ADR 无效 | `ADR.NN.13.SS`（决策上下文） `12 月 XXX` |遗留模式| `ADR.NN.14.SS` `选择-XXX` |遗留模式| `ADR.NN.15.SS` `CON-XXX` |遗留模式| `ADR.NN.16.SS` **类型代码映射**（ADR 特定的有效代码：13、14、15、16）：代码|元素类型 |描述 ---|---|--- 13 |决策背景|背景和问题陈述 14 | 14决定声明|实际做出的决定 15 | 15考虑的选项 |评估替代方案 16 | 16后果|该决定的影响 **无效的代码转换**：无效代码 |有效代码 |元素类型 ---|---|--- 01 | 13 |决策上下文（是功能需求） 05 | 14 | 14决策声明（是用例） 06 | 16 | 16后果（是接受标准） **正则表达式模式**： # 查找 ADR 类型代码无效的元素 ID invalid_adr_type_01 = r'ADR\.(\d{2})\.01\.(\d{2})' replacement_01 = r'ADR.\1.13.\2' invalid_adr_type_05 = r'ADR\.(\d{2})\.05\.(\d{2})' replacement_05 = r'ADR.\1.14.\2' # 查找遗留模式 Legacy_dec = r'###\s+DEC-(\d+):' Legacy_opt = r'###\s+OPT-(\d+):' Legacy_con = r'###\s+CON-(\d+):' ** ** ### 第 4 阶段：修复内容问题解决占位符和不完整的内容。 **修复操作**：问题代码 |问题 |修复行动 ---|---|--- REV-P001 | `[TODO]` 占位符 |手动完成标记（无法自动修复） REV-P002 | `[TBD]` 占位符 |手动完成标记（无法自动修复） REV-P003 |模板日期`YYYY-MM-DD` |替换为当前日期 REV-P004 |模板名称 `[名称]` |替换为元数据作者或标志 REV-P005 |空部分|添加最少模板内容 REV-P006 |缺少决策状态 |添加“已提议”作为默认状态 **自动更换**：替换={ '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'), '[状态]': '建议', } **ADR 特定内容修复**：部分|缺少内容 |自动填充 ---|---|--- 状态 |空 | “提议” 决定日期 |空 |当前日期决策者 |空 | “[等待分配]” ** ** ### 第 5 阶段：更新参考文献确保可追溯性和交叉引用正确。 **修复操作**：问题 |修复行动 ---|--- 创建的文件缺少`@ref:` |添加参考标签跨 ADR 路径不正确 |更新以正确的相对路径缺少 BDD 可追溯性 |添加`@trace：BDD-NN.SS`标签缺少 BRD 对齐 |添加 `@trace: BRD-NN.SS` 标签 **可追溯性矩阵更新**： ## 可追溯性 | ADR 元素 |追踪至 |类型 | |------------|------------|------| | ADR.01.14.01 | BDD.01.09.03 |行为实施 | | ADR.01.13.01 | BRD.01.22.05 |业务背景 | ** ** ### 第 6 阶段：处理上游漂移（自动合并）解决了自 ADR 创建以来上游源文档 (BDD) 发生更改的问题。通过版本管理实现分层自动合并。 #### 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 |找不到上游文件 |部分|错误 ** ** **上游/下游上下文**：方向 |层 |神器|关系 ---|---|---|--- 上游| 4 |业务驱动开发 |提供驱动决策的行为规范当前| 5 |美国存托凭证 |架构决策记录下游| 6 |系统|系统设计实施决策 **ADR ID 模式**：`ADR-NN-SS` 其中： * `NN` = 模块编号 (01-99) * `SS` = 模块内的序列号 (01-99) * 示例：`ADR-01-15` = 模块 01，决策 15 ** ** #### 分层自动合并系统 **变化百分比计算**： defcalculate_drift_percentage(current_hash:str,upstream_hash:str, 当前_内容：str，上游_内容：str）->浮动： """计算版本之间内容更改的百分比。""" 如果当前哈希值==上游哈希值：返回 0.0 # 基于行的差异计算 current_lines = set(current_content.strip().split('\n')) upload_lines = set(upstream_content.strip().split('\n')) 添加 = 上游行数 - 当前行数已删除 = 当前行数 - 上游行数 Total_changes = len(添加) + len(删除) 总行数 = max(len(当前行数), len(上游行数), 1) 返回（总更改数/总行数）* 100 **等级定义**：等级 |变化% |行动|版本增量|人工审核 ---|---|---|---|--- 1 级 | < 5% |自动合并决策更新 |补丁 (x.x.+1) |否 2 级 | 5-15% |自动合并变更日志 |次要 (x.+1.0) |否第 3 级 | > 15% |存档+重新生成|主要 (+1.0.0) |是的 ** ** #### 第 1 层：小更新（< 5% 变化） **触发**：小的上游修改（拼写错误、澄清、少量添加） **自动合并操作**： 1. 使用新的上游版本更新受影响的 `@ref:` 标签 2. 如果措辞发生变化，则刷新决策上下文 3. 增加 ADR 补丁版本（例如 `1.0.0` -> `1.0.1`） 4. 漂移缓存中的日志更改 **第 1 层修复示例**： @ref：BDD-01.09.03 (v1.2.0) @ref：BDD-01.09.03 (v1.2.1) ** ** #### 第 2 层：适度更新（5-15% 变化） **触发器**：有意义的上游变化（新场景、修改行为） **自动合并操作**： 1. 应用所有第 1 层操作 2. 生成详细的变更日志部分 3. 如果受影响，请更新决策理由 4. 使用“[REVIEW-SUGGESTED]”将决策标记为需要审核 5. 增加 ADR 次要版本（例如 `1.0.1` -> `1.1.0`） 6. 将变更日志块添加到 ADR **变更日志块格式**： ## 上游变更日志 ### 版本1.1.0 (2026-02-10) **来源**：BDD-01.feature (v1.3.0) **变化百分比**：8.7% **自动合并层**：2 |更改类型 |描述 | ADR 影响 | |-------------|-------------|------------| |添加|场景：超时错误处理 | ADR-01-03 决定背景已更新 | |修改|场景：身份验证流程步骤 | ADR-01-01 决定理由更新 | |已删除 |无 |不适用 | **标记为审查的决定**： - ADR-01-03 [审查建议]：新的错误处理方案可能会影响重试策略 ** ** #### 第 3 层：主要更新（> 15% 变化） **触发**：重大上游重组或新要求 **行动**（需要人工审核）： 1. 存档当前ADR版本（不删除） 2. 创建存档清单 3. 将所有决定标记为“[SUPERSEDED]”（未删除） 4. 触发再生工作流程 5. 增加主要版本（例如，`1.1.0` -> `2.0.0`） 6. 使用新的决策 ID 生成新的 ADR **无删除政策**：决定永远不会被删除。相反，它们被标记为已取代： ### ADR-01-05：身份验证令牌策略 [已取代] > **取代**：ADR-01-15 (v2.0.0) > **取代日期**：2026-02-10 > **原因**：上游 BDD 重构了身份验证流程 **原始决定**（保留供审计）： ... **存档清单格式** (`ADR-NN_archive_manifest.json`)： { “archive_version”：“1.0”， "archive_date": "2026-02-10T16:00:00", "archived_adr": "ADR-01", “存档版本”：“1.1.0”， “新版本”：“2.0.0”， “触发”：{ “类型”：“tier_3_drift”， "upstream_document": "BDD-01.feature", “变化百分比”：23.5， "upstream_version_before": "1.2.0", “upstream_version_after”：“2.0.0” }, “取代的决定”：[ { “id”：“ADR-01-05”， "title": "身份验证令牌策略", “superseded_by”：“ADR-01-15”， "reason": "上游 BDD 重构身份验证流程" }, { “id”：“ADR-01-07”， "title": "会话管理方法", “superseded_by”：“ADR-01-16”， "reason": "BDD 中的新会话要求" } ], “保留的决定”：[ { “id”：“ADR-01-01”， "title": "数据库选择", “状态”：“不变”， “carried_forward_as”：“ADR-01-01” } ], “archive_location”：“docs/05_ADR/archive/ADR-01_v1.1.0/” } ** ** #### 增强型漂移缓存 **更新了`.drift_cache.json`结构**： { “缓存版本”：“2.0”， "adr_id": "ADR-01", "adr_version": "1.1.0", “adr_updated”：“2026-02-10T16:00:00”， “drift_reviewed”：“2026-02-10T16:00:00”， “上游跟踪”：{ “BDD”：{ “文档”：“../../04_BDD/BDD-01.feature”， “tracked_version”：“1.3.0”， "content_hash": "a1b2c3d4e5f6...", “last_sync”：“2026-02-10T16:00:00” } }, “下游跟踪”：{ “系统”：{ “文档”：“../../06_SYS/SYS-01.md”， “notified_version”：“1.1.0”， “notification_date”：“2026-02-10T16:00:00” } }, “合并历史记录”：[ { “日期”：“2026-02-10T16:00:00”， “等级”：2， “变化百分比”：8.7， "upstream_document": "BDD-01.feature", "version_before": "1.0.1", "version_after": "1.1.0", “decisions_updated”：[“ADR-01-01”，“ADR-01-03”]， “decisions_flaged”：[“ADR-01-03”]， “自动合并”：正确 }, { “日期”：“2026-02-08T10:00:00”， “等级”：1， “变化百分比”：2.3， "upstream_document": "BDD-01.feature", "version_before": "1.0.0", "version_after": "1.0.1", “decisions_updated”：[“ADR-01-02”]， “决策标记”：[]， “自动合并”：正确 } ], “acknowledged_drift”：[ { "文档": "BDD-01.feature", “acknowledged_date”：“2026-02-07”， “acknowledged_version”：“1.1.5”， "reason": "已审核 - 仅文档更改，无 ADR 影响" } ] } ** ** #### 自动合并决策流程流程图TD A[检测上游漂移] --> B[计算变化%] B --> C{变化 < 5%？} C -->|是| D[第 1 层：自动合并] D --> D1[更新@ref 标签] D1 --> D2[增量补丁版本] D2 --> D3[记录到漂移缓存] D3 --> Z[完成] C -->|否| E{改变5-15%？} E -->|是| F[第 2 层：自动合并 + 变更日志] F --> F1[应用第 1 层操作] F1 --> F2[生成变更日志块] F2 --> F3[标记审核建议] F3 --> F4[增加次要版本] F4 --> F5[记录合并历史记录] F5 --> Z E -->|否| G[第 3 层：存档 + 重新生成] G --> G1[创建存档清单] G1 --> G2[存档当前版本] G2 --> G3[标记决定被取代] G3 --> G4[增加主要版本] G4 --> G5[触发再生] G5 --> G6[通知下游SYS] G6 --> H[需要人工审核] ** ** #### 下游通知当ADR发生变化时（任何层），通知下游SYS文档： ** ** #### 第 6 阶段的命令选项选项 |默认 |描述 ---|---|--- `--自动合并` |真实|启用分层自动合并系统 `--merge-tier-override` |无 |强制特定层（1、2 或 3） `--跳过存档` |假 |跳过第 3 层的归档（不推荐） `--通知下游` |真实|向 SYS 文档发送通知 `--生成变更日志` |真实|生成 Tier 2+ 的变更日志 `--preserve-superseded` |真实|保留被取代的决定（必需） ** ** ## 命令用法 ### 基本用法 # 根据最新评论修复 ADR /doc-adr-修复程序 ADR-01 # 修复明确的审查报告（遗留） /doc-adr-fixer ADR-01 --review-report ADR-01.R_review_report_v001.md # 使用明确的审计报告修复（首选） /doc-adr-fixer ADR-01 --review-report ADR-01.A_audit_report_v001.md # 修复并重新运行审核 /doc-adr-fixer ADR-01 --重新验证 # 修复迭代限制 /doc-adr-fixer ADR-01 --revalidate --max-iterations 3 ### 选项选项 |默认 |描述 ---|---|--- `--审查报告` |最新 |要使用的特定审计/审查报告（首选`.A_audit_report`） `--重新验证` |假 |修复后运行审阅者 `--最大迭代次数` | 3 |最大修复审查周期 `--修复类型` |全部 |特定修复类型（以逗号分隔） `--创建缺失` |真实|创建缺失的参考文件 `--备份` |真实|修复前备份ADR `--试运行` |假 |预览修复而不应用 `--承认漂移` |假 |交互式漂移确认模式 `--更新漂移缓存` |真实|修复后更新 .drift_cache.json **报告选择优先级**： 1. 按时间戳选择最新报告。 2. 如果时间戳相等，则优先选择“ADR-NN.A_audit_report_vNNN.md”而不是“ADR-NN.R_review_report_vNNN.md”。 ### 修复类型类型 |描述 ---|--- `丢失的文件` |创建缺失的索引、架构文档 `损坏的链接` |修复链接路径 `element_ids` |转换无效/旧元素 ID `内容` |修复占位符、日期、状态 `参考文献` |更新可追溯性和交叉引用 ‘漂移’ |处理上游漂移检测问题 `全部` |所有修复类型（默认） ** ** ## 输出工件 ### 修复报告 **嵌套文件夹规则**：所有 ADR 都使用嵌套文件夹 (`ADR-NN_{slug}/`)，无论大小如何。修复报告与 ADR 文档一起存储在嵌套文件夹中。 **文件命名** : `ADR-NN.F_fix_report_vNNN.md` **位置**：在 ADR 嵌套文件夹内：`docs/05_ADR/ADR-NN_{slug}/` **结构**： --- 标题：“ADR-NN.F：修复报告 v001” 标签： - 地址 - 修复报告 - 质量保证自定义字段： document_type：修复报告工件类型：ADR-FIX 层数：5 父文档：ADR-NN 来源_审查：ADR-NN.A_audit_report_v001.md fix_date: "YYYY-MM-DDTHH:MM:SS" fix_tool：文档-adr-修复程序修复版本：“1.0” --- # ADR-NN 修复报告 v001 ## 总结 |公制|价值| |--------|--------| |来源评论 | ADR-NN.A_audit_report_v001.md（或旧版“ADR-NN.R_review_report_v001.md”）| |审查中的问题 | 12 | 12 |已解决的问题 | 10 | 10 |剩余问题 | 2（需要人工审核）| |文件已创建 | 2 | |文件修改 | 3 | ## 文件已创建 |文件|类型 |地点 | |------|------|----------| | ADR-00_INDEX.md |美国存托凭证指数|文档/05_ADR/ | | ARCH_Authentication.md |拱形占位符 |文档/00_REF/架构/ | ## 应用的修复 | ＃|问题代码 |问题 |修复已应用 |文件| |---|------------|--------|-------------|-----| | 1 | REV-L001 |损坏的索引链接 |创建 ADR-00_INDEX.md | ADR-01.md | | 2 | REV-L001 |拱形链接破损 |创建占位符 ARCH 文件 | ADR-01.md | | 3 | REV-N004 |元素类型 01 无效 |转换为类型 13 | ADR-01.md | | 4 | REV-L003 |使用绝对路径|转换为相对| ADR-02.md | ## 需要人工审核的问题 | ＃|问题代码 |问题 |地点 |原因 | |---|------------|--------|----------|--------| | 1 | REV-P001 | [TODO] 占位符 | ADR-01：L45 |需要建筑专业知识| | 2 | REV-D001 |检测到 BDD 漂移 | ADR-01：L120 |审查行为变化 | ## 修复后验证 |公制|之前 |之后|达美航空 | |--------|--------|--------|--------| |评论分数 | 88 | 88 95 | 95 +7 | |错误 | 3 | 0 | -3 | |警告| 5 | 2 | -3 | ## 后续步骤 1.完成ARCH_Authentication.md占位符 2. 处理剩余的 [TODO] 占位符 3. 检查 BDD 漂移并根据需要更新决策 4. 运行“/doc-adr-reviewer ADR-01”来验证修复 ** ** ## 与自动驾驶仪集成该技能由审核 -> 修复周期中的“doc-adr-autopilot”调用：流程图LR 子图 Phase5[“第 5 阶段：审查和修复周期”] A[doc-adr-reviewer] --> B{分数 >= 90?} B -->|否| C[文档地址修复程序] C --> D{迭代 < 最大值？} D -->|是|一个 D -->|否| E[手动审核标志] B -->|是| F[通过] 结束 **自动驾驶仪集成点**：相|行动|技能 ---|---|--- 5a 阶段 |进行初步审查 | `doc-adr-审阅者` 5b 阶段 |如果发现问题，请应用修复程序 | `doc-adr-修复程序` 5c 阶段 |重新运行审核 | `doc-adr-审阅者` 5d 阶段 |重复直到通过或最大迭代 |循环 ** ** ## 错误处理 ### 恢复行动错误 |行动 ---|--- 未找到审计/审查报告 |提示先运行 `doc-adr-audit` 或 `doc-adr-reviewer` 无法创建文件（权限）|记录错误，继续其他修复无法解析审计/审查报告 |中止并显示明确的错误消息超出最大迭代次数 |生成报告、标记以供手动审核 ### 备份策略在应用任何修复之前： 1. 在 `tmp/backup/ADR-NN_YYYYMMDD_HHMMSS/` 中创建备份 2. 将所有 ADR 文件复制到备份位置 3. 对原始文件应用修复 4. 如果修复过程中出现错误，请从备份恢复 ** ** ## 相关技能技能|关系 ---|--- `doc-adr-审计` |首选组合审计源（输入） `doc-adr-审阅者` |提供审查报告（输入） `doc-adr-自动驾驶仪` |协调审核 -> 修复周期 `doc-adr-验证器` |结构验证 `文档命名` |元素 ID 标准 `doc-adr` | ADR 创建规则 `doc-bdd` |上游行为参考 `doc-brd` |上游业务背景 ** ** ## 版本历史版本 |日期 |变化 ---|---|--- 2.3 | 2.3 2026-02-27 |将 frontmatter 迁移到“元数据”；添加了“ADR-NN.A_audit_report_vNNN.md”（首选）与旧版“ADR-NN.R_review_report_vNNN.md”的兼容性；定义确定性优先级（最新时间戳，然后在关系上“.A_”优先于“.R_”）；将嵌套文件夹报告路径示例更正为“docs/05_ADR” 2.2 | 2.2 2026-02-26 |与 ADR-MVP-TEMPLATE.md v1.1 一致（11 部分 MVP 结构） 2.1 | 2.1 2026-02-11 | **结构合规性**：添加了用于嵌套文件夹规则实施的阶段 0 (REV-STR001-STR003)；在其他修复阶段之前首先运行 2.0 | 2026-02-10 |增强第 6 阶段，具有分层自动合并系统；三级阈值（第 1 级 <5%，第 2 级 5-15%，第 3 级 >15%）；无删除政策 - 保留被取代的决定；第 3 层的存档清单；增强了带有合并历史记录的漂移缓存；自动生成的 ADR ID（ADR-NN-SS 模式）；下游SYS通知；变化百分比计算 1.0 | 2026-02-10 |初始技能创造； 6 阶段修复工作流程； ADR 索引和架构文件创建；元素ID转换（类型13、14、15、16）；修复了损坏的链接； BDD/BRD上游漂移处理；与自动驾驶仪集成审核->修复周期 ## 实施计划一致性 (IPLAN-004) * 将计划派生的输出视为有效的源模式，并验证实施计划范围/目标的意图保留。 * 验证上游自动驾驶仪优先级假设：`--iplan > --ref > --prompt`。 * 将计划上下文和工件输出之间的目标/范围冲突标记为需要澄清的阻塞问题。 * 不要引入旧的后备路径，例如“docs-v2.0/00_REF”。

文档地址修复程序

包含技能