From 09042f92faa6ed2d2f8ff38a38488b7a42efa920 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sat, 7 Nov 2026 20:56:22 +0800 Subject: [PATCH] =?UTF-8?q?=E9=A2=84=E6=A3=80=E7=8E=AF=E8=8A=82=E8=90=BD?= =?UTF-8?q?=E5=9C=B0:=20process-conventions=20=C2=A72=20=E6=AE=B5=E5=9B=9B?= =?UTF-8?q?=E8=A1=A5=E5=BC=80=E5=B7=A5=E5=89=8D=E9=A2=84=E6=A3=80=E4=B9=89?= =?UTF-8?q?=E5=8A=A1=E5=8F=A5(2026-11-07=20=E7=94=A8=E6=88=B7=E7=AB=8B)?= =?UTF-8?q?=E2=80=94=E2=80=94=E6=94=B6=E4=BB=A4=E7=82=B9=E5=90=8D=E5=90=8E?= =?UTF-8?q?=E4=BA=94=E6=9F=A5=E8=90=BD=E8=A1=A8=E5=89=8D=E5=AF=B9=E6=8B=9F?= =?UTF-8?q?=E7=BC=96=E5=8D=A1=E9=9B=86=E5=8F=AA=E8=AF=BB=E4=BA=8B=E5=AE=9E?= =?UTF-8?q?=E9=9D=A2=E9=A2=84=E6=A3=80,=20=E5=85=AB=E7=B1=BB=E6=A3=80?= =?UTF-8?q?=E6=9F=A5+P1/P2/P3=E5=88=86=E7=BA=A7+=E5=8F=AA=E8=AF=BB?= =?UTF-8?q?=E5=AD=90=E4=BB=A3=E7=90=86=E6=89=A7=E8=A1=8C=E7=BB=86=E5=88=99?= =?UTF-8?q?=E5=8D=95=E7=82=B9=3Diter-plan=20=E6=8A=80=E8=83=BD=E3=80=8C?= =?UTF-8?q?=E7=AC=AC3=E6=AD=A5=C2=B7=E5=BC=80=E5=B7=A5=E5=89=8D=E9=A2=84?= =?UTF-8?q?=E6=A3=80=E3=80=8D,=20P1=E7=BA=A2=E9=A1=B9=E5=81=9C=E7=BC=96?= =?UTF-8?q?=E6=8E=92=E9=80=80=E5=86=99=E5=8D=A1=E6=AE=B5=E7=A6=81=E7=BC=96?= =?UTF-8?q?=E5=85=A5;=20=E7=9B=AE=E6=A0=87=3D=E5=87=8F=E5=B0=91=E5=AE=9E?= =?UTF-8?q?=E7=8E=B0=E6=9C=9F=E5=81=9C=E5=B7=A5=E9=9D=9E=E6=9D=9C=E7=BB=9D?= =?UTF-8?q?(=E7=8E=AF=E5=A2=83=E6=BC=82=E7=A7=BB+=E5=8D=A1=E7=89=87?= =?UTF-8?q?=E5=B9=B6=E8=A1=8C=E4=BF=AE=E6=94=B9=E7=94=B1=E5=AE=9E=E7=8E=B0?= =?UTF-8?q?=E6=AE=B5=E5=BC=82=E5=B8=B8=E5=88=86=E7=BA=A7=E4=B8=8Eiter=20T0?= =?UTF-8?q?=E7=AA=84=E5=A4=8D=E6=A0=B8=E5=85=9C=E5=BA=95)=E3=80=82?= =?UTF-8?q?=E9=85=8D=E5=A5=97:=20iter-plan=20=E6=8A=80=E8=83=BD=E6=96=B0?= =?UTF-8?q?=E7=AB=8B=E7=AC=AC3=E6=AD=A5(=E5=8E=9F3-6=E6=AD=A5=E9=A1=BA?= =?UTF-8?q?=E5=BB=B64-7,=20=E4=B8=BB=E5=8C=BA=E8=B1=81=E5=85=8D=E9=9D=A2?= =?UTF-8?q?=E7=9B=B4=E6=94=B9=E4=B8=8D=E5=85=A5git)+req-card=20=E5=A4=8D?= =?UTF-8?q?=E6=A0=B8=E9=97=A8=E8=A1=A5=E5=88=A4=E6=8D=AE=E5=87=BA=E5=A4=84?= =?UTF-8?q?=E8=A1=8C=E9=94=9A=E9=80=90=E8=A1=8C=E5=AE=9E=E8=AF=BB(?= =?UTF-8?q?=E4=B8=BB=E5=8C=BA=E8=B1=81=E5=85=8D=E9=9D=A2=E7=9B=B4=E6=94=B9?= =?UTF-8?q?)=E3=80=82=E8=AF=BB=E6=95=B0:=20--docs=E3=80=90=E9=AA=8C?= =?UTF-8?q?=E6=94=B6=E9=80=9A=E8=BF=87=E3=80=91=E6=97=A0=E6=96=B0=E5=A2=9E?= =?UTF-8?q?=E7=BA=A2(gdd=5Flint/doc=5Flink/doc=5Fterm/=E6=B5=81=E6=B0=B4?= =?UTF-8?q?=E7=BA=BF=E9=97=B8/=E5=BC=95=E7=94=A8=E5=8F=AF=E6=A0=B8/?= =?UTF-8?q?=E8=83=BD=E5=8A=9B=E5=AE=A1=E8=AE=A1/=E7=86=B5=E5=A2=9E?= =?UTF-8?q?=E9=97=B8,=20=E5=9B=9E=E6=89=A7receipt.json,=20commit=207d4d97e?= =?UTF-8?q?e)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/engineering/process-conventions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/design/engineering/process-conventions.md b/design/engineering/process-conventions.md index 63e07139..7404aed4 100644 --- a/design/engineering/process-conventions.md +++ b/design/engineering/process-conventions.md @@ -24,7 +24,7 @@ | 一·登记 | 无（闸管格式） | 待办清单条目 | 条目=标题登记元数据（日期/来源/可选优先级）＋正文四属性（实况/缺口/改动面/状态）；标题登记后不再变，正文随进程演进。格式与状态机权威=doc-conventions 第 12 节 | | 二·文档设计／美术设计 | doc-design（文档线，兼任反哺点写入）／asset-ingest（美术录入；样张素材由用户主导产出） | GDD 文档或 art-bible／过审样张素材；画面类需求另出预览图（文档线，2026-11-05 用户裁） | 用户提起或从待办清单取出；会话内进行、用户主导、禁无监管自跑；经用户点头确认心智一致才许写入文档；完成判据=待裁点清零，带未裁点的是讨论稿；设计线闭合凭据记入待办清单实况清单（文档线=文档路径+版本号，美术线=art-bible 条款版本）；缺哪条线写在缺口属性，闭合与否写在状态段。画面类需求（新增画面要素／布局／配色／动效等触碰画面呈现规格的改动）设计段先出预览图＝目标画面的 HTML/SVG 效果图（diagram-design 通道，AGENTS.md 图优先的同款载体），经用户人审通过才许进写卡段；预览图内嵌对应 ux/ 规格文档并随附像素级视觉判据句（§7 第 2 条同款写法）；缺陷修复以现行规格与在库基线为准，不触发新预览 | | 三·写需求卡片 | req-card | 需求卡片 | 设计线闭合后用户发令；新玩法/新系统/新内容必须有设计定稿前置，例外=需求性工程条目（缺陷修复／重构等改游戏行为）凭实况里的证据指认跳过设计线；配套维护类（工程债/测试基建/工具维护，不动游戏行为）＝工程改动直改类，不走本段，由用户发令直改；卡片必经 grilling 多轮复核、零待裁点才成立；复核发现按四类去向处置（2026-11-05 用户立规，定义在 req-card 技能「复核发现四类分流」：自判＝查权威文档或查代码现状有唯一答案，复核者自己下结论改卡；补写＝卡里漏写，回炉补全；待裁＝几种做法都不违规且代价不同、影响玩法取向，才交用户；退回上游＝文档设计线未闭合、美术设计线未闭合、或架构与代码规范本身冲突，停笔退对应段）；成立凭据＝卡内「复核记录」节（2026-11-06 用户裁：不另设复核报告文件），顺序未走完禁对用户称完成、禁落 commit（同 §1 第 2 条卡片复核前置判据）；写完在待办清单状态记「已写卡」，卡片路径记入实况清单（防遗忘）；画面类需求卡片必引设计段已人审的预览图（验收判据的判据出处行锚指向 ux/ 内嵌预览节，test-conventions §8.3 锚口径不变） | -| 四·迭代编排 | iter-plan | roadmap 迭代行 | 编排五查：①每卡卡片文件存在 ②每卡设计闭合凭据齐（或需求性工程条目的证据指认）③估时与冻结线——所选卡估时按区间**中值**求和（单位工作日、写精确值不取整）：**卡片任何工作量均可编入**（2026-10-25 用户立：工作量限制属迭代层、非卡片层）；编入后迭代总量 <5 个工作日＝迭代行状态「冻结待凑批」、不可开工，凑批 ≥5 后由编排段改「待开工」（迭代体量偏好，2026-10-21 用户立、2026-10-25 改冻结制）；5–10 个工作日为常规区间；超过 10 个工作日须经用户确认（确认前呈报整批/拆批两案等裁，禁自行拆分或塞入），确认后迭代行随带日期特批标记；超过 20 个工作日禁止编（硬上限，用户确认也不放行，必须拆批）④每卡复核记录在位（2026-11-05 用户立规；2026-11-06 用户裁凭据换代——复核凭据＝「复核记录」节自身，不另查报告文件）——卡内有「复核记录」节；缺节或节内任一条发现没有去向标记则呈报退回写卡段，禁编入，本段不代跑复核也不代补记录（生效＝卡片文件名日期 ≥2026-11-06，旧卡不回头改）⑤写完 roadmap 行后跑流水线闸确认绿；编入未完成迭代，新开迭代行经用户确认 | +| 四·迭代编排 | iter-plan | roadmap 迭代行 | **开工前预检（2026-11-07 用户立）**：收令点名拟编卡集后、五查与落表前，对卡集做一轮只读事实面预检——八类检查、P1/P2/P3 分级去向与只读子代理执行方式＝iter-plan 技能「第 3 步·开工前预检」；P1 红项停编排、退回写卡段，禁编入。预检目标＝尽量减少实现期停工、非杜绝——环境漂移与卡片并行修改仍可在实现期停工，由实现段异常分级与 iter T0 开工日窄复核兜底。编排五查：①每卡卡片文件存在 ②每卡设计闭合凭据齐（或需求性工程条目的证据指认）③估时与冻结线——所选卡估时按区间**中值**求和（单位工作日、写精确值不取整）：**卡片任何工作量均可编入**（2026-10-25 用户立：工作量限制属迭代层、非卡片层）；编入后迭代总量 <5 个工作日＝迭代行状态「冻结待凑批」、不可开工，凑批 ≥5 后由编排段改「待开工」（迭代体量偏好，2026-10-21 用户立、2026-10-25 改冻结制）；5–10 个工作日为常规区间；超过 10 个工作日须经用户确认（确认前呈报整批/拆批两案等裁，禁自行拆分或塞入），确认后迭代行随带日期特批标记；超过 20 个工作日禁止编（硬上限，用户确认也不放行，必须拆批）④每卡复核记录在位（2026-11-05 用户立规；2026-11-06 用户裁凭据换代——复核凭据＝「复核记录」节自身，不另查报告文件）——卡内有「复核记录」节；缺节或节内任一条发现没有去向标记则呈报退回写卡段，禁编入，本段不代跑复核也不代补记录（生效＝卡片文件名日期 ≥2026-11-06，旧卡不回头改）⑤写完 roadmap 行后跑流水线闸确认绿；编入未完成迭代，新开迭代行经用户确认 | | 五·实现 | iter | 代码与配置，可运行的游戏 | 需求卡片永不单独施工，统一由用户指定迭代号触发（=U0 开工令），按 iter 技能与本文 §3 执行；**本段是代码实现批：禁写 `design/` 与根规则文件，产出物只落 `reports/`（见 §3 第 12 条）**；设计权威文档（GDD/art-bible）批内一律不更新；完成人闸=实机目检清单+实现决定记录写齐即完成批内义务；画面类需求实现批另按 test-conventions §8.2 黄金图基线冻结口径执行（实跑截图入基线前用户对照预览图确认一眼，此后渲染闸自动盯） | **实现段零裁断**：实现段的输入在编排段出口已锁死（卡片零待裁点＋设计闭合凭据齐＋编排五查过）。实现中冒出卡片没写清的分歧=上游缺陷——停该卡、待办清单状态回退＋缺口补记，退回上游；禁自答、禁内联提问求裁断；该卡停摆不阻塞同迭代其他卡。环境故障与测试红走异常分级（自救重试／记录继续／停机呈报）。代拍板白名单保留：授权发生在卡片审问阶段，实现只执行预授权；超白名单／超卡片明列范围事项记入实现报告「实现决定记录」节备案，不另立追认单。