文档(实现指证清理): GDD 全树纯代码指证换代中文设计表述+纯度闸新增反引号调用形态判红——六类清算(方法/信号/类/常量/探针/调试与遥测入口名/提交号与运行时文件路径),保留面=数据索引(.tres 表路径与表名、表字段、表内枚值、存档键、封闭词表标签)并在 doc-conventions §5 明文写死;能力审计闸加 CALL_FORM_RE 窄规则兜底;顺修 §5 表两行误合并
This commit is contained in:
1 parent
fafb4fee0a
commit
6690c2a75b
35 files changed
+309
-306
No files matched your search
@@ -2,8 +2,8 @@
|
||||
r"""capability_audit.py — 能力清单、覆盖域表与 GDD 纯度机检(文档域闸件)
|
||||
|
||||
职责(test-conventions §8.9 三层模型的机检半边;规则正文=test-conventions §8.9+doc-conventions §5):
|
||||
A 文档纯度:design/gdd 全树现行文档禁写实现细节——代码路径(.gd/.py/.sh)、测试文件名、断言名;
|
||||
唯一例外=配置文件索引(.tres 表路径与表名)。围栏代码块内不扫。
|
||||
A 文档纯度:design/gdd 全树现行文档禁写实现细节——代码路径(.gd/.py/.sh)、测试文件名、断言名、
|
||||
反引号包裹的调用形态(`名字(...)`);唯一例外=配置文件索引(.tres 表路径与表名)。围栏代码块内不扫。
|
||||
B 验收标准:design/gdd/systems/** 每篇须有非空的「## 验收标准」节(豁免件具名在册,附理由)。
|
||||
C 能力行结构:game/tests/README.md 能力表六列齐、逐行六格非空。
|
||||
D 代表用例可核:能力行「代表用例」的每条 `文件:函数`——文件存在、在 run_all.gd 套件 manifest 内、
|
||||
@@ -35,6 +35,7 @@ RUN_ALL = REPO / "game" / "tests" / "run_all.gd"
|
||||
|
||||
PURITY_RE = re.compile(r"\.(gd|py|sh)\b")
|
||||
ASSERT_RE = re.compile(r"check_quiet\s*\(|\bcheck\s*\(")
|
||||
CALL_FORM_RE = re.compile(r"`[A-Za-z_][A-Za-z0-9_.]*\s*\([^`]*\)`")
|
||||
FENCE_RE = re.compile(r"^\s*```")
|
||||
|
||||
CAP_COLS = ("能力", "真实入口", "代表用例", "最后验证批次", "缺口")
|
||||
@@ -149,6 +150,9 @@ def check_purity():
|
||||
m = ASSERT_RE.search(ln)
|
||||
if m:
|
||||
red(doc.relative_to(REPO), no, "纯度", "断言名 `%s`(禁写实现细节)" % m.group(1))
|
||||
m = CALL_FORM_RE.search(ln)
|
||||
if m:
|
||||
red(doc.relative_to(REPO), no, "纯度", "反引号调用形态 %s(禁写实现细节)" % m.group(0))
|
||||
|
||||
|
||||
def check_accept_sections():
|
||||
|
||||
Reference in new issue
Block a user