From f6172903b81c9146cdc7a65108fdf0aed0ab362c Mon Sep 17 00:00:00 2001 From: lhl Date: Sun, 9 Aug 2026 16:56:49 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=E6=AD=A3=E9=94=99=E8=AF=AF?= =?UTF-8?q?=E7=A0=81=E4=B8=80=E8=87=B4=E6=80=A7=20spec/plan=20=E8=AE=A1?= =?UTF-8?q?=E6=95=B0=E7=AC=94=E8=AF=AF=EF=BC=88LLM=20=E9=94=99=E8=AF=AF?= =?UTF-8?q?=E7=A0=81=E5=AE=9E=E4=B8=BA=204=20=E6=9D=A1=E9=9D=9E=205?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plans/2026-08-09-error-code-consistency-test.md | 6 +++--- .../specs/2026-08-09-error-code-consistency-test-design.md | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/superpowers/plans/2026-08-09-error-code-consistency-test.md b/docs/superpowers/plans/2026-08-09-error-code-consistency-test.md index 75335ce..d9246dc 100644 --- a/docs/superpowers/plans/2026-08-09-error-code-consistency-test.md +++ b/docs/superpowers/plans/2026-08-09-error-code-consistency-test.md @@ -106,10 +106,10 @@ def test_error_doc_llm_rows_resolve_to_exception(): def test_error_doc_stable_llm_row_count(): - # 格式护栏：LLM 行数 === 5；新增/删除 LLM 错误码需显式更新此数 + # 格式护栏：LLM 行数 === 4；新增/删除 LLM 错误码需显式更新此数 mapping = _extract_llm_error_rows(API_DOC.read_text(encoding="utf-8")) - assert len(mapping) == 5, ( - f"api §7 LLM 错误码行数应为 5，实际 {len(mapping)}；" + assert len(mapping) == 4, ( + f"api §7 LLM 错误码行数应为 4，实际 {len(mapping)}；" "新增/删除错误码须同步更新此计数。" ) diff --git a/docs/superpowers/specs/2026-08-09-error-code-consistency-test-design.md b/docs/superpowers/specs/2026-08-09-error-code-consistency-test-design.md index 114b8f1..56bf153 100644 --- a/docs/superpowers/specs/2026-08-09-error-code-consistency-test-design.md +++ b/docs/superpowers/specs/2026-08-09-error-code-consistency-test-design.md @@ -16,7 +16,7 @@ ## 2. 范围与不做的事 **范围：** -- 仅验证 §7 表格中**来源列以 `exceptions.` 开头**的 5 条 LLM 错误码行（LLM_TIMEOUT / LLM_NETWORK_ERROR / LLM_NOT_CONFIGURED / LLM_PARSE_ERROR） +- 仅验证 §7 表格中**来源列以 `exceptions.` 开头**的 4 条 LLM 错误码行（LLM_TIMEOUT / LLM_NETWORK_ERROR / LLM_NOT_CONFIGURED / LLM_PARSE_ERROR） - 双向验证：异常树 → 文档、文档 → 异常树 **不做（YAGNI）：** @@ -54,7 +54,7 @@ def _extract_llm_error_rows(document: str) -> dict[str, str]: |---|------|---------|---------| | 1 | `test_error_doc_lists_every_llm_error_code` | 异常树 → 文档 | 遍历 `LLMError.__subclasses__()`，每个子类 `error_code`（非 None）必须出现在文档映射中，且来源类名 == 子类名 | | 2 | `test_error_doc_llm_rows_resolve_to_exception` | 文档 → 异常树 | 文档映射中每个错误码都能在 `LLMError.__subclasses__()` 中找到 `error_code` 相同、类名匹配的唯一类 | -| 3 | `test_error_doc_stable_llm_row_count` | 格式护栏 | 文档映射中 LLM 行数 == 5（防止表格结构变化静默失效；新增/删除 LLM 行需显式更新此数） | +| 3 | `test_error_doc_stable_llm_row_count` | 格式护栏 | 文档映射中 LLM 行数 == 4（防止表格结构变化静默失效；新增/删除 LLM 行需显式更新此数） | | 4 | `test_error_doc_parse_guard_prevents_silent_noop` | 格式护栏 | 若解析结果为空（表格格式被改动导致正则失配），立即硬失败而非静默通过 | ### 3.5 失败可诊断（DX 修正 F1/F2）