From fdaa10cb1c3e0081c963783599b9c6a22d7bcf97 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Tue, 20 Oct 2026 00:10:43 +0800 Subject: [PATCH] =?UTF-8?q?docs(rules):=20=E6=89=B9=E5=90=8E=E6=94=B6?= =?UTF-8?q?=E5=B0=BE=E6=8A=80=E8=83=BD=20batch-closure=20=E8=90=BD?= =?UTF-8?q?=E5=9C=B0=E6=8C=87=E8=AE=A4=E2=80=94=E2=80=94AGENTS.md=20?= =?UTF-8?q?=E6=8A=80=E8=83=BD=E5=AF=B9=E7=85=A7=E5=8A=A0=E7=AC=AC=E5=85=AD?= =?UTF-8?q?=E5=85=A5=E5=8F=A3=EF=BC=8Bprocess-conventions=2012/13=20?= =?UTF-8?q?=E6=8E=A5=E4=B8=8A=E6=82=AC=E7=A9=BA=E7=9A=84=E3=80=8C=E5=BD=92?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E6=89=B9=E5=81=9A=E3=80=8D=EF=BC=8Bdoc-conve?= =?UTF-8?q?ntions=20=C2=A711=20=E5=88=A0=E9=99=A4=E6=96=B9=E5=BC=8F?= =?UTF-8?q?=E4=B8=8E=20reports/README=20=E7=94=9F=E5=91=BD=E5=91=A8?= =?UTF-8?q?=E6=9C=9F=E5=90=84=E8=A1=A5=E6=89=A7=E8=A1=8C=E5=85=A5=E5=8F=A3?= =?UTF-8?q?=EF=BC=9B=E6=8A=80=E8=83=BD=E6=96=87=E4=BB=B6=E6=9C=AC=E8=BA=AB?= =?UTF-8?q?=E5=9C=A8=20.zcode/skills/=EF=BC=88=E4=B8=8D=E5=85=A5=20git?= =?UTF-8?q?=EF=BC=89=EF=BC=8C=E5=8F=8D=E5=93=BA=E8=90=BD=E6=96=87=E4=BB=8D?= =?UTF-8?q?=E5=BD=92=20doc-design=EF=BC=8C=E6=9C=AC=E6=8A=80=E8=83=BD?= =?UTF-8?q?=E5=8F=AA=E5=81=9A=E9=80=80=E5=BD=B9=E7=BC=96=E6=8E=92?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 2 +- design/dev/doc-conventions.md | 2 +- design/dev/process-conventions.md | 4 ++-- reports/README.md | 3 ++- 4 files changed, 6 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index e06a059c..a74b6c9a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -40,7 +40,7 @@ | 时机 | 权威文档 | |---|---| | 批次开工 / 流程纪律 | `design/dev/process-conventions.md`——worktree 铁律、五段流水线、批次清单、测试两入口与 MC/闸机细则、像素纪律 | -| 流水线段入口 | 技能对照——doc-design=文档设计／asset-ingest=美术录入／req-card=写卡／iter-plan=迭代编排／iter=实现（五者均装于项目 `.zcode/skills/`）；登记不立技能；格式与状态机权威=`design/dev/doc-conventions.md` §12 | +| 流水线段入口 | 技能对照——doc-design=文档设计（兼任反哺点落文）／asset-ingest=美术录入／req-card=写卡／iter-plan=迭代编排／iter=实现（五者均装于项目 `.zcode/skills/`）；登记不立技能；批后收尾与中间文档退役=batch-closure（同一目录）；格式与状态机权威=`design/dev/doc-conventions.md` §12 | | 写代码 / 改代码前 | `design/dev/code-conventions.md`——结构/契约/语言/数值/流程五类硬纪律（反例库 = 同目录 code-conventions-cases.md） | | 写测试 / 改测试前 | `design/dev/test-conventions.md`——探针标配 / 回归断言 / 全量验证 / 验收清单落码 / 变异验证 | | 写文档 / 改文档前 | `design/dev/doc-conventions.md`——白话写作 / 载体分工 / 用语 / 结构骨架 / 会话记录与生命周期 | diff --git a/design/dev/doc-conventions.md b/design/dev/doc-conventions.md index 6701df0d..b0072705 100644 --- a/design/dev/doc-conventions.md +++ b/design/dev/doc-conventions.md @@ -121,7 +121,7 @@ | 迭代实现报告 | 实现批收口的迭代级报告（各卡状态/代拍板追认单/GDD 反哺点清单），属中间文档，**落 `reports/` 不落 `design/`**（2026-10-17 用户裁：实现批禁写 `design/`，`reports/` 是其唯一可写目录）：反哺点裁决落文吸收后按「证据只留最新」退役 | | 证据只留最新 | 测试证据只保留最新一次迭代或最新一轮同类审计版本；新证据落位后同批删上一份；待人清单过人闸后同规退役 | -**删除方式**：按 `design/dev/concept-conventions.md` 第 2 节删除概念 SOP 口径——先查引用面（grep 文件名于阻塞域），改写或删除指路句，再删文件，收尾跑死链检查全绿。 +**删除方式**：按 `design/dev/concept-conventions.md` 第 2 节删除概念 SOP 口径——先查引用面（grep 文件名于阻塞域），改写或删除指路句，再删文件，收尾跑死链检查全绿。执行入口=项目技能 batch-closure（批后收尾与中间文档退役）。 ## 12. 流程文档格式 diff --git a/design/dev/process-conventions.md b/design/dev/process-conventions.md index 5646a2d1..c8659157 100644 --- a/design/dev/process-conventions.md +++ b/design/dev/process-conventions.md @@ -52,8 +52,8 @@ **完成** 10. **批末按域验收才合并**——在任务 worktree 内跑 `tools/run_all_gates.sh`，**按本批改动域选档**：本批改动触及 `game/`（游戏工程代码、测试、探针、场景）→ `--code`；不触及 `game/` 的一切改动（`design/`、根规则文件、`tools/` 工具脚本、`.zcode/` 配置等）→ `--docs`；同批混触 `game/` 与文档面 → 全量档不带参数。所选域全绿才合回 master。该脚本是全部验证闸的**唯一入口、唯一清单与唯一域划分**，闸件增减、分域调整都只改它；**本文与其他文档禁另列闸件清单**（清单散落多处正是 iter27 漏跑 `probe_gate --full` 的成因）。跑完写回执 `game/tests/.gates/receipt.json`（含 `domain` 字段），合回时由 worktree-guard 按 diff 路径推域强制校验。闸件（`tools/` 下机检脚本与闸壳）自身的改动不占合回全量——其质量义务＝落批时的变异验证（test-conventions §6），闸真崩溃时合回闸 fail-closed（跑不出回执即拦），不以合回全量为兜底 11. **合并后主区按域复跑**——合并可能引入冲突或环境差异，落回 master 后按本批改动域复跑：触及 `game/` 的批＝全量复跑（维持）；纯文档域批＝复跑文档域档（秒级），不再全量 -12. **批次完成后的登记义务**——合回 master 后按 doc-conventions §12.1 推进 06 条目状态（做完整条删除），涉及迭代编排的在 roadmap 迭代总表与顶部「当前位」节换代，跨会话教训写记忆库。批次过程与结论由 git 提交信息承载，禁止再写会话状态文件（2026-10-18 用户裁，见 doc-conventions 第 10 节）。`design/` 与根规则文件（`AGENTS.md`/`roadmap.md`）实现批禁写，见 §13 -13. **文档同步闸（2026-10-17 改口径：实现批禁写文档）**——实现批**禁写 `design/` 整个目录与根规则文件**，要往外交代的东西一律落 `reports/`：实现报告 `reports/iter-实现报告-<日期>.md`（各卡状态+实机目检总清单+遗留读数义务）、代拍板追认单 `reports/iter-代拍板-<日期>.md`、GDD 反哺点清单 `reports/iter-反哺点-<日期>.md`（每条写清哪个文件哪一节、改成什么、依据是什么）。设计权威文档（GDD/art-bible）**任何批都不直改**：用户在会话中逐点裁决后，由非迭代批（工具/规则/文档批）写入 `design/`，并把反哺条目从 `reports/` 清掉（吸收即死）。机械面文档（roadmap 行/术语表/README 工具注）同样归非迭代批在合并前更新。反哺点未落地期间相关 GDD 节视为待反哺，读前先查 `reports/` 与 06；需求卡片必列「关联文档同步面」按两层标注 +12. **批次完成后的登记义务**——合回 master 后按 doc-conventions §12.1 推进 06 条目状态（做完整条删除），涉及迭代编排的在 roadmap 迭代总表与顶部「当前位」节换代——执行入口=项目技能 batch-closure（批后收尾与中间文档退役），跨会话教训写记忆库。批次过程与结论由 git 提交信息承载，禁止再写会话状态文件（2026-10-18 用户裁，见 doc-conventions 第 10 节）。`design/` 与根规则文件（`AGENTS.md`/`roadmap.md`）实现批禁写，见 §13 +13. **文档同步闸（2026-10-17 改口径：实现批禁写文档）**——实现批**禁写 `design/` 整个目录与根规则文件**，要往外交代的东西一律落 `reports/`：实现报告 `reports/iter-实现报告-<日期>.md`（各卡状态+实机目检总清单+遗留读数义务）、代拍板追认单 `reports/iter-代拍板-<日期>.md`、GDD 反哺点清单 `reports/iter-反哺点-<日期>.md`（每条写清哪个文件哪一节、改成什么、依据是什么）。设计权威文档（GDD/art-bible）**任何批都不直改**：用户在会话中逐点裁决后，由非迭代批（工具/规则/文档批）写入 `design/`（执行入口=doc-design 技能），并把反哺条目从 `reports/` 清掉（吸收即死；退役执行=batch-closure 技能）。机械面文档（roadmap 行/术语表/README 工具注）同样归非迭代批在合并前更新。反哺点未落地期间相关 GDD 节视为待反哺，读前先查 `reports/` 与 06；需求卡片必列「关联文档同步面」按两层标注 14. **实机目检归用户，只登记不阻塞**——真人检测项登记进实现报告目检总清单与 07-体验验证清单即完成批内义务；禁把等目检当停工理由或完成前置 15. **中间产物吸收即死**——细则见 AGENTS.md 硬性红线与 doc-conventions 第 11 节 diff --git a/reports/README.md b/reports/README.md index 8689c62d..43757fe9 100644 --- a/reports/README.md +++ b/reports/README.md @@ -21,4 +21,5 @@ ## 生命周期 一个迭代号一组文件，落档即死：反哺点被 `design/` 吸收后，对应文件删除，历史进 git commit log -（与"历史决策记录只进 git log、不设决策文档"这条红线同口径）。 +（与"历史决策记录只进 git log、不设决策文档"这条红线同口径）。退役执行=batch-closure 技能 +（批后收尾与中间文档退役），删前先过 doc-conventions §11 判据。