工程(能力审计闸上电): tools/capability_audit.py 接入文档域 08e——GDD 纯度＋能力清单与覆盖域表结构由机检兜底；baseline 加 08e 绿记录、07/08d 条目随批 5 文档清理实测归绿；test-conventions §8.9 与 doc-conventions §5 补闸件指路句（闸件清单唯一出处=run_all_gates.sh 头部）
This commit is contained in:
DKChan committed
1 parent
a10bf92656
commit
915222fa0a
4 files changed
+16
-8
No files matched your search
@@ -67,7 +67,7 @@
|
||||
| 一页纸节点 | 一节、一条规则 ≤一页纸（约 ≤80 行）；装不下就拆节 |
|
||||
| 一系统一文档 | 不建 analysis 推演件；两三句能说清的"为什么"直接写进设计目的或规则正文 |
|
||||
| 正文只写现行规则 | 禁删除线、"（作废）"、"（日期+拍板）"式注记；审计信息入对应文档附录 |
|
||||
| 禁实现内容 | 系统文档与概念文档全文禁写实现细节——代码路径（`.gd`／`.py`／`.sh`）、测试文件名、断言名一律不出现；唯一例外＝配置文件索引（`game/data/tables/*.tres` 这类表路径与表名）。实现事实归 `architecture.md`；验收标准只写玩家或系统可观测面 |
|
||||
| 禁实现内容 | 系统文档与概念文档全文禁写实现细节——代码路径（`.gd`／`.py`／`.sh`）、测试文件名、断言名一律不出现；唯一例外＝配置文件索引（`game/data/tables/*.tres` 这类表路径与表名）。实现事实归 `architecture.md`；验收标准只写玩家或系统可观测面。本行由文档域闸的能力审计机检，闸件清单与域划分的唯一出处＝`tools/run_all_gates.sh` 头部 |
|
||||
| 正文单点维护 | 一条规则句只写在定义它的那份文档（owner 文档）；其他文档要引用时写指针或语义概括，禁复制色值、尺寸、路径等可核对的具体值——上一句管不住数值之外的双写，本句补上。豁免面 = 执行侧文件必须带字面值才能工作时（生图提示词里的十六进制色、脚本参数），转写不算双写，但该文件头部必须写明"冲突时以 owner 文档为准" |
|
||||
| 禁写变更记录 | 文档与代码文件内一律禁设「版本历史／修订记录／变更记录／修改记录／更新记录／更新日志」节或表格，禁逐版本叙述「改了哪些条款」；沿革与改动明细只进 git commit log。版本号可作为文档现行身份标记出现在文首状态行与正文引用中，但不得再挂变更表 || 后置 ≠ 删除 | P1/P2 后置内容逐条列出；复活后置项 = 修订文档，禁静默加回 |
|
||||
| 活体清单不冻结计数 | 对会生长的清单（文档树构成、UI 层项、RNG 流词表等）不写死计数与枚举——写指针到 owner（根索引/常量表/实现文件），现状值由 owner 承载；历史计数只进 git 提交信息 |
|
||||
|
||||
@@ -150,3 +150,5 @@
|
||||
**维护时序**：能力清单归写卡段维护——写需求卡片时增删能力行、刷新本批受影响行的「最后验证批次」；实现批禁写该文件（process-conventions §3 第 11 条）。规则后果是清单滞后一个迭代：本批实现后的代表用例与「最后验证批次」由下次写卡补齐。实现批的验收义务在改动—验收对照表，不在能力清单。
|
||||
|
||||
**文档纯度**：验收意图与能力描述只写玩家或系统可观测面，禁写代码路径（`.gd`／`.py`／`.sh`）、测试文件名、断言名；唯一例外＝配置文件索引（`game/data/tables/*.tres` 这类表路径与表名）。规则正文见 doc-conventions §5「禁实现内容」。
|
||||
|
||||
**机器闸**：本节的结构由文档域闸「能力审计」机检——GDD 纯度（同款禁实现内容口径）、系统文档验收标准节非空、能力行六列与非空、代表用例（`文件:函数`）与真实入口可核、覆盖域表与能力行对得上；红项按新增红处理。闸件清单与域划分的唯一出处＝`tools/run_all_gates.sh` 头部。
|
||||
@@ -1,5 +1,5 @@
|
||||
{
|
||||
"note": "存量基线·首次自动生成；闸况变化时本脚本会判红，需人工确认后重生成；2026-10-17 人工确认重生成 06 条目：af94ce97 把 gdd_lint 记为存量红（01 篇 R5），该红已由 fcb8c3f8 补流程图消除，实测 --docs 域 06 exit=0，故基线改回绿。2026-10-18 新增闸件 08c 流水线闸（tools/pipeline_gate.py 注册上电），手工加入绿记录（roadmap 压缩批实测 --docs 域 exit=0），其余条目原样保留。2026-10-22 测试术语与层级重构批 A 改键：01 冒烟全量→01 系统测试（同一断言面 smoke_all.gd，运行器换 tools/run_system_test.py，过渡期判定口径不变）、02 单元套件→02 单元与集成测试（同一 run_all.gd 入口，名从实）、新增 00 冒烟测试（tools/run_smoke.py＋game/tests/smoke_boot.tscn，重写后单跑实测 17 项 0 失败 PASS）；09 静态扫描基线 exit=1（fp=4354b2aa72a7）系滞后红，本批单跑实测 exit=0（与 2026-10-22 16:20 回执一致），基线改回绿；其余条目原样保留。；2026-10-23 主会话记 07 doc_link 为存量红（用户令忽略：锻造工坊.md 死链的修复在另一会话未合入，合回闸豁免；外部修复合入后应重生成基线归绿）；2026-10-26 用户特批带红合并（迭代 38 收口）：09 静态扫描记存量红——gdstyle 恶化 2 条（battle_orchestrator.gd max-file-length 1314>1302＝卡④头注必载内容、level_map_screen.gd max-class-variables 22>21＝卡①缓存成员，均为卡片义务的记账漂移非缺陷，压缩还债经计算不可行），用户裁「不管引入的恶化直接提交、特许免测试重跑」；后续批次若触及两文件可顺带还债或经批准重生成基线归绿；2026-10-27 用户裁「标准是尺、不以现状为尺」：09 存量红照实记（exit=1＋现行红项指纹，两条恶化各自点名可核），gdstyle 基线登记值回退 1302/21（波 0 的 18 条陈旧键清理保留），gdstyle_gate 逐条违规行加 FAIL 前缀并加「refresh 禁抬高登记值」守卫——存量红期间任何新增违规或进一步恶化都会改指纹被拦；阈值口径不变＝gdstyle 默认值（文件 1000 行／类变量 15 等），还债归迭代 40 卡①（battle_orchestrator 1314→≤1000）与迭代 41 卡③（level_map_screen 22→≤15），还清后重新生成基线归绿；2026-10-27 用户特批带红合并（迭代39 拆件批）：02 记存量红（fp f74b9a48ef4a＝round_flow EV 锚 goblin 0.9148∉[1.00,1.20]，触发器批有意行为改动，旧带宽锚触发器前设计，重锚归后续数值批待用户发起）；08d 记存量红（red-nokeys＝生涯.md:55 引 adventure_runner.gd:814 行号漂移，B1 拆分后 660 行，另 :50/:60 与 元进度.md:70 建议级，修复归合并后文档批，反哺点在册）；07 doc_link 基线红→现绿改善随下次基线重生成记账；09 指纹经 S9 注解修复（f96632de）回归登记值 91d45583cf6d；2026-10-28 迭代40 收口记账（用户裁「刷」）：卡① 拆件还债——battle_orchestrator 行数红项消失（实测 1036≤登记 1302；契约2 残余 36 行系合并适配带入 master 迭代39 内容，用户裁登记残余债归待办清单），09 红项由两条收敛为一条（level_map_screen 类变量 22＞21＝迭代38 存量，还债归迭代41 卡③），指纹 91d45583cf6d → 8467b4588a20（收口会话按闸壳同款算法对用户探跑日志实算，全量闸复验）；02 存量红已随 master 侧 EV 重锚批（ba5105aa）归绿并入本合并；2026-10-28 EV 锚重锚批（工程改动·worktree ev-anchor-remeasure-20261028，用户特许会话内执行）：02 基线红→现绿归绿——round_flow EV 锚 goblin 带宽按无情境口径（模拟器不过滤 trigger 行）重锚 [0.82,1.02]（迭代39触发器批孤注守势入池稀释，实测 0.9148，重锚注记 enemy.tres 与测试注释；旧带 [1.00,1.20] 随池构成换代作废），撤销证明＝带宽回退 [1.00,1.20] 断言复红；08d 存量红不变（生涯.md:55 行号漂移，修复归文档批）",
|
||||
"note": "存量基线·首次自动生成；闸况变化时本脚本会判红，需人工确认后重生成；2026-10-17 人工确认重生成 06 条目：af94ce97 把 gdd_lint 记为存量红（01 篇 R5），该红已由 fcb8c3f8 补流程图消除，实测 --docs 域 06 exit=0，故基线改回绿。2026-10-18 新增闸件 08c 流水线闸（tools/pipeline_gate.py 注册上电），手工加入绿记录（roadmap 压缩批实测 --docs 域 exit=0），其余条目原样保留。2026-10-22 测试术语与层级重构批 A 改键：01 冒烟全量→01 系统测试（同一断言面 smoke_all.gd，运行器换 tools/run_system_test.py，过渡期判定口径不变）、02 单元套件→02 单元与集成测试（同一 run_all.gd 入口，名从实）、新增 00 冒烟测试（tools/run_smoke.py＋game/tests/smoke_boot.tscn，重写后单跑实测 17 项 0 失败 PASS）；09 静态扫描基线 exit=1（fp=4354b2aa72a7）系滞后红，本批单跑实测 exit=0（与 2026-10-22 16:20 回执一致），基线改回绿；其余条目原样保留。；2026-10-23 主会话记 07 doc_link 为存量红（用户令忽略：锻造工坊.md 死链的修复在另一会话未合入，合回闸豁免；外部修复合入后应重生成基线归绿）；2026-10-26 用户特批带红合并（迭代 38 收口）：09 静态扫描记存量红——gdstyle 恶化 2 条（battle_orchestrator.gd max-file-length 1314>1302＝卡④头注必载内容、level_map_screen.gd max-class-variables 22>21＝卡①缓存成员，均为卡片义务的记账漂移非缺陷，压缩还债经计算不可行），用户裁「不管引入的恶化直接提交、特许免测试重跑」；后续批次若触及两文件可顺带还债或经批准重生成基线归绿；2026-10-27 用户裁「标准是尺、不以现状为尺」：09 存量红照实记（exit=1＋现行红项指纹，两条恶化各自点名可核），gdstyle 基线登记值回退 1302/21（波 0 的 18 条陈旧键清理保留），gdstyle_gate 逐条违规行加 FAIL 前缀并加「refresh 禁抬高登记值」守卫——存量红期间任何新增违规或进一步恶化都会改指纹被拦；阈值口径不变＝gdstyle 默认值（文件 1000 行／类变量 15 等），还债归迭代 40 卡①（battle_orchestrator 1314→≤1000）与迭代 41 卡③（level_map_screen 22→≤15），还清后重新生成基线归绿；2026-10-27 用户特批带红合并（迭代39 拆件批）：02 记存量红（fp f74b9a48ef4a＝round_flow EV 锚 goblin 0.9148∉[1.00,1.20]，触发器批有意行为改动，旧带宽锚触发器前设计，重锚归后续数值批待用户发起）；08d 记存量红（red-nokeys＝生涯.md:55 引 adventure_runner.gd:814 行号漂移，B1 拆分后 660 行，另 :50/:60 与 元进度.md:70 建议级，修复归合并后文档批，反哺点在册）；07 doc_link 基线红→现绿改善随下次基线重生成记账；09 指纹经 S9 注解修复（f96632de）回归登记值 91d45583cf6d；2026-10-28 迭代40 收口记账（用户裁「刷」）：卡① 拆件还债——battle_orchestrator 行数红项消失（实测 1036≤登记 1302；契约2 残余 36 行系合并适配带入 master 迭代39 内容，用户裁登记残余债归待办清单），09 红项由两条收敛为一条（level_map_screen 类变量 22＞21＝迭代38 存量，还债归迭代41 卡③），指纹 91d45583cf6d → 8467b4588a20（收口会话按闸壳同款算法对用户探跑日志实算，全量闸复验）；02 存量红已随 master 侧 EV 重锚批（ba5105aa）归绿并入本合并；2026-10-28 EV 锚重锚批（工程改动·worktree ev-anchor-remeasure-20261028，用户特许会话内执行）：02 基线红→现绿归绿——round_flow EV 锚 goblin 带宽按无情境口径（模拟器不过滤 trigger 行）重锚 [0.82,1.02]（迭代39触发器批孤注守势入池稀释，实测 0.9148，重锚注记 enemy.tres 与测试注释；旧带 [1.00,1.20] 随池构成换代作废），撤销证明＝带宽回退 [1.00,1.20] 断言复红；08d 存量红不变（生涯.md:55 行号漂移，修复归文档批）；2026-10-29 文档清理批（批 5）实测 --docs 域 07/08d 皆绿，两条目归绿；2026-10-29 能力审计闸上电（tools/capability_audit.py 注册文档域 08e，查 GDD 纯度＋能力清单与覆盖域表结构）：手工加入绿记录（批 5 纯度红项清零后孤立实测 exit=0），其余条目原样保留",
|
||||
"gates": {
|
||||
"00 冒烟测试": {
|
||||
"exit": "0",
|
||||
@@ -34,8 +34,8 @@
|
||||
"fp": "green"
|
||||
},
|
||||
"07 doc_link": {
|
||||
"exit": "1",
|
||||
"fp": "red-nokeys"
|
||||
"exit": "0",
|
||||
"fp": "green"
|
||||
},
|
||||
"08 doc_term": {
|
||||
"exit": "0",
|
||||
@@ -58,8 +58,12 @@
|
||||
"fp": "skip"
|
||||
},
|
||||
"08d 引用可核": {
|
||||
"exit": "1",
|
||||
"fp": "red-nokeys"
|
||||
"exit": "0",
|
||||
"fp": "green"
|
||||
},
|
||||
"08e 能力审计": {
|
||||
"exit": "0",
|
||||
"fp": "green"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -16,8 +16,8 @@
|
||||
# ——本批改动含 game/ 下非 .md 的行为载体（代码/测试脚本/探针/场景/数据表/素材）时用。
|
||||
# 影响面选闸：本批 game/ 改动全在测量面（game/tests、game/sim）时，00/03/04/05 记
|
||||
# SKIP（测量面不触开机路径/场景树/渲染输出；映射定义在脚本中部，判定保守）。
|
||||
# --docs 只跑文档域闸（06 gdd_lint／07 doc_link／08 doc_term／08c 流水线闸／08d 引用可核
|
||||
# ＋10 熵增闸）
|
||||
# --docs 只跑文档域闸（06 gdd_lint／07 doc_link／08 doc_term／08c 流水线闸／08d 引用可核／
|
||||
# 08e 能力审计＋10 熵增闸）
|
||||
# ——本批改动只有文档件时用：game/ 内的 .md（README、生成清单）、design/、根规则文件、
|
||||
# tools/ 工具脚本、.zcode/ 配置等一切非代码面改动。
|
||||
# --quick 全量档的中段自检形态：跳过渲染闸（窗口化，需开显示器）与静态扫描；完成出库禁用。
|
||||
@@ -255,6 +255,8 @@ gate "08 doc_term" "doc_term.log" "$PY" "$REPO/tools/doc_term_audit.py" --strict
|
||||
gate "08c 流水线闸" "pipeline.log" "$PY" "$REPO/tools/pipeline_gate.py"
|
||||
# ── 8d. 引用可核（现行文档里「文件:行号」指针的目标存在性与行界，判据=件头注）──
|
||||
gate "08d 引用可核" "doc_ref.log" "$PY" "$REPO/tools/doc_ref_audit.py" --strict
|
||||
# ── 8e. 能力审计（GDD 纯度＋能力清单与覆盖域表结构，判据=test-conventions §8.9＋doc-conventions §5）──
|
||||
gate "08e 能力审计" "capability.log" "$PY" "$REPO/tools/capability_audit.py" --strict
|
||||
fi
|
||||
# ── 6c. 回放确定性对拍（条件闸件；属代码域）──
|
||||
if in_domain code; then
|
||||
|
||||
Reference in new issue
Block a user