docs(规则修订): 改动四类+卡片/迭代两层模型落规约(2026-10-25 用户裁定 12 项全执行)——AGENTS「两类批」改「改动四类」(需求改动=唯一走写卡+迭代;工程/文档设计/美术素材=无卡无迭代直改)+五段铁律限定需求改动并补两层口径;process-conventions §2 首句改造+两层口径+工程直入拆分+「低于5不得编」改「任何卡可编入、<5=冻结待凑批」;doc-conventions §12 状态机补待执行与直改类序列、通道表拆需求性/工程性、§12.2 补冻结待凑批与周期新规;test-conventions 头注补测试归属句;术语表术语替换;pipeline_gate 状态词表/状态五形态/周期校验同步(<5 未处冻结态才红);三张违形卡(S9/S13/节点图换代收尾批)删除、结论回写条目、五条目状态改待执行;退役词四处顺带换代。全量域闸绿(回执 full 档,07 doc_link 较基线改善);子代理审计过(四小修已落)。.zcode/.qoder 六技能(iter/iter-plan/req-card/batch-closure/doc-design/asset-ingest)同批换代,不入 git

This commit is contained in:
DKChan committed 2026-10-25 06:57:29 +08:00
1 parent e20eb90d56
commit 9fdacdebeb
10 files changed
+39 -547

No files matched your search

+7 -5
View File
@@ -56,7 +56,7 @@
**通行检验标准**:读者是业内人但没读过项目历史——需要作者解释才懂的词不合格,必须展开成完整白话句(换新名词不算改,展开才算改)。**写后自查**:凡自己都要停顿才能想起意思的词,一律展开。
**词表冻结**:doc_term_audit 与术语表「用语规范」节的禁用词表不再扩充;扩表唯一入口=用户实读反馈并经用户裁决,由非迭代批写入,禁 agent 自行增词。
**词表冻结**:doc_term_audit 与术语表「用语规范」节的禁用词表不再扩充;扩表唯一入口=用户实读反馈并经用户裁决,由工程/文档设计改动批写入,禁 agent 自行增词。
## 5. 结构纪律
@@ -158,6 +158,7 @@
美术轨:待美术设计 → 美术设计中 → 美术设计已闭合
进入下游段(待写卡及之后)的前置条件——双轨:两个设计轨闭合段都在场;单轨:本轨闭合段在场
下游共用序列:待写卡 → 已写卡 → 已编迭代 N → 完成即整条删除
直改类(工程/文档设计/美术素材改动):登记 → 待执行 → 完成即整条删除(经设计讨论的可前置闭合段,如「文档设计已闭合+待执行」)
单轨累积示例(已编迭代):文档设计已闭合+待美术设计+已写卡+已编迭代 2
```
@@ -167,7 +168,8 @@
| 设计面 | 通道规则 |
|---|---|
| 工程直入 | 缺陷修复/工程债/测试基建/重构四类工程条目:登记即「待写卡」,凭现状里指认的证据跳过设计轨 |
| 工程直入(需求性) | 缺陷修复/重构等改游戏行为的条目=需求改动:登记即「待写卡」,凭现状里指认的证据跳过设计轨 |
| 工程直入(工程性) | 工程债/测试基建/工具维护等不动游戏行为的配套条目=工程改动:登记即「待执行」,用户发令直改,不走写卡 |
| 反哺点专条 | 待裁决 → 已写入 → 删除 |
| 备选库条目 | 暂不排期、留在备选库的条目:状态词后缀「(备选)」 |
@@ -175,7 +177,7 @@
### 12.2 roadmap 迭代行格式
roadmap 由顶部里程碑表+迭代总表组成,迭代总表一行一个迭代,回答一个问题:这个迭代编入了哪些卡、做到哪一步。迭代行六列:
roadmap 由顶部里程碑表+迭代总表组成,迭代总表一行一个迭代,回答一个问题:这个迭代编入了哪些卡、做到哪一步。两层口径(2026-10-25 用户立):需求卡片=需求单位的实施文档,任何工作量皆可写、皆可编入迭代;工作量限制只属迭代层——迭代估时总量 <5 个工作日=冻结不可开工。迭代行六列:
```
| 迭代号 | 状态 | 需求卡片 | 编入时间 | 预计周期 | 实现报告 |
@@ -184,10 +186,10 @@ roadmap 由顶部里程碑表+迭代总表组成,迭代总表一行一个迭
| 列 | 规则 |
|---|---|
| 迭代号 | 写「迭代 N」形态(N 为阿拉伯数字);这是流水线闸交叉核匹配的依据 |
| 状态 | 待开工 / 进行中 / 已完成(YYYY-MM-DD)/ 已终止(YYYY-MM-DD) |
| 状态 | 待开工 / 冻结待凑批 / 进行中 / 已完成(YYYY-MM-DD)/ 已终止(YYYY-MM-DD) |
| 需求卡片 | 只写文件路径;一格内一行一卡,格内排列顺序=执行顺序;已退役填保留字「已退役(git 历史可考)」;历史迭代不可考填「—」(早期无卡片制的迭代) |
| 编入时间 | YYYY-MM-DD(该迭代最近一次编入卡片的日期);历史迭代不可考填「—」 |
| 预计周期 | 所选卡估时区间**中值**求和,单位工作日,写精确值不取整,形态「≈N 个工作日」(1 周=5 个工作日);5–10 为常规区间;超过 10 须随带日期的用户特批标记(格式见 12.4),流水线闸见标记放行、无标记判红;低于 5 或超过 20 均判红(硬下限/硬上限,2026-10-21 用户裁定:特批标记也不放行);历史迭代不可考填「—」 |
| 预计周期 | 所选卡估时区间**中值**求和,单位工作日,写精确值不取整,形态「≈N 个工作日」(1 周=5 个工作日);5–10 为常规区间;超过 10 须随带日期的用户特批标记(格式见 12.4),流水线闸见标记放行、无标记判红;低于 5 的迭代行状态必须为「冻结待凑批」(2026-10-25 两层模型:小卡可编入,迭代总量不足即冻结、禁止处待开工/进行中);超过 20 判红(硬上限,特批标记也不放行);历史迭代不可考填「—」 |
| 实现报告 | `reports/iterN-实现报告-YYYY-MM-DD.md`;未完成=「—」;退役=「已退役(git 历史可考)」;已完成迭代只许存在路径或退役保留字、禁「—」 |
迭代行禁入内容:事项说明、卡序叙述、T 段明细、读数、闸数字、裁点记录、门依赖。卡间依赖写在卡片自身,行内只放上表六列的事实。特批标记同样可用于 roadmap 格(须带日期,见 12.4)。