From defe4454a6d76f7952b2fc35099f7be91d33004a Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 18 Oct 2026 17:05:17 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E6=8A=80=E8=83=BD):=20=E6=8A=80=E8=83=BD?= =?UTF-8?q?=E5=AE=89=E6=94=BE=E4=BD=8D=E7=BD=AE=E6=8D=A2=E4=BB=A3=E2=80=94?= =?UTF-8?q?=E2=80=94doc-design/asset-ingest/iter-plan=20=E4=B8=89=E6=8A=80?= =?UTF-8?q?=E8=83=BD=E8=87=AA=E7=94=A8=E6=88=B7=E7=BA=A7=E6=8C=AA=E5=9B=9E?= =?UTF-8?q?=E9=A1=B9=E7=9B=AE=20.zcode/skills/=EF=BC=882026-10-18=20?= =?UTF-8?q?=E7=94=A8=E6=88=B7=E8=A3=81=E5=AE=9A=EF=BC=9A=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E4=B8=93=E7=94=A8=E4=B8=8D=E7=95=99=E7=94=A8=E6=88=B7=E7=BA=A7?= =?UTF-8?q?=EF=BC=89=EF=BC=8CCLAUDE.md=20=E5=AF=BC=E8=88=AA=E8=A1=8C?= =?UTF-8?q?=E4=B8=8E=20process-conventions=20=C2=A72=20=E6=8E=AA=E8=BE=9E?= =?UTF-8?q?=E5=90=8C=E6=AD=A5=EF=BC=88req-card/iter=20=E7=B3=BB=202026-10-?= =?UTF-8?q?08/11=20=E6=97=A2=E6=9C=89=E7=94=A8=E6=88=B7=E7=BA=A7=E6=8A=80?= =?UTF-8?q?=E8=83=BD=E3=80=81=E7=BB=B4=E6=8C=81=E5=8E=9F=E4=BD=8D=EF=BC=89?= =?UTF-8?q?=EF=BC=8C=E8=A7=84=E7=BA=A6=E6=8E=AA=E8=BE=9E=E4=B8=A4=E5=A4=84?= =?UTF-8?q?=E5=8E=BB=E7=94=A8=E6=88=B7=E7=BA=A7=E9=99=90=E5=AE=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 4 ++-- design/dev/process-conventions.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 227da653..3ea69bfa 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -41,7 +41,7 @@ | 时机 | 权威文档 | |---|---| | 批次开工 / 流程纪律 | `design/dev/process-conventions.md`——worktree 铁律、五段流水线、批次清单、测试两入口与 MC/闸机细则、像素纪律 | -| 流水线段入口 | 用户级技能对照——doc-design=文档设计／asset-ingest=美术录入／req-card=写卡／iter-plan=迭代编排／iter=实现（登记不立技能）；格式与状态机权威=`design/dev/doc-conventions.md` §12 | +| 流水线段入口 | 技能对照——doc-design=文档设计／asset-ingest=美术录入／iter-plan=迭代编排（三者装于项目 `.zcode/skills/`）／req-card=写卡／iter=实现（此二者用户级 `~/.zcode/skills/`）；登记不立技能；格式与状态机权威=`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`——白话写作 / 载体分工 / 用语 / 结构骨架 / 会话记录与生命周期 | @@ -57,7 +57,7 @@ - **仓库根禁止设会话状态文件**（2026-10-18 用户裁废除 `active.md`）——现状看 roadmap「当前位」，待办看 06，过程看 git 提交信息，产出物看 `reports/`；任何文档禁止另设「当前状态快照」节，两处记同一件事必然漂移（细则见 doc-conventions 第 10 节） - 测试执行两入口铁规——只有迭代 loop 开发与用户点名两个触发入口；其余会话零测试，需测试支撑先请示并注明未跑测 - 交付前验收 = 跑 `tools/run_all_gates.sh` **按改动域**全绿（唯一入口、唯一闸清单、唯一域划分，禁在文档另列）；合回 master 由 worktree-guard 按 diff 推域校验回执强制（process-conventions §3） -- **两类批**——**迭代批**（代码实现，`/iter` 发射）：**禁写 `design/` 整个目录**（含新增/修改/删除），设计文档对它只读、是写测试与实现代码的输入依据；产出物只准写 `reports/`；批末只跑代码域闸。**非迭代批**（工具/规则/文档改动）：不占 roadmap 迭代号，按改动域跑闸。文档内容的落地走五段流水线相应段（文档设计段入口=用户级技能 doc-design；登记条目格式由流水线闸强制） +- **两类批**——**迭代批**（代码实现，`/iter` 发射）：**禁写 `design/` 整个目录**（含新增/修改/删除），设计文档对它只读、是写测试与实现代码的输入依据；产出物只准写 `reports/`；批末只跑代码域闸。**非迭代批**（工具/规则/文档改动）：不占 roadmap 迭代号，按改动域跑闸。文档内容的落地走五段流水线相应段（文档设计段入口=doc-design 技能；登记条目格式由流水线闸强制） - 五段流水线铁律——一切工作按「登记 → 文档设计／美术设计 → 写需求卡片 → 迭代编排 → 实现」推进，段间不自动流转、每段转进由用户发令；编入迭代的卡片必须设计闭合＋零待裁点，流水线闸 `tools/pipeline_gate.py` 强制（工具并行开发中，注册进 run_all_gates.sh 文档域归第二批）；实现段零裁断——卡片没写清=上游缺陷，停该卡退回上游，禁内联求裁（process-conventions §2，格式与状态机=doc-conventions §12） - MC/模拟：无数值改动零跑；档位硬闸见 `sim-data/README.md`「MC 采集档位表」，一档只能由用户发起 - 闸机轮次纪律：新码先孤立验证 → 出红只跑红件最小单元 → 长批先最小参数试车 → 开工扫坑册（process-conventions §6） diff --git a/design/dev/process-conventions.md b/design/dev/process-conventions.md index ee3cee98..62241bb8 100644 --- a/design/dev/process-conventions.md +++ b/design/dev/process-conventions.md @@ -16,7 +16,7 @@ ## 2. 五段流水线 -一切要做的东西按五段流水线走：**登记 → 文档设计／美术设计（双轨）→ 写需求卡片 → 迭代编排 → 实现**。段间不自动流转，每段转进由用户发令；每段一个用户级技能入口，登记不立技能（条目格式由流水线闸强制）。设计工作在会话内进行、用户主导、禁无监管自跑。 +一切要做的东西按五段流水线走：**登记 → 文档设计／美术设计（双轨）→ 写需求卡片 → 迭代编排 → 实现**。段间不自动流转，每段转进由用户发令；每段一个技能入口（doc-design／asset-ingest／iter-plan 装于项目 `.zcode/skills/`；req-card／iter 为用户级技能），登记不立技能（条目格式由流水线闸强制）。设计工作在会话内进行、用户主导、禁无监管自跑。 | 段 | 入口技能 | 产出 | 出入口铁律 | |---|---|---|---|