# 文档 CTR 修复程序 ## 目的自动**修复技能**，读取最新的审核报告并将修复应用于 CTR（合同）文档。这项技能弥合了“doc-ctr-reviewer”（识别问题）和纠正后的点击率之间的差距，从而实现迭代改进周期。 **层**：8（点击率质量改进） **上游**：REQ 文档、CTR 文档、审核报告 (`CTR-NN-SSS.R_review_report_vNNN.md`) **下游**：修复点击率（MD + YAML），修复报告（`CTR-NN-SSS.F_fix_report_vNNN.md`） ** ** ## 何时使用此技能在以下情况下使用“doc-ctr-fixer”： * **审核后** ：在 `doc-ctr-reviewer` 识别问题后运行 * **迭代改进** ：审核的一部分 -> 修复 -> 审核周期 * **自动化管道**：用于质量关卡的 CI/CD 集成 * **批量修复** ：根据审核报告将修复应用于多个 CTR * **双文件同步问题**：MD 和 YAML 内容存在分歧 **请勿在以下情况下使用**： * 不存在审核报告（首先运行 `doc-ctr-reviewer`） * 创建新的点击率（使用 `doc-ctr` 或 `doc-ctr-autopilot`） * 只需要验证（使用 `doc-ctr-validator`） ** ** ## 技能依赖技能|目的|使用时 ---|---|--- `doc-ctr-审稿人` |待修复问题的来源 |输入（阅读评审报告） `文档命名` |元素 ID 标准 |修复元素 ID `doc-ctr` |点击率创建规则|创建缺失的部分 `文档请求` |需求追踪 |验证上游链接 ** ** ## 工作流程概述流程图TD A[输入：CTR路径] --> B[查找最新评论报告] B --> C{找到评论？} C -->|否| D[首先运行 doc-ctr-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：处理上游漂移] 结束子图 DualFileSync["双文件同步"] K2 --> L1{MD + YAML 存在吗？} L1 -->|是| L2[同步 MD <-> YAML] L1 -->|否| L3[创建丢失的文件] L2 --> L4[验证一致性] L3 --> L4 结束 L4 --> M[写入固定点击率文件] M --> N[生成修复报告] N --> O{重新运行审核？} 哦-->|是| P[调用 doc-ctr-reviewer] P --> Q{分数 >= 阈值？} Q -->|否，迭代次数 < max| F 问 -->|是| R[完成] 哦-->|否|右 ** ** ## 修复阶段 ### 第 0 阶段：修复结构违规（严重）修复了不在嵌套文件夹中的 CTR 文档。此阶段首先运行，因为所有后续阶段都依赖于正确的文件夹结构。 **嵌套文件夹规则**：所有 CTR 文档都必须位于嵌套文件夹中，无论文档大小如何。 **所需结构**：点击率类型 |所需地点 ---|--- 双文件| `docs/08_CTR/CTR-NN_{slug}/CTR-NN_{slug}.md` \+ `CTR-NN_{slug}.yaml` **修复操作**：问题代码 |问题 |修复行动 ---|---|--- REV-STR001 |点击率不在嵌套文件夹中 |创建文件夹，移动两个文件，更新所有链接 REV-STR002 | CTR 文件夹名称与 CTR ID 不匹配 |重命名文件夹以匹配 REV-STR003 | CTR >25KB 应进行分段 |手动审核标记 **结构修复工作流程**： def fix_ctr_struct(ctr_path: str) -> 列表[修复]: """修复点击率结构违规问题。""" 修复=[] 文件名 = os.path.basename(ctr_path) 父文件夹 = os.path.dirname(ctr_path) # 从文件名中提取 CTR ID 和 slug match = re.match(r'CTR-(\d+)_([^/]+)\.(md|yaml)', 文件名) 如果不匹配： return [] # 无法自动修复无效文件名 ctr_id = match.group(1) slug = match.group（2） Expected_folder = f"CTR-{ctr_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） # 移动 .md 和 .yaml 文件 base_name = f"CTR-{ctr_id}_{slug}" 对于 ['.md', '.yaml'] 中的 ext： old_file = os.path.join(parent_folder, base_name + ext) 如果 os.path.exists(old_file): new_file = os.path.join(new_folder, base_name + ext) Shutil.move（旧文件，新文件） fixes.append(f"已将 {old_file} 移动到 {new_file}") # 更新移动的 .md 文件中的上游链接 md_path = os.path.join(new_folder, base_name + '.md') 如果 os.path.exists(md_path): 内容=路径(md_path).read_text() update_content = content.replace('../07_REQ/', '../../07_REQ/') 更新内容 = 更新内容.replace('../06_SYS/', '../../06_SYS/') 路径（md_path）.write_text（更新内容） Fixs.append(f“更新了嵌套文件夹结构的相对链接”) 返回修复 **移动后链接路径更新**：原始路径 |更新路径 ---|--- `../07_REQ/REQ-01_slug/REQ-01.md` | `../../07_REQ/REQ-01_slug/REQ-01.md` ** ** ### 第 1 阶段：创建丢失的文件创建被引用但不存在的文件。 **范围**：丢失文件 |行动|使用的模板 ---|---|--- `CTR-NN-SSS.yaml` |从 MD 创建 YAML 合约 | YAML 合约模板 `CTR-NN-SSS.md` |从 YAML 创建 MD 文档 |医学博士合同范本架构文件 (`*_schema.json`) |创建占位符架构 | JSON 架构模板参考文档 |创建占位符 |参考模板 **YAML 合同模板**： # CTR-NN-SSS: [合约名称] # 由 doc-ctr-fixer 自动生成 - 需要完成合同： id：CTR-NN-SSS 名称：“[合同名称]” 版本：“1.0.0” 状态：草案创建：“YYYY-MM-DD” 元数据：层数：8 工件类型：点击率上游请求：REQ-NN 接口：类型：“[API|事件|数据|服务]” 协议：“[HTTP|gRPC|AMQP|Kafka]” 端点：[] # TODO: 定义端点模式：[] # TODO：定义模式验证： # TODO: 定义验证规则 **总经理合同模板**： --- 标题：“CTR-NN-SSS：[合约名称]” 标签： - 点击率 - 合同 - 第 8 层自定义字段： document_type：合同工件类型：点击率层数：8 上游请求：REQ-NN yaml_companion：CTR-NN-SSS.yaml --- # CTR-NN-SSS: [合约名称] > **状态**：占位符 - 需要完成 ## 1. 合约概述 [TODO：记录合同目的和范围] ## 2. 接口定义 [TODO：定义接口规范] ## 3. 数据模式 [TODO：文档数据模式] ## 4. 验证规则 [TODO：定义验证规则] --- *由 doc-ctr-fixer 作为占位符创建。完成本文档以解决问题。* ** ** ### 第 2 阶段：修复损坏的链接更新链接以指向正确的位置。 **修复操作**：问题代码 |问题 |修复行动 ---|---|--- REV-L001 |内部链接失效 |更新路径或创建目标文件 REV-L002 |外部链接无法访问 |添加警告评论，保留链接 REV-L003 |使用绝对路径|转换为相对路径 REV-L004 | YAML 参考已损坏 |更新 YAML $ref 路径 REV-L005 |架构引用无效 |修复 JSON 架构 $ref **路径解析逻辑**： def fix_link_path(ctr_location: str, target_path: str) -> str: """根据CTR位置计算正确的相对路径。""" # 点击率文件：docs/08_CTR/CTR-01-API.md + CTR-01-API.yaml # 架构文件：docs/08_CTR/schemas/ 如果 is_yaml_reference(target_path): 返回fix_yaml_ref（ctr_location，target_path） elif is_schema_reference（目标路径）：返回fix_schema_ref（ctr_location，target_path）其他：返回计算相对路径（ctr_location，目标路径） **YAML 参考修复**：参考类型 |原创|固定 ---|---|--- 架构参考 | `$ref: schema.json` | `$ref: ./schemas/schema.json` 组件参考 | `$ref: #/components/` |验证路径存在外部参考| `$ref: http://...` |如果无法访问则添加警告 ** ** ### 第 3 阶段：修复元素 ID 将无效的元素 ID 转换为正确的格式。 **转换规则**：图案|问题 |转换 ---|---|--- `CTR.NN.XX.SS` |无效的类型代码 |转换为有效的 CTR 代码 `API-XXX` |遗留模式| `CTR.NN.16.SS` `INT-XXX` |遗留模式| `CTR.NN.16.SS` `型号-XXX` |遗留模式| `CTR.NN.17.SS` `SCHEMA-XXX` |遗留模式| `CTR.NN.17.SS` `条款-XXX` |遗留模式| `CTR.NN.20.SS` **类型代码映射**（每个 ID_NAMING_STANDARDS.md 的 CTR 特定）：无效代码 |有效代码 |元素类型 ---|---|--- 01 | 16 | 16接口 02 | 17 | 17数据模型 28 | 28 16 | 16接口（旧版） 29 | 29 17 | 17数据模型（旧版）任何其他 | 2020 年 16 月 17 日 |映射到接口、数据模型或子句 **有效的点击率类型代码**：代码|元素类型 |描述 ---|---|--- 16 | 16接口 | API端点、服务接口 17 | 17数据模型|模式、数据结构 20 |合同条款|合同条款、验证规则 **正则表达式模式**： # 查找具有无效点击率类型代码的元素 ID invalid_ctr_type = r'点击率\.(\d{2})\.(?!16|17|20)(\d{2})\.(\d{2})' # 查找遗留模式 Legacy_api = r'###\s+API-(\d+):' Legacy_evt = r'###\s+EVT-(\d+):' Legacy_schema = r'###\s+SCHEMA-(\d+):' ** ** ### 第 4 阶段：修复内容问题解决占位符和不完整的内容。 **修复操作**：问题代码 |问题 |修复行动 ---|---|--- REV-P001 | `[TODO]` 占位符 |手动完成标记（无法自动修复） REV-P002 | `[TBD]` 占位符 |手动完成标记（无法自动修复） REV-P003 |模板日期`YYYY-MM-DD` |替换为当前日期 REV-P004 |模板名称 `[名称]` |替换为元数据作者或标志 REV-P005 |空部分|添加最少模板内容 REV-Y001 |无效的 YAML 语法 |尝试 YAML 修复 REV-Y002 |缺少必需的 YAML 字段 |添加带有占位符的字段 **自动更换**：替换={ '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'), '“1.0.0”'：f'“{calculate_version()}”'， } **YAML 修复操作**： YAML 问题 |修复动作 ---|--- 缺少引号 |在字符串值周围添加引号无效缩进 |修复 2 个空格缩进重复的钥匙 |保留第一，评论重复缺少冒号 |在键后添加冒号 ** ** ### 第 5 阶段：更新参考文献确保可追溯性和交叉引用正确。 **修复操作**：问题 |修复行动 ---|--- 缺少 `@req:` 参考 |添加 REQ 可追踪标签 REQ 路径不正确 |更新以正确的相对路径缺少追溯条目 |添加到追溯矩阵孤儿 YAML 伴侣 |链接 MD 和 YAML 文件 **请求可追溯性修复**： ## 3. 接口端点 ## 3. 接口端点 @req：[REQ-01.28.01](../07_REQ/REQ-01.md#req-01-28-01) ** ** ### 第 6 阶段：处理上游漂移（自动合并）解决了自使用分层自动合并系统创建 CTR 以来上游 REQ 文档发生更改的问题。 #### 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 |找不到上游文件 |部分|错误 ** ** **上游**：REQ（第 7 层） **下游**：SPEC（第 9 层） #### 合约 ID 模式 **格式** : `CTR-NN-TYPE-SS` 组件|描述 |示例 ---|---|--- `点击率` |神器前缀 |点击率 `NN` |文档编号 (01-99) | 01, 02, 15 `类型` |合同类型| API、数据、事件、服务 `SS` |类型内的序列 (01-99) | 01, 02, 13 **自动生成的 ID 示例**： * `CTR-01-API-01` \- 文档 01 中的第一个 API 合同 * `CTR-01-API-13` \- 文档 01 中的第 13 个 API 合约 * `CTR-02-DATA-05` \- 文档 02 中的第 5 个数据合同 * `CTR-03-EVENT-02` \- 文档 03 中的第二个活动合同 #### 分层自动合并系统更改百分比是通过比较 CTR 创建时的上游 REQ 内容哈希值与当前的值来计算的： defcalculate_drift_percentage(ctr_path: str, req_path: str) -> float: """计算影响 CTR 的上游 REQ 变化的百分比。""" drift_cache = load_drift_cache(ctr_path) Original_hash =drift_cache.get('req_content_hash') current_hash =compute_content_hash(req_path) 如果original_hash == current_hash：返回 0.0 # 逐行比较 Original_lines =drift_cache.get('req_snapshot_lines', []) 当前行数 = 读取文件行数(req_path) Changed_lines = len(set(original_lines) ^ set(current_lines)) 总行数 = max(len(原始行数), len(当前行数)) 返回（更改行数/总行数）* 100 等级 |变化% |行动|版本影响 ---|---|---|--- **1 级** | < 5% |自动合并合约更新 |补丁增量 (1.0.0 → 1.0.1) **2 级** | 5-15% |自动合并详细的变更日志 |小增量（1.0.0 → 1.1.0） **第 3 级** | > 15% |归档电流，触发再生|主要增量 (1.0.0 → 2.0.0) #### 第 1 级：轻微漂移 (< 5%) 自动合并，干扰最小： **行动**： 1. 将 `@req:` 引用更新为当前 REQ 版本 2. 同步 REQ 中的元数据字段 3.增加合约补丁版本 4.更新漂移缓存 **更新示例**： # 之前 (CTR-01-API-05.yaml) 合同：编号：CTR-01-API-05 版本：“1.0.0” 请求版本：“1.0.0” # 自动合并后合同：编号：CTR-01-API-05 版本：“1.0.1” 请求版本：“1.0.1” 最后合并：“2026-02-10T16:00:00” #### 第 2 层：中等漂移 (5-15%) 自动合并详细的变更日志： **行动**： 1. 所有 1 级行动 2. 生成详细的变更日志条目 3. 将 `[MERGED]` 标记添加到受影响的部分 4.增量合约小版本 5. 使用变更日志更新配套 MD 文件 **变更日志格式**： ## 变更日志 ### v1.1.0 (2026-02-10) - 自动合并 **上游更改** (REQ-01.md v1.0.0 → v1.1.0)： - 修改：REQ-01.28.03 - 更新验证规则 - 添加：REQ-01.28.07 - 新的身份验证要求 - 漂移：8.5% **合同更新**： - [合并] 第 3.2 节：更新模式验证 - [合并] 第 4.1 节：添加了身份验证合同参考 #### 第 3 级：显着漂移 (> 15%) 存档并重新生成： **行动**： 1. 创建存档清单 2. 将当前点击率移至存档 3.通过`doc-ctr-autopilot`触发CTR再生 4.增加主要版本 5. 新点击率中的链接存档 **存档清单** (`CTR-NN-TYPE_archive_manifest.yaml`)： # CTR 存档清单存档：原始 ID：CTR-01-API-05 存档版本：“1.1.0” 存档日期：“2026-02-10T16:00:00” archive_reason：“upstream_drift_exceeded_15%” 漂移百分比：23.5 上游触发：文档：REQ-01.md 原始版本：“1.0.0” 当前版本：“2.0.0” 存档文件： - 路径：“archive/CTR-01-API-05_v1.1.0.md” 哈希：“sha256:abc123...” - 路径：“archive/CTR-01-API-05_v1.1.0.yaml” 哈希：“sha256：def456...” 再生：新 ID：CTR-01-API-05 新版本：“2.0.0” 触发技能：doc-ctr-自动驾驶仪重新生成：“2026-02-10T16:05:00” #### 无删除政策合同永远不会被删除。当合同失效时： **弃用标记**： # CTR-01-API-03.yaml 合同：编号：CTR-01-API-03 状态：“[已弃用]” 已弃用日期：“2026-02-10” deprecated_reason：“已被 CTR-01-API-15 取代” 后继产品：CTR-01-API-15 **MD 弃用标头**： --- 状态：已弃用已弃用日期：“2026-02-10” 后继产品：CTR-01-API-15 --- # CTR-01-API-03：旧版用户身份验证合约 > **[已弃用]** 此合约已被 [CTR-01-API-15](./CTR-01-API-15.md) 取代。 > 保留作为历史参考和向后兼容性文档。 #### 增强型漂移缓存漂移缓存跟踪合并历史记录以用于审计目的： **文件**：`.drift_cache.json`（每个 CTR 目录） { “CTR-01-API-05”：{ “当前版本”：“1.1.0”， "req_content_hash": "sha256:abc123...", "req_snapshot_lines": ["line1", "line2", "..."], "last_checked": "2026-02-10T16:00:00", “最后修改”：“2026-02-10T15:30:00”， “合并历史记录”：[ { “日期”：“2026-02-08T14:00:00”， “等级”：1， “漂移百分比”：3.2， "version_before": "1.0.0", "version_after": "1.0.1", “req_version”：“1.0.1” }, { “日期”：“2026-02-10T16:00:00”， “等级”：2， “漂移百分比”：8.5， "version_before": "1.0.1", "version_after": "1.1.0", “req_version”：“1.1.0”， “变更日志条目”：3 } ], “档案历史记录”：[] } } #### 文件类型处理 `.md` 和 `.yaml` 合约文件都会被处理：文件类型 |合并动作 ---|--- `.md` |更新 frontmatter、@req 参考文献、变更日志部分 `.yaml` |更新合约元数据、版本、时间戳两者 |同步版本号，保持双文件一致性 **同步顺序**： 1.先处理YAML（合约数据权威） 2. 将更改同步到 MD 伴侣 3.更新漂移缓存 4. 生成修复报告条目 #### 漂移问题代码代码|严重性 |等级 |描述 |行动 ---|---|---|---|--- REV-D001 |信息 | 1 |较小的 REQ 修改 (< 5%) |自动合并、补丁版本 REV-D002 |警告| 2 |适度的 REQ 修改 (5-15%) |自动与变更日志合并，次要版本 REV-D003 |错误 | 3 |主要 REQ 修改 (> 15%) |存档并重新生成，主要版本 REV-D004 |信息 | 1-2 | 1-2添加新要求 |添加合同存根 REV-D005 |警告|不适用 |引用已弃用的合同 |更新对继任者的引用 ** ** ## 双文件同步 CTR 文档由必须保持同步的配对 MD + YAML 文件组成。 ### 同步检测同步问题 |检测|分辨率 ---|---|--- MD 存在，YAML 缺失 |检查配套文件 |从 MD 生成 YAML YAML 存在，MD 缺失 |检查配套文件 |从 YAML 生成 MD 内容不匹配|比较关键字段 |调和分歧版本不匹配 |比较版本字段 |更新到最新 ### 同步操作 **MD 到 YAML 同步**：医学博士部分 | YAML 字段 ---|--- 标题 | `合约名称` 版本 | `合约版本` 接口端点| `端点[]` 数据模式 | `模式[]` 验证规则| `验证` **YAML 到 MD 同步**： YAML 字段 |医学博士部分 ---|--- `合约名称` |标题 `端点[]` |接口端点部分 `模式[]` |数据模式部分 `验证` |验证规则部分 ### 冲突解决冲突类型|解决策略 ---|--- 两者都修改了相同的字段|手动审核标记 YAML 有更新的数据 |从 YAML 更新 MD MD 有更新数据 |从 MD 更新 YAML 结构差异|保持MD结构，同步数据 ** ** ## 命令用法 ### 基本用法 # 根据最新评论修复点击率 /doc-ctr-fixer CTR-01-API # 修复明确的审查报告 /doc-ctr-fixer CTR-01-API --review-report CTR-01-API.R_review_report_v001.md # 修复并重新运行审核 /doc-ctr-fixer CTR-01-API --revalidate # 修复迭代限制 /doc-ctr-fixer CTR-01-API --revalidate --max-iterations 3 # 仅同步双文件 /doc-ctr-fixer CTR-01-API --sync-only ### 选项选项|默认 |描述 ---|---|--- `--审查报告` |最新 |使用的具体审查报告 `--重新验证` |假 |修复后运行审阅者 `--最大迭代次数` | 3 |最大修复审查周期 `--修复类型` |全部 |特定修复类型（以逗号分隔） `--创建缺失` |真实 |创建缺失的参考文件 `--备份` |真实 |修复前备份点击率 `--试运行` |假 |预览修复而不应用 `--仅同步` |假 |仅同步 MD/YAML，跳过其他修复 `--承认漂移` |假 |交互式漂移确认模式 `--更新漂移缓存` |真实 |修复后更新 .drift_cache.json ### 修复类型类型 |描述 ---|--- `丢失的文件` |创建缺失的 YAML、MD、架构文档 `损坏的链接` |修复链接路径和 YAML 引用 `element_ids` |转换无效/旧元素 ID `内容` |修复占位符、日期、YAML 语法 `参考文献` |更新 REQ 可追溯性和交叉引用 ‘漂移’ |处理上游漂移检测问题 `同步` |同步 MD 和 YAML 伴随文件 `全部` |所有修复类型（默认） ** ** ## 输出工件 ### 修复报告 **嵌套文件夹规则**：所有 CTR 使用嵌套文件夹 (`CTR-NN_{slug}/`)，无论大小如何。修复报告与 CTR 双文件 (.md + .yaml) 一起存储在嵌套文件夹中。 **文件命名** : `CTR-NN-SSS.F_fix_report_vNNN.md` **位置**：在 CTR 嵌套文件夹内：`docs/08_CTR/CTR-NN_{slug}/` **结构**： --- 标题：“CTR-NN-SSS.F：修复报告 v001” 标签： - 点击率 - 修复报告 - 质量保证自定义字段： document_type：修复报告工件类型：CTR-FIX 层数：8 父文档：CTR-NN-SSS 来源评论：CTR-NN-SSS.R_review_report_v001.md fix_date: "YYYY-MM-DDTHH:MM:SS" 修复工具：doc-ctr-修复器修复版本：“1.0” --- # CTR-NN-SSS 修复报告 v001 ## 总结 |公制|价值| |--------|--------| |来源评论 | CTR-NN-SSS.R_review_report_v001.md | |审查中的问题 | 15 | 15 |已解决的问题 | 12 | 12 |剩余问题 | 3（需要人工审核）| |文件已创建 | 1 | |文件修改 | 2 | |双文件同步 |已完成 | ## 文件已创建 |文件 |类型 |地点 | |------|------|----------| | CTR-01-API.yaml | YAML 合约 |文档/08_CTR/ | ## 双文件同步状态 | MD 文件 | YAML 文件 |同步状态 |行动| |--------|------------|-------------|--------| | CTR-01-API.md | CTR-01-API.yaml |同步|从 MD 生成 YAML | ## 应用的修复 | ＃|问题代码 |问题 |修复已应用 |文件 | |---|------------|--------|-------------|-----| | 1 | REV-L004 |损坏的 YAML 参考 |更新架构路径 | CTR-01-API.yaml | | 2 | REV-N004 |无效的元素类型 |转换为类型 16 | CTR-01-API.md | | 3 | REV-Y001 |无效的 YAML 语法 |固定缩进 | CTR-01-API.yaml | ## 需要人工审核的问题 | ＃|问题代码 |问题 |地点 |原因 | |---|------------|--------|----------|--------| | 1 | REV-P001 | [TODO] 占位符 | CTR-01-API.md:L45 |所需领域知识 | | 2 | REV-D002 | REQ 内容已更改 | REQ-01.28.01 |审查要求更新 | ## 上游漂移总结 |上游文档 |参考|修改|点击率更新 |陈旧的日子|需要采取行动| |--------------------|------------------------|----------|--------------|------------------------|------| | REQ-01.md | CTR-01-API：L57 | 2026-02-08 | 2026-02-05 | 3 |审查变更 | ## 修复后验证 |公制|之前 |之后 |达美航空 | |--------|--------|--------|--------| |评论分数 | 88 | 88 96 | 96 +8 | |错误 | 3 | 0 | -3 | |警告| 5 | 2 | -3 | ## 后续步骤 1. 填写CTR-01-API.md中的[TODO]占位符 2. 检查上游 REQ 漂移 3. 运行 `/doc-ctr-reviewer CTR-01-API` 来验证修复 ** ** ## 与自动驾驶仪集成该技能由 Review -> Fix 周期中的“doc-ctr-autopilot”调用：流程图LR 子图 Phase5[“第 5 阶段：审查和修复周期”] A[doc-ctr-reviewer] --> B{分数 >= 90?} B -->|否| C[doc-ctr-修复程序] C --> D{迭代 < 最大值？} D -->|是|一个 D -->|否| E[手动审核标志] B -->|是| F[通过] 结束 **自动驾驶仪集成点**：相|行动|技能 ---|---|--- 5a 阶段 |进行初步审查 | `doc-ctr-审阅者` 5b 阶段 |如果发现问题，请应用修复程序 | `doc-ctr-修复程序` 5c 阶段 |重新运行审核 | `doc-ctr-审阅者` 5d 阶段 |重复直到通过或最大迭代 |循环 ** ** ## 错误处理 ### 恢复行动错误 |行动 ---|--- 未找到审查报告 |提示先运行 `doc-ctr-reviewer` 无法创建文件（权限）|记录错误，继续其他修复无法解析审核报告 |中止并显示明确的错误消息 YAML 解析错误 |尝试修复，如果无法恢复则标记超出最大迭代次数 |生成报告、标记以供手动审核双文件冲突|手动解析标志 ### 备份策略在应用任何修复之前： 1. 在 `tmp/backup/CTR-NN-SSS_YYYYMMDD_HHMMSS/` 中创建备份 2.将所有CTR文件（MD + YAML）复制到备份位置 3. 对原始文件应用修复 4. 如果修复过程中出现错误，请从备份恢复 ** ** ## 相关技能技能|关系 ---|--- `doc-ctr-审稿人` |提供审查报告（输入） `doc-ctr-自动驾驶仪` |协调审核 -> 修复周期 `doc-ctr-验证器` |结构验证 `文档命名` |元素 ID 标准 `doc-ctr` |点击率创建规则 `文档请求` | REQ上游可追溯性 ** ** ## 版本历史版本 |日期 |变化 ---|---|--- 2.2 | 2.2 2026-02-26 | **元素类型代码对齐**：将每个 ID_NAMING_STANDARDS.md 的类型代码从 28、29 更新为 16、17、20；修复了从 ai_dev_flow/CTR/ 到 ai_dev_ssd_flow/08_CTR/ 的路径 2.1 | 2.1 2026-02-11 | **结构合规性**：添加了用于嵌套文件夹规则实施的阶段 0 (REV-STR001-STR003)；在其他修复阶段之前首先运行 2.0 | 2026-02-10 |增强第 6 阶段，具有分层自动合并系统；添加了第 1/2/3 层阈值（<5%、5-15%、>15%）；合约 ID 模式 CTR-NN-TYPE-SS；没有带有 [DEPRECATED] 标记的删除政策；第 3 层的存档清单；增强了带有合并历史记录的漂移缓存；支持 .md 和 .yaml 合约文件 1.0 | 2026-02-10 |初始技能创造； 6 阶段修复工作流程；双文件（MD+YAML）同步；元素ID转换（类型28、29）； YAML语法修复； REQ漂移处理；与自动驾驶仪集成审核->修复周期 ## 实施计划一致性 (IPLAN-004) * 将计划派生的输出视为有效的源模式，并验证实施计划范围/目标的意图保留。 * 验证上游自动驾驶仪优先级假设：`--iplan > --ref > --prompt`。 * 将计划上下文和工件输出之间的目标/范围冲突标记为需要澄清的阻塞问题。 * 不要引入旧的后备路径，例如“docs-v2.0/00_REF”。

文档 Ctr 修复程序

包含技能