- v15.2.x
Codex分担:型号配置的角色行多快速型号、上下文宽度两列,代理地址进型号配置文件、一句固定话能改;走代理的两列必填、改配置那一刻也核,换族时两列清空;会话命令起任何会话之前洗掉继承来的代理六项,走代理的照本行配置带齐六项
设计指纹f5ba2319内容指纹960fe667测试指纹90ba6ca560d47219改动设计 5 个(harness-engineering.md、ADR.md、overview.md、session.md、settings.md);代码 6 个(requirements.js、session-phrases.js、model-settings.js、session-ctl.js、settings-commit.js、harness.js)
需求Codex分担签字 6ed0已完结
为了:Codex分担 —— 主要型号、快速型号、上下文宽度、代理地址都在型号配置里配,走代理的会话起来就带齐代理这条路要的那几项,一句话能切回 Claude,走官方的会话不会被带去走代理。
- 升第二位:新增一类东西(配置多两列与代理地址、改代理地址的固定话、洗环境多六项);两类、改配置的认法与派发闸都没改写。取舍见 ADR-131(补充 ADR-130),旧条目一个字不改。
- 守卫(
guard/**):固定话常量(session-phrases.js)角色那一句后可带「快速 <型号写法>」「宽度 <数>」(宽度也认 900k 这种写法),也能只说其中一列;两类那一句带了「快速」「宽度」的整句不收;多认「型号配置:代理 <地址>」;需求零件认固定话的那一处跟着认代理那一种。 - 体系守护技能的脚本:型号配置命令(
core/model-settings.js)的角色行多「快速型号」「上下文宽度」两列,顶层多「代理」那一栏(地址与它自己的最后改动),代码里不再写代理地址;取有效值多答两列、来自哪里逐列答;两条核对(快速型号与走的路同一族,宽度是整数、下限 10 万、上限走代理 90 万走官方 100 万);走代理的缺两列或缺地址,起会话拒、改配置那一刻同一个判法也拒,点名哪几个角色并附补设的固定话;换族时没说到的两列清空(改类引起的也清);跟随去掉四列;改代理地址那一句只核地址本身(http 或 https 开头,不许带用户名、口令、空格、引号);show 表头上方印代理地址,表里多两列,类那两行与执行体那一行不印这两列;X大脑 那一行是 gpt 时启动命令带齐代理那六项;占位令牌与两项开关是代理那条路的常量。会话命令(core/session-ctl.js)发起、叫醒、恢复三条路经同一处先洗掉继承来的代理六项(并进SCRUBBED_ENV),走代理的再照本行配置带齐六项、回话里列出带了哪几项,走官方的只带设了的两列;代理起不来时报文写明连的地址,并附双击启动代理、带完整路径的重新授权「!」命令、地址不对就说那一句三句。设置提交脚本(core/settings-commit.js)的提交说明在角色那一段后面接「快速 …」「宽度 …」,改了代理地址的另写一行「代理 …」。入口(harness.js)的用法照改。 - 床(跟着被测对象同批):型号配置、改配置、固定话、守卫认固定话、会话命令(三条路洗六项、走代理带齐六项、走官方的命令行不变、起不来的报文三句)、设置提交、说明措辞各补组;改坏对照写模块类。
- 文档 · 架构详图(文首版本改成 v15.2.0):§十五「型号与推理档」写上快速型号与上下文宽度两列只设在角色行上与没写时怎么取、两条核对、改配置那一刻也核、换族清空、代理地址住型号配置文件与改它的固定话(只核地址本身、没有地址时只拒走代理的)、发起叫醒恢复任何会话之前洗掉继承来的代理六项、走代理的带齐六项(占位令牌与两项开关是常量)、起不来时报文的地址与三句、执行体用派它的会话的环境,以及守不到;会话命令表发起一行与「会话登记册与恢复」里固定话的认法照改;§十七「型号配置」词条补上两列、代理地址、改配置那一刻也核、换族清空、洗六项。§二 第一轮写进去的那几句不改。
- 文档 · 决策记录加 ADR-131;旧条目一个字不改。
- 文档 · 体系守护技能说明:参考文档
references/settings.md的 model-settings 一节(用法、两列、代理地址、逐行表、固定话、改配置那一刻也核、换族清空、洗六项、起不来的三句、守不到)与设置提交的说明格式,references/overview.md两处,references/session.md发起与叫醒恢复里洗六项与带齐六项。 - 同批:agent 架构升第三位(X大脑 定义里固定话那一句与走代理的会话出问题时给切回句的规矩)。
- 守不到(细目在架构详图 §十五「型号与推理档」末尾与 ADR-131):宽度上限照实测定,上游收得下的长度变了机器不知道;走官方而没写两列时客户端的缺省机器不核;两项开关是平台的环境变量,平台改了名字或不再认,机器不知道。
- 不动:两类、固定话的认法、派发闸、§二 威胁模型那几句、x-agent 规范。
- v15.1.x
订正:型号配置「按角色」里有认不出的角色名、或这一栏整个不是对象时,起任何一位都拒绝并点名,不再照取类的值;会话命令的 gpt 写法认法与型号配置对齐
设计指纹f7291a21内容指纹4174d546测试指纹3a492bb8e4870832改动设计 2 个(harness-engineering.md、settings.md);代码 3 个(model-settings.js、session-ctl.js、settings-commit.js)
需求Codex分担签字 5ee1已完结
为了:Codex分担 —— 配置写坏时一律当场拒绝、点名怎么修,不悄悄按类的值起会话;会话命令与型号配置认同一种 gpt 写法。
- 升第三位:订正。独立复盘第一轮指出:「按角色」里认不出的角色名只在查看命令里点名,起会话不拒、照取类的值,与「写坏的配置一律拒绝、不退回类的值」对不上。两类、改配置的认法与派发闸都没改。
- 体系守护技能的脚本:型号配置命令(
core/model-settings.js)—— 「按角色」里有认不出的角色名、或「按角色」整个不是对象,取有效值对任何一个角色都答不行,点名哪个名字认不出(或这一栏不是对象)、怎么修(改对名字或从版本库取回,「跟随」改不了它);一个角色自己那一行写坏仍只挡这一位;两类的读法与派发闸照旧;改配置遇到「按角色」不是对象直接拒绝。会话命令(core/session-ctl.js)因此对任何一位都拒绝起并照原样点名;它认 gpt 写法改成与型号配置同一种(名字那一段带数字、带日期尾巴的也认)。设置提交脚本(core/settings-commit.js)遇到「按角色」里认不出的角色拒绝提交。 - 床(跟着被测对象同批):型号配置、改配置、会话命令、设置提交几张补认不出的角色、「按角色」不是对象与 gpt 写法几组;改坏对照写模块类。
- 文档 · 架构详图(文首版本改成 v15.1.1):§十五「型号与推理档」里写坏的「按角色」分两种说清 —— 一个角色那一行写坏只挡这一位,有认不出的角色名或这一栏不是对象七个角色都挡,两样都不挡两类与派发闸,改配置与设置提交各自拒绝;体系守护参考文档
references/settings.md的 model-settings 一节同一句同步改。 - 同批:agent 架构升第三位(X大脑 定义里「跟随」两处措辞照核准后的说法改)。
- 不动:两类、固定话的认法、派发闸、逐行有效表的样子、走代理的那一路与起之前的真请求;决策记录不加条目(ADR-130 的取舍没变)。
Codex分担:型号配置可按角色单独设一行(两类照旧,多一句「跟随」),查看命令印每个角色一行的有效表;型号是 gpt 的会话经本机代理,起之前发一次最小的真请求,代理不通当场拒绝、不退回 Claude
设计指纹4074f302内容指纹c54b3224测试指纹1495c6e183291f6d改动设计 6 个(harness-engineering.md、ADR.md、SKILL.md、overview.md、session.md、settings.md);代码 6 个(requirements.js、session-phrases.js、model-settings.js、session-ctl.js、settings-commit.js、harness.js)
需求Codex分担签字 5ee1已完结
为了:Codex分担 —— 型号配置细到每个会话角色、有一张一眼看清的逐行表,项目经理、复盘经理、运维经理能各自单独切到 Codex(gpt 型号,经本机代理)分担 Claude 的用量;代理不通时当场拒绝,不悄悄退回 Claude。
- 升第二位:新增一类东西(按角色覆盖、逐行有效表、走代理的那一路);两类、改配置的认法与派发闸都没改写,「按角色」一行都没写时每个角色读出的值与只分两类时逐个相同,配置文件不用迁移。取舍见 ADR-130(取代 ADR-127「不做」里「按角色细分的句式」那一条),旧条目一个字不改。
- 守卫(
guard/**):固定话常量(session-phrases.js)多认「型号配置:<角色> <型号写法> <档>」与「型号配置:<角色> 跟随」两句,七个会话角色的名单只住这一处,型号规整多认 gpt 那一族的写法;需求零件(requirements.js)认固定话种类那一行从「两类」放宽到「两类或七个角色」。派发闸一字不改。 - 体系守护技能的脚本:型号配置命令(
core/model-settings.js)多一栏可选的「按角色」与读坏了点名、一个取有效值的函数(答型号、推理档、走哪条路与地址、来自哪里)、代理地址常量与「gpt 打头的经本机代理」的推法;show 印七个角色加执行体的逐行有效表,X大脑 那一行是 gpt 时印出的启动命令带代理设置;set 多认--role(与--class二选一)与--follow(跟随只去掉单独设的型号与推理档,留着这个角色的最后改动)。会话命令(core/session-ctl.js)按角色取有效值;走代理的那一位在内联设置的环境变量里多带代理地址与占位令牌两项,发起、叫醒、恢复之前对它发一次最小的真请求,没成就不起、不叫、不拉并附代理原话;横幅认 gpt 那一族。设置提交脚本(core/settings-commit.js)的提交说明在类的两段后面接每个单独设的角色;入口(harness.js)的用法照改。 - 床(跟着被测对象同批):型号配置两张(有效值、写坏、逐行表、
--role与跟随)、固定话、守卫认角色那一种固定话、派发闸(有单独设的角色时照旧只认执行类推理档)、会话命令(假 claude 与假代理:带不带那两项、起前请求的几种结果、横幅认 gpt)、设置提交、说明措辞(几句说法在场)各补组;改坏对照写模块类。 - 文档 · 架构详图(文首版本改成 v15.1.0):§二 威胁模型加一行「对话内容送到哪」—— 设成 gpt 的会话会把对话内容(含仓里的代码与文档)经本机代理送到 ChatGPT 账号,哪些角色此刻走 Codex 看查看命令的逐行表,不想让哪一摊的内容出去就把那一行说回 Claude 型号;§十五「型号与推理档」写上可按角色单独设、跟随、有效值、走哪条路由型号推出、逐行表、走代理的那两项、起之前的真请求、代理不通当场拒绝不退回 Claude、执行体继承派它那一位自己那一行,以及守不到;§十五 角色表与 §十七 X大脑 词条里的启动命令改成照 X大脑 那一行的有效值,会话命令表的发起、叫醒、恢复三行与「会话登记册与恢复」里固定话的认法照改;§八「派发的型号与推理档」两句照「继承派它那一位自己那一行」订正,判法不变;§十七「型号配置」词条补可按角色单独设。
- 文档 · 决策记录加 ADR-130(按角色覆盖而不取消「类」、走哪条路由型号推出、代理不通不退回 Claude;不取甲);旧条目一个字不改。
- 文档 · 体系守护技能说明:索引里 model-settings 一行;参考文档
references/settings.md的 model-settings 一节(用法加--role与--follow、可按角色单独设、逐行表、新增「走哪条路」一段、守不到)与设置提交的说明格式,references/overview.md两处,references/session.md发起与叫醒恢复里取有效值与核代理、固定话一句。 - 同批:agent 架构升第三位(X大脑 定义里改型号配置那一条写上角色那一句、跟随与
--role)。 - 守不到(细目在架构详图 §十五「型号与推理档」末尾与 ADR-130):设成 gpt 的会话把对话内容送到 ChatGPT 账号,机器不拦,只靠逐行表让人看得见;Codex 写的中文与对规矩的遵从和 Claude 不同,守卫、检测、测试拦不住「说得不清楚」;干到一半代理掉线或授权过期,会话停在报错上,机器不自动切回 Claude;起之前那次请求只判成没成;横幅的样子随代理与客户端升级可能变,认不出就拒绝;叫醒、恢复按此刻配置判走不走代理,会话起了之后配置又改过的那一位会判错一次;X大脑 窗口是 BOSS 手起的,它那一行设成 gpt 时代理通不通机器不核。
- 不动:派发闸、agent 设计页正文、x-agent 规范;配置文件只多一栏可选的,不迁移。
- v15.0.x
日志拆分:记录分状态与日志、测试不读真仓日志、Harness 说明书只写当前、技能说明只预载索引;换主控后接得上核准;改坏对照不再误报咬住
设计指纹bcfd2ce7内容指纹724c9581测试指纹787f2db60cc5c2cc改动设计 56 个(CLAUDE.md、harness-engineering.md、ADR.md、x-constitution-rule.md、x-dev-rule.md、x-dev-skill-workflow.md、x-field-naming-reference.md、x-meta-rule.md 等);代码 25 个(project-archive.js、requirements.js、state-watch.json、test-faces.js、trial.js、floor.js、map-engine.jsonl、map-rest.jsonl 等)
需求日志拆分签字 26c6已发布
为了:日志拆分 —— 记录分「状态」与「日志」两类并在工作区地图标明,日志不进判定、不进说明书、平时不进上下文,测试不读真仓日志;说明书剥净来历、技能说明只留一页索引、规则书按目录装;核准跟着登记的主控走;改坏对照不再造孤立的守卫副本
- 升第一位:改写既有契约。记录原来只靠宪法 §六.11 与架构详图 §十五「记录分几类、放哪」的写法规矩,没有一处机器标识;现在记录分「状态」与「日志」两类,工作区地图给每个记录路径标出类别,日志不被判定代码按内容判、不被测试读、不进说明书、平时不进上下文;需求账本与会话台账完结之后换了住处;新增一个地图属性、一道检测闸与运行器常驻的卫生检查;同一版里还改了「谁能核准」的认法(核准者跟着会话登记册里此刻登记的主控走)与改坏对照的造法。取舍与取代见 ADR-128、ADR-129,旧条目一个字不改。
- 工作区地图(
hooks/workspace/**):新增属性「记录」(取值状态、日志、否,不写就是否,只由区写、一个路径只属一类);盘点表里每类记录各落一个区并有值 —— 需求账本与会话台账的第一层、原话账、跑床账、各单元的变更历史、需求履历里的 record.json 与 releases.json、发布台账与各站点发布档案、总账与待立项目清单是状态,已提交的账本区requirements/done/、已结束的台账区ledger/ended/、跑床记一行ledger/bed-runs/、需求履历里的 RECORD.md、决策记录、复盘记录、计划归档是日志(为此新开了这几处的区与子区);地板新增一类「记录」逐类钉住值,棘轮加「状态记录」「日志记录」两类;why.js对每类代表路径答出「记录」的值与出处行。 - 守卫(
guard/**):需求零件新增按需求名取账本的ledgerFileOf(先第一层再done/,镜像取同一层),读事件、完整性核对、补说签字与看 24 小时内签字的那一处经它读两层;判消失、判未提交、点名待提交、联调判拦、判越界几处只读第一层、读法不改;trial.js的 findClosed 与 deliveredFor 改读两层。核准者跟着登记的主控走:核准先认登记册里此刻登记的主控(仓里与镜像两处对得上;读不出或没登记主控时照旧认最近一笔确认所在的会话),不是办理会话、没写过机器镜像、镜像查得到写证据三条照旧作用在核准者身上;核准一笔多记当时登记的主控,读的一端按它认、不重读登记册,没记这一栏的老核准只认签字会话;project-archive.js让履历里接任主控核准的一笔写明「接任的主控」。测试面零件(test-faces.js)新增常驻卫生检查:床头 @covers 与 state-watch 盖到地图里标状态或日志的路径判不过并点名(state-watch 只盯在不在与类型的放过,在记录目录里列名字的判不过),记录区只问地图、不写路径字面量,例外冻结名单只有只追加小床一张、只准删不准加;空壳计划里守卫面的床并进 module;检测引擎技能的测试面扩到references/guide/**;state-watch 里盯计划归档名单的条目删掉。 - 运行器与体系守护技能的脚本:
bed-runner.js的全量卫生检查加一栏「床的声明通道盖到了记录」(不带筛选的全量运行与全量--list都报、计入失败);改坏对照的两路造法(按点改坏、空壳对照)不再造孤立的守卫副本 —— 预加载桩跟着床的 copyFileSync 与 cpSync 换内容,两路都不再设 GUARD_HOOKS_DIR,按点改坏的类只剩模块与判据(写「守卫」报「类只认 模块 / 判据」),登记在复制点清单里的床照样按点改坏;提交命令(plan-commit.js)在提交并推送成功之后把这条需求的账本、验收单与它的可读版挪进requirements/done/、仓外镜像那一份同批挪,把会话已结束、写证据里的文件都已提交的会话台账挪进ledger/ended/<日期>/并清 30 天前的日期目录,推送没成功的不挪;--move单独挪账(可预览),提交命令出现之前就完结的老需求由它一并挪;十态(plan-loop.js)与复盘取数(plan-retro.js)按需求名取账本改读两层,复盘取数的会话账连ended/读;harness.js里核准命令与提交命令的帮助照改。 - 检测引擎(
check-spec/**):新增一道「真相源不写来历」(check/source-no-history.js,和版本契约一样立在引擎里、不进任何系统规范;check.js只加接线)—— 管宪法、规则书、执行体定义与注册表、自研技能说明与参考文档、判据的正文与简介、架构详图、各张架构设计页与架构标准页、治理站点手写页;认公历日期、版本号注记、带「当天、实测、定、立、起、前后」或带时刻的月日、「此前」「原先」;文首「版本」一行与页头版本标记、决策号、代码块里的占位、判据标题里本规范自己的版本号、登记表里的版本标识与规范要求的日期栏,以及换电脑清单的工具版本号、治理站点业务页「最近复核」、业务视图页页头复核那一格、各业务域 ARCH.md 的 lastReviewed、业务视图页样机画面里的字、架构详图里记本机平台版本的两处,按位置或结构逐个点名不算;增量检测整份判改到的文件(自它上一次封版以来改过的),全量检测只报数、不改退出码。 - 床(跟着被测对象同批):新增只追加小床
records-append-only(从 ops-model-text 拆出,只守决策记录对着版本库基线只追加,是卫生检查唯一的例外)与来历闸的判法床、真实入口床;ops-model-text 拿掉决策记录、三份变更历史与履历目录的 @covers,范围直接写进床,N19 改用造的文本;tetrad-governance-gates 删掉读真决策记录的 G4,sensitive-data 只核计划目录第一层在办的计划并删掉扫真仓说明书与日志的 G4;harness-dev 拿真履历当样本那一处改夹具;站点床跑前跑后的真仓指纹只核站点源码、构建器与站点产物;trial-gate 与 stop-timing 删掉为孤立副本留的退路;回归床 bite.test.js 钉住新造法;地图、挪账、核准、卫生检查与测试面各床补组;各技能自带的床与站点床夹具里核技能说明原文的几处,改到参考文档里核。改过的每张床与新床做空壳对照。 - 文档 · 宪法:§六.11「记录最少」升成存在性声明 —— 记录分状态与日志两类,地图给每个记录路径标出类别,日志不被判定代码按内容判、不被测试读、不进说明书、平时不进上下文,由检测与运行器按地图核;机制留在下层。
- 文档 · 架构详图(文首版本改成 v15.0.0):§十五「记录分几类、放哪」按两类重写并写成一条写法规矩(说明书、注释、规则书都只写当前,来历只进变更历史、决策记录、需求履历、发布记录与提交),写明判定代码不按日志内容判、读日志的地方只有写者、完整性核对、写保护与跳过、当场用法四种;§十五 角色表里 X大脑 那一行写明仍要用户定的只剩六类、其余纯技术取舍听取架构师的结论后直接定,「怎么派工」写明先省 token、再在不多花 token 的前提下吃满电脑资源提速;§十六 写明床不许把记录盖进上游、床不读真仓日志由交付时的日志换空对照查,「空壳怎么造」照新造法改写;§十八 记下属性「记录」;§八「签字只锁五样」与 §十七 术语「待核准、核准、没有核准路」照核准者跟着登记的主控走改写;整份从头到尾只写当前 —— 来历剥净,已退役机制的整段与被新口径取代的旧段落(四段)删掉,节的名字与顺序不变。
- 文档 · 决策记录加 ADR-128(记录分状态与日志、Harness 说明书只写当前、技能说明只预载索引)与 ADR-129(核准者跟着登记的主控走,取代 ADR-111 里核准者那一句);旧条目一个字不改。
- 文档 · 规则书、元规范与技能说明:没配对规范的七份规则书剥来历,四端开发规则与字段命名参考写上适用范围(只覆盖业务各端与内核目录,碰到才装、不再常驻);元规范正文与编号约定剥来历;八份自研技能说明剥来历,超过约 8KB 的六本(体系守护、发布、统一开发、检测引擎、数据端、元治理)拆成一页索引(frontmatter、一段用途、命令表与几处指针)加同一技能 references 下按主题的参考文档(原文挪不抄,检测引擎的放
references/guide/),移动端与模块下线只剥来历;体系守护参考文档里讲核准、讲改坏对照的两段与统一开发讲待核准的一句照本版改写,体系守护的架构参考删掉已作废的一节、统一开发的架构参考去掉「影子构建」的叫法;检测引擎用法文档指向新的参考文档;计划模板与机器镜像样板里讲核准者的两句照改。 - 同批:agent 架构升第三位(设计页与执行体注册表、定义剥来历,几份定义加指针、指向技能说明某节的指针改到参考文档,敏感命令叫法对齐);项目架构升第三位(清理归档里账本本体与会话台账改成提交之后挪进日志区,核准者跟着登记的主控走,去掉讲经过的用语)。
- 守不到(照实写,细目在 ADR-128、ADR-129 与架构详图 §十五「记录分几类、放哪」、§十六「床不读真仓的记录」):来历闸只认日期、版本号这类写法,没剥过的系统规范与业务说明书只在被改到时整份判、全量只报数;床不读真仓日志只在交付那一刻查过,以后新写的床直接读的机器不当场拦,读了日志、换空也不改结论的看不见;「判定代码不按日志内容判」只靠复盘;挪账只在提交并推送成功之后,会话死在半路留下没提交的写,它的台账一直留在第一层;规则书写不写适用范围机器不拦;核准认的是登记册里登记的主控、不是用户本人,核准命令预览那句与三查结果单、验收区的标注在接任时仍按旧判法显示。
- 不动:版本契约、封版核心、跑床账封版记录的核对、框架锁的极简比对与发布登记的代码;34 份系统规范与 21 份业务架构文档的来历;站点床里的来历检查。
- v14.0.x
型号配置:各角色的型号与推理档改成一份只由 BOSS 一句话来改的配置(主控类、执行类各一对)—— 会话命令按类带、执行体写 model: inherit 跟着派它的会话走、守卫的派发闸核派发带的型号与推理档;要 BOSS 亲手做的事做成他用「!」跑的受信脚本
设计指纹2f2818d3内容指纹5858f39c测试指纹2cb5f64f2e551186改动设计 3 个(harness-engineering.md、ADR.md、SKILL.md);代码 13 个(command-policy.js、requirements.js、session-phrases.js、team.js、verify-harness.js、floor.js、map-engine.jsonl、map-rest.jsonl 等)
需求型号配置签字 dea6已发布
为了:型号配置 —— 型号与推理档不再写死在会话命令、项目设置和每份执行体文件里,改成一份 BOSS 对 X大脑 说一句话就能改、不立需求不升版的配置;要 BOSS 亲手做的事一律做成一条他用「!」粘贴运行的受信脚本,先落项目设置改法与设置文件提交两处。
- 升第一位:改写既有契约。型号与推理档原来按角色写死在三处 —— 会话命令里的名单与常量、项目设置里强制子代理型号的两个键、每份执行体文件的
effort: max,x-agent 还逼执行体文件「逐字等于 max」;现在各角色的型号与推理档只住一份型号配置.claude/model-settings.json(主控类 X大脑、产品架构师、Harness架构师,执行类是其余会话角色与全部执行体,各一对型号加推理档),改它只有一条路 —— BOSS 对 X大脑 说固定话「型号配置:<类> <型号写法> <档>」,X大脑 跑受信命令,命令核到新鲜的原话才改,不立需求、不升版、不封版;ADR-117 讲会话型号的那一半与 agent-effort-max 那条需求定下的「执行体推理档逐字 max」口径被取代,旧条目一个字不改。 - 新增 · 体系守护技能:
core/model-settings.js(--action=model-settings:show 谁都能看,set 只有登记册里的主控跑、核 BOSS 的新鲜原话;型号写法规整;原子写;每类各记最后改动与用过的原话;读不出、缺一类、推理档不在五个里一律拒绝,不退回写死的值)、core/project-settings.js(--action=project-settings:登记的闭集改法「去掉执行体型号强制」,按文本删项目设置 env 里的两个键,改完核只少这两个键且写前拦截的接线还在)、core/settings-commit.js(--action=settings-commit:提交项目设置与型号配置文件,一份文件一个提交、不推送,代签设置文件不在名单里);三个脚本都不接--root,harness.js加三个动作路由;两条「!」脚本先打印预览再动手,只有 BOSS 用「!」跑得了。 - 守卫(
guard/**):固定话常量做成一张表(session-phrases.js,一行一种句式)并加「型号配置:<类> <型号写法> <档>」(按行认:一条消息里可以连说两行、每类一行,每行独占一整行;其余三种固定话仍整条消息恰是一句)与型号规整(人话「族名 版本」、完整型号名、官方别名三种写法,不对着型号名单核);requirements.js的bossPhraseHeard多认modelSettings:<类>,定时任务提示词含「型号配置:」一律拦,永不放行名单加型号配置文件;command-policy.js的写保护(新旧两支)加型号配置文件与三个新脚本,敏感命令加型号配置的 set(按执行体编号拦,第五条)与两条「!」脚本(经 Bash 工具跑一律拦、含预览);派发闸加第二样 —— 组队零件的dispatchWhy拆成typeWhy(类型与名册,原样搬入)与modelWhy两关,modelWhy调requirements.js的modelDispatchWhy,对每一次过了类型与名册那一关的派执行体判入参里的 model 与 effort(不带型号、只放等于执行类推理档的、主控类会话派必须带、配置读不出时执行类不带参数的照放其余拦),取代原来只管复盘者的型号闸(dispatchBlockWhy里管型号的几行删掉,它第一行记下派它的会话号);工作区地图给型号配置文件加一区(不受治、保护只标脊柱不标判官、入库),三个新脚本进脊柱代码区,地板、钉住床、对拍台同批补。 - 会话命令(
core/session-ctl.js):删掉OPUS_ROLES、SESSION_EFFORT两个常量;起会话时读型号配置(读不出就拒绝起会话并点名怎么修)、按这位角色所属的类带--model与--effort,起完照横幅核同一个值(完整型号名比族名加版本,官方别名只比族名,推理档逐字比,认不出宁拒勿放);起 claude 子进程前洗掉继承来的子代理型号、强制开关与推理档四个环境变量(SCRUBBED_ENV、cleanEnv,所有 claude 调用都经spawnClaude);登记主控的报文印 X大脑 启动命令整行;主控类有哪几位只住core/model-settings.js的一份常量,会话命令与守卫都读它。 - 床(跟着被测对象同批):新增型号配置命令、两条「!」脚本、固定话与型号规整、守卫三处与派发闸的床;改写会话命令的床、守卫回归套件里写死型号的几处、文字对表床(加规矩原文在架构详图与 X大脑 定义里的一条);每张新床与改过的床做空壳对照。
- 文档 · 架构详图(文首版本改成 v14.0.0):§十五「型号与推理档」一段整段改写 —— 型号与推理档见型号配置、那份文件是唯一出处,写明两类各归哪些角色、改配置只有一条路、会话命令怎么读、执行体跟着派它的会话走、守卫的派发闸核什么、守不到;角色表需求方与主控两行加改型号配置、主控一行的启动命令照配置,角色表之后新增两段(要 BOSS 亲手做的事的规矩原文,与它怎么落、守不到);
start子动作的命令形状与核对、复杂化审查官与新增执行体两处的文件写法同步;NS-5、NS-9 改成只核写法、不核值;§八 环1「派执行体通道」里复盘派出那一道去掉型号这一条、派发闸加第二样,会话命令与敏感命令一支由四条改五条并加两条「!」脚本,写保护脊柱名单与永不放行名单加型号配置文件;环3「需求对账」里「派发闸」一段限定为第一样、新增「派发的型号与推理档」一段,复盘派出那一道去掉「型号降级」,提交命令一段加设置提交脚本的指针,定时任务通道一枝加型号配置那一句的前缀;§十五「会话登记册与恢复」里固定话的认法加改型号配置(型号配置按行认);§二「定时任务冒充用户的话」一行与 §八 环3「说话只认主控」一段加上改型号配置;§二、§四、§十三、§十五(不归任何版本单元的东西)、层图与 §十七(术语表加「型号配置」、X大脑 一行)里对应的说法同步。 - 文档 · 决策记录加 ADR-127(写明取代 ADR-117 讲会话型号的那一半与「执行体推理档逐字 max」的口径,不做的、守不到、升哪一位;旧条目一个字不改)。
- 文档 · 体系守护技能说明:加 model-settings、project-settings 与 settings-commit 三节(用法、谁能跑、做什么、守不到),会话命令一节讲型号与推理档的几句改成指向型号配置,架构速查与「它是什么」同步,文件头版本升一位。
- 同批:agent 架构单元升第一位(18 份可派出去的执行体文件
effort: max换成model: inherit,X大脑 定义照型号配置并加指针,设计页写死型号与推理档的几处换成指向型号配置、硬控清单加第 52 至 54 行);x-agent 升第一位(NS-COMMON-0009 只核写法、NS-COMMON-0005 收成写了只许 inherit,条款、系统架构页、测试床同批);项目架构升第三位(只把写死的会话与执行体型号换成指向型号配置);治理站点使用方式页里写死的 X大脑 启动命令改成指向型号配置、构建器床两处断言跟改。 - 守不到(照实写,细目在 ADR-127 与架构详图 §十五「型号与推理档」「要 BOSS 亲手做的事怎么落」、§八「派发的型号与推理档」):BOSS 用编辑器手改配置,机器认不出是谁改的、也不提示,手改不动「最后改动」,所以手改之前说过、还没用掉的固定话仍算新鲜;原话账本只在本机,换电脑后要 BOSS 再说一次;型号名格式对而平台不认,要等下一次起会话的横幅核对才抓到;派发带的推理档平台照不照办、执行体的推理档在对话记录里看不看得到,只能靠平台;两类型号不同时,主控类会话派的执行体型号跟主控类走、守卫只核推理档;已在跑的会话改不了,常驻会话要等重起才跟新配置;用脚本转一道去跑「!」命令守卫看不见,两条命令都是闭集、绕过去也无害,「!」是不是真由 BOSS 敲的机器不核;改完项目设置只管以后读设置的进程、不撤已应用的变量;会话命令洗环境洗不到已经带着那几个变量的旧作业与已在跑的会话(叫醒时仍重放旧值、自己派的执行体仍被强制,要换新只能删了再发起),也没有真环境的实测。
- 不动:宪法;提交命令(
plan-commit.js)、三查、封版、发布出口与版本契约。
- 升第一位:改写既有契约。型号与推理档原来按角色写死在三处 —— 会话命令里的名单与常量、项目设置里强制子代理型号的两个键、每份执行体文件的
- v13.0.x
订正:旧名单快照按「对完就拆」拆干净 —— 对拍台一侧的两份旧名单快照与读它们的床、工具一并拆掉,架构详图与 ADR-126 里「冻结为历史记录、只许核对」的旧说法同批订正
设计指纹05453181内容指纹dac1c960测试指纹9ec1bc9edcf39abe改动设计 2 个(harness-engineering.md、ADR.md);代码 0 个
需求守卫读地图签字 a733已发布
为了:守卫读地图 —— 把「对完等值证明就拆掉旧名单快照,落地后名册只有地图这一份账」做满:对拍台一侧的旧名单快照与读它们的床、工具也拆掉,文档里「冻结为历史记录」的说法改成现在的做法。
- 升第三位:订正,守卫与引擎读地图的设计没变。v13.0.0 把对拍台一侧的两份旧名单快照(
legacy-lists.json、new-roster-lists.json)留成「冻结的历史记录、只许核对」,与那条需求签字时的口径(对完等值证明就拆掉旧名单快照,落地后名册只有地图这一份账)不符;这一版把它们连同读它们的床和读取工具一并拆掉,对拍台不再读旧名单快照。改读那一次的等值证明(逐张名册往地图里多加、少一个成员各红一次)照旧留在那条需求的证据记录里。 - 文档 · 架构详图(文首版本改成 v13.0.1):§十六 对拍台一节「补录语料与读地图的对账」一段的 ⑤ 与 §十八「守不到」的 ②,把「旧名单快照冻结为历史记录、只许核对」改成现在的做法:旧名单快照只在改读名册那一次用来证明等值,证明留档后连同读它们的床与工具拆掉,对拍台不再读旧名单快照,落地后名册只有地图这一份账。
- 文档 · 决策记录:ADR-126 决定⑥里关于旧名单快照「冻结、只许核对」的几句同样订正(ADR-126 是同一条需求新加的条目,订正它不算改写旧条目;旧条目一个字不动)。
- 不动:v13.0.0 一节与它的封版记录。
- 升第三位:订正,守卫与引擎读地图的设计没变。v13.0.0 把对拍台一侧的两份旧名单快照(
守卫读地图:守卫里按路径分类的判断改问同一张工作区地图(经唯一入口、用到才装、读不到按拦、三条路不碰地图),检测引擎的五份名册与版本契约的单元根改成加载时从地图名册算出,元规范的覆盖令牌判断读名册,地板补齐,对拍台补录,沙箱复制点全带地基目录
设计指纹361904a2内容指纹dac1c960测试指纹a2a7fb974163f161改动设计 3 个(harness-engineering.md、ADR.md、x-standard-rule.md);代码 22 个(guard.js、command-policy.js、gate-measure.js、requirements.js、session-ledger.js、stop-handler.js、test-faces.js、verify-harness.js 等)
需求守卫读地图签字 a733已发布
为了:守卫读地图 —— 全仓「这个路径是什么」只问同一张工作区地图:守卫与检测引擎余下的按路径判断都改读它,只换读法、答案逐条不变;地图读不到时要用它的判断按拦并点名坏在哪,读坏了也能在施工区副本里修好换回。
- 升第一位:改写既有契约。守卫里按路径分类的判断(写保护的五个谓词与判业务目录、受治与判决依据、测试面上游组与测试根、规则书分类)和检测引擎的五份名册常量、
module-detector的三个常量、版本契约的单元根与跳过名,原来各抄各的名单,现在问同一张工作区地图,答案逐条不变;地图读不到时,守卫里要用地图的动作一律按拦并点名坏在哪个文件第几行(守卫此前不读地图,读坏对它没有影响);ADR-114 的「五份名册一个字不动」「缺地基目录时照常 require」与 ADR-115 决定④的「守卫本步不读地图」被取代。 - 地图与地板(
.claude/hooks/workspace/):地板补进守卫今天保护着、此前没有的条目(会话登记册目录、代签设置文件、定时任务文件、提交命令与开工命令、会话命令与代签命令模块、守卫「路径里含这一段就算」的任意深度写法)和保护区、装配产物、发布档案、免检写区的受治根四类,施工区里的床账与射程缓存仍保护;余段逐属性对着守卫核过、以守卫为准改值(受治数据层补成受治、执行体定义的脊柱收窄到.claude/agents/*.md、车道的值、/references/排除等),与设计目标不同的几组标「过渡」保住今天的答案;路径规则加三种写法(连续几段seq、只对哪些路径起作用under、起点不是仓根那一段nested),文件类的区底下另立<文件>/*子区只管文件本身;新增六张名册(单元根、版本契约跳过名、没有配对规范的规则书、覆盖令牌、裁判五样、判定代码),名册成员可带附加信息;读取模块多了只给守卫用的折小写开关与名册附加信息的取数口。 - 守卫(
guard.js、guard/**):新增唯一入口guard/map-reader.js(顶层只装 Node 自带的东西,读取模块与地板第一次问才装,折小写开关只给守卫,读不到原样抛、不叠重试,地基目录里路径的五个保护类视图由地板直接答);command-policy.js的写保护谓词与判业务目录问地图视图(先做今天的路径归一;仓外绝对写法、带$~%的写法、无锚怪癖、目录自身节点、怪名字走老支,老支正则一字未改;加载本文件不读地图;新导出isHardProtected、isAncestorOfProtected、inWorkArea供对拍台与钉住床);requirements.js的受治根与判决依据五样、判定代码读名册(用到才读),认流程那条链上的名单与字面量写死并钉住,施工区判断与免检写区写死,开工判断与说话那一道读不到地图时把地图的错往上抛(新导出laneIsJudge、laneEnds、laneFlowOfNonePath、workAreaOf、neverRelease、TOP_PATH_PREFIXES等);test-faces.js的上游四组取自地图属性「测试面上游」、测试根取自名册「测试根」;stop-handler.js的规则书判据用到才装、装不上不放过;gate-measure.js遇到地图的错原样往上抛、不吞成「没有手机端」;guard.js的装载口与顶层兜底点名出错位置并带修法,说话那一道只放过地图的错(退出码 0、原话已入账、签字不生效),写后提醒读不到地图时可见地跳过;台账零件只多导出一个常量,联调零件、装配面与写后记账零件的字面量一个字未改,由钉住床核与地图一致。 - 检测引擎与元规范:
constants/defaults.js、terminals.js、test-roots.js、rule-books.js、version-contract.js(九个单元根与跳过名)和utils/module-detector.js的三个冻结常量加载时读地图引擎段的名册算出,导出名、形状、值、顺序不变,名册缺或写歪一律抛、不给默认值,缺地基目录加载当场抛;判据注入的门面多露名册附加信息一口,读取模块装不上时的占位五个口全抛;元规范 NS-COMMON-0018 的覆盖令牌判断读名册「覆盖令牌」(缺注入推红),规则书指纹同步;check.js里读余段属性的几处留字面量、由引擎常量床核与地图一致;引擎的匹配器与各处自写的通配一个不换。 - 对拍台:补录语料与补录金标准(原语料与主金标准一个字不动)、新适配器 A58 至 A62、补登记表与守卫处置表、引擎读地图处置表(每行恰好一个去向,双向对账)、独立求值器补三种规则写法与装载拒绝、旧名单快照冻结(只许核对);全量证明一并回放补录语料与新适配器。改读那一次逐张名册做了多加、少一个成员的等值证明,证明完拆掉名册钉住床与它的旧名单快照夹具(墓碑已登记)。
- 床(跟着被测对象同批):新增
map-reader.test.js、command-policy-map.test.js、requirements-map.test.js、workspace-guard-reader.test.js、workspace-guard-lazy.test.js、workspace-guard-failure.test.js、workspace-guard-literals.test.js;改写workspace-decouple.test.js、workspace-engine-constants.test.js;加强沙箱覆盖床workspace-sandbox.test.js(扫描扩到守卫树,守卫一侧的复制点另立数组登记)、地图与地板与完整性几张床、引擎注入与版本契约床、test-faces.test.js、元规范钉住床(0018 加五条)、对拍台六张床(普查、地图等价、探针路径、完整性、回放、全量证明);守卫回归套件verify-harness.js的失败矩阵与惰性表把入口算一列、加「地图读到半截 + 非字面的业务目录写法」两行;每张新床与改过的床做空壳对照。 - 文档 · 架构详图(文首版本改成 v13.0.0):§十八 的总述、数据模型与「工作区地基的完整性闸、没改的与守不到」按现在的说法重写;「引擎读地图」(名册常量从地图算出、六张新名册、注入门面多露附加信息、
check.js里留字面量的几处)、「守卫读地图与读坏了怎么办」(唯一入口、哪些问地图哪些不问、用到才装与三条路不碰地图、读不到的处置与逐事件做法、读坏之后施工区副本里修的路径、认签字的做法、车道按改地图的值办、刻意写死的字面量清单、沙箱带地基目录、换入后自检、守不到)、「测试面上游」(上游组取自地图属性)三节;§十六 对拍台一节加补录与读地图的对账一段,上游组与测试根真相源的说法同步;§八 零件用到才装、写保护的判断条件、部署门的端名册与 ⑭、认流程与认车道里名单的说法同步;§九、§十五、§十七 里「名单只写在一处」的说法与术语表的工作区地图、地板、判决依据与判定代码几行同步。 - 文档 · 决策记录加 ADR-126(写明取代 ADR-114 的哪几处与 ADR-115 决定④ 整条,补充 ADR-115 决定①②,旧条目一个字不改)。
- 守不到(照实写,细目在 ADR-126 与架构详图 §十八):对拍只对语料里的路径成立;地图读坏期间真仓里除施工区副本之外要问路径的写都被拦(含计划目录与被签字放行的地基目录文件),修复只走施工区副本里修好、经换入帮手换进真仓,没有在办需求时新需求签不了字、只剩急救开闸;需求履历放行栏等只显示的几处读不到地图时静默丢;读取模块自己有语法错时引擎一侧装载口的报文偏弱(仍拦、仍点名);独立求值器与读取模块对
under点名的名册写在规则后面、区路径末尾X/**两处口径不同(只对非法数据与真数据里没有的写法有分别);折小写只给守卫,同一张地图对只差大小写的路径守卫与引擎可能答不同;名册落地后没有常驻的等值床;单元名前缀与显示名、风险标记里母本与内核一项、写保护的扣除项、认命令词这几样写死而不钉;延迟只量不设门槛。 - 欠下的:守卫判
mv的来源与rm的目标只比受保护样本表与「目录加/_」,样本表里没有的上级目录可以被整份挪走或删掉;签字会话用curl -o等不在守卫写命令清单里的程序可以往受保护文件落盘;地图读坏之后的抢修态没做 —— 去向都是「新增拦截」。 - 不动:宪法、项目架构设计页与 agent 架构设计页、车道表里「真仓直改,不做副本」那一句;认仓根、认树根的几十处;技能脚本与治理站点构建器;三份规范判据里暂留的名单抄本与 x-deploy 044 的改读。
- 升第一位:改写既有契约。守卫里按路径分类的判断(写保护的五个谓词与判业务目录、受治与判决依据、测试面上游组与测试根、规则书分类)和检测引擎的五份名册常量、
- v12.1.x
规矩固化一:把只记在 X大脑 记忆里的做事规矩一次写进真相源 —— 宪法加第 10 至 12 条(刹车规矩、记录最少、规矩当场固化),详图 §十五 加「刹车规矩」「记录分几类、放哪」两段与「全仓静默窗口」,「怎么派工」加 ⑥ ⑦,技能说明加「命令行写法」一节,加一张核字在场的床
设计指纹c1b37f69内容指纹1a122f4a测试指纹9498c3e775995ee5改动设计 4 个(CLAUDE.md、harness-engineering.md、ADR.md、SKILL.md);代码 0 个
需求规矩固化一签字 a103已发布
为了:规矩固化一 —— 把用户定的做事规矩从 X大脑 的记忆里一次写进宪法、架构详图、技能说明和每份执行体定义,压缩上下文或重开会话都不会丢,再加一张测试床核这些字在场。
- 升第二位:新增一类东西。宪法三条规矩(刹车规矩、记录最少、规矩当场固化)、架构详图三段(刹车规矩、记录分几类放哪、全仓静默窗口)、体系守护技能说明一节(命令行写法)、一张核字在场的床;既有契约一个字没改写 —— 非签字事项不弹窗、插队只认红灯与提速、并不并只看是不是改同一处,这三处是改口收窄,都靠纪律,没有改任何机器认的命令、账本或闸;两个裁判各判什么、三条主流程的闭环、五类架构、签字与开工、发布与提交都不变。
- 宪法 §六:第 9 条之后新增第 10 条「刹车规矩」、第 11 条「记录最少」与第 12 条「规矩当场固化」,都只写定性、不写机制名与文件路径;第 10、11 条的细则指到架构详图 §十五,第 12 条的做法只写在 X大脑 定义里、没有详图指针。
- 文档 · 架构详图(文首版本改成 v12.1.0):§十五「遇到顶层问题的两种走法」里插队的门槛改成只认红灯与提速两种,其余一律排进待立项目清单、不插队,红灯里点名刹车的三种情形;其后新增「刹车规矩」一段(什么算被平台的安全检查拦下、怎么停、怎么报、同样的失败连着两次、修法要改自己占着的判定代码或守卫时报 X大脑 并带两个选项、要靠诀窍才过得去的机器关口报框架毛病、被拦过的会话不再叫醒与换新会话接手、机器之间传大段内容传位置加指纹、今天靠什么、守不到)与「记录分几类、放哪」一段(七类各放哪,被计划或清单引用的设计稿放耐久处,过程文件不进计划目录与主控线目录也不叫用户去删,心得写进交回的报告);「怎么派工」⑤ 里主控一侧改成签字题用弹窗、除签字题外不弹窗并在每轮回复末尾附「待你回话」小卡片,新增 ⑥「等用户回话时不空等」与 ⑦「排队的需求提前备料」,「今天靠什么」补半句;「一条需求一次封版收得了口……」一段末尾加「互不相干的不并」;「跑整面床、发布两个全仓共用的窗口」一段加「全仓静默窗口」(发布、跑整面床与单跑站点床的那几分钟,除被放行的那一位,仓内任何文件都不写、也不跑重命令;窗口的开始与结束只凭被放行的那一位报命令真起了、真退出了,宣布之前先确认),§九「谁改了站点的源谁就可以建」一句加括号,窗口开着时除外。
- 文档 · 体系守护技能说明:新增「命令行写法」一节(所有 node 命令,不放 bash 围栏);retro 一节补办理会话号取法与对话记录位置;叫醒与改派两处各补一句被平台的安全检查拦过的会话不叫醒;文件头版本升一位。
- 文档 · 决策记录加 ADR-125(写明取代 ADR-120 决定④ 里插一条优化的口径与详图 ⑤ 里「一律给选项」那一半,不做的、守不到、升哪一位)。
- 测试床(跟着被测对象同批):新床
brake-rules.test.js核宪法、架构详图、执行体定义、agent 设计页、技能说明里这些字在场,并带改坏对照;宪法对表那张床ops-model-text.test.js的 N5 同批改到第 1 到 12 条,加三条的标题与关键话。 - 同批:agent 架构单元升第一位(执行体定义「禁区」加通则行、对抗审查官定义加「核查六问」一节、项目经理与运维经理与 X大脑 定义补全仓静默窗口的角色句等),见 agent 架构自己的变更历史。
- 守不到(照实写,细目在 ADR-125 与架构详图 §十五「刹车规矩」一段的「守不到」〔记录类的几样也并在那一段里〕和「全仓静默窗口」的「守不到」):平台的安全检查拦下这件事守卫看不见,「拦一次就停」靠宪法与每份执行体定义里同一句话,机器只核字在场、不核行为;同样的失败连着两次没有统一出口,不数;「诀窍」是语义,机器认不出;压缩与叫醒之后「我刚被拦过」只靠看板状态栏与巡检;记录放没放对地方、设计稿有没有放进耐久处、不写来历,机器都不核;全仓静默窗口里的写和重命令机器不拦、事后红出来才发现,窗口算没算开始或结束只凭被放行的那一位的报;非签字不弹窗、等用户回话时不空等、排队的需求提前备料全靠纪律,见「怎么派工」的「今天靠什么」;字在场不等于照做。
- 不动:守卫、检测引擎、立项与接力命令的脚本、项目架构设计页。
- v12.0.x
登记册的锁不再因文件系统瞬时占用偶发失败:拿锁撞上 EPERM、EBUSY、EACCES 时退让重试,到时仍是那个码就点名它;拿锁永远成功的改坏对照改成每次都咬得住
设计指纹99b3ced9内容指纹1a122f4a测试指纹e1c57843df4358c6改动设计 1 个(harness-engineering.md);代码 1 个(session-registry.js)
需求登记册锁签字 74e0已发布
为了:登记册锁 —— 发布前测试不再因登记册的锁偶发红而被拦。
- 升第三位:订正,设计内容没变。登记册脚本拿锁撞上 EPERM、EBUSY、EACCES 这三个码,原来当场失败;现在和写登记册改名一样退让重试,留在原来的等待循环里、受等锁时限管,到时限仍不行就如实点名最后一个码,不说成「被占着」。其余码仍当场失败,建完锁文件之后写内容、关文件出错仍当场失败,撞上 EEXIST 的原路一个字不动。「哪些码算暂时错误」收成一处判断,写登记册的改名和拿锁共用,改名的 6 次与睡眠节奏一个字不改;放锁、续期不动。
- 测试(跟着被测对象同批):R5a 加严,先断言拿到锁之后锁文件在;R10l 改指 R5a(不再靠三个进程碰运气撞上才变红),新增 R10l2(独占创建换成覆盖创建)指 R5b,两颗都是测试进程里同步做的断言,不起子进程;新增 R5m、R5n、R2k 三条注入用例(分别注入 fs.openSync、fs.renameSync 的暂时错误,每条断言注入真被消耗并在 finally 里还原),配改坏对照 R10aa 至 R10ad;R5j 保留为真进程压力回归,只在它上面加一行注释,不再当咬合裁判。新增用例耗时见测试床。
- 文档 · 架构详图(文首版本改成 v12.0.1):只改文首版本一行;正文里讲这把锁的说法仍然成立,不动。
- 守不到(照实写):平台成因没核,成因未在本机复现,涉及成因的话一律写「可能」;注入用例证明代码撞到码时怎么做,不证明平台会给这个码;真权限问题与瞬时占用同码,拿锁要等满时限才报;放锁删不掉时锁文件留到进程退出,进程不退出的最长留到十分钟过期;R10l、R10l2 每次都红是由构造推出的,没有在错开起跑或满负载下实测。
- 欠下的:仓库级跑床锁(bed-runner.js 的 acquireLock 与 swap-in.js 的 takeBedLock)同形缺口,和 beds.json 改名落盘报 EPERM 的同类样本,另走自己的车道。
- 不动:身份核验与读登记册(whoIs、sidWhy、validate、commit、readSide、readState)和导出表、过期判断、令牌、等待步长、守卫、决策记录、技能说明、两张设计页、宪法。
收尾不挡下一条:清理归档之前只问跑床与建站两把锁,复盘和遗留、发现的去向挪到归档之后在后台办;复盘记录搬到主控线的复盘记录目录,归档时建骨架,收尾单在归档那一刻定格
设计指纹e02f436e内容指纹668dc7cc测试指纹957e277588e6e616改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、SKILL.md);代码 7 个(requirements.js、verify-harness.js、PLAN-TEMPLATE.html、plan-loop.js、plan-run.js、plan-wrapup.js、harness.js)
需求收尾不挡下一条签字 65d7已发布
为了:收尾不挡下一条 —— 验收完结、该发的格发完之后当场归档、提交,下一条就能开工;复盘和遗留、发现的去向在后台同时办,结果照样进清单和复盘记录。
- 升第一位:改写既有契约。清理归档之前,接力命令原来问三样(复盘记录里的结论写了、收尾单第三栏每条去向不是默认的「后放」、没人拿着跑床与建站的锁),现在只问最后一样;复盘记录原来住在专项计划目录、随计划归档,现在住主控线目录下的复盘记录目录;收尾单第三栏的默认去向由「后放」改为「后台办理中」,复盘记录里的发现不再进第三栏。
- 清理归档零件:archiveHolds 只返回锁;新增复盘记录的路径函数、建骨架函数(这一次调用真搬了计划时建、已有不覆盖、预览只说将建、建不成只说一句不影响归档)和后台收尾状态函数(只看结论与去向两项);复盘记录多认一行「去向:」(恒要,没有遗留也没有发现的写「去向:无」);收尾单第一栏「过程复盘」一节对每条完结的专项都写,表在归档那一刻定格。
- 接力命令:完结之后三步不变;第 3 步归档不了只剩锁两种;末尾打印的次序不变。
- 十态:十个态与次序不动;第 7、8 态产品经理的下一步去掉遗留去向那半句;不带计划名列清单时,后台没办完的新式专项挂一行「后台还在办」;结案报告多一栏「后台收尾」。
- 守卫验收完结那句回话(亲签与代签两处):去掉「把遗留清单发主控定去向、照它改好收尾单」与「去向都定过」,多一句复盘与去向在后台办;判断一个字没动。
- 文档 · 架构详图(文首版本改成 v12.0.0):§四 宪法对照表里运作方式一行多指一处;§八 清理归档 ① 与验收完结那句回话,收尾单 ② 的起草两次与「过程复盘进收尾单」,接力命令验收完结之后三步与守不到 ⑧⑪,十态一节新增后台没办完的一行,「复盘记录与收尾单里的表」,新增「后台收尾」一段(不挡什么、放哪、骨架、谁写什么、怎么看、守不到),提交命令带的台账与结案报告;§十四 十态表第 7、8 行及其后一段、结案报告;§十五 角色表的主控、项目经理、产品经理、复盘经理四行与执行体层表里「过程复盘」一行、「遇到顶层问题的两种走法」段尾;§十六「每次跑床记一行」里归档之后现跑的表与定格的表怎么对着看;§十七 术语表的复盘经理、过程复盘、收尾、结案报告几行。
- 文档 · 体系守护技能说明(版本 1.10.0)、开发流技能说明与计划模板页首:体系守护技能说明的 run、loop、retro、wrapup、review-brief 各节同口径换成「归档只问两把锁、复盘与去向在后台办」,retro 一节写明复盘记录放在主控线、认哪三个记号、骨架怎么建、归档之后现跑的表怎么取;开发流技能说明「先收尾」一条与计划模板页首说明里那一句换成同一个意思的新句子。
- 文档 · 决策记录加 ADR-124(写明取代 ADR-120 里「接力命令归档之前只多问一样『复盘记录里的结论写了没有』」那一半、ADR-106 里「遗留去向都由主控定过」那一半,旧条目一个字不改)。
- 守卫与体系守护技能 · 脚本与床(跟着被测对象同批):清理归档零件、接力命令、环态零件与帮助文字、守卫需求零件的完结回话(亲签与代签)同批改;清理归档、接力命令、十态、守卫完结回话(含守卫主自测里的两条)、计划模板几组床同批改写或新增,每条配改坏对照。
- 守不到(照实写,细目在 ADR-124):后台收尾被忘记,只靠十态清单与结案报告的显示和项目经理的巡检催;机器只核「结论:」「去向:」两个记号有没有字,写得对不对不核;骨架只在这一次调用真搬了计划时建,已归档的重跑不补、建不成只说一句,这几种按老式显示;归档之后现跑的耗时表读不到施工区副本里的跑床行,跑床那几项以收尾单定格的表为准;迟到的复盘记录和清单在下一次提交之前只在工作树里;治理站点上看不到迟到的结论;「下一步开工前插一条优化」的窗口缩小;站点发布仍攒着发时,下一条照样等那一批。
- 不动:提交命令、开工命令与开工条件、发布门、工作区地图、宪法。
- v11.0.x
发布提速:静态站点的发布前测试按整机预算开池同时跑(部署门入口照旧一张接一张);备份通过后发布档案的上传目录只留这一次真要写的文件,只传它们、assets 检查点也只核它们,没变的文件不传不核
设计指纹3de17c0a内容指纹49130466测试指纹ab0d51ed0ef79168改动设计 6 个(harness-engineering.md、ADR.md、SKILL.md、x-deploy-dev-arch.md、SKILL.md、x-harness-arch.md);代码 7 个(publish-tests.js、release.js、verify-feature.js、bed-runner.js、machine-budget.js、plan-run.js、harness.js)
需求发布提速签字 3d85已发布
为了:发布提速 —— 发布前那一遍测试同时跑起来,上传与核对只处理这一次新增和改动的文件,不再把全站每次都传一遍、核一遍。
- 升第一位:改写既有契约。两处:静态站点的发布前测试原先照旧一张接一张,现在按整机预算开池同时跑;assets 检查点原先对每个入口核首页那一组之外的每个文件,现在只核这一次真要写的文件,发布档案的上传目录在备份通过后也只留这些文件。其余是新增:「这一次真要写的文件」的现算口径、备份通过后收窄上传目录这一步。判决依据一个字不变:发布前测试的「全部通过才放行」「跳过不算通过」「测过的源码指纹前后比」,守卫的上传档案闸、部署门、发布前版本比对,检查点的名字与先后、命令,部署门入口与函数床的一张接一张。
- 发布前测试开池:发布库的发布前测试脚本调运行器时经
o.jobsAuto(连同o.jobsAutoNote)交进整机预算给的路数 —— 预算只取运行器旁边那一处(core/machine-budget.js),不另量、不另写系数;调用时才载入它(守卫另有一处也会载入发布前测试脚本,顶层多一个载入会连累它);读不出、或给的路数不是 1 以上的整数,就直接报错、不退回一张接一张;运行器自己再与这一轮真要跑的张数取小者,只剩一张就是一张接一张、不带追踪。池只决定哪些床一起跑,每张床发布前照样当场真跑;后台、手机网页版、官网、治理站点四个出口共用这一处,开池对四个都生效。部署门入口与函数床不带路数,缺省仍是 1,要在真函数目录里装配内核,不合批。 - 备份与上传只处理这一次真要写的文件:备份检查点照旧读全站(发布清单里的全部路径加首页那一组)、照旧留完整的回滚底本,并记下每个文件此刻的线上指纹;这一次真要写的文件按备份已记的线上指纹与本版发布清单现算 —— 首页那一组之外、线上没有或指纹不同的才是(首次上线就是全部),不新增存进发布记录的栏;备份的全部检查都过了,才把发布档案的 assets 目录收窄到只剩这些文件(没变的删掉、删空的目录清掉);发布清单与记录里的清单照旧记全站,换首页、清理、回滚都按清单算;上传仍从 assets 目录传,守卫的上传档案闸认的目录没变;要写的是零个就不传。重跑已定格的备份只核对备份目录与当时记下的指纹,上次崩在收窄中途的会在这里补完(收窄是幂等的)。
- assets 检查点只核这一次真要写的文件:默认域名与每个访问域名都只核它们(首页那一组仍留给切首页那一步);先默认域名再访问域名、访问域名先探路、两种不过的提示都不变;要写的是零个就核零个、算过;发布记录里的
checked与各入口核了几个,就是要写的个数。10-27 那两次治理站点发布之间真变的只有 90 个文件,全站是 716 个。 - 文档 · 架构详图(文首版本改成 v11.0.0):「跑床分道并发」一段里讲运行器的进程内调用缺省一张接一张的几处(一句话、开关与整机预算、每次跑床记一行)与指向决策记录的那一句,改成发布前测试开池、部署门入口照旧;§九「发布准备的全站引用核对与新文件逐入口核对」里 assets 检查点一条改成只核这一次真要写的文件并写明备份通过后收窄上传目录,「为什么是这两半」的结论句随之改,守不到加三条。
- 文档 · 技能说明与参考文档:部署技能说明(版本 3.8.0)与参考文档里讲备份、上传、assets 检查点的几处(技能说明里被部署技能自测逐字钉着的三处字面不动);体系守护技能说明(版本 1.9.0)与参考文档里讲运行器的进程内调用缺省一张接一张的几处。
- 文档 · 决策记录加 ADR-123(写明取代 ADR-121 决定①里发布前测试那一半、ADR-110 里「发布前测试照旧一张接一张」那一句、ADR-91 里逐入口各比一遍的范围)。
- 脚本与床(跟着被测对象同批):发布前测试脚本、发布库的发布脚本(备份通过后收窄上传目录、assets 检查点只核这一次写的文件)、唯一运行器 / 接力命令 / 开发流 VERIFY / 跑床命令帮助 / 整机预算脚本里写着「发布前测试不带路数」的注释与帮助文字同批改;对应的床同批改写或新增,每条配改坏对照(把「指纹不同」判成「相同」、核对把没变的也核上或把变了的漏掉、发布前测试不带路数,各自对应的床必须红)。
- 守不到(照实写,细目在 ADR-123):没变的文件不再核(它在访问域名那一头若被缓存弄坏,这一次核不到);备份到上传之间线上被别人换过版本,备份那一刻算出的「要写的文件」就不准(同一时刻只有运维经理一处发布,靠纪律);默认域名整个不通时,核对要对这一次写的每个文件各等满超时与重试才报(按约 90 个文件、6 路同时、每个等满 3 次 × 60 秒算,约 45 分钟),连接一直有零星字节进来却迟迟传不完的,没动静超时抓不到;发布前测试的池整体作废时退回一张接一张重跑,那一遍比不开池还慢;开池能省多少,前提是那几张起 git 的床已在池里,还在池外独占跑的省不到,用时的下限由池里最慢的那一张床定;静默仍盖到最后一次上传(每次往线上放新内容的上传都进部署门,要缩短得改发布出口的判决依据,不在这一版)。
- v10.0.x
派独立复盘只给一段程序生成的派发表头:审查官自己读账本目录里的说明文件,守卫派发时核提示词恰好是这段表头、复盘者收尾时再核表头并核它把说明读全了;说明全文不再抄进提示词,旧写法删除
设计指纹6eaa618b内容指纹4836c3d2测试指纹fd26c9afc8ad2ef3改动设计 3 个(harness-engineering.md、ADR.md、SKILL.md);代码 8 个(guard.js、requirements.js、verify-harness.js、plan-loop.js、plan-run.js、requirement-check.js、review-brief.js、harness.js)
需求床并行与床账签字 f250已发布
为了:床并行与床账 —— 派独立复盘只给一段短表头,审查官自己读说明文件,守卫核指纹、核它读全了。
- 升第一位:改写既有契约。派独立复盘的提示词由说明全文改成程序生成的一段短表头,旧写法被拦;守卫判法同批改写,并新增「读全」。其余是新增:表头函数、读全判定、术语表里的「派发表头」。两个裁判各判什么、三条主流程的闭环、结论行的格式、连着三次不过要用户发话、只派对抗审查官、型号、不带名字、续跑与去重都不变。
- 表头与说明生成程序:复盘说明命令的标准输出只印一段几行的派发表头(任务编号、计划名、结果单编号、说明文件的位置、怎么读并写明共几行),说明全文照旧写进账本目录、不再打印;表头由守卫需求零件里一个函数按账和说明文件现算(账与说明文件读得出且编号合法、说明文件第一行等于由账拼出的标记行、说明正文现算的指纹等于账里的编号,三条任一不成立就没有表头),说明生成程序、接力命令、守卫三处都调它;口径写死:说明文件 = 标记行 + 两个换行 + 正文 + 一个换行,指纹算正文(去掉第一行、一个空行和末尾那一个换行),「最后一行」是按换行拆开、去掉末尾空串之后的行数(新增
briefLinesOf);说明文件与账的文件名后缀、说明正文的指纹和标记行的拼法也收进需求零件。写不进账本目录、或现算不出表头,命令退出码 1、什么都不印。 - 接力命令与环态:七步走完,末尾先印一句说明、一条分隔线、同一段派发表头、一条分隔线(免得复制时多拷旁边的说明句和环的态),再印环的态,最后一行仍是复盘说明的编号;生成复盘说明那一步多核「现算得出派发表头」;环的第 4 态「下一步」改成「拿接力命令末尾印出的派发表头派独立复盘,等复盘结论入账」。
- 守卫派发这一关:提示词须逐字等于此刻现算的表头才放(只忽略首尾空白与换行风格),计划名从对上的那一份取;抄说明全文、表头里改字或加减一句、改计划名、说明正文被改过、账或说明文件不在、生成之后又重新生成都拦,报文只有一条固定话,以「复盘任务的提示词必须原样是程序生成的派发表头」打头,后面写怎么办(先跑复盘说明命令、把印出来的表头整段原样当提示词、说明全文审查官自己读);带名字、类型、型号、账本被改过、连着三次不过这几道原样。
- 守卫收尾这一关与读全:可信条件里「提示词逐字等于说明全文」换成「逐字等于此刻现算的表头」,再加一项「读全了」—— 看复盘者的执行体记录:记录里读这份说明文件的调用(调用参数里的文件路径整串相等或以「/」加仓根相对路径结尾)与它们的结果、各次读到的行号取并集盖住第 1 行到最后一行(空行不能丢、幻影行不碍事、漏最后一行判没读全)、读到的首行任务编号对得上账里的编号,搜索工具与命令行读的不认(它们的调用里没有
file_path);读取情况的取法单独成readCoverageIn;守卫收尾那一支调读全判定时再包一层 try。没读全那一笔照记、标不可信、不计入连败,回话分五种说(没有对说明文件的读取;读取都报了错;有读取但一行行号都认不出,话里写明「报 X大脑」;第 N 行起没读到;首行编号不符),函数自己出错说「读取记录判不了」。 - 说明正文与三查里那句话:说明正文的预算句改成不计读这份说明本身的几次,纪律里加「不要运行复盘说明命令或接力命令重新生成说明」;不可信的原因不落账、只在复盘者收尾那一刻守卫回的话里,所以三查里的「最新复盘不可信」改成不指某一个原因、列出可能的几种(履历里的那一句不动)。
- 旧路删除:整份说明比对、命令打印全文那一路、接力命令末尾「拿复盘说明原样派」那句、各处说明里「原样当提示词」的话、床里拿整份说明当提示词的夹具,一并换成表头;不并存,不留折叠版。
- 文档 · 架构详图(文首版本改成 v10.0.0):守卫通道图里复盘派出那一道,「第一次」「第三次独立复盘抓出的修补」两处,复盘判法一段的预算与纪律句、复盘说明写明车道一段末句,接力命令一段(末尾印表头、产物核对),「复盘进关口」整段重写(表头与口径、派发这一关、可信条件、读全、从生成到收尾说明被改了怎么判、守不到七样),环的十态表第 4 态,术语表加「派发表头」一条。
- 文档 · 体系守护技能说明(版本 1.8.0):「run」一节讲接力末尾印派发表头、守不到与决策记录指针,「review-brief」一节整段改成表头的说法。
- 文档 · 决策记录加 ADR-122(写明取代 ADR-87 边界里「提示词逐字等于程序生成」这一半)。
- 守卫与体系守护技能 · 脚本与床(跟着被测对象同批):守卫需求零件(表头、读全、派发关)与守卫主文件复盘者收尾那一支、复盘说明生成程序、接力命令、环态文字、帮助文字、三查里那句「不可信」的话同批改;对应的床同批改写或新增,每条配改坏对照。
- 守不到(照实写,细目在 ADR-122):审查官读的过程中说明被换成别的内容、读完又换回原样;「读全」靠执行体记录里读文件工具结果的写法,平台改了写法会把复盘全记成不可信(往安全的方向错),床里的夹具抓不到平台以后的变化;读全不等于读懂、读对;用搜索工具或命令行读说明的不认;平台安全检查会不会连几行的表头也拦保证不了,拦了就停下报 X大脑;派出之后不能续跑审查官;不可信的原因不落账,三查只能列出可能的几种,履历里「结论不可信」那一句沿用固定写法、不分原因。
- v9.0.x
床并行与床账:跑床缺省按整机预算开池同时跑(只选中一张、运行器的进程内调用照旧一张接一张),追踪器认得更多的「干净」,守卫主自测拆成按组同时跑的几张床,副本跑出的床账按指纹收回真仓,改坏对照按点跑,施工区副本里的运行时账与射程缓存和真仓同级写保护,每次跑床记一行、耗时表数得出并行度与 CPU 占用
设计指纹970be1ae内容指纹ab8cf4ca测试指纹16d5d5fd4184e35b改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、x-harness-arch.md);代码 14 个(command-policy.js、test-faces.js、verify-harness.js、verify-feature.js、bed-runner.js、bite-stub.js、write-trace.js、plan-retro.js 等)
需求床并行与床账签字 5d7f已发布
为了:床并行与床账 —— 让测试同时跑起来、重复的不再跑:运行器缺省按本机的 CPU 与内存开池同时跑,副本里跑过的结果能带回真仓,守卫那张最大的测试拆开同时跑,改坏对照按点跑、按指纹记账,每次跑床量出并行度和 CPU 占用、低了在耗时表上亮红旗。
- 升第一位:改写既有契约。跑床的命令行入口与开发流 VERIFY 的缺省由一张接一张改成按整机预算开池;施工区对写保护答「不保护」收窄,副本里的跑床账与射程缓存除外。其余是新增:整机预算、追踪口径表与准入册版本、守卫主自测的组表与分块床、床账收回与改坏栏、改坏对照、每次跑床记一行。两个裁判各判什么、空壳对照与发布前测试的口径、三条主流程的闭环、五类架构都不变。
- 整机预算与缺省开池:新增
core/machine-budget.js(路数是按逻辑核数算的与按空闲内存算的两者的小者,夹在 1 到 16 之间;系数只写这一处,放在运行器判定口径区之外,改系数不作废别的床的旧记录)。跑床的命令行入口不带--jobs时取它交给运行器,运行器再与这一轮真要跑的张数(--stale沿用掉的不算)取小者,只选中一张时照旧一张接一张、不带追踪(封版命令逐张补跑因此一字不变);--jobs放宽到 1 到 16,池上限 16;接力命令与开发流 VERIFY 起床时不再写死路数;运行器的进程内调用(发布前测试、部署门入口)缺省仍一张接一张,一个字没动。系数的定法是机器静时整仓各跑 8、12、16 路量拐点:本机量到拐点在 12 路上下,缺省取比它小一路的保守值,系数没动(量到的数记在 ADR-121)。 - 追踪器与准入册(追踪口径第 2 版,放宽):认得更多的「干净」—— 只读 git(子命令取守卫只读 git 名单
GIT_RO的子集;子命令之前的开关是封闭清单,只认-c白名单键、--no-pager、--no-optional-locks;追踪器注入GIT_OPTIONAL_LOCKS=0;载入之后才出现的起程序的环境变量判脏)、不带改写开关的 oxlint、整串只是一条 node 命令的 shell 形态(fork的execPath不是当前 node 的不算)、床里再起的运行器沿用外层的令牌、床自己在测试根下按现成写法建的zzharness-、zzmeta-沙箱(进程号在这张床的进程树里、跑完已不在)。准入册带口径版本,运行器里一张口径表写明每一版是放宽还是收紧:跨过的全是放宽只作废判脏的结论,跨过收紧全部作废。 - 守卫主自测拆块:驱动
verify-harness.js拆成 27 组,组表写在驱动里,--groups、--list-groups按组挑着跑、印组表;床是原路径verify-harness.test.js一块、verify-harness-blk1到blk5五块、探针小床verify-harness-probe.test.js(往真仓放东西的两组,持锁、永远独占)、核对床verify-harness-groups.test.js(各块点名的组合起来恰好是全部组);不按改动挑块。 - 床账跨根:造副本带上真仓的床账与准入册、补环境(手机端包、根层依赖);换入之后同一个进程里拿跑床锁,让判定模块在真仓里重算指纹,副本账里指纹逐张相同的条目收进真仓、对不上的不收、同一指纹两边都有记录时红的算数,拿不到锁换入照常成功、收回跳过并明说;账里每张床的记录多一栏改坏栏。
- 改坏对照:
harness.js --action=beds --bite-list=<改坏清单文件>,运行器在沙箱里按点替换着跑(守卫、模块、判据三样,几路同时跑),结论按「床 + 被改文件 + 两者此刻的内容指纹 + 点号」记进改坏栏,内容没变的点不重跑;改坏栏不参与「过没过」的判定。 - 施工区写保护的例外:副本里的
.claude/tmp/ledger与.claude/tmp/.scope-cache照真仓写保护(编辑工具与命令行都写不了),副本里别的文件照旧不保护、照旧能写;守卫命令判定模块同时导出GIT_RO。 - 记一行与耗时表:运行器每真跑了床往
.claude/tmp/ledger/bed-runs/<日期>.log记一行(起止、几路、几张、进池与独占、跑了哪几张、床自报用时之和、整机 CPU 占用、哪个会话、哪个仓根);耗时表只读这些行(真仓里的按办理会话认,施工区副本里的就地全算),加「跑床并行度」「跑床期间 CPU 占用」两项,红旗验收之后按 8 条门槛查、在办期按 3 条,并行度低于 3、CPU 占用低于 40% 才亮(跑床墙钟合计不到 10 分钟不判),「同一张床跑得太多次」按运行器记的行里的床清单数;「独立复盘」一段没有派出记录时从审查官在会话账里第一笔带执行体名的动静起算。 - 文档 · 架构详图(文首版本改成 v9.0.0):§八「项目自带」讲造副本带账与补环境、换入收回、施工区写保护的例外,「过程复盘的耗时表与红旗」改成按运行器记的行算(两项、8 条与 3 条门槛、独立复盘起点、守不到改成现状),接力命令与 VERIFY 不写死路数;§十六「唯一运行器」一段加「跑床只经唯一运行器」,「跑床分道并发」改写(整机预算、认得的干净、仓内沙箱、口径版本、记一行、守卫主自测拆块),新增「床账跨根」与「改坏对照按点跑」,诚实边界加 ㉙,两处整张守卫主自测的总说法对表。
- 文档 · 体系守护技能说明与参考文档:技能说明(版本 1.7.0)讲路数开关与缺省、「跑床只经唯一运行器」、记一行、改坏对照、红旗、造副本、换入收回;参考文档里跑床缺省的说法同批改。
- 文档 · 决策记录加 ADR-121(写明取代 ADR-110 决定①里缺省的一半与决定②里「干净」的两处、ADR-112 决定④里写保护的一半、ADR-120 守不到里一条)。
- 守卫与体系守护技能 · 脚本与床(跟着被测对象同批):守卫命令判定模块(脊柱谓词、
GIT_RO)、判定模块test-faces.js(改坏栏三个导出、收回副本账)、驱动与它拆出的床;运行器、bite/(write-trace.js、新增points.js)、harness.js、machine-budget.js、造副本与换入两个动作、耗时表生成器、接力命令、开发流 VERIFY 同批改;各自的测试床同批新增或改写,每条配改坏对照。 - 守不到(照实写,细目在 ADR-121):追踪器对起程序的环境变量只比载入时的快照,
HOME、PATH一类没列,git diff在不写索引的环境变量下仍可能刷新索引,git -C判脏所以两张用它的床留在独占道;池协调器杀进程树时用同步调用、期间已退出的好床可能被记超时,守卫目录里team-gates.test.js的 T5b 在池里偶尔红(独占绿,已登记独占,原因没查清);收回只认指纹逐位相同、证明不了环境相同,收回等锁最长 45 分钟而工具里单条命令最长 10 分钟;写保护的例外只按路径字面判,把副本里的.claude/tmp整个挪走再写拦不住,工作区地图仍把施工区写成不受写保护;几个会话、副本与真仓同时跑床时各按整机预算开池、合起来会超,直跑只写进说明、不拦也不数;并行度含运行器自己的开销与池里排队,CPU 占用是整机的;plan-wrapup.js一处注释还写着「六条红旗」。
- v8.1.x
复盘经理:每个专项验收完结之后,由新设的复盘经理复盘这一程 —— 耗时表与红旗由机器出,结论与发现收进收尾单,结论没写不归档(不挡验收和发布);会话命令多认「用时起、用完关」一类角色;十态对在办的需求多打一行红旗
设计指纹ef5558df内容指纹c25a1c4a测试指纹e9e89eb9b9e390d2改动设计 4 个(CLAUDE.md、harness-engineering.md、ADR.md、SKILL.md);代码 7 个(plan-loop.js、plan-run.js、plan-wrapup.js、session-ctl.js、session-registry.js、harness.js、plan-retro.js)
需求复盘经理签字 6b28已发布
为了:复盘经理 —— 每个专项验收完结之后,由复盘经理把这一程的过程复盘一遍(补上 PDCA 的 A):机器先出耗时表和红旗,复盘经理按这条专项的档写结论与发现,发现先过一次减法审、再由 X大脑 逐条定去向,复盘记录收进收尾单,结论没写就不归档,但不挡验收和发布。
- 升第二位:新增一类东西。一位只作会话用、用时起用完关的复盘经理,一个只读的耗时表命令,收尾单里的一节与一个来源,接力命令归档之前一道轻的前提;既有契约一个字没改写 —— 三条主流程的闭环、五类架构、十态的名字与次序、收尾单五栏的名字与认法、签字与开工、发布与提交都不变。
- 复盘经理:每个专项验收完结时由项目经理起一位复盘经理复盘这一程(和发布同时进行、不加等待;几条同时完结时一位接着做下一条,都做完、它报完结果之后由项目经理关)。它跑耗时表那条只读命令,照这条专项的档写结论与发现(小事一句结论、红旗只照实写成发现;成条的事有红旗才深挖;难事一律深挖),只写专项计划目录里的复盘记录
RETRO.md,报 X大脑;不定去向、不派执行体、不改别的文件、不碰线上。独立复盘仍只派对抗审查官,两样不混。 - 会话命令多认一类「用时起、用完关」的角色:名字固定叫「复盘经理」,起它要带专项名、握手内容写明复盘哪一条,型号按角色给(与项目经理、运维经理、产品经理同属 Sonnet 那一类),登记册记它;列会话时不点名它不在,恢复时不自动拉它,用完用原来的停与删关掉。九个子动作不变。
- 耗时表命令与红旗:体系守护多一个只读动作
retro,对一条专项出耗时表与红旗;不写任何文件、不起子进程,命令原文一个字都不打印。表里是各段耗时、各执行体从第一笔到最后一笔、跑床、收尾环、拦截按原因计数、跑得慢的命令,另有「休眠」——全仓所有会话的台账同时一笔都没有、也没有命令在跑的长空档(关机、睡眠),单列时长,不算等待、不算卡住。红旗的门槛只写在生成器一处:验收之后六种(某一段超这一档的时长上限、同一张床跑得太多次、同一种拦截出现得太多次、一条命令跑得太久、两笔动静之间空得太久、独立复盘不止一轮),在办期只认其中三种(拦截、命令、空档),因为接力命令反复跑床是常态,同一张床和某一段超上限在办期会常亮。 - 十态:对在办的需求(开了工、没完结)用同一个生成器的在办期口径算一遍,有红旗就多打一行;排队的、已完结的不打。十态的名字、次序、各自的认法一个字没动。
- 收尾单与归档:第一栏「用时」那一行后面多一节「过程复盘」,表由接力命令每次刷新时从账本现算(不从复盘记录里抄),再接复盘记录里的结论;发现放进第三栏、每条标「过程:」,去向与别的遗留同一个办法。接力命令归档之前多问第三样:复盘记录里那句结论写了没有(只核写没写);发现的去向不另挡,由「去向都定过」那一样管,架构师的改法不挡;直接手跑归档的执行开关和以前一样不问。没有复盘记录的计划,收尾单和以前一模一样。
- 发现的去向:发现先过一次复杂化审查官的减法审,再由 X大脑 逐条定「下一步开工前插一条优化 / 排进清单 / 不立」,门槛严(会让接下来几步做错、或每一步都要多花不少时间的才插),与停线、记一笔同一个口径;判法只写在架构详图「遇到顶层问题的两种走法」一处。
- 文档 · 宪法:§四「运作方式」加半句 —— 每个专项验收完结之后,由复盘经理复盘这一程。
- 文档 · 架构详图(文首版本改成 v8.1.0):§十五 角色表加「复盘经理」一行,主控、项目经理、产品经理三行各改几句,执行体按层表加「过程复盘」一行;「常驻会话与会话命令」「会话登记册与恢复」讲这一类角色;「遇到顶层问题的两种走法」加过程复盘发现的判法;§八 新增「过程复盘的耗时表与红旗」一段,「清理归档」「收尾单与治理站点一格」「接力命令」「环的十态」几处同批对表;§十七 术语表加「复盘经理」「过程复盘」,入口表执行体一栏补上复盘经理。
- 文档 · 体系守护技能说明:讲会话命令、接力命令、十态、收尾单与清理归档的几句同批对表,新增 retro 一节(耗时表命令的用法、表里各项、红旗、休眠、复盘记录的固定写法)。
- 文档 · 决策记录加 ADR-120(为什么新设一位经理而不是新增一条流程、为什么挡归档只挡一样、守不到的几样)。
- 体系守护技能 · 脚本与床(跟着被测对象同批):会话命令与登记册认这一类角色;新增耗时表生成器与它那条只读命令,十态多打在办期的红旗一行;收尾单刷新时收进复盘记录,接力命令归档之前多问结论写了没有。新床
plan-retro.test.js用造好的小账本对拍各段耗时、计数、红旗与休眠,每条门槛两边各一条;会话命令、登记册、收尾单、接力命令、十态的床同批改,新运作的文字对表床把宪法那半句和术语表里的两个词加进去;每条配改坏对照。 - 守不到(照实写,细目在 ADR-120):结论写得对不对、挖得深不深,机器不判,只核写没写;卡住的命令账本里看不见,只能用多久没动静近似;跑床账只记每张床最近一次的结果、没有逐次历史,「同一张床跑得太多次」这条红旗要等账里带上逐次记录才会亮;休眠把「机器开着、全体会话却都在等」的长空档也认成休眠,命令跑到一半机器睡了,那一段算进这条命令的时长;用户在控制台里手工做的步骤账本里没有;复盘经理写的结论与发现原样进收尾单、会随治理站点公开,贴不贴命令原文由它的定义管、机器不过滤。
- v8.0.x
代签到底:验收一签同时授权发布与提交,机器按项目名提交并出结案报告,签字与开工分开,命令行里的 git 一律只读
设计指纹37618304内容指纹cb403e8e测试指纹598d83d3342a2b86改动设计 8 个(CLAUDE.md、harness-engineering.md、ADR.md、x-dev-rule.md、x-meta-rule.md、SKILL.md、SKILL.md、SKILL.md);代码 26 个(guard.js、assembly-face.js、command-policy.js、project-archive.js、requirements.js、session-ledger.js、stop-handler.js、trial.js 等)
需求代签到底签字 c912已发布
为了:代签到底 —— 签字一之后,验收、发布、归档、提交、结案报告全程不再等用户:验收那一签同时授权这条需求的发布与提交,签字一可以提前签好几份、开工才占版本单元。
- 升第一位:改写既有契约。四处:① 验收完结那一签(亲签,或照代签设置代签)同时授权这条需求该发的每一格各发一次(出问题立刻回滚算同一次)与它的提交,授权不再因这条需求是不是只发治理站点而分两种,所有格一个口径;② 提交只经一条受信的提交命令,命令行里的 git 一律只读;③ 签字与开工分开:签字一可以提前签、一次签好几份,开得了工当场开、开不了排队,开工才占版本单元、放行写、算在办,占到这一条提交完;④ 项目架构环的启动改成开工那一刻,守卫各处的「在办」改指开了工的。
- 授权的口径:亲签的凭 X大脑 转来的验收原话(运维经理动手之前到原话账本只读核一遍),代签的凭代签记录(命令里带需求名与「代授权」标记,机器核)。不随某条需求验收而做的发布(重发、每天的站点、回滚到更早的版本)、生产构建、开发中途的联调授权,另要授权。
- 代授权发治理站点:带「代授权」标记的发布,治理站点那一支问「这条需求有没有治理站点一格」,不拿站点自己的源码目录去对落点表;这一格有没有的判法只有一份,住守卫的联调零件,发布登记转调它,部署门、云函数脚本出口、静态站点发布准备三处问同一个。答有、没有、判不了三样:授权门把判不了当没有、拦下并说判不了,发布登记把判不了当有。后台、手机网页版、官网这些别的站点按落点表够不够得着原料目录认,「要发的内容等于验收那一刻」那一道对所有站点一样。
- 提交命令与命令行里的 git 只读:体系守护技能多一个提交动作,环收尾之后由主控跑,不带执行开关只预览。跑之前依次核五样(已完结且完结那一笔记着要提交、环收尾成立、还没提交过、在主干上且暂存区里的路径都在这一次要提交的清单里、交付的每个文件仍是验收那一刻的内容或库里已有验收之后提交的版本),哪一样不过就停、什么都不写。只提交这条需求验收过的交付、它的履历与归档和台账,不带别的需求还没走完的东西;钥匙石与代签设置从不提交,与库里不一样时每次点名,等用户亲手看、亲手提交。提交说明三段,打带说明的项目标签,只推主干与这个标签,原子推送、只许正常推;被拒、断网、缺凭据、超时都留在本地、重跑补推;做到一半出错的从缺的那一步接着做。提交命令受写保护、算判决依据,不认换守卫目录的环境变量与命令行换仓根。守卫的命令判定不分是不是办理会话,命令行里的 git 只放只读子命令(symbolic-ref 只放读一个名字),提交与推送只经提交命令,退回、重置永远不做。
- 存档点退役与换入帮手的「删」:存档点提醒整个退役(它的零件与床、守卫收尾放行出口那一处接线、会话台账里那一类记账与计时里它那一段、回归套件里的登记),收尾时不再对用户说「可以存档」;换入帮手多一个「删」——清单里标删的受保护文件先备份、问同一份放行、再删,恢复时放回。
- 结案报告:十态命令带计划名查一条已提交的需求时,末尾印五行加一行提交号(交付了什么、发了哪几格、还要用户自己上传的端、遗留去了哪、代签凭什么,以及提交号、标签、推没推到远程),全取自履历、发布段、收尾单与账本;十态命令查已完结的需求时多一行提交;第 10 态的下一步改成主控跑提交命令、项目经理拿结案报告转 X大脑。
- 签字与开工分开:签字一不再被单元挡。开工条件三样(签字那一刻与开工命令判的是同一个函数):要占的单元上没有开了工没完结的需求、也没有完结了还没提交的;碰判定代码时没有别的开了工没完结的需求也碰着;仓里没有已完结还留在计划目录的需求。三样都满足,签字那一刻就当场开工,账本里那一笔与普通的确认一模一样;有一样不满足,记成带「排队」标的确认——不占单元、不放行写、不算在办,也不拒签。「开没开工」只有一个判法(账本里有「开工」那一笔,或有一笔确认不带排队标);已经开了工的重签只查新加的单元与新碰到的判定代码,不退回排队;完结了没提交的占用者从账本认。开工命令由主控或项目经理跑,不带执行开关只预览,核过四样(签了字一、还没开工、签字没作废、账本可信)与开工条件三样才记开工基线与开工那一笔、叫醒这条需求的产品经理,受写保护、算判决依据(「三查」那一样)。一道确认题的多选放开,同一个版本单元上的几份也能一题签。十态不加态,排队并进第 2 态「已立项」,环的启动改成开工那一刻;每次回话另点名「待提交」「待补推」,「待清理归档」那一行的后果半句写「开不了工」。
- 守卫其余各处按开工认在办:状态表多一个「排队」;只认在办才放行的读者自然排除排队的;取反型的读者(验收完结、代签、验收区、出题、排队一览、十态、复盘说明、封版绑需求的作废那一支)显式补「还没开工」一支;直读确认那一笔的(基线、联调零件里计划不见了从账本认在办、履历的总用时)问「开没开过工」与开工基线;排队的需求不挡正式发布、开不了联调,发布登记不给它记联调,核准过程改动时不查单元占用与判定代码占用。排队一览改成五段:占着的、排着的、此刻开得了工的、卡在收尾归档与提交的、判定代码谁在改。
- 文档 · 宪法:§四 运作方式写确认可以提前签好几份、开得了工当场开、开不了排队,同一处同一时刻只开工一条(占到上一条提交完),开了工才动受治文件;§六.8 写确认后开了工再动受治文件、验收完结的那一签同时授权这条需求的发布与提交、不随这条需求验收的线上写入每一次都要授权、按项目名提交只经受信命令。
- 文档 · 架构详图(文首版本改成 v8.0.0):§一 最后一道人闸;§二 提交权、最后人闸、钥匙石、代签与诚实边界;§三 全景图里签字那一刻、命令行里的 git 与部署门几行;§六 体系守护技能的命令清单加提交命令;§八 环1 的 git 判法、提交命令、结案报告、签字与开工分开、同一块排队、收尾与归档、认车道、定档、部署门认联调(含 ⑮ 代授权的发布与联调)、待提交与待补推的点名、环的十态、一题签几条;§十三 为了哪条需求;§十四 十态表(第 2、3 态与第 7、9、10 态)、环的启动、环收尾之后的提交与结案报告;§十五 角色表(需求方、主控、项目经理、产品经理、运维经理)、提速八条规矩、车道表「走哪几步」加开工、签字机制、「谁来发布、怎么授权」;§十七 术语加开工、排队、提交命令、项目标签、结案报告,改阶段、环、判决依据与判定代码、代签等条目,入口表下通则 ④ 的一句,口径统一。
- 文档 · 决策记录:加 ADR-118(代签到底:验收一签同时授权发布与提交,机器按项目名提交;取代 ADR-05 的后一半、ADR-15 的一句、ADR-98 与 ADR-116 里「只发治理站点的需求才连带授权」的口径)与 ADR-119(签字与开工分开:取代 ADR-94 的同一块排队、ADR-97 的收尾与归档硬控、ADR-106 的改判定代码同一时刻只办一条这三道在签字那一刻「签不上」的那一半,以及 ADR-98 里多选要求落点单元互不相交与环启动的定义),旧条目一个字不改。
- 文档 · 体系守护技能说明:record-release 一节的「治理站点」一格写明判法住守卫、判不了往哪边错;trial 一节的代授权的联调与发布加治理站点按有没有这一格认与守不到;ask 一节写验收题的授权句与确认题的半句、签了之后是当场开工还是排队;代签连带发布与联调一句改口径;多一个 commit 一节与 start 一节,queue 一节改成五段,run、loop、reconcile、wrapup、approve、swap-in、session、sign 各节讲排队、开工与提交的说法同批改。
- 文档 · 统一开发技能说明、开发规则书与元治理规则书:统一开发技能说明的生命周期说明与各阶段提示里「签字一签上之后才动受治文件」改成开了工之后,同一块排队一段改成签字与开工分开;开发规则书开篇「先过需求闭环」与业务流程三档表「走哪几步」加开工,开发期联调上线里在办的读法同批改;元治理规则书里两处「你审 commit」改成独立复盘与验收把关。
- 文档 · 部署技能说明:描述一行与激活场景开头一句里的授权括号、顶部「发布授权约束」的授权口径与治理站点的授权怎么算、发布面总表与激活场景表里治理站点两行、「代授权的联调与发布」一节(治理站点按有没有这一格认,加守不到)、绝对禁止里的授权一条,同一个口径。
- 守不到(细目在 ADR-118、ADR-119):亲签那条路机器不核转来的是不是用户的原话;治理站点这一支只信履历里记的落点表,不核它与盘上的文件对不对得上;脚本进程里直接调 git 守卫看不见,凭据管理器在本机的真实行为床里造不出来;账本追加没有跨进程加锁,签字与开工、两次开工同一时刻判同一个单元可能两条同占;不同单元的两条可以同时开工,先完结的那一条的发布要等另一条把它的单元封了版;排队久了的计划可能要重签。
- v7.1.x
会话型号按角色给:两位架构师的会话用 Opus 5.5,其余会话用 Sonnet 5.5,推理档仍是最高
设计指纹b20af7a8内容指纹006baca2测试指纹ff5455bd20ef88fa改动设计 3 个(harness-engineering.md、ADR.md、SKILL.md);代码 1 个(session-ctl.js)
需求会话型号签字 d3d2已发布
为了:会话型号 —— 额度有限,会话命令起的会话里只有出设计的两位架构师需要最强型号,所以起会话时按这位的角色带型号,起完对着横幅按角色核。
- 升第二位:设计内容变了(会话型号从全部用同一个型号改成按角色分),没有改写既有契约 —— 会话命令的九个子动作、固定句、命令的固定形状(只有型号这一项随角色)、登记册、权限档与设置都不变。
- 文档 · 架构详图(文首版本改成 v7.1.0):§十五「型号与推理档」整句换成按角色分,角色到型号只写在这一处 —— 两位架构师(产品架构师、Harness架构师)Opus 5.5,其余(项目经理、运维经理、各专项的产品经理)Sonnet 5.5,推理档仍是最高;子代理照项目设置仍是 Sonnet 5.5,被派出去当执行体的架构师也是执行体、同样跑 Sonnet 5.5;X大脑 的启动命令不变。会话命令表里
start一行的命令形状与核横幅的型号同批改成按角色。 - 文档 · 体系守护技能说明:会话命令「发起」一段的型号改成按角色给并指向架构详图那一处,核横幅的型号按这位的角色核;叫醒一段不动。
- 文档 · 决策记录加 ADR-117(取代 ADR-116 里讲会话型号的那一半,旧条目一个字不改)。
- 体系守护技能 · 会话命令与它的床(跟着被测对象同批):会话命令里写死的型号常量换成一份名单式的规则 —— 名单里是两位架构师,起成 opus,其余起成 sonnet;起完核横幅里的型号家族,不是这位角色该用的就当失败,照旧停删、不登记,报文写明这位角色要哪个型号。守着它的会话命令床同批改:夹具里的假横幅可以给另一个家族,遍历角色逐个发起核命令行的型号,每个角色各用另一个家族的假横幅发起都失败;每条配改坏对照。
- 守不到(照实写,细目在 ADR-117):平台收不收
--model sonnet、Sonnet 会话的横幅写成什么,床里只用假的 claude 命令,没有实测,第一次起 Sonnet 会话时要看一眼横幅;对不上时命令按设计把刚起的会话停掉删掉并点名原因,不会留下错型号的会话。
- v7.0.x
新运作:会话由系统用官方后台会话自己发起 —— 四位常驻(项目经理、运维经理、产品架构师、Harness架构师)各管一摊,每个专项一位产品经理会话从立项到归档端到端负责(取代「工作会话」,运维经理取代「部署会话」);会话命令九个子动作与会话登记册;签字记录只认用户的原话与代签命令两条路,代签设置与验收谁签;开闸改成签字一授权、到时机器放行;复杂化审查官与宪法「禁止复杂化」;「框架架构」改叫「Harness架构」;架构详图、决策记录 ADR-116、开发规则书与各技能说明同批
设计指纹411dc996内容指纹80f587b0测试指纹18a6c52c9e5f628a改动设计 17 个(CLAUDE.md、harness-engineering.md、ADR.md、x-dev-rule.md、SKILL.md、SKILL.md、SKILL.md、admin.md 等);代码 41 个(guard.js、command-policy.js、project-archive.js、requirements.js、session-ledger.js、stop-handler.js、test-faces.js、trial.js 等)
需求新运作签字 ce76已发布
为了:新运作 —— 项目不再靠用户亲手开窗口才能往前走,各位的叫法对上他们管的那一摊,harness 里用户无从自行验收的东西不再逐条等他点头,开闸跟着签字一走、到时机器放行。
- 升第一位:改写既有契约四处。① 签字记录:此前只认用户的原话,现在只认两条路,用户的原话与代签命令;验收完结、验收后的发布授权、开发中途的联调授权在用户设置允许的类别里可由 X大脑 代点,签字一(需求确认,同时是开闸的授权)与改代签设置永远只归用户。② 开闸:此前是用户手动改名停掉整个写前拦截,现在跟着签字走 —— 签字一授权,实施中守卫照常在岗、只对这条需求的办理会话放行它签过的受保护文件,完结、归档、签字作废自动收回,手动开闸只在急救时用。③ 运作方式:会话由系统用官方后台会话自己发起,四位常驻会话各管一摊,每个专项一位产品经理会话端到端负责,设计由两位架构师出,X大脑 收窄成首席产品官;宪法 §四 运作方式整段、§六 第 8 条讲两次签字与单次授权的几句随之改写。④ 叫法:五类架构里的「框架架构」改叫「Harness架构」,「工作会话」「部署会话」改叫产品经理、运维经理。同批升版:agent 架构升到 v3.0.0、项目架构升到 v5.0.0,各自的变更历史里写。
- 体系守护技能 · 会话命令与会话登记册(新):
harness.js加--action=session,九个子动作 —— 登记主控、发起、叫醒、停、删、恢复、列表、重建登记册、改名;实现在scripts/core/session-ctl.js与session-registry.js。命令由脚本用参数数组直接起claude、不经 shell;发起时全部参数带齐(执行体、Opus 5.5、最高推理档、免确认权限、不进工作树的设置),发起后到会话列表里核对、型号看横幅;写前拦截没接上线时发起、叫醒、恢复一律拒绝;任何一个活着的同名会话在时拒绝再起,同一条需求已有活着的产品经理时拒绝再起;会话名是「需求短名-类别-档」(四位常驻按固定名字),对不上规则的拒绝。送进会话的话只许是一处常量里的固定句,握手、转话、叫醒的原因一律经 SendMessage;叫醒与恢复一律不带任何参数,只用claude --resume 完整会话号 --bg 固定句这一个形状(带任何参数续上都会复制出同名副本,回执出现副本当失败、停掉删掉、报主控);恢复默认只预览,执行时只拉停了、失败、干着活的;改名是先停、再不带参数续上、首句写「/rename 新名」,会话号不变,新名由登记册里的短名、类别和档拼出、不收自由文本。会话登记册住.claude/tmp/sessions/、用户目录里镜像一份(和平台自己的会话名册是两回事),原子写、带递增序号、锁带进程号和时刻可抢,只存完整小写会话号、名字、角色、哪条需求,状态不存、现查;除登记主控、列表和恢复预览(只读)、重建登记册(要用户亲口说固定话)之外,每个子动作只有登记册里的主控或项目经理跑得了;登记主控只认会话列表里种类是交互、名叫 X大脑 的那一个,换主控与重建登记册都要用户亲口说固定话,只认新鲜的、同一笔原话不能用第二次;官方输出缺字段时报错、不硬做。 - 守卫 · 七处判法,其余判法与放行规则一行不动:① 用户说的话恰好等于固定句时,不记进原话账本、不认作签字(固定句与受信命令共用一处常量
guard/session-phrases.js,句子后面多一个字就照常记);② 任何会话不经受信脚本直接跑claude一律拦,不分是不是办理会话;③ 会话登记册目录加进写保护名单,新写的判决模块(会话命令与登记册session-*.js、代签设置与代签命令sign-*.js)同批进脊柱写保护;④ 签字记录只认两条路(用户的原话、代签命令),代签、改代签设置、重建登记册、换主控四条敏感命令另按钩子输入里的agent_id拦执行体,只有主控本人的会话跑得了;⑤ 代签设置文件加进写保护名单,工作区地图的数据文件声明它所在的区(不受治、受保护、入库);⑥ 部署门、各条发布出口与联调判定认代授权的标记和代签记录;⑦ 写保护文件对签过字的办理会话放行、其余照拦。守卫文件里报文与注释的旧叫法同批换成现行叫法。 - 代签设置、验收谁签与代签命令(新):代签设置放在
.claude/sign-settings.json(不归任何版本单元、不升版不封版,文件缺了、读不出或写得不对一律按亲签),两个开关按专项类别分 —— 产品专项(类别写「产品」的需求)、Harness专项(类别写「Harness」或「规范」的需求),运维、分析两条辅助流程没有验收签字、不在其内;读写只经core/sign-settings.js(--action=sign-settings,show谁都能看,set只有主控跑得了)。改设置不立项:用户在 X大脑 窗口说四句固定话之一,受信命令去原话账本核到这句话确实是用户说的、晚于设置文件里「最后改动」那一笔、同一笔不能用第二次,才改并记下时刻与那一笔原话的位置;或用户用编辑器手改文件(下一次读设置就照新值,「最后改动」与账本对不上时提示一句)。计划的看板与机器镜像多一栏「验收谁签」(acceptBy写亲签或代签、acceptWhy写理由),随签字一锁住:放宽要用户说,收紧走核准、不用重签;设置是上限,以读设置那一刻为准。代签命令(--action=sign --plan=<名> --kind=验收完结 --as=代签,core/sign-delegate.js)核三样:调用的会话是登记册里的主控、设置此刻允许这一类、这条计划的「验收谁签」是代签;关口与用户亲签同一套(三查全绿、独立复盘过、看板与机器镜像对得上),验收区先留证据、没有证据就签不了;账本里代签的那两笔(验收、完结)带代签标记、设置指纹与证据位置,签字人写「X大脑 代签」,履历写明;用户随时能自己签。生效时点:代签靠会话登记册认出谁是 X大脑,这一版落地之后才生效 —— 此前已签字一的计划没有「验收谁签」这一栏,验收照旧由用户签,之后立项的计划才有这一栏。 - 发布与联调的代授权:代签的那条需求,验收后的发布与开发中途的联调由 X大脑 代用户授权 —— 把代签记录转给运维经理,运维经理照发。机器核:代授权的发布与联调在命令里显式带需求名和「代授权」标记,部署门和各条发布出口(云端工具的部署门、云函数脚本出口、静态站点发布准备)只核带标记的这条路 —— 这条需求的验收是代签、设置此刻仍允许这一类、要发的内容指纹等于验收那一刻的才放行,联调则看设置允许、这条需求在办、落点对得上;设置改回亲签,同一笔当场被拦并写明原因。不带标记的(用户本人授权的)发布与联调照旧,机器不核、靠纪律。
- 开闸跟着签字走:计划工具(立项命令、对账命令、签字题命令)把落点表里落在受保护文件上的格自动标出来 —— 不另存标记,由签字那一刻的落点表和受保护名单现算(新旧签字一样),签字题与看板写一句人话「签了就等于同意到时放行这些文件,不用你手动开闸」;签字一只能用户本人签、从不代签。实施时守卫照常在岗,写一个受保护文件要同时满足四样才放行:写的是这条需求的办理会话(只认签字时记下的会话、登记册里登记为这条需求产品经理的会话、主控或项目经理指名的改派,谁都能跑的自助改派不带走放行,常驻会话不写机器镜像);路径在签字那一刻的落点表算出的受保护格里、且核准后的现行落点表里还有(签后核准加进来的格不放行,要放行得先核准、再请用户重签(重签只有签字作废时才有,没作废就只能请用户手动开闸换入,补签放行没做),核准减掉的格也不再放行);这条需求在办(签了字一、没完结、签字没作废);路径不在永不放行名单里。范围写死为守卫脊柱与检测引擎承牙两类;放行询问只有一个入口(
requirements.js的releaseOf),写文件工具、命令行、换入帮手认同一份;验收完结、归档、签字作废当场收回;永不放行名单(各本账、需求履历、各单元的锁清单、装配标记、检测引擎的射程缓存、版本库自己的忽略清单、代签设置文件、会话登记册、项目设置与本机设置)写在代码里、只许加严,唯一运行器、部署门入口、空壳桩不在名单里;放行评估自己出错(读不了账本、机器镜像坏了、抛异常)一律按不放行、吞掉、记一笔、不往外抛;需求履历记这条需求放行过哪些受保护文件、实际写了哪些。手动开闸留作急救:新守卫坏了、连恢复命令都被拦住时才用,急救第一步先停常驻会话与各位产品经理。过渡:这套放行装上之前,这条需求自己换守卫的那一批(批 2)仍要用户最后手动开一次闸(并进整批换入的那一个窗口,关闸后做金丝雀);批 2 装上放行之后,这条需求复盘后再改这几个受保护文件不用再开(急救除外)。 - 计划与流水线脚本:计划模板(
PLAN-TEMPLATE.html)与机器镜像模板(scope.template.json)加「验收谁签」一栏,立项命令、签字题命令、对账命令、核准命令认这一栏并自动标受保护格;改派命令分指名改派(主控或项目经理带--to=<完整会话号>)与自助改派(--take)两种记法,放行只认前者;立项在签字一之前、立项命令由产品经理在自己的会话里跑,所以从写第一笔计划起它就是办理会话,立项命令不再打印握手一段(握手内容由发起命令打印、项目经理照原样经 SendMessage 送),回报节点除了发消息同时把看板状态栏改成现状;云函数脚本出口、静态站点发布准备和发布脚本入口认代签记录与设置,换入帮手认签字放行;立项命令、十态命令与其余脚本报文里的旧叫法换成现行叫法。 - 文档 · 宪法(只写定性与存在性):§二「强制三流程」订成现行的三条主流程;§三 两把尺子里的第五类架构叫 Harness架构;§四 运作方式逐句改成新运作(常驻会话、每个专项一位产品经理端到端负责、会话由项目经理自动发起、设计由两位架构师出、不动受治文件的小事由 X大脑 直接派执行体而动受治文件的事再小也交产品经理、机器认的是办理会话和登记册里的主控与项目经理),工作流目录与闭环图里的旧叫法换成现行的;§四 与 §六 第 8 条里讲两次签字与单次授权的话改成只写定性(需求确认由用户签,验收完结与线上写入的点头按代签设置由用户本人或主控来,签字一不代、改代签设置不经立项);§六 加第 9 条「禁止复杂化」,两句并在一条里。
- 文档 · 架构详图(文首版本改成 v7.0.0):§二 参与者、并发会话与威胁模型(多了无人值守的后台会话,多了 AI 在用户设置允许的范围里替用户签验收、授权发布,多了放行只给办理会话、只给签过的文件);L4 写前拦截里的保护与放行(开闸改成急救);§十五 角色表、执行体按层表、车道表「谁来做」与「怎么派工」、取舍原则与复杂化审查官的机制(三个时点、四种判断)、签字机制与发布授权;§十七 术语表新增会话、代签、开闸放行相关的条目(Harness架构、产品架构师、Harness架构师、复杂化审查官、产品经理、运维经理、常驻会话、会话登记册、会话命名、恢复命令、高保真、场景判定、代签、代签设置、验收谁签,以及签字放行、受保护格、急救开闸),「主控」一条补「主控即 X大脑,首席产品官」,五类需求入口表的执行体一栏加复杂化审查官与产品经理;全文叫法同批换成现行的。
- 文档 · 其余:决策记录加 ADR-116;业务开发规则书(
x-dev-rule.md)的三档表、联调上线、施工区与讲两次签字与授权的几处改口;体系守护技能说明新增会话命令与代签命令两节、改派命令加指名改派;统一开发、元治理、数据、模块下线、检测引擎、部署(发布授权加代签这一条路)几份技能说明与统一开发的参考文档里讲主控出设计、签字授权、「请用户开闸换入」和旧叫法的地方同批改。 - 测试(跟着被测对象同批):新增会话命令(对假的
claude命令行逐个子动作断言它收到的参数)、会话登记册、代签设置、代签命令、设计页图号与字号几张体系守护床,钩子目录下新增固定句、代签、放行的床;改写立项、十态、清理归档、需求对账、核准、体检、统一开发、封版命令、部署门等床里钉着旧叫法或签字授权的断言,守卫整套回归里钉着旧叫法、签字或联调履历的断言同批改;叫法清扫、术语表、入口表、宪法对表的断言加在体检总自测里,历史账本(决策记录与三份变更历史、需求履历)里原有的旧名行由床核原样没动、只许追加;新床对被测对象换成空壳都会变红。 - 守不到(照实写,细目在 ADR-116 与两张设计页的诚实边界):说话钩子只认固定句,防不了有人手打同一句固定句;登记册被手改、会话号被冒用、主控登记被冒用机器挡不全,代签命令认 X大脑 靠登记册,它的口子也是代签的口子;X大脑 派出的执行体与它同一个会话号,四条敏感命令按
agent_id拦执行体、防不住主控会话本身被冒用;X大脑 代验时判断得对不对机器判不了,证据留在看板验收区靠用户抽查;用户本人授权的发布与联调机器照旧不核;编辑器手改代签设置账本里不留原话;急救时手动开闸是整关,能改守卫的人就能改放行的判定,办理会话往签过的文件里写了什么机器挡不住;常驻会话不是办理会话、不写机器镜像;实测只在本机的 Claude Code 版本上做过,真重启电脑没演;叫法清扫床判不了改过的句子通不通顺,落在别的单元里这次没碰的旧叫法在那些单元空出来之前与现行叫法不一致。 - 演练补洞(换入之后的第二轮,常驻四位起来做过一遍恢复演练之后补的;仍是这一版,不另升):演练实测出洞,补法分五样。① 守卫再动三处,合前七处共十处:⑧ 说话只认主控 —— 会话登记册读得出而且登记了主控之后,签字说法与用户亲口说的「重建登记册」「改代签设置」只认主控会话里说的,别的会话里出现这样的话不记进原话账本、不认作签字、只回一句原因,选项题答完同理,原话账本核对(
bossPhraseHeard)对这两种也只认主控那一笔,「换主控」不受此限,登记册读不出来、没登记主控的仓照旧;⑨ 环 1 多一支定时任务通道 ——CronCreate、ScheduleWakeup的提示词含签字说法或用户亲口说的固定话(含换主控,整句或子串)一律拦,登记着的非主控会话只许建提示词整句恰好等于巡检固定句的,写前接线的匹配名单同批加上这两个名字;⑩ 落盘的定时任务文件.claude/scheduled_tasks.json进脊柱写保护与永不放行名单。固定句常量(guard/session-phrases.js)多一句巡检句,说话钩子遇到它与发起、叫醒、恢复同一待遇。② 会话命令:读横幅的等待单设时限、缺省放宽到 120 秒;握手内容开头直接写上会话自己的短号(命令里写出环境变量名会被环 1 当成改写会话身份拦掉);运维经理被发起、叫醒、恢复之后读它自己的会话记录核云端工具连上没有,没连上就停掉、再不带参数叫醒一次、再核,还不行报主控,记录里没有结论算「核不出」、不算失败;发起命令的内联设置多一项MCP_TIMEOUT(90 秒)。③ 文档:架构详图 §二 多一行威胁模型「定时任务冒充用户的话」并订正边界 ②⑤⑩、加 ⑪,§八 加定时任务通道与说话只认主控、写前接线名单加两个名字、写保护与永不放行名单加定时任务文件,§十五 加「运维经理的云端工具自愈」、项目经理与运维经理两行和会话命令几行同批补;体系守护技能说明的会话命令一节同批对上;决策记录 ADR-116 末尾追加一段说明。④ 守不到(补进上一条的清单):定时任务送进来的普通话在主控与没登记的会话里仍被记成原话;定时任务文件被 node 脚本直接写守卫看不见;说话只认主控以登记册读得出、登记了主控为前提,新窗口没登记之前用户的签字不记;云端 MCP 开机可能超时、后台会话没人点/mcp,stdio 方式的服务启动失败官方没有自动重试;命令核云端工具读的是会话记录文件里平台自己追加的条目,格式官方没承诺,读不出就说「核不出」;MCP_TIMEOUT在后台会话里生不生效官方文档没写,本机六轮重启实测(删了重起三轮、停了叫醒三轮)都连上了、一轮没连上的都没有,所以没测出来;恢复演过的是停掉后台会话再拉回,真重启电脑仍没演。⑤ 测试(跟着被测对象同批):新增「说话只认主控」「定时任务通道」两张守卫床(main-only-says.test.js、scheduled-prompt.test.js,都经守卫入口真起守卫、并对被测判断逐处改坏);会话命令床补横幅等待、握手短号、云端核对三种结论 × 发起/叫醒/恢复三条路、没连上重开一次、两次都没连上报主控、只对运维经理做,登记册床补NEEDS_CLOUD;文字床 N4 补运维经理定义里「开工先核云端工具」一节与项目经理巡检指针的要点;守卫整套回归、固定句、代签、放行几张床里受新判法影响的断言同批改(带登记册又拿别的会话号签字的几条,把签字会话换成主控);每张新床与改过的床都做了改坏对照。⑥ 换入前的独立审查查出一条必须修、已修:守卫读会话登记册的办法此前是宽松的(只读仓里那一份、不核镜像),会话命令是严格的(两处对不上就拒绝);登记册对守卫是「登记了主控」、对命令却是「不可用」时(比如换电脑只拷了仓里那份),登记主控被拒,而「会话登记册:重建」那句又被说话钩子当成非主控窗口里说的丢掉,两头互相指、签字全锁。现在守卫的registryOf经会话命令的readState读(运行时才装,装不上才退回宽松读,退路也剥文件开头的 BOM),全仓只有一个「登记册可用」的标准;不可用时守卫当没有登记主控,重建在任何窗口里说都记得上。床加在main-only-says.test.js(M9 / M9b / M9c)与scheduled-prompt.test.js(C10 / C10b / C10c),signed-gate.test.js加 G4c(签字作废重签之后,新签字时的落点表盖住的受保护格放行),都做了改坏对照。
- v6.2.x
工作区地基第 1 步「地图立起来」:全仓「这个路径是什么、归谁、能不能动、算不算」只写一份 —— 新目录 .claude/hooks/workspace/ 立起工作区地图(两个数据文件、读取模块、地板、地图自己的匹配函数、问为什么命令、指纹口径骨架),检测引擎的索引与目录遍历共用一个跳过判断并读它(只许多跳),判据多一个注入键 workspaceMap,射程缓存键多算地图这一样;测试面按段登记、对拍台的有意改动清单带组号与档位;架构详图新增第十八节、决策记录 ADR-113 至 115
设计指纹05a12ac7内容指纹fb632ba9测试指纹1f609bee1005a9b0改动设计 2 个(harness-engineering.md、ADR.md);代码 17 个(session-ledger.js、state-watch.json、test-faces.js、verify-harness.js、non-standard-checker.js、file.js、index.js、indexer.js 等)
需求地图立起来签字 2e1e已发布
为了:地图立起来 —— 工作区地基第 1 步(引擎这一侧)。精确普查数出按路径判断的地方共 809 处(检测引擎 162、守卫 167、技能脚本 242、材料侧与站点 238),同一个目录在索引里是一个结论、在检测器自己走目录树时是另一个结论,改一条规矩漏一处就静默分叉;这一版把检测引擎这一侧收到一份地图上,其余读者(规范判据、守卫、其余脚本)在后几步陆续迁来。
- 升第二位:新增一类东西 —— 工作区地图与它的地基目录(地图数据、读取模块、地板、匹配函数)、引擎的共用跳过判断、判据注入键、测试面按段登记;宪法不改,仓根
CLAUDE.md指针表多一行指向地图;引擎里的三张跳过名册、端名册、测试根、规则书名册和版本契约一个字没动。 - 地基目录(新,
.claude/hooks/workspace/):map-engine.jsonl、map-rest.jsonl(JSON、一条记录一行、t在前、出处就是行号、末行带条数的结束记录;引擎段 = 词表、名册、区树骨架、存在与检测两个引擎属性和作用在它们上的路径规则,余段 = 其余属性按区编号挂在骨架上、对象认法、视图);read.js(读取模块:装载、校验、查询、问为什么、判据用的只读取数口;读不到就拦并点名文件与行号,八种坏法各一个用例,读到半截先重读一次);floor.js(地板:脊柱、引擎承牙、受治根、必跳名、地基目录自身,只许加不许减,装载时拿样本路径核地图,越过地板就拒绝);glob.js(自写、不依赖 minimatch,以matchFilePattern的五步为基线,不认得的写法抛错);fingerprint.js(只定接口,算法留第 4c 步);why.js(why.js <路径>与--check)。地图数据对金标准在 8004 条真路径上逐路径一致,唯一有意改动 D3:.claude/bak下 20 个文件不再进检测引擎的索引(检测结论零变化);8122 个入库文件、盘上被忽略的条目和 35 个灰区都落进了声明过的区。 - 检测引擎:新增
scanners/walk-skip.js(索引与目录遍历共用的跳过判断:目录名册、点开头、测试根、路径前缀表四条原样,加地图第五条,只问扫描根之下的目录);indexer.js与file.js的几处遍历改调它;non-standard-checker.js的buildDetectorTools多一键workspaceMap;scope-cache.js的键多算第五样(地图引擎段与读取模块、地板、匹配函数三件代码)。遍历从此不再看见点开头目录与测试根里的东西(计划写明的后果,靠全量检测前后对比兜)。 - 守卫:
guard/test-faces.js的检测引擎上游组登记地图引擎段与三件代码并加挂引擎面;guard/session-ledger.js的判据组指纹多登记同样四个文件、缺了不抛;guard/state-watch.json登记完整性闸要盯的仓根一层与.claude一层。守卫的加载路径本步不读地图。 - 对拍台与技能:有意改动清单带组号与档位(
zz-tools/replay-core.js的applyIntended按档对账、checkIntended核形状与组号表);独立求值器按整块算并能读新的数据文件;旧名单快照补上几张名册;新增引擎侧处置表、地图等价床、探针路径床;adapters.js的 A31 标签订正为三十三个写法。 - 测试:新增读取与格式、失败矩阵、地板棘轮、完整性三道闸、名册钉住、守卫脱钩、沙箱复制点覆盖、测试面分段咬合、引擎常量不变、注入键、索引与遍历同结论、匹配函数差分、地图等价、探针路径等床;改写
incremental-parity.test.js(「改前口径」连地图那一层一并拿掉,另加两层各咬一次)、work-area-skip.test.js(引擎整树进假仓补带地基目录,近似名的正对照改从扫描目标进去)、scope-cache.test.js、test-faces.test.js、session-ledger.test.js、replay.test.js、census.test.js;引擎整树被拷进沙箱的几处床与驱动各补一行带地基目录;每张新床与改过的床都量了耗时、做了改坏对照。 - 文档:架构详图新增第十八节「工作区地基」、订正 §七「路径级忽略」里两种视图分叉的说法与 §十六「夹具」的口径、§十六补「对拍台与有意改动清单」小节、术语表加「工作区地图」「地板」;决策记录加 ADR-113、ADR-114、ADR-115。
- 守不到(照实写):地图写的是「今天的口径」,怪路径(大小写、反斜杠、
..折叠、盘符写法)不在等价床里;保护的判法本步仍是「路径里含这一段就算」;完整性闸看得出「没落进任何区」与「歧义」,看不出「落进了错的区」;遍历收成一种视图的后果靠全量检测前后对比兜,比的是此刻的盘;引擎现行匹配器没换;地图读坏时检测被拦、守卫不被拦,抢修态留第 3a 步;生成物区在余段里写的「受治:不适用」几行被地板盖住、本步是死数据;旧isGeneratedArtifact对全部顶层物下的装配产物路径都判产物、地图只认两个移动端(合成路径上的已知差异,留第 3a 步);读取模块不折叠路径中段的.与..。
- 升第二位:新增一类东西 —— 工作区地图与它的地基目录(地图数据、读取模块、地板、匹配函数)、引擎的共用跳过判断、判据注入键、测试面按段登记;宪法不改,仓根
- v6.1.x
项目自带:每条需求在项目里有自己的施工区文件夹,副本、备份、探针放那里,守卫隔开别的需求的会话,清理归档整份删;造副本与换入两个体系守护动作;Claude 的记忆文件搬进项目;核准命令的指纹开关改叫 --fp;几处文字与实际对不上的同批订正
设计指纹263a0121内容指纹5cb1a673测试指纹b56622c94f446381改动设计 7 个(CLAUDE.md、harness-engineering.md、ADR.md、x-dev-rule.md、SKILL.md、SKILL.md、SKILL.md);代码 16 个(command-policy.js、requirements.js、stop-handler.js、worktree-probe.js、verify-harness.js、config.js、bed-runner.js、plan-approve.js 等)
需求项目自带签字 81e6已发布
为了:项目自带 —— 用户 10-21 说「每次项目实施的时候,就再x-test里面构建自己的项目目录,然后只能再自己的项目目录里面构建本次项目所有的临时文件和测试文件」「我不期望项目里面的东西导出再项目外面放来放去,万一未来换电脑了,目录会导致不存在而报错」。此前一条需求的副本、备份、探针散在系统临时目录里,靠守卫自动登记、清理归档逐行核;换电脑时这些目录不存在,Claude 的记忆文件也放在用户目录里。这一版把登记的单位由「逐个仓外目录」换成「施工区这一个文件夹」,并新增一类守卫隔开别的会话的区。
- 升第二位:新增一类东西 —— 施工区(一类由守卫隔开别的会话的文件夹)与造副本、换入两个体系守护动作;清理归档硬控的关口与机器判法一个没加没减,只是登记的单位由逐个仓外目录换成施工区这一个文件夹。宪法 §六.8 不改,§六.5 只改一句待办去向。
- 守卫 · 需求零件(
guard/requirements.js):新增施工区的判法workAreaOf(只认仓根相对路径以精确的x-test/zz-work/起头,第一段后面那一级就是需求名;大小写、反斜杠、/e/盘符写法都先换成仓根相对路径再判)、workAreaStateOf(活区、账本被改过的区、死区 —— 需求已完结、计划已归档、计划已不在、还没签字 —— 与区根)、workAreaWhy(拦截报文三句:归谁、你是谁、怎么办);受治判断与两个目录遍历(补忽略清单、没有版本库时的那一支)不进施工区;写前拦截与写后记账各多一支施工区,排在受治判断之前;registerOutside改成只提醒、不再往登记文件追加(outsideUnitOf保留);核准那一步指纹对不上的拒绝报文里的开关名改叫--fp。 - 守卫 · 命令判定零件(
guard/command-policy.js):脊柱、检测引擎、保护区、生成物、发布档案五个写保护谓词对施工区下的路径答「不保护」;写命令全集PATH_CMDS与删除类动词DELETE_VERBS导出,每个写命令的落点都过施工区那一道(别的需求的区、没签字的会话、区根与根下散文件一律拦;死区的删除类动词谁都放);跑施工区里的脚本只放这条需求的办理会话;swap-in.js进脊柱写保护名单(与核准命令同一待遇);换了目录之后的相对落点沿用已有的「一律拦」。guard/worktree-probe.js的收尾测量与写证据不记施工区。换入前的独立预审又补了几道(都在这一零件里,分词器多记一个braceAfter):区名那一段带展开写法(通配、方括号、花括号展开、反斜杠转义、变量、波浪号、感叹号、反引号)一律拦;没签字的会话删死区的免检只给磁盘上真有、路径干净、一路没有联接、所在的区确是死区的路径;删除类命令(含 mv 的来源)穿过联接对办理会话也拦;cd/pushd进别的区再跑相对路径的脚本按「当前目录加相对路径」算落点;install -d的操作数进直写清单;死区的「怎么办」一句改写不带尾斜杠的删法。 - 检测引擎:路径前缀名单
IGNORED_PATH_PREFIXES加x-test/zz-work(索引沿用、scanners/file.js的目录遍历新用,同一张名单,只认这一条路径、不挡近似名与路径中段的同名目录)。名单里原有的.claude/tmp因此对遍历也生效:此前检测器自己走目录树时看得见它、索引看不见,两种视图的这一处分叉没有了;没有规范的射程落在那里,检测结论不变,对拍台回放零差异(架构详图 §七「路径级忽略」的诚实边界、ADR-112 ⑨ 同批订正,work-area-skip.test.js加 K2e 钉住)。 - 体系守护技能:清理归档(
core/plan-wrapup.js)的清一步多「施工区」—— 整份删、不跟着联接走,起草收尾单第二栏与预览先列出里面有什么,搬之前先核施工区文件夹本身(是联接、不是文件夹、真实位置不在x-test/zz-work之下就整条拒绝),只读盘点多第五段「停滞区」(只列不删);老计划留下的登记文件照旧读、照旧清。新增三个动作:--action=work-copy(造副本:决定带什么不带什么 —— 本机才有、带明文密钥的.env一族、.mcp.json、.npmrc、各层.claude/settings.local.json按文件名不带;副本根默认放一个空的.git文件当标记,旁边另存指纹清单;要在副本里跑整套回归的加--git,改建沙箱版本库:git init、提交一次基线、objects/info/alternates指回真仓的对象库,仍不往上找)、--action=swap-in(把副本里改好的文件换进真仓:不带执行开关只预览;执行时先备份并附指纹清单、用读写写目标并把修改时刻设成此刻、给本会话记写证据、写完逐字节核对、打印恢复命令;备份目录可以放在目标根的施工区里,不能放在来源根里面或目标根里施工区之外;--base把「复制那一刻不在、现在有了」「复制那一刻有、现在被删了」也算被别人改过而拒绝;中途出错时把恢复命令一并打出来)与--action=restore(只验备份,或按备份放回)。核准命令(core/plan-approve.js)的指纹开关由--print改叫--fp:守卫查 node 求值开关时连脚本后面的参数一起看,--print=<指纹>被当成求值拦下、执行那一步谁也跑不了;守卫那道墙不放宽。运行器(core/bed-runner.js)的卫生检查对x-test/zz-work及其下面的路径不验「床路径存不存在」(改在判决口径区之外,不让任何床记录作废)。 - 其它文件:五份执行体定义里讲临时文件与仓外副本的几行改成本需求的施工区,X大脑 的定义补「核准过程改动」一条;项目设置加
claudeMdExcludes: ["**/x-test/zz-work/**"](实测:不排除时读副本里一个文件就加载五个指令文件,排除后零个)、删五条已无对应文件的放行规则;.gitignore订正 x-temp 的说法并加**/.claude/settings.local.json一行(各层目录都认,不靠这台机器用户级的全局忽略文件);x-deploy-dev的config.js一段注释改成指向env-registry.js的文件头;仓根package.json钉engines.node: "22.x",仓根CLAUDE.md指针表多一行指向换电脑清单。Claude 的记忆文件搬进项目里主控线的目录(文件入库),设法是写在本机项目本地设置里的autoMemoryDirectory。 - 文档:宪法 §六.5 改一句待办去向;架构详图新增小节「项目自带」(一条原则、一个单位、七件事、守不到),「清理归档硬控」一节重写,「签字锁住的目录」六处改新口径,核准一节补
--fp与一条守不到,术语表加「施工区」;决策记录加 ADR-112;开发规则书与体系守护、业务开发、检测引擎三份技能说明同批改。 - 测试:新增
work-area.test.js(守卫的施工区)、work-area-copy.test.js(造副本)、swap-in.test.js(换入与恢复)、work-area-skip.test.js(检测引擎)四张床;改写钉着旧登记行为的断言(守卫主自测 WG1–WG9b、requirements.test.js、requirements-signing.test.js、requirements-substance.test.js里登记的几处);worktree-probe.test.js写死仓根的两处改成按床自己的仓根算;plan-wrapup.test.js加施工区与停滞区几组;plan-approve.test.js加 P8(预览打印的下一步命令交给守卫的命令判定,三种身份都不被拦,换回旧开关名被拦);harness-dev.test.js的 G20 加三条断言,L5(项目架构设计页正文字数)改成豁免「换电脑清单」小节、小节另设自己的字数上限;每条新断言都做了改坏对照,与预期不符的逐条分诊过。预审补的几道各有床:work-area.test.js的 WA11(展开写法、联接、cd 之后跑脚本、install -d)、swap-in.test.js的 S5d / S6 / S3d、work-area-copy.test.js的密钥文件与--git几组;plan-wrapup.test.js停滞区个数那条断言原先同时接受 n-1 和 n,收紧成一个确切的数。 - 守不到(照实写):隔离只拦编辑工具和命令行里认得出落点的写 —— 脚本进程里自己写的东西、带变量通配反引号的落点、经联接或硬链接绕出去的写、8.3 短名、云端工具往本地落盘的写都拦不住;BOSS 手动
git clean -xdf会清空全部施工区(含换入前的备份);要留的记录与施工材料分没分开机器不核;老计划的登记文件被手改、保留的理由写得对不对机器不核;记忆目录的设置对已开着的会话不保证生效,搬完要请开着的会话重开;计划目录下的文件命令行删不了,作废的记忆只能改写成作废说明并从索引里拿掉;脚本自己的开关别叫-e、-p、--eval、--print(守卫查 node 求值开关时连脚本后面的参数一起看);写工具的 NT 前缀与 UNC 管理共享写法折不回仓根相对路径(受治业务文件的需求闸本来就有这个洞);写命令全集之外的命令(find -exec rm、xargs rm、shred -u、split、tar -C、curl -o、git clone、Windows 的copy/move/xcopy/robocopy/rd/attrib等)往别人的区里写拦不住;cd带变量、pushd +N、popd之后当前目录算不出,相对路径的脚本只能照字面判;写类命令经联接写进真目录拦不住(只拦删除类);标记副本(默认造法)跑不了整套回归,要整套的加--git;沙箱版本库只往自己的对象库里写(work-area-copy.test.jsC7d 钉着:沙箱里提交、打标签之后真仓的.git一个字节没变,沙箱里没配远端、推不出去,拿掉 alternates 沙箱自己的历史与对象照样齐全),但真仓哪天gc --prune清掉不再被引用的提交(比如改写历史之后),还活着的沙箱借读那些提交就报缺对象(沙箱自己的基线对象是它自己写的,不受影响),换电脑后 alternates 里的旧路径也要改 —— 沙箱只活一条需求,用完随施工区整份删。
- v6.0.x
少重签:签字只锁五样(需求那一句话、要用户亲手验的清单、动钱与动权限与身份与改已发布表字段类型或删功能三个自报、档、流程),其余过程(标准的措辞与条数、自动用例、亲手验用例的「在哪看、怎么验」、同一流程之内加或换的版本单元、落点表里的目录与格)签字之后改了不让签字作废,由签字时说话的会话核准、机器记账、验收时逐条列旧到新;范围按「签字时的加核准过的」算;核准一笔复盘作废、验收清单多一个必勾项;架构详图、决策记录 ADR-111、三份技能说明、开发规则书、发布技能说明、计划模板同批
设计指纹bac473b4内容指纹ab0ef858测试指纹af8cfa618a6d9f25改动设计 7 个(harness-engineering.md、ADR.md、x-dev-rule.md、SKILL.md、SKILL.md、SKILL.md、SKILL.md);代码 15 个(guard.js、command-policy.js、project-archive.js、requirements.js、trial.js、verify-harness.js、PLAN-TEMPLATE.html、scope.template.json 等)
需求少重签签字 ae81已发布
为了:少重签 —— 用户 10-20、10-21 说「各种重签,如果都没有什么变化,或者一些小改动,却没有改需求,可以不需要反复重签」「我签字的是需求啊……只要总体需求不变,过程的东西就由你来签啊」,并在弹窗里选了「只锁五样」。此前签字锁住整份计划(标准、用例、落点表里的目录与单元),目录、措辞、用例、单元一改就作废,用户为同一件事反复签字。这一版改写「签字锁什么」这条既有契约,升第一位;宪法 §六.8 不改,变的只是「签过字的内容」指哪几样。
- 守卫 · 需求零件(
guard/requirements.js):内容编号改成只盖前四样(需求那一句话、亲手验的清单、三个自报、档),流程不进编号 —— 签字那一笔记下当时的流程,之后每次判断逐次和此刻从落点表算出的比,不一样当场判签字作废;新签字多记lock(算法版本)、sub(前四样的原件)、flow(当时认出的流程)、mh(当时机器镜像的指纹)与过程的底proc。签字之后的过程改动(标准、自动用例、亲手验用例的写法、同一流程之内的版本单元、落点表的目录与格)叫「待核准」,签字照样有效;新增approveProcess(核准)、pendingOf(待核准清单)、approverCheck(核准者资格)、approveReasons(核准那一刻重判)、noPathOf(没有核准路)、有效范围一组读者(effectiveDirsOf/effectiveUnitsOf/approvedTargetsOf,planStates把「签字时的目录加已核准的」挂在机器镜像的__allow上,cellOf只认它),和复盘记录里的过程指纹(processFactsOf/processFactsPrint)。老签字按留的底只比底里有的项(signHolds),一样就仍是在办、沿用原来签的编号,没留底的一律重签。 - 守卫 · 其余零件:联调零件(
guard/trial.js)放行面与放行的单元读有效范围、正式发布门读整张落点表并上有效范围;履历零件(guard/project-archive.js)完结与每核准一笔都把核准清单写进需求履历;写保护名单(guard/command-policy.js)加核准命令、判决依据的「三查」那一样把它算进去(不多出一样);守卫入口(guard.js)记复盘结论时把任务说明里的过程指纹一并记下。 - 体系守护技能:新增
--action=approve(core/plan-approve.js)—— 最近一笔签字所在的会话跑它核准签字之后的过程改动,不带--execute只预览并打印清单指纹,执行带同一个--print;变少要带--accept-fewer,加业务域单元要带--domain=<单元名>。三查结果单、复盘说明、验收区各多一节「签字之后的过程改动」(核准记录与待核准清单,逐条旧到新,节顶上写累计新增覆盖多少受治文件);第一查红在哪几样多一个键unapproved;复盘说明的判法多一条例外与一项必查;有核准记录的需求验收清单最后多一个必勾项「签字之后的过程改动我看过、认可」;确认区「需求」组里的标准与自动用例只当说明列出、不再是要勾的明细;项目环(--action=loop)对没有核准路的签字作废多说一句原因。 - 元治理与开发流:封版命令把「为了」解析到一条需求时核本单元在不在有效范围里、待核准的过程改动挡封版;计划模板(
PLAN-TEMPLATE.html)与机器镜像模板(scope.template.json)的说明改成新规矩;开发规则书里「放行面是签过字的落点表」补一句指签字时的目录加核准过的目录。 - 文档:架构详图 §八「需求对账」多一段「签字只锁五样、过程由主控核准」,并把讲签字锁住什么、什么时候作废、范围怎么算、冻结面、第一查红在哪几样、判决依据的几处同批订正,术语表加两条改三条;决策记录加 ADR-111;体系守护、业务开发、元治理三份技能说明与发布技能说明(「放行面是落点表」两处补半句)同批改。
- 测试:新增
requirements-approve.test.js(核准)、requirements-substance.test.js(锁什么)、requirements-legacy-walk.test.js(老签字走完全程)与plan-approve.test.js(核准命令)四张床,钉老签字的夹具在hooks/tests/fixtures-legacy-sign/;原来拿「多一条标准、多一个目录」让签字作废的几十条断言改成拿锁住的内容,三查、复盘说明、封版命令、计划环、履历、联调与发布门、守卫主自测各补新断言,每条新断言都做了改坏对照。 - 守不到(照实写):机器认不出核准者是不是主控本人,只核三件事;办理会话就是签字会话(或签字会话自己写过机器镜像、写者查不到)的需求没有核准路,待核准的过程改动当作实质、要重签;「需重签」标记只在有人跑核准命令时才落下;签字会话没了之后没有核准路;等重签期间动了待核准清单标记会静默失效;老签字的底里没有每条用例对着哪条标准与落点表按格的行;标准与用例的措辞放松了是不是把需求改松,机器判不了,靠独立复盘的必查项和验收时逐条看。
- 守卫 · 需求零件(
- v5.4.x
订正:补封 v5.4.0 漏封的 7 个文件(设计内容没变)
设计指纹222d5a63内容指纹79df4359测试指纹161f69ab0f79229a改动设计 1 个(harness-engineering.md);代码 7 个(requirements.js、verify-harness.js、layer-auditor.js、check.js、defaults.js、index.js、indexer.js)
需求检测提速·并发签字 7821已发布
为了:检测提速·并发 —— 补封 v5.4.0 漏封的 7 个文件:它们是落盘那天用拷贝工具写进仓里的,守卫账里没有写证据,封版命令按会话归属把它们当成无主改动、留了旧指纹没封进 v5.4.0;这一版带认领清单封上。设计与 v5.4.0 一字不差。
- 补封的 7 个文件(都是 v5.4.0 一节里已经讲过的改动,这里不重讲):守卫
requirements.js、verify-harness.js,体系守护layer-auditor.js,检测引擎check.js、constants/defaults.js、constants/index.js、scanners/indexer.js。 - 怎么漏的、怎么补:接力命令第 4 步调封版命令时不带
--adopt,而落盘用的拷贝工具写文件不经守卫的写后记账;封版只封本会话有写证据的改动与没人动过的文件,这 7 个文件归在「无主」一栏、保留旧指纹,封版后回读报「v5.4.0 封版之后改过」。已封的一节不能重封,所以补一版(先例:10-14 agent 架构多封的 2.0.1)。以后落盘改受治文件,要么走留写证据的写法,要么封版前先看预览、该认领的带--adopt。 - 测试:和 v5.4.0 同一批床;这一版只在变更历史最上面加了本节、在架构详图文首把版本行改成 5.4.1,对这两处判旧的几张床补跑过。
- 补封的 7 个文件(都是 v5.4.0 一节里已经讲过的改动,这里不重讲):守卫
检测提速·并发:测试床开 --jobs 才分道并发(缺省 1 一字不变;每张床带写追踪,只有在独占跑里证明不写真仓的床进池,越界后污染窗口里的床独占重跑,池里红绝不改绿);选床认法以带上游的反查为准、新加对拍床;测试闭环体检改用只给体检的批量函数;增量检测提前起 oxlint、射程与缓存跳过 .claude/tmp;复盘者型号检查只放行 sonnet 与 claude-sonnet-5-5;守卫两张新床缩身、补「主人会话已结束」的 rt 床;架构详图、体系守护技能说明与参考、决策记录 ADR-110 同批
设计指纹d53bffb2内容指纹0179745a测试指纹499cb460d5340944改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、x-harness-arch.md);代码 7 个(test-faces.js、verify-feature.js、bed-runner.js、plan-run.js、harness.js、oxlint-checker.js、write-trace.js)
需求检测提速·并发签字 7821已发布
为了:检测提速·并发 —— 检测提速的第二步,也是最后一步:测试床在安全的前提下分道并发跑(缺省照旧一张接一张,开 --jobs 才并发;会动真仓的床照旧独占;红绝不改绿)、选床认法对拍纠偏、测试闭环体检少读重复的账、检测引擎少等 oxlint 那一截且射程缓存不再被 .claude/tmp 的增删作废,顺手清掉守卫三处小尾巴;每张床判什么、检测判什么一个字不变。
- 运行器 · 分道并发与写追踪(
bed-runner.js、新建的bite/write-trace.js、harness.js,体系工程师改):新增--jobs=N(命令行接受 1 到 8 的整数,缺省 1;推荐 4 到 6、开发期起步 4,2 路、3 路也是合法的池;缺省与不带逐字相同:不起池、不注入追踪、不学准入、不读写准入册与快照;判定模块或追踪器不在时说明一句、退回一张接一张)。开了之后这一轮全部床都带写追踪:准入册.claude/tmp/ledger/bed-trace.json记每张床「绑床文件加夹具」的追踪结论(bedFixtureKey算键),独占跑通过、追踪判干净(追踪器写过载入行、没写真仓、没起碰真仓的非 node 子进程、worker 线程都被注入)才进池,新床、改过的床、没有结论的床一律先独占跑一遍;经部署门外壳的函数床、自报持锁的床、床文件读不到的床永远走独占道、不看也不学追踪结论;在仓内跑 git、oxlint 的床和符号链接指向仓内的床判脏,不开白名单(整仓演练里判脏的 25 张构成见下面「判脏 25 张」一条,是否放宽另议)。池先跑、独占道后跑;第二道快照(git status -uall的路径加内容哈希,加追踪册派生的被忽略目录清单)轮首、池后各取一次,独占道后那一次只在这一轮学到了干净结论时才取,轮首取不到 git 状态时这一轮不起池、也不学新结论;变了的路径必须有来历(某张床的追踪里写过它、会话台账的写证据里有别的会话写过它、或属于放过的区域),解释不了的整池作废。追踪里的豁免写成两处目录前缀.claude/tmp/.scope-cache/与.claude/tmp/beds-last/(含目录本身的创建):追踪器实测引擎落射程缓存是四笔(建缓存目录、写scopes.json.<进程号>.<随机>.tmp、改名两端),只豁免最后那个文件名会把每张碰到引擎没命中缓存的床判脏;该目录里只有scopes.json一个文件,读缓存时校验和、版本、键任一对不上就当没命中,写坏了也只是少命中一次;台账、需求账、计划目录在追踪里仍一律算写真仓。第二道快照同样放过这两个前缀,另放过台账目录、需求账目录、计划目录(运行器这一轮自己按批落的账、准入册都落在台账目录里),否则别的会话跑一次检测改了射程缓存、或运行器自己落一批账,都会被当成「分不出谁写的」、整池作废。某张池里的床越界后,污染窗口(第一次越界写起到还原或轮末)里跑过的池里的床红绿都不算、全部独占重跑;越界的那张先独占重跑、登记独占并点名,重跑之后残留仍在的这一轮记未过并点名、其后各床不落账;分不出谁写的、池协调器没交出结果、池后快照取不到,都整池作废一次、这些床改在独占道重跑,本轮不再起池,整池因解释不了的变化作废时独占重跑逐张盯着那几条路径,重跑里重写了它们(样子或修改时间变了)的床追到了就登记独占;没被作废的池里红独占复跑一次归因、账上仍记红,池里红而独占绿的登记独占。输出文件名用单调计数器加进程号,池的结果走文件,指纹在派发那一刻取、复算前先invalidate(),落账按批原子写(池阶段处置完记一批,独占道每 10 张或每个函数门记一批,每张床只记一次),要做空壳对照的床排到轮末再对照再记;池里的床用时另带并发路数与最近一次独占用时,重面阈值求和用独占用时。小批不起池:池里各床的独占用时加起来,并发省下的时间抵不过起池的固定开销(池后一次快照、每张床取两遍指纹;运行器按约 6 秒加每张约 0.7 秒估),或池里只剩一张,就并进独占道一张接一张跑;只许从池挪进独占道、不许反过来;挪进去的床照样带追踪、照样学准入结论;判定不变,只影响开发期按改动跑的那几张。写追踪预加载文件:载入行、令牌、逐笔同步追加、枚举fs全部导出且没归类的算写、node 子进程与 worker 线程注入、盯运行器进程号;日志追加走启动时存下的低层原函数(打开、写、关闭),不用appendFileSync(它在 Node 里回头调导出对象上此刻的writeFileSync,被排在追踪器后面载入的围栏拦下,见「测试跑出并修掉的不一致与缺口」④);追踪器任何情况下不往床的标准输出和标准错误写一个字:日志写不进时退出前补一行logfail,补不上就把日志整个删掉(运行器读不到载入行,照没有载入行判脏),装钩失败也不再打标准错误、改记一行没归类的记号;日志里path恒是被改的路径、path2只供对照,复制只记目标,rename 与 link 两端各一行各带写前的样子,记的是「要写」不是「写成了」、先都按写算(保守);整仓演练里判脏的构成见下面「判脏 25 张」一条,是否放宽另议;递归建目录(mkdir带recursive)时,调用前仓内此刻还不存在的祖先目录也各记一笔(写前的样子是不存在),自上而下,最后才记给定路径本身,已存在的祖先、仓外的祖先不记 —— 让「建一棵树再整棵删掉」的床判得出已还原(测试工程师用运行器一半的床演出来的缺口,已修,不是设计之外的新机制);嵌套的追踪会话(被追踪的床里再用另一个令牌起带追踪的运行器会话,运行器自测才有)不覆盖内层环境、不补NODE_OPTIONS,往外层日志记一笔标脏的起子进程 —— 外层看不到内层床的写(盲区),所以记成脏,这样的床只走独占道、不会被当成干净;调用方清空或剥掉预加载的NODE_OPTIONS也照补,嵌套运行器起的内层床仍在追踪里。交叉核对(追踪器与守卫、检测引擎两位工程师只读核对,运行器作者改)后运行器的改动:射程缓存追踪豁免改目录前缀;污染窗口还原后终点放在最后一笔写的追踪行之后再加 2 秒(TRACE_TAIL_MS;追踪行记的是「要写」那一刻,写完还要一会儿);部署门外壳那条路读追踪日志时带门入口进程的进程号(载入行要核的是它自己的,不是它起的床的);残留没清时其后落定的各床不落账(残留在中途被还原了,之后落定的行照常记账);用时夹成非负;池里红床归因复跑越界时准入册记脏;指纹错误按床去重;一轮收完兜底对账(auditRows):结果里的床恰好是这一轮要跑的床、各出现一次、各交给记账一次(跑在残留里没记账的除外),对不上点名并计入未过。单张床的超时上限:带写追踪起的床(并发这一轮的独占道、池、部署门外壳)放宽到 30 分钟(TRACED_BED_TIMEOUT_MS),不带追踪的老路径(--jobs缺省)仍是 15 分钟;证据是整套守卫回归verify-harness带追踪时在忙闲不定的机器上量到过 709 秒(追踪日志 22153 行、被追踪进程 1025 个),第一轮演练里它在多人同时跑活的时段超过 15 分钟上限被杀(记成 ERROR);机器安静时它带追踪只用约 474 秒(第二轮独占道)。上限只是防挂死的保险,余量是留给机器忙的时候的(运行器源码里有两处注释还写着早先“安静时 583 秒 → 709 秒”的读数:头注(第 77 到 78 行)和TRACED_BED_TIMEOUT_MS旁;后一处在判定口径区里,改一个字全部床的旧记录作废,前一处在框外、改它不作废记录,但改运行器要再开一次闸,主控定两处都不改,以本条为准)。池的逻辑写在判定口径区里;函数床仍一个一个走独占道,发布前测试与部署门入口不带--jobs。 - 守卫 · 判定模块(
test-faces.js,体系工程师改):运行器上游组补整个bite/目录(写进目录项、不写进只算框出区段的那一栏;bite.js、bite-stub.js改了从此也作废旧记录);账本记录多两个可选字段(并发路数、最近一次独占用时),重面阈值求和时有独占用时就用它,别的判定一个字不变;新增只给体检用的批量函数faceStatusBatch(自己组装结果,账本整读一次、判定上下文开头重建一次;收尾、封版、三查、接力用的faceStatus、judge、testPrintOf不经它,一条静态断言钉着闸的函数体里不出现批量函数名)。批量函数是新增的,为批量没改那几个闸用的函数(faceStatusRaw、bedState、judge、testPrintRaw)里的任何一处;它们里唯一被改的是「重面」阈值取数(recMs,faceStatusRaw与judgeRaw各一行,那是并发池的标注带来的,与批量无关);它们共用的fileHash另多了批量期间才生效的私有记忆挂钩(auditMemo,平时为空,结果与原来一样;按文件去重哈希的记忆放在这里,不碰全局的fileCache);新导出bedFixtureKey(床文件加夹具的指纹键,准入册用)与faceSubjectsOf(给对拍床用)。选床认法纠偏:对拍先在真仓上干跑——72 个面、1161 次「被测文件 → 带上游的facesOfFile」反查,只有skill:x-spec-checker一个面不一致,48 个被测文件反查不到它(references/**46 个,assets/templates两个模板);读了skill-docs.test.js全文,它只读SKILL.md与scripts/**,脚本只当文本读,assets下两个模板经 grep 核过全部床无人执行或读取;所以按「证明床不读才收窄」收窄:该面的被测范围只含SKILL.md与scripts/;收窄后真仓上 72 个面 1113 次反查零不一致,没有「已知不一致」登记,其余各面没有不一致可修。对拍床在整仓副本上跑的是 72 个面、1114 个被测文件逐个反查,同样零不一致;1113 与 1114 之差,是副本里多出的.claude/skills/x-harness-dev/scripts/core/bite/write-trace.js(skill:x-harness-dev面把整个技能目录除tests都算被测范围;落盘后真仓上也是 1114)。 - 守卫 · 复盘者型号检查(
requirements.js,体系工程师改):只放行sonnet与claude-sonnet-5-5两种写法(与 x-agent 条款 ARCH-A02 的型号白名单同口径;项目把子代理型号统一强制成 Sonnet 5.5,这两种写法不再算降级),haiku 与旧版 sonnet 的完整型号名照旧拦,拦下的报文里补上这两种写法;守卫其余拦什么一个字不变,guard.js的传参不变。 - 检测引擎(
check.js、oxlint-checker.js、constants/defaults.js、constants/index.js、scanners/indexer.js,体系工程师改):增量检测把 oxlint 提前起跑,结果仍在原位等、原位打印,报文次序与退出码不变;凡在等到它之前就退出的路径(覆盖闸违规、抛错)先收掉在跑的 oxlint 再退;oxlint-checker.js加一个交出子进程句柄的回调,它依赖的根目录与 L1 目录常量一并上移;findOxlint改成同步(checkFiles里不能await:一await就把起跑排到索引与射程那一长段同步活之后,提前起跑成了原位起跑),有「oxlint 在建索引之前已起跑」的断言守着。用假 oxlint(记起跑时刻的探针)量,从进程启动到 oxlint 起跑:改前 3.4 到 15.9 秒,改后 0.9 到 1.3 秒;同一场景总用时 21.3 秒降到 5.3 秒;覆盖闸违规的路径上多付约 0.5 到 1 秒(起 oxlint 再taskkill收掉),实测 6.7 秒对 7.5 秒。射程与缓存不再被.claude/tmp的增删牵动:defaults.js加路径级忽略的新常量IGNORED_PATH_PREFIXES(不混进目录名册),索引器据此跳过,常量层入口头注同步。动手前的普查:在整仓副本里造旧引擎的影子根,对每份规范实跑scanTargetsForSpec(规范, null, 仓根, 索引器),数目标里落在.claude/tmp/下的——35 份规范(含元规范 x-standard-spec,它在增量检测里本就排除),目标合计 32224 个,落在.claude/tmp/下的 0 个,目标恰是.claude目录本身的 0 个;索引里.claude/tmp下有 787 个文件、73 个目录。改后同批 35 份规范的射程逐项相等,索引里少的正好是那 787 个文件加 73 个目录。适用面写**/*的诱饵规范:旧引擎 5450 个目标(含 787 个.claude/tmp下的),新引擎 4663 个(0 个)。.claude/tmp里增删文件,新引擎射程缓存的键不变,旧引擎的键变。不加射程缓存命中记录(打进报文会破坏逐项相等,写文件又多一处真仓写入)。 - 体系守护与开发流(
layer-auditor.js、plan-run.js、harness.js、verify-feature.js,体系工程师改):体检的auditTests改用批量函数一次问完各面(批量缺席或整体抛错时退回逐面问,三处抛错的语义与逐面问逐字相同;版本契约那一段不动,它是判决依据)。先剖面,五个数(整仓副本里冷进程跑三次取中位数,机器当时偏忙,只当量级):判定上下文重建 6 → 3,readLedger72 → 1,fingerprintBed376 次 / 355 张不同床(不变),statSync22220 → 4857,VC.auditAll约 8.3 秒(不动)。用时:整次auditTests改前 30.2 秒(逐面段 20.5 秒加版本契约 8.3 秒);同时段 A/B 对照,逐面路径 24.1 秒、批量路径 16.4 秒,扣掉版本契约是 15.5 秒对 7.4 秒。CPU 采样:statSync占 39%,fileHash占批量段约 79%;批量函数里加的按文件去重哈希的私有记忆把批量段从约 11.5 秒降到 4.8 秒,不要这份记忆则批量比逐面只省约 3 秒。接力命令里按改动跑床那一步(常量取 4 路)、开发流 VERIFY、命令行全量带--jobs,发布前测试与部署门不带;harness.js校验--jobs是 1 到 8 的整数并转给运行器、帮助文字照新写法。 - 测试 · 守卫与引擎一侧的床(测试工程师写):新建
face-parity.test.js(4 个用例:整仓副本里 72 个面、1114 个被测文件逐个反查〔落盘后真仓上同数〕,零不一致,没有「已知不一致」登记;改坏对照——把技能面被测范围放宽回整个技能目录——必须红;9 个变异体,8 个有效的全红,1 个等价〔@covers反查补回来了〕)、audit-batch-parity.test.js(16 个用例:5 个样本仓,覆盖状态全集、五种 stale 原因、零床的面、重面含池里记录、带毒的床、坏账本、没账本、床被挪走;批量与逐面问逐项深度相等、账本只读一次、auditTests接线〔批量只问一次,批量整体抛或缺席都退回逐面问〕;7 个变异体全被指定检查咬住,含「批量求和没用recMs」与「闸偷用批量函数」;另在layer-auditor.js上做 5 个演练,4 个被 B6 咬住、1 个等价)、incremental-parity.test.js(8 个用例:「改前口径」是同一份引擎只把IGNORED_PATH_PREFIXES清空;小仓里放诱饵规范加两份真规范,起真引擎 7 路并发,改前改后报文与退出码逐字相同;覆盖闸违规、读索引抛错两条提前退出的路,退出后没有 oxlint 残留;oxlint 在建索引之前已起跑;去掉stopOxlint()后两条路都有残留;6 个引擎变异体全红)、ledger-rt-alive.test.js(5 例,R1 到 R4 各自能红);test-faces.test.js补 N 组 7 条(80 → 87:技能面收窄、bite/进运行器上游、bedFixtureKey〔公式钉死〕、par与exMs原样存与写错抛、重面阈值、faceSubjectsOf),11 个变异体各被 N1 到 N7 咬住;requirements.test.js71/71,守卫主回归套件verify-harness.js整套 1630 通过 0 失败(含 RV6d、RV8c 到 RV8f)。射程普查没有放进常驻床:全仓逐份实跑scanTargetsForSpec约 7.5 秒、超预算,所以引擎对拍床用小仓加两份真规范,「落在.claude/tmp下的目标数」靠上面检测引擎一条里那次实跑的普查数字。 - 测试 · 守卫两张新床缩身(
guard-trim-parity.test.js、stop-timing.test.js,测试工程师改;建一次模板再复制,断言一条不减):缩身前的验证脚本在仓外找不到,设计里写的「11 个」变异体无据可查,所以按两张床各自的守卫功能新列清单:对拍床 12 个、计时床 9 个,缩身前后跑同一批,红的断言号逐个一致;其中 3 个两版里都没人红 —— G09、S05 是等价变异,G10 是床的缺口(床把账本里oos记的键转小写之后才比,「记原大小写」的变异看不出来,缩身前就如此)。用时(交替跑各 3 遍取中位数):计时床 22.4 → 16.2 秒(约 −28%),对拍床 31.6 → 26.6 秒(约 −16%,噪声大)。没到设计估的「缩一半上下」:对拍床本来就是建一次模板再复制,缩身只把cpSync换成读进内存再写出,省的只是复制那一块;剩下的大头是被测守卫自己每次对账起的 git 子进程(约 91 个)加 9 次起守卫进程,那就是断言要测的东西;想减半只剩床内多进程并行,与运行器池的并发计划冲突,没做;试过NODE_COMPILE_CACHE无收益,已撤回。计时床手挑复制的引擎常量清单随defaults.js的改动仍够用(守卫不加载indexer.js);对拍床的小仓里文件修改时间与 git 状态不影响任何场景。运行器账里这两张床的读数:第二轮里guard-trim-parity在独占道重学准入、进账 24.7 秒,stop-timing在池里跑(池里用时被并发抬高);机器安静时串行一轮里账上的读数是guard-trim-parity24.3 秒、stop-timing18.1 秒(早先参照里分别是 31.8 秒与 21.9 秒)。环境小事照实记一笔:fs.cpSync带filter选项在这台机器(Node 22.18、Windows)上偶发把 node 弄崩(段错误),没找到根因,床已绕开。 - 测试 · 运行器与追踪器一侧的床(测试工程师写):新建
bed-write-trace.test.js(写追踪对账与变异体,对账床)89 例(其中 J3、J4、J5、M10、M11 和 C5 的只读样本是真仓第一轮发现追踪器被围栏拦下之后补的,J5 与 M11 是体检官立案后补的,见「测试跑出并修掉的不一致与缺口」④)、bed-pool.test.js(调度,调度床)38 例;改写harness-dev.test.js(新增 C8b、C8c、C8d 三例核体检接线——批量问面、批量整体抛退回逐面问、报告里不打用时——与 E6 核--jobs开关和帮助文字;G24 的必有符号清单加三个符号)、plan-run.test.js(只改断言文字)、feature-dev.test.js(多一次在假仓里真跑中转脚本)。对账床核两件事:追踪器记得全不全——归类对账、每个写入口各调一次(含writeFileSync字符串快路径、回调、promises、FileHandle、流)都被记到、载入证明、写前的样子、node 子进程 14 种起法、worker 线程 7 种起法、老写法与 ESM、日志与进程、语义保真、嵌套的追踪会话;运行器据追踪判得对不对——在假仓里真跑运行器。调度床核池的调度:并发不超过 N 且真并发起来、池先跑独占道后跑且独占不与池重叠、超时记 ERROR 并杀整棵进程树、指纹漂移判错、同一毫秒派发两床输出各归各、池里红的输出另存不被盖、每张床只记一次且按批落账、中途杀掉运行器已落账的不丢、小批不起池与大批照起、单张床时限两档的接线、缺省 jobs 与不带逐字相同。变异体(各由指定断言咬住,改坏的位置找不到本身就算红):追踪器十一个——writeFileSync漏钩 → B1、不写载入行 → C2、没归类的入口静默放行 → C6、worker 不注入 → F1、不记写前的样子 → D1、子进程不注入 → E1、不按仓根过滤 → B2、缺的祖先目录不记 → D2、认不出嵌套的追踪会话 → L2、日志改回appendFileSync→ J3、装钩失败时回到往标准错误写字 → J5(用故障注入的追踪器副本演:在install()末尾故意抛错);运行器十个——准入恒真 → S1、去掉窗口判定 → S2、去掉池后复算 → R10、追踪豁免整个.claude/tmp→ S3、豁免加回台账与需求账与计划目录 → S4、去掉载入行检查 → S5、快照不带-uall→ S7、快照不比内容哈希 → S8、输出撞名 → S10、落账丢批 → R11;调度床进程内九个——起池恒划算、恒不划算 → A2,准入恒真、部署门外壳的床也进池、自报持锁的床也进池 → A11,时限两档对调、o.bedTimeoutMs不再覆盖 → A12,起池协调器的时限不看有没有带追踪、总上限不再按每路排几张算 → A13。另做了不进床的一次性实验:追踪器 X1 到 X10、运行器 G1 到 G5、时限取档接错档 H1 到 H5(B11、A13、B2 咬住)、清理选择性的三个改坏(H5 咬住);池里用poolWorth的那一处用反了、没有「池里只有一张」这一支、登记独占被追踪结论翻回去、运行器各处取档接错档,要真跑运行器才看得见,不配永久变异体,由 B7、B8、B9、B10、B11 与 A13 后半的断言咬住。对账结果(逐样本):越界三样本——border-axis-scope往业务目录mkdir -p种探针树再rm树根、ns-common-0007往被忽略目录做同样的事、写了又删的探针文件——摘出独占册放进池,都被暴露,按真做法(建树加rm根)都判已还原、窗口关上,窗口内的床整体作废并独占重跑,对照床不受牵连,越界的登记独占;残留样本(越界床崩在写与删之间)之后派发的床与独占道的床都落在没还原的窗口里,只标未记账、不进账;只有第二道抓得到的两个样本——非 node 子进程用相对路径往未入库的路径写、往追踪册里出现过的被忽略路径写,追踪看不见、快照比得出来,这一轮学到的准入结论作废;两道都抓不到的一个样本——往被忽略目录写一个追踪册里从没出现过的文件,这张床被学成干净,写进守不到⑥;worker 线程里写真仓、追踪器路径写坏都判脏。空壳对照:第一轮演练 14 项未过的构成里没有空壳对照没咬住的一项,第二轮改过的 7 张床做了空壳对照、全部通过;逐张结论(账里每张床的bite字段):落盘当天验证与真仓两轮里做过空壳对照的共 26 张,全部咬住(换成空壳后变红、退出码 1)—— 落盘当天验证的 13 张(其中bed-write-trace的记录已被真仓第二轮那一次覆盖):守卫一侧ledger-rt-alive、face-parity、audit-batch-parity、test-faces、stop-timing、guard-trim-parity、requirements,检测引擎一侧incremental-parity,开发流feature-dev,运行器与体系守护一侧bed-pool、harness-dev、plan-run、bed-write-trace;真仓第一轮 13 张:bite、requirement-check、acceptance-sheet、record-release、plan-checks、plan-wrapup、plan-loop、plan-handoff、plan-new-ask、plan-trial、review-brief、team-attribution、检测引擎一侧的skill-docs;真仓第二轮 1 张:bed-write-trace(追踪器修过之后)。共 26 张:咬住(bites)26 张,登记不做(off;登记表BITE_OFF为空)0 张,没咬住或出错(nobite、miss、error、none)0 张(26 张是记录时刻不早于落盘当天的床数,bed-write-trace的两次记录合并成一条)。 - 测试跑出并修掉的不一致与缺口:① 对拍床跑出的:
skill:x-spec-checker面有 48 个被测文件反查不到该面(references/**46 个、assets/templates两个模板),已按「证明床不读才收窄」收窄,见上面判定模块一条;其余各面没有。② 对账床(运行器与追踪器一侧)演出来的:床建一棵探针树、事后整棵删掉,追踪器此前只记最深那一层,树根第一次被记就成了那笔删除、写前的样子记成目录,运行器拿「此刻不存在」比「写前是目录」判成没还原,污染窗口开到轮末,其后各床被标未落账 —— 而探针树早被床自己删干净了;已修:递归建目录时仓内缺的祖先目录各记一笔,见上面运行器一条。③ 调度床演出来的:测试里「杀运行器」的样本,被杀的运行器没机会自己清,那张挂住的床的输出与追踪日志(系统临时目录里的x-bed-out-*、x-bed-trace-*)每跑一次留 2 个,全部测试累计留了 154 个、涉及 66 个进程号;已修:调度床收场时按被杀运行器的进程号清掉名字里带这个进程号的那两类文件(C3 钉着:清之前确实有、清完一个不剩;名字同形状、进程号是别人的诱饵一个不动,不按前缀一把扫),对账床 H5 钉着清理的选择性。④ 真仓第一轮演出来的:360 张里只有x-harness/site-build一张红(94 个用例 86 过 8 败,另加「隔离收尾没过」),单独直接跑(不带追踪)94 过 0 败。根因:追踪器写日志用启动时存下的appendFileSync,Node 里它内部回头调导出对象上此刻的writeFileSync;站点床子进程里的围栏(排在追踪器后面载入)把那个入口换成只许写沙箱的版本,追踪器往系统临时目录追加日志被当成越界拦下:一是围栏记 boundary-denied、床收尾抛SITE_BED_CHILD_ESCAPE,二是追踪器的日志写不进、退出时往子进程标准错误打字,站点床把标准输出和标准错误拼起来当 JSON 读,用例级联红。仓里只有这一张床装这种围栏。演练副本里这张床在每一轮带追踪的跑法下也红,当时归给了环境(它在基线里确实红,缺依赖),那只对了一半:基线里的红是缺依赖,带追踪时的红另有这个缺陷。原 J1 用例看不出它:围栏沙箱在追踪仓根之外,追踪器载入之后没有一笔要记。已修(见上面运行器一条与对账床一条):日志追加改走低层原函数,追踪器不往床的输出写字,补 J3(围栏在追踪器之后载入、沙箱在仓根里,围栏子进程与孙进程的写和起孙进程的记录都记到)、J4(围栏在追踪器之前载入时日志本来就写不出去,要保住的是不出声和不漏判:这个进程没有载入行,运行器判追踪不可信)、J5(装钩失败,用故障注入的追踪器副本演:不出声、记一行没归类的记号,运行器判脏;体检官立案后补)、变异体 M10 与 M11 和 C5 的只读样本;修后站点床经运行器--jobs=2带追踪 94 过 0 败,真仓第二轮里它在独占道通过。顺带记一次我自己的失误:修完第一次带追踪重跑站点床时,我在床运行期间改了架构详图,被床自己的「真实取材源码不许变」指纹抓到(报「隔离收尾没过」),重跑时不动任何文件就过了。 - 早先参照与整仓演练(办理会话量):早先的参照是旧代码在整仓副本里串行整床跑一遍——354 张床串行 4674.3 秒(约 78 分钟),退出码 1:13 张红、1 张登记豁免跳过(
x-backend/replica-fidelity)。这一遍是在多人同时跑活的时段里量的,偏高约 50%,噪声大,只当早先的参照、不拿来当同等负载下的对照(对照用后面机器安静时的串行一轮)。13 张红在旧代码上就红,原因是副本是仓的副本(没带 git 状态、没装node_modules):x-deploy-dev/mobile-post-validate、x-governance/sensitive-data、x-harness/site-build(88.7 秒;带追踪的几轮里它的红另有追踪器被围栏拦下这个缺陷,不全是环境,见「测试跑出并修掉的不一致与缺口」④)、x-plan-doc/ns-common-0001-0004-view-scope、x-styles/antd-baseline-tooth、x-styles/axes-teeth、x-styles/dup-gap-teeth,以及x-test/mobile/backends/web/下六张(mobile-web-backend、mobile-web-parity-assembler-shell、-bundler、-components-a、-components-b、-runtime-b);整仓演练时这 13 张当「环境红」单列、不算并发造成的。串行秒数最大的床(同一遍里量的,同样偏高):verify-harness441.3、x-styles/border-axis-scope367.2、harness-dev225.6、deploy-release-pipeline166.6、plan-run162.7、requirements-signing133.4、x-styles/axis-matrix129.3、trial-gate126.1、business-arch-closure107.5、stop-ring105.7、session-ledger103.8,这前 11 张占了串行总时间里约 2100 秒。整仓演练的正式三轮放专用整仓副本做、用完就删:先--jobs大于等于 2 首轮全独占带追踪,再不带--stale全量并发一轮,最后在机器安静时缺省--jobs、不带追踪,一张接一张串行一轮,作同等负载下的对照;三轮的结果见下一条。 - 整仓演练三轮的结果(专用整仓副本;前两轮
--jobs=4,机器上同时还有别的会话与程序在跑,用时只当量级;第三轮缺省串行,全体队员静默、机器处理器忙碌约 15 到 20%):
· 第一轮(准入册清空,360 张全独占、带追踪、学准入;360 张是早先参照的 354 张加本需求新增的 6 张床):汇总标题 5388.6 秒、外层计时 5407.2 秒(约 90 分钟;跑在多人同时干活的时段里,又含一张被 15 分钟上限误杀的verify-harness,不是首轮的真实代价),退出码 1,14 项未过 = 13 张环境红(与早先参照同一批)加 1 张 ERROR:verify-harness带追踪超过单张 15 分钟上限被杀(早先参照里串行 441.3 秒通过),随后把带追踪床的上限放宽到 30 分钟(见上);345 张通过、1 张登记豁免跳过。分道:进池 0,独占道 360(没有追踪结论 330、自报持锁 9、经部署门外壳 21)。准入册学到 318 张:干净 293 张(独占用时合计 2244 秒)、判脏 25 张(合计 1464 秒)、登记独占 0 张;追踪册 216 条路径。册里记的独占用时是第一轮多人同时干活时量的,偏高;第二轮进池的 289 张在安静串行里合计 1271 秒,那才是池里的活量。
· 第二轮(不带--stale,准入册带第一轮的结论,演练时副本里的运行器指纹 86c5be49,含带追踪床 30 分钟的上限):汇总标题 2511.3 秒(41.9 分钟),退出码 1,13 项未过 = 13 张环境红(与早先参照、第一轮同一批);346 张通过(第一轮被上限误杀的verify-harness这次通过)、13 张 FAIL、1 张登记豁免跳过。进池 289 张(准入册对当前床文件与夹具判过干净),独占道 71 张 = 自报持锁 9 · 床文件或夹具改过 7 · 追踪结论是脏 22 · 没有追踪结论 12 · 经部署门外壳 21。池 4 路并发,池墙钟约 580 秒;池里 289 张全过、0 红、0 作废;池后快照「两次之间变了 0 条路径」,独占道后快照同样 0。提速多少、各段怎么拆见下一条(第三轮的对照)。
· 第三轮(同等负载下的对照:同一副本,缺省--jobs、不带追踪、旧路径一张接一张串行;全体队员静默,机器处理器忙碌约 15 到 20%):汇总标题 3086.6 秒(51.4 分钟),退出码 1,13 项未过 = 同一批 13 张环境红;346 张通过、13 张 FAIL、1 张登记豁免跳过;与第二轮逐张红绿完全一致,状态不一致 0 张。第二轮 2511.3 秒对这一轮 3086.6 秒:比 0.814,快 18.6%(1.23 倍),这是并发的真实提速;早先参照的 4674.3 秒与第一轮的 5407.2 秒都是在多人同时干活的时段里量的,偏高、噪声大,不拿来当对照。拆开看(按床配对):池里 289 张在安静串行里合计 1271 秒,到第二轮里池墙钟约 580 秒,并发加速 2.19 倍(4 路的理论上限是 4 倍,效率约 55%;池里各床自己的用时合计 2433 秒,是各自安静串行用时的 1.91 倍,中位数 1.96 倍,原因是 4 路并发抢磁盘、杀毒和处理器,再加带追踪;整仓演练只量过 4 路,路数再开大是否还涨没量,判断吞吐被共享的磁盘与杀毒卡住、难涨);独占道 71 张在安静串行里合计 1791 秒,到第二轮里带追踪 1847 秒(多 56 秒,+3.2%);其余约 84 秒是记账、快照、指纹复算、空壳对照。为什么只快 18.6%:第二轮的 2511 秒里独占道占 1847 秒(74%),池只吃得掉 289 张的 1271 秒;即使池无限快,第二轮也不会低于独占道的 1847 秒加开销,约 32 分钟(对安静串行最多快 38%)。签字稿的模拟值与实测的差别:签字稿按 188 次跑床记录逐次模拟,写的是全量跑床约 40 分钟、并发每 9 天省 92 到 96 分钟(模拟值,不是实测);实测全量在安静机器上串行是 51.4 分钟,不是约 40 分钟,池跑每轮全量省 18.6%,约 9.6 分钟(3086.6 − 2511.3 = 575.3 秒)。
· 独占道 71 张共 1847 秒(30.8 分钟),按结果拆:自报持锁 9 张 674 秒(verify-harness474.4、site-build74.8、business-arch-closure61.9、border-axis-ledger-ratchet27.6、axes-teeth11.8、assembly-face10.6、x-motion-axis-closure6.5、brand-ladder-tooth5.0、ns-common-0012-00131.6);判脏 25 张 983 秒;改过后重学成干净的 4 张 54 秒(guard-trim-parity24.7、bed-write-trace14.0、bed-pool9.5、audit-batch-parity5.7);经部署门外壳 21 张 121 秒;环境红或登记豁免 12 张 15 秒;另有约 84 秒是记账、快照、指纹复算与空壳对照(7 张改过的床做了空壳对照,全部通过)。
· 判脏 25 张(983 秒):写了真仓的 14 张 478 秒(border-axis-scope206、stop-ring104〔写根node_modules〕、axis-matrix54、deploy-gate-wiring33、engine-probe29、tetrad-framework-independence15、meta-dev7、incremental-parity7〔临时小仓里摘目录联接,追踪器顺着联接认成引擎目录,保守误判;还起taskkill〕、compile-checkers6.6、mobile-dev6.5、data-dev3.9、ns-common-00033.1、ns-common-00071.0、mirror-arm31.0);只起了碰仓内路径的子进程的 11 张 505 秒(git 3 张 180:deploy-release-pipeline130.8、requirements46.1、worktree-probe3.4;powershell 1 张 38.3:plan-checks;嵌套追踪会话 1 张 126.5:plan-run;shell 里起 node 6 张约 160:harness-dev97.8、verify-mobile-canary23.0、feature-dev17.7、auth-spec-liveness13.8、module-del4.5、deploy-dev3.5)。shell 里起 node 的认法(追踪器作者写好了,40 条正反例全过)没有做,做了净省约 2 分钟。
· 红绿是否一致:360 张逐床对照,第二轮与第三轮(安静串行)完全一致,状态不一致 0 张;第一轮与第二轮唯一状态不同的是verify-harness(第一轮被 15 分钟上限误杀,第二轮通过),13 张环境红三轮相同。另有一处环境差别:第一轮跑在缺 72 个空文件的副本上(副本放在系统临时目录,这些 0 字节文件被 Windows 存储感知的磁盘清理清掉了),第二轮补齐后跑;没有哪张床的状态因此变化。池里红或越界而登记独占的床:没有(池里 289 张全过、0 作废、快照零变化;第一轮学到的册子里登记独占 0 张)。落盘后真仓上的对照:真仓第二轮对演练副本第二轮逐张比(都是 360 张),状态不同 13 张 —— 全是副本里的环境红(副本没带 git 状态、没装node_modules)在真仓上通过:x-deploy-dev/mobile-post-validate、x-governance/sensitive-data、x-harness/site-build、x-plan-doc/ns-common-0001-0004-view-scope、x-styles/antd-baseline-tooth、x-styles/axes-teeth、x-styles/dup-gap-teeth,以及x-test/mobile/backends/web/下六张;其余 347 张两边一致(346 张通过、1 张登记豁免跳过);真仓第一轮与第二轮之间状态不同 1 张:x-harness/site-build(第一轮红、第二轮过,追踪器被围栏拦下的缺陷已修)。真仓两轮里池里红或越界而登记独占的床都没有(第二轮池里 303 张全过、0 作废、池后快照零变化)。
· 稳态与落盘后的窗口(演练副本上的估计,真仓实测见本条末):第二轮已是稳态(只差 4 张新干净的床进池),下一轮约 41 分钟;真仓上那 13 张环境红会真跑,估计 42 到 47 分钟。下限(独占道):verify-harness474 + 判脏 983 + 其余约 390 ≈ 1850 秒,加开销约 32 分钟(对安静串行最多快 38%)。设计估的稳态是全量约 20 到 24 分钟(独占道约 16 分钟,按 13 张已知独占床合计约 850 秒加函数门床约 1.5 分钟估的),实测没有到:独占道 71 张带追踪共 1847 秒,原因同上面独占道的总量。落盘后的窗口:判定口径区改了、全部旧记录作废,首次全量必须全跑一遍;方案 A(推荐)首轮--jobs=4学准入,机器安静时约 55 分钟(= 安静串行 3087 秒 × 1.032 加约 90 秒的快照、指纹与记账;第一轮演练实测的约 90 分钟含多人同时干活的噪声与一张被误杀的verify-harness,不拿来估),第二轮池跑约 42 到 47 分钟,加余量 15 分钟,占跑床锁约 2 小时;之后每次全量约 42 到 47 分钟。落盘后真仓上跑的两轮(--jobs=4;机器当时只有本会话在跑,处理器忙碌约 20% 到 55%,第二轮开头排队 24 秒等别的会话的一张床):第一轮(19:11 起;判定口径区已改、旧记录全部作废,准入册清空,360 张全独占、带追踪、学准入;追踪器是修复之前的)汇总标题 2186.8 秒(36.4 分钟),退出码 1,1 项未过 =x-harness/site-build(追踪器的日志被围栏拦下,见「测试跑出并修掉的不一致与缺口」④);分道:进池 0,独占道 360(没有追踪结论 330 · 自报持锁 9 · 经部署门外壳 21);准入册学到 329 张:干净 304 张、判脏 25 张、登记独占 0 张;独占道后快照「两次之间变了 4 条路径」,4 条都有来历、解释不了 0;13 张关键床的空壳对照通过。第二轮(20:18 起;追踪器已修,带第一轮的准入结论,不带--stale)汇总标题 1626.0 秒(27.1 分钟),退出码 0,0 项未过(1 张登记豁免跳过:x-backend/replica-fidelity);进池 303 张,独占道 57 张(自报持锁 9 · 床文件或夹具改过 1 · 追踪结论是脏 25 · 没有追踪结论 1 · 经部署门外壳 21);池墙钟约 299 秒(5.0 分钟;这 303 张各自独占用时合计约 960 秒,加速约 3.2 倍),独占道约 1321 秒(22.0 分钟,占第二轮的 81%);池里 303 张全过、0 张红、0 张作废,池后快照「两次之间变了 0 条路径」,独占道后快照 2 条(有来历 2、解释不了 0);空壳对照做了 1 张(bed-write-trace,咬住)。第二轮比第一轮短 25.6%(0.744);第一轮全独占、带追踪,等于一遍带追踪的串行,所以这是真仓上同一台机器、同等状态下池对串行的对照(演练副本上不带追踪的对照是 51.4 → 41.9 分钟、快 18.6%,两个口径不混用;真仓上没有单独量不带追踪的串行)。对上面的估计:首轮估约 55 分钟、实测 36.4 分钟;第二轮估约 42 到 47 分钟、实测 27.1 分钟 —— 实测低于估计,估计取自演练副本上的读数(副本在系统临时目录里,当时机器忙闲不定),真仓这两轮机器较安静、13 张环境红在真仓上也都通过了,各占多少没有单独验证;设计估的稳态 20 到 24 分钟仍没到(独占道 1321 秒,比设计估的约 850 秒多)。
· 安全证据:两轮前后的工作区状态只有 git 里被跟踪的射程缓存文件变了(在豁免内);系统临时目录顶层名字前后对比(第一轮中途对第二轮结束)新增或改过 160 项,其中 153 项带唯一后缀,7 项像固定名的都不是床留下的(is-*.tmp安装程序临时目录 2 个、WinGet、cv_debug.log、一个十六进制.tmp、本次演练自己的暂存目录、运行器每仓一把的跑床锁文件);一处小毛病,已修:测试里「杀运行器」的样本每跑一次留 2 个小临时文件(x-bed-out、x-bed-trace),全部测试共 154 个、66 个进程号,演练两轮本身不留;调度床现在收场时按被杀运行器的进程号清掉(见下面「测试跑出并修掉的不一致与缺口」③)。
· 追踪开销(以第三轮的配对为准):第二轮独占道里那 71 张是一张接一张跑的,与第三轮安静串行只差带不带追踪,逐张配对——71 张合计 1791 → 1847 秒,多 56 秒(+3.2%);其中通过且安静串行用时不小于 1 秒的 56 张,逐张比的中位数 ×1.086(多约 0.95 秒)、P25 ×1.021、P75 ×1.233、P90 ×1.297(多约 3.6 秒);这 56 张里非部署门外壳的 35 张 1589 → 1623 秒(+2.1%),经部署门外壳的函数床 21 张 96 → 121 秒(+26.5%,多 25 秒);绝对值多花最多的几张:border-axis-scope+8.0 秒(198 → 206,+4%)、deploy-release-pipeline+5.8 秒(+5%)、border-axis-ledger-ratchet+4.5 秒(+19%)、order-fulfill-merge+4.2 秒(+36%)、deploy-gate-wiring+4.1 秒(+14%)、stop-ring+3.6 秒(+4%)、axis-matrix+2.9 秒(+6%)、harness-dev+1.9 秒(+2%);verify-harness475.5 秒(不带)对 474.4 秒(带)没有差异。早先的读数都不当追踪开销:第一轮对早先参照逐床比(中位数 0.913、总用时比 1.153)与两轮整床互比,噪声在 ±30% 以上;同一副本同一张床先不带后带的单遍读数(verify-harness+22%、team-gates+10%、trial-gate+3%,以及先量到的dispatch-reserve-create+11 秒、project-gates+19 秒,后者复量复现不出)是在机器忙闲不定时量的,有噪声,不采用,只当量级;追踪器作者按单价外推verify-harness约 60 多秒,高于安静配对里的无差异,是外推偏高,同样不采用。追踪的单价与剖面见下面守不到⑬。 - 新补用例与新建整张床的自身耗时(分两类,各报各的;单张超过 10 秒的写明收没收下,不只报好看的几项):类① 新建整张床——测试守卫与引擎一侧的四张,机器大致安静时量:
face-parity.test.js5.4 秒、audit-batch-parity.test.js6.3 秒、incremental-parity.test.js6.2 秒、ledger-rt-alive.test.js0.4 到 0.7 秒;忙时face-parity约 11 秒、audit-batch-parity14 到 15 秒、incremental-parity约 9 秒 —— 这三张的 10 秒目标只在安静时达成,照实写。运行器与追踪器一侧的最终数字(机器安静时量):bed-pool.test.js(调度床)9.4 到 10.4 秒(上沿略过 10 秒);bed-write-trace.test.js(对账床,追踪器一半加运行器一半)13.8 到 15.6 秒,忙时 17 到 18 秒 —— 对账床超过 10 秒的目标,收没收下:已尽量收(追踪器一半单独时曾收到 6.5 秒〔账本 ms 为 6495;独跑 5.5 到 7.4 秒;模拟外层追踪 6.5 到 7.1 秒;空壳对照再跑一遍约 6.2 秒;收之前串行 11 秒以上,靠演练并行起、矩阵拆两半并行、驱动里并起收到的〕;加上运行器一半之后又收:假仓只拷运行器三个零件加test-roots、.git瘦到 7 个条目、同一假仓同一驱动连跑几轮、栅栏代替睡眠、收场并行删),收不下:耗时正比于起的进程个数,并行省不下来,样本一个不砍;也没有拆成三张,床名在签字时已锁。整仓安静串行一轮里运行器账上的单张读数:audit-batch-parity5.8 秒、face-parity4.0 秒、incremental-parity6.9 秒、ledger-rt-alive0.5 秒、bed-pool9.9 秒、bed-write-trace13.1 秒 —— 唯一超过 10 秒的是bed-write-trace,原因见上。追踪器被围栏拦下的修复(见「测试跑出并修掉的不一致与缺口」④)给这张床补了 J3、J4、J5、M10、M11 和 C5 的只读样本,84 例变 89 例,分两步量:先补到 87 例(J3、J4、M10、C5 只读样本)时,真仓第二轮之后机器安静,旧床(演练用的未改副本)与新床交替各跑三遍取中位数,整床 8.30 秒对 8.40 秒,新增用例自身约 +0.1 秒(噪声内),在 10 秒内;再补 J5、M11(体检官立案后补):这两个演练进程单独量各约 0.13 秒(并行起,不抬高整床墙钟),补完后整床读到 11 到 12 秒,是在机器忙碌约 60% 时读到的(同内容的两份交替量也是这个水平),没有在机器安静时重量整床,只当上沿;超过 10 秒的部分来自机器忙,两个新进程合计只占约 0.25 秒,不拆不收(耗时正比于进程个数的理由见上)。这几对读数都在真仓所在的机器上量,低于上面副本里的读数,盘与机器忙闲不同,只比各自的旧新。类② 补进已有老床的用例(改前改后耗时差):test-faces.test.js的 N 组自带计时 2.0 到 2.5 秒,整床交替量改前后中位数都是 10.7 秒(噪声内);harness-dev.test.js新增 C8b、C8c、C8d 与 E6 共约 1.8 秒;feature-dev.test.js多一次假仓里真跑中转脚本约 0.6 秒;plan-run.test.js只改断言文字、0 秒;守卫两张瘦身的前后用时见上(计时床 −28%,对拍床 −16%)。 - 文档(框架架构师改):架构详图文首版本改成本版。第六节「VERIFY 接上测试」补并发开关一句。第七节补「路径级忽略」一段(含诚实边界:检测器自己走目录树仍看得见
.claude/tmp、索引看不见,两种视图分叉)。第八节环1 派执行体通道补复盘者型号检查只拦什么一句;环3 增量检测补 oxlint 提前起跑、提前退出先收与起跑的局限,射程复用补文件清单不含.claude/tmp与守不到;接力命令跑床那一步补带--jobs。第十六节:唯一运行器补--jobs,--stale一句去掉「串行」,「测试面」一段补选床以带上游反查为准与对拍床,新增「跑床分道并发」一小节(机制只写这一处),「按张记录」补运行器上游组含bite/与记录多出的两个字段,收尾分级的重面一句补池里的床按独占用时求和,体检一段补批量函数,诚实边界补 ㉗(体检是时点快照)与 ㉘(并发的守不到,含追踪器看不见的清单),对照表补新床与运行器上游。体系守护技能说明(SKILL.md,自带版本 1.3.0 → 1.4.0)的beds一节改成新口径(缺省仍逐张顺序,--jobs才并发、会动真仓的床仍独占、红绝不改绿,全量命令带--jobs=4);参考文档x-harness-arch.md的 beds 一节补并发池与写追踪的设计取舍;决策记录加 ADR-110。逐处核过,架构详图与两份技能文档里没有「禁并发」这类与现状不一致的说法。 - 没动的:每张床判什么、检测判什么(判定口径、跳过口径、空壳对照的造法与豁免名单一个字没变,只有运行器的调度与上游组变);发布前测试与部署门入口(入口代码不动,函数床不合批);守卫其余拦什么放什么(只有复盘者型号检查收窄这一处);项目架构设计页与 agent 架构设计页(接力步序不动,「同步挪到跑床前」不做;「型号降级拦」「只看派发时带的型号参数」「强制开关下不会触发」三句仍成立);
guard.js、session-ledger.js、scope-cache.js、版本契约;写保护与判定代码的名单;x-styles 与 x-structure 两份规范的条款书、架构页里「常驻床禁并发跑」的说法(讲的是会动真仓的常驻床,这类床会被追踪判脏、走独占道,不在这一条的落点里,核过没动)。 - 守不到(照实写):① 非 node 的子进程,追踪只按它的工作目录与参数判,它真写了什么看不见:工作目录落在仓里、或参数里有仓根路径的算脏、不进池;工作目录在仓外、参数里又没有仓根路径,却用相对路径往仓里写的,追踪这一道看不见,交第二道快照(对账床 R5 演练:写到未入库的路径、写到追踪册里出现过的被忽略路径,独占道后的快照比得出来,这一轮学到的准入结论作废);② 追踪钩的是 Node 的 fs 入口,看不见的有:原生扩展;WASI;
process.binding;v8.writeHeapSnapshot、process.report.writeReport;node:sqlite;编译缓存目录;跨线程传来的 fd、继承来的额外 stdio fd(记成认不出路径,只会多判脏);路径别名(8.3 短名、subst、事先存在的目录联接或符号链接,经它们写进仓内、落在仓外);主线程被同步死循环占死时盯父进程的定时器不触发(由运行器的超时兜);记的是「要写」不是「写成了」、只记调用里给的那个路径(递归建目录时仓内此刻缺的祖先目录除外,那些按解析后的路径找、各记一笔;带..的相对路径里 Node 顺带建出来的中间目录不单独记,但总在已记的最上面一级之下,事后rm -r那一级照样还原得了;cp与rm -r里的子文件各自不记);同一个 fd 同一个入口 250 毫秒内的后续写只记第一笔;只在 Windows 加 Node v22.18.0 上验过;这几样靠第二道快照兜;③ 追踪器判「NODE_OPTIONS里已经有追踪器」用路径子串匹配:床自己在选项里带上追踪器路径字样(比如塞进--title=)就能让追踪器不再往子进程补自己,即床想逃过子进程注入是做得到的 —— 床是自家代码、不是威胁模型,意外撞上的概率很小(测试工程师发现,追踪器作者认下);④ 嵌套的追踪会话里,外层看不到内层床的写,只能记脏,这样的床永远只走独占道;⑤ worker 注入拿不准时(execArgv非空、床又清了NODE_OPTIONS):Node 22.18 里 worker 其实继承了父线程的预加载、写也被记到了,追踪器仍保守报没注入上,所以只钉「报了」、不钉「看不见」;⑥ 追踪看不见的写(非 node 子进程用相对路径等)若落在被忽略目录里、又是追踪册里从没出现过的新路径,第二道快照也看不见 —— 两道都比不出来,这张床会被学成干净(对账床 R6 演出来,S9 钉着快照这一半;是诚实边界、不是目标行为);第二道抓得到的是追踪册里出现过的被忽略路径、git 清单里没有的未入库路径、已脏文件的内容改动(R5、S7、S8);追踪册有条数上限、超了丢最老的,早先记下的被忽略目录路径可能不再被第二道逐个核;⑦ 池里两张床经网络端口或系统临时目录里的固定名互相干扰,只做过抽查,不是穷尽;⑧ 准入册与追踪册是本机状态,防的是忘记不是故意改写(与账本同一条边界);⑨ 体检是时点快照、不是闸,窗口等于一次审计的时长,「新鲜」计数有偏差也翻不了体检的结论;⑩ 检测器自己走目录树仍看得见.claude/tmp,索引看不见,两种视图分叉,今天没有规范的射程落在那里(见上面的普查),也没有闸盯着这件事;⑪ oxlint 提前起跑的局限:慢路径分批时同步段内只起第一轮(至多 8 批),增量检测的 js/ts 改动通常是单批;oxlint 输出超管道缓冲时要等引擎让出事件循环才读;非 Windows 上经 shell 起的子进程只杀得掉sh(本仓只在 Windows 用);⑫ 反向缺口(不在这一条的射程):x-standard/gates-detector-discipline.test.js的 0031 锚读.claude/skills/*/assets/templates/**,床头没有@covers,模板一改没有床判旧;收窄技能面之前就有;⑬ 追踪的代价(单价与剖面,体系工程师在 22 核、杀毒实时扫描的机器上量):每个被追踪的进程启动多约 13 到 15 毫秒(机器安静时不带 158 毫秒、带 173 毫秒;拆开看,读文件加编译加模块解析约 6 毫秒,顶部 require 内置模块净增约 2 毫秒,其余函数定义约 1.4 毫秒,装钩约 4 毫秒);仓内每记一行日志约 2 毫秒(每行打开、追加、关闭一次,1.9 到 2.3 毫秒,与日志长度几乎无关:日志 366KB 时 1.89、2.9MB 时 1.97 毫秒;杀毒拖慢开关文件);仓内第一次写一个新路径多约 4.3 毫秒(含写前的样子:取状态、读文件、算哈希);仓外路径的判断每次 1 到 13 微秒(纯字符串运算、不碰盘);读不钩;mkdir -p新建深树时每多记一层约 3.5 毫秒(新建四层的每次多约 10.6 毫秒,已存在的目录几乎不变,不带recursive的不变)。曾评估把每行打开追加关闭改成持久句柄(每行 23 到 42 微秒,便宜 50 到 100 倍),收益只占整轮的 3% 到 4%、还要重验追踪器,没做。整床的开销以整仓演练第三轮的配对为准(独占道 71 张合计 +3.2%,经部署门外壳的函数床 21 张 +26.5%、多 25 秒,逐张比的中位数 ×1.086,verify-harness475.5 秒对 474.4 秒没有差异;逐项见上面「早先参照与整仓演练」里的追踪开销一条)。早先同一副本同一张床先不带追踪后带追踪各量一遍的单遍读数,机器忙闲不定、有噪声,不采用,只当量级:verify-harness583 → 709 秒(+22%,+126 秒是机器忙闲的噪声;追踪日志 22153 行、被追踪进程 1025 个;把 +126 秒除以进程数得到的每进程约 123 毫秒是除法、不是单价)、team-gates56.3 → 61.8 秒(+10%,305 个进程)、trial-gate144.9 → 149.0 秒(+3%,159 个进程)。按上面的单价外推verify-harness约有 60 多秒(日志行数乘 2 毫秒约 44 秒,进程数乘 13 毫秒约 13 秒,起子进程复制环境约 5 秒),高于安静配对里的无差异,是外推偏高,也不采用。进程很少却显得慢的两张床,先量到过很大的开销(经部署门外壳的函数床dispatch-reserve-create10.1 → 21.3 秒,project-gates39.5 → 58.5 秒),之后在安静的机器上复量,复现不出:dispatch-reserve-create不带 5.3 到 6.0 秒、带 5.9 到 7.1 秒(交替先后顺序六对,中位 5.9 → 7.1,+1.1 秒),project-gates49.9 → 50.2 秒,追踪器自己花在这两张床里只有 0.43 秒与 0.60 秒(日志追加占大头);先前的 +11 秒与 +19 秒是量时机器的状态,不是追踪的开销。两轮整床互比噪声在 ±30% 以上,不能当追踪开销;⑭ 落盘之后全部床的旧记录作废(运行器判定口径区与上游组都改了),首轮开--jobs时没有准入结论、全部独占,不提速,整仓占着跑床锁跑完(机器安静时估约 55 分钟,加上第二轮池跑约 42 到 47 分钟、余量 15 分钟,占锁约 2 小时;演练第一轮实测的约 90 分钟是多人同时干活的时段里量的,不拿来估;排队上限 45 分钟,窗口里别的会话不跑床、不封版、不排接力的跑床那一步);⑮ 架构详图这一版补的几段,机器守不到:增量检测只核引用在不在,不核说得对不对,由独立复盘对着代码读原文核。 - 升哪一位:运行器多了一类东西(分道并发的池、准入册、写追踪预加载文件),所以升第二位;每张床判什么、检测判什么、守卫拦什么放什么没有改写,不是改写既有契约,不升第一位,也不是纯订正。
- 运行器 · 分道并发与写追踪(
- v5.3.x
检测提速·减负:守卫每轮收尾只给本会话改过的受治文件算指纹、写前判命令先问拦不拦再读台账、执行体停下台账只读一遍、收尾每轮分段计时记进会话台账;开发、发布、体系守护三条流水线去掉重复劳动;两张最慢的测试床减负;收尾单认遗留取最后一个去向写法、清理归档不再重复计失败;架构详图讲 x-agent 闸的一段订正成现状,讲收尾、台账事件与流水线的几处描述同批补齐
设计指纹67af26fc内容指纹6d6a0b4d测试指纹fccb0e2d50f65143改动设计 1 个(harness-engineering.md);代码 11 个(guard.js、command-policy.js、requirements.js、session-ledger.js、stop-handler.js、team.js、verify-harness.js、index.js 等)
需求检测提速·减负签字 d87f已发布
为了:检测提速·减负 —— 检测提速的第一步:去掉每轮收尾检查与开发、发布、体系守护三条流水线里的重复劳动,给两张最慢的测试床减负,顺手修两处框架小毛病;检测和测试判什么、守卫拦什么放什么一个字不变。
- 守卫 · 收尾对账(
requirements.js,体系工程师改):同一批输入下拦与放、报文、落盘内容逐条不变,只有报文里「范围外的改动」那条附注可能变少、整条消失。每轮收尾的需求对账原来先给全部受治文件算一遍指纹、再拿本会话改过的那几个去比;现在新增并导出fingerprintsOf(root, keySet),遍历受治名单、只对文件键在keySet里的文件算指纹,算法与全量的fingerprints逐字相同(.claude/settings.json走把开闸与关闸算成同一份的中和哈希,其余走普通哈希)。stopAudit给它的keySet就是touchedBySession—— 收尾环算好的归属里本会话名下与分不清两栏,加台账里本会话的写证据;「变没变」的比较也限在这个集合里,删掉的文件照旧算改过。依据:judgeChanges里判成「本会话的」「分不清」的文件只有这几样来源,所以拦的两条(本会话写的改动不在任何签过字的需求范围里、落进别的会话在办的需求范围里)与记进账本的越界记录不变;别的会话与没有写证据的改动不再被逐个读、不再列。列受治文件的governedFiles多一个可选参数skipIgnoreFiles:点名的文件键里没有.gitignore与.git/info/exclude时,不做补忽略清单那步遍历;不传参数与原来逐字相同。 - 守卫 · 写前判 Bash 命令与执行体停下(
command-policy.js、guard.js、team.js,体系工程师改):判法一个字不变,只少读台账。写前判 Bash 命令的写文件一支(reqWriteWhy)原来先ctx.touched读一遍本会话台账、再问这个文件拦不拦;现在先writeBlockWhy(…, false)按「没写过」问,放就不读台账,被拦而且ctx.touched为真才用 true 再问一次 —— 本会话写没写过只会放宽、不会收紧,所以先问「没写过」放了就是放;与编辑工具那一支同一个顺序。执行体停下原来记停(recordStop)与判停(stopWhy)各读一遍本会话台账;现在guard.js读一遍(team.eventsOf导出),经opts.evs传给stopWhy、经第四个可选参数evs传给recordStop,不传时与原来逐字相同。 - 守卫 · 收尾分段计时(
session-ledger.js、guard.js、stop-handler.js,体系工程师改):新增recordRoundTiming与roundTimings。每个收尾轮恰记一笔留痕类事件{k:'rt', t, ms, segs}—— 时刻、本轮总用时(毫秒)、各段用时;segs恒有十六个段键(boot、measure、attribute、trial、team、tests、seal、assembly、site、detect、side、audit、notes、archive、record、other),各段之和恒等于ms;用process.on('exit')一处管所有出口(收尾提前返回的那条路径 —— 继续拦那一轮、且没有上一轮红数 —— 以前不写台账,现在也记一笔;零件装不上的收尾也记一笔),runStop的返回里可选多一个timings字段(tests、seal、assembly、site、detect、side六段的用时)。执行体停下那一支不记;记账失败不影响放行与拦截(仓里一贯写法:记不下不影响判)。rt没有文件键,不进归属、干净结论与拦不拦的判定;账里能按段取出每一轮的用时,给后面决定收尾能不能并发做时定收益用。 - 开发流 · VERIFY(
verify-feature.js,体系工程师改):按改动跑测试床那一步带--stale,只补跑对当前内容不新鲜的床、已经通过的沿用,与接力命令里跑床那一步同一个口径;床过没过、记成什么仍由唯一运行器照旧判,这里只多了筛选这一步(机制见架构详图 §十六「只跑不新鲜的」)。 - 发布 · 发布前验证(
x-deploy-dev的server/validate/index.js,体系工程师改):验证一批云函数时,原来循环里每个函数起一次部署门入口(x-test/run-deploy-gate.js);现在提到循环外只起一次、一次收全部函数名(入口本来就认一次给多个名字、取并集,内核面的床只跑一遍),每次最多 80 个,多了分批;一批里有一个红照旧整批红。照实写一处差别:入口自己遇到第一张红的床就停,所以同一批里某个函数的床红了,排在它后面的函数的床这一轮不再跑 —— 整批红的结论不变,后面的函数红不红要等第一张红修掉之后再看。 - 体系守护 · 接力命令(
plan-run.js,体系工程师改):七步里封版那一步,在规范同步没有同步任何系统规范域时沿用接力开头那次只读三查的结果单(c.sheet0)、不再重算一遍;同步过的照旧重算(同步可能刚刷新过条款书与架构页的派生区,开头那张单子已经旧了)。 - 体系守护 · 收尾单与清理归档(
plan-wrapup.js,体系工程师改):收尾单认遗留的LEFT_ITEM_RE改成贪婪匹配,遗留原文自带「—— 去向:」时取最后一个当去向(原来取第一个,这样的遗留被误判成去向没定);清理归档时,登记的子路径已经不存在(父目录已清掉)写成「已不在」(goneNow)、不再计成失败,接力命令不因此退出 1。 - 测试 · 守卫的床(测试工程师写):新建两张。
guard-trim-parity.test.js(共 40 条)把改前与改后的结果逐条比,分四组:A 组收尾对账 22 个场景(本会话写的、别的会话写的、分不清的、被删掉的、新建的受治文件,加大小写不同的键、.claude/settings.json、多份基线、已完结的需求、签字作废、无版本库、被 gitignore 的产物等边角;金值录自改前的守卫),B 组读盘计数 6 条,C 组写前判 Bash 命令 6 组共 22 步,D 组执行体停下 6 条。stop-timing.test.js7 条,核每个收尾轮恰记一笔进账、字段齐全、按段取得出来,账写不进去时放行与拦截的结论不变。requirements.test.js里 5 处有意改的附注断言,主回归套件verify-harness.js里 RQ22 那条断言(正是允许变少的那条附注)与一行注释同批改写。对拍结果:收尾对账 336 组(含随机)与改前 0 差异,写前判命令 2880 组判定逐条相同、读台账次数 512 降到 200;最终成品上做了 19 个变异(把判法改坏,如撤回只算碰过的文件的指纹、撤回先问再读、计时什么都不记、停下关再读一遍台账、少一个段名),每个都让预期的断言红;换成掏空的守卫副本,对拍床 40 条里 38 条红、计时床 7 条全红(对拍床剩下的 2 条本来就是「放行、无事件」,空壳蒙得过)。 - 测试 · 流水线三处与收尾归档的床(测试工程师改):
feature-dev.test.js新用例核 VERIFY 跑床带--stale、对当前内容已通过的床不再重跑;deploy-dev.test.js的 T13 核一批函数只起一次部署门入口、一批里有一个红照旧整批红;plan-run.test.js新增三条核该复用时复用、有同步时照旧重算;plan-wrapup.test.js33 → 35 条,补两例 —— 遗留原文自带「—— 去向:」时取最后一个,登记的子路径已不存在时不计成失败、退出码 0。 - 测试 · 两张最慢的床减负(测试工程师改):样式射程床(
border-axis-scope.test.js,归 x-styles 这个版本单元)起真检测引擎的次数从 24 次降到 11 次,回到基线那 6 次(故意多查几条规范、防探针污染)照留,基线红就当场退出、后面的探针不再种;用例 21 → 21,断言 31 → 33,不得误伤的反例一条不少;它自己的改动写进 x-styles 那一版的变更历史,这里只记一笔。体系守护总自测(harness-dev.test.js)把 L3 体检、全仓卫生检查、discover、--help与未知动作这几处的取数合并成各取一次、几条用例共用;用例 85 → 85,断言 332 → 332。 - 测试 · 空壳对照(取自唯一运行器的账,逐张查过):这一版新建与改过的床都做过空壳对照,账里逐张记着结论 bites(换成空壳后变红,退出码 1)—— 守卫对拍床
guard-trim-parity.test.js、计时床stop-timing.test.js、requirements.test.js、feature-dev.test.js、deploy-dev.test.js、plan-run.test.js、plan-wrapup.test.js、体系守护总自测harness-dev.test.js;样式射程床border-axis-scope.test.js的对照记在 x-styles 自己那一版里,这里只指过去。 - 用时对比(来源都写明):① 收尾对账里算指纹那一段:改前每轮全量算约 4.4–5.5 秒,改后只算本会话改过的文件约 1.1–1.6 秒,约 3.5–3.8 倍,剩下的底是
git ls-files约 1.2 秒(对真仓只读,机器当时有别的会话在跑床,绝对值偏大,看比例);仓外沙箱对着约四千个受治文件,对账段中位 2030 → 309 毫秒、整轮中位 3097 → 900 毫秒;办理会话落地后那一轮实测对账一段 0.55 秒。② 两张最慢的床:样式射程床账本 307559 → 234297 毫秒(机器被占着);体系守护总自测 113666 → 94423 毫秒(同时段对照 123.9 → 103.7 秒)。③ 新建与新补的用例自身耗时:plan-run.test.js新增三条合计约 4.9 秒,deploy-dev.test.js的 T13 约 1.9 秒,feature-dev.test.js新用例约 1 秒;守卫两张新床(对拍床 40 条、计时床 7 条)直接跑、机器安静时各约 25 秒,运行器账里分别记了 111.5 秒与 167.5 秒(落地那段机器被占着)—— 它们只在守卫的文件改了才重跑,不在每轮收尾里付。④ 收尾整轮:改前没有计时账,来源有三:10-10 以来 3019 轮的平均 9.4 秒(分析时从会话记录里取的);这条需求的办理会话里落地前的两轮 12.3 与 11.6 秒(会话记录);上面①的沙箱对照。改后账里(k:'rt'事件)记下 7 轮,来自两个会话:办理会话 1 轮,整轮 8.5 秒(对账一段见①);另一个会话 6 轮,整轮 5.0、21.3、24.1、45.7、58.8、112.9 秒(忙轮,干的活比办理会话重得多);7 轮中位 24.1 秒。各轮干的活不同,整轮不能直接对着改前平均比,可比的是①的对账一段。⑤ 各段占比(7 轮合计):无主改动复核(side)45%、台账整读与归属(attribute)15%、测试新鲜度(tests)13%、需求对账(audit)9%,四段合计 83%;量工作树(measure)6%、检测引擎各批(detect)5%、治理站点新鲜度(site)3%,其余各段合起来不到 3%;每轮中位side10.3 秒、attribute4.7 秒、tests4.2 秒、audit2.0 秒。样本只有 7 轮、两个会话,这一版只是把账记起来,比例留给后面的「检测提速·并发」用更多轮复核。 - 文档 · 架构详图(框架架构师改):文首版本改成本版。第六节「VERIFY 接上测试」补一句:按改动跑测试床带
--stale、只补跑不新鲜的,与接力命令里跑床那一步同口径。第八节:环2 讲台账事件的那一段补收尾轮计时事件rt(时刻、总用时、十六个段的用时,没有文件键;它的时刻算会话动静,被平台超时掐掉的那一轮没有这一笔);环3 需求对账「守卫提速的几处口径」第④⑤两条改成现状 —— ④ 写前判 Bash 命令的写文件那一支同样先按「没写过」问、放就不读台账,⑤ 收尾对账只给本会话改过的文件算指纹(附注的条数可能变少);接力命令那一段补一句:封版一步在没有同步系统规范域时沿用开头的三查结果单。第十五节:NS-5(model 白名单)改成现状 —— 白名单是七个精确值(官方别名 opus、sonnet、fable,继承 inherit,完整型号名 claude-opus-5-5、claude-sonnet-5-5、claude-fable-5-1),实际型号由项目设置统一强制(子代理型号加强制开关),白名单只防写出平台解析不到的型号名,原来写的「禁 sonnet/haiku」「物理化模型分派铁律:最低 opus」去掉;NS-8 后面补 NS-9(推理档与型号只写一处:名册里没标「只作主会话」的执行体文件必须写effort: max、不许写model,标了的不许写effort;判据是 x-agent 的 NS-COMMON-0009,条款是 ARCH-A05,x-agent V1.6.0 立);生命周期那一段讲新增执行体的地方点上 NS-9。逐处核过,全文别处没有「八颗闸」这类与现状不一致的说法。 - 没动的:检测引擎与测试运行器的判定口径(判什么、怎么判、记成什么一个字没变,只有调用它们的几处少做重复);发布前的版本比对;守卫认旧的干净结论的口径;守卫派复盘者时的型号检查(它与 x-agent 的 model 白名单是两件事,改它会改变拦与不拦,与这一版承诺的「拦与放逐条不变」相冲,这一版不碰);三查的核对命令(
requirement-check.js)每次仍对全部受治文件算指纹,auditTests单次约 13 秒和全仓卫生检查每次重算也没动 —— 这几处是判决依据或运行器,留给后面的「检测提速·并发」。 - 守不到(照实写):① 守卫的对拍床只覆盖它造出来的那批输入 —— 真仓里没造到的组合它看不见,改前改后在那些输入上是不是逐条相同,这张床证不了;② 收尾分段计时的账只在新床里核「每个收尾轮恰记一笔、字段齐全、按段取得出来」,改后的用时是从账里取出来写进这一版说明的,改前没有账(来源见「用时对比」④),这一半机器不核,由独立复盘抽查账里的记录;③ 钩子被平台超时掐掉的那一轮没有
rt(计时在进程退出时记);④ 收尾提前返回的那条路径(继续拦那一轮、且没有上一轮红数)以前不写会话台账、现在记一笔rt,零件装不上的收尾也记一笔;rt的时刻会被「判主人会话已结束」当成这个会话最后一笔动静,只会让判断更晚、不会更松;⑤ 架构详图 NS-5 与 NS-9 那一小段,以及这一版补的几句,机器守不到:增量检测只核引用在不在,不核说得对不对,由独立复盘对着 x-agent 的判据与条款书、对着守卫的实现读原文核。 - 升哪一位:守卫的会话台账多了收尾轮计时
rt这一类事件(新增一类东西),三条流水线的做法跟着改,所以升第二位;检测和测试判什么、守卫拦什么放什么没有改写,不是改写既有契约,不升第一位,也不是纯订正。
- 守卫 · 收尾对账(
- v5.2.x
签字带高保真:计划「设计」页签最顶上写场景判定;改界面的需求把用户点过头的那一版高保真放进自己的 preview 目录、嵌进看板「设计」「签字」两个页签,由对着它的标准里写着的文件名与内容指纹锁住;架构详图车道表与开发规则书照新做法改口
设计指纹f1b3cd71内容指纹7afdda81测试指纹48762b357ead1223改动设计 2 个(harness-engineering.md、x-dev-rule.md);代码 1 个(PLAN-TEMPLATE.html)
需求签字带高保真签字 dfd4已发布
为了:签字带高保真 —— 用户和主控来回画过、点过头的那一版高保真,此前不进签字档:签字锁住的是需求、标准、用例与落点表,不锁预览,归档的看板里只有文字写着去 preview 看(核过最近五条带画面的需求都是这样),日后复盘找不回签的是哪一版。用户 10-18 签了确认:改界面的需求,点过头的那一版直接嵌进看板、一屏看完不用点开,由对着它的标准锁住;每份计划「设计」页签最顶上写明走哪条流程、哪一档、凭什么,日后复盘照它对。计划模板多了两类块、改界面的需求多了一条规矩,是新增一类东西,升第二位。
- 资产 · 计划模板(
.claude/skills/x-feature-dev/assets/plan/PLAN-TEMPLATE.html,体系工程师改,照签字页签里第 1 版高保真):「设计」页签最顶上加「场景判定」一块,写这条需求走哪条流程、哪一档、凭什么(落点认出的流程、中了哪几个风险标记、为什么定这一档、要不要高保真);「设计」「签字」两个页签各加「高保真」一块,只在改界面的需求里有、不改界面的整块删掉 —— 每一版直接嵌着、一屏铺开不用点开,写明是什么、对着哪条标准,旁边一个单独打开的链接与内容指纹(文件 SHA-256 的前 8 位);签字页签那一块排在最上面、在核对命令生成的那一段(签字区那对标记)之外,核对命令不生成也不刷新它。 - 文档 · 架构详图(框架架构师改):文首版本改成本版。第十五节车道表「业务流程 · 小事」「业务流程 · 成条的事」两行「走哪几步」那一格,讲预览的那半句(「签字之前附要改的那一屏的截图或预览」与「页面预览」)改成新做法 —— 用户点过头的那一版高保真放进这条需求自己的 preview 目录(被否的几版留着、名字带第几版,不盖不删),嵌进看板「设计」「签字」两个页签,对着它的标准写明本计划 preview 目录里的文件名与内容指纹;两格都以「改界面的」起头(与开发规则书同一个说法),小事那一格留着「要改的那一屏」(同一格后面「看那一屏、验收」接的就是它),成条的事那一格的需求清单、字段与接口表照留;表头、行名与别的格没动(立项命令照抄「走哪几步」那一格进看板「步骤」页签,难事那一格以「同成条的事,另加」打头,跟着成条的事走)。「先分级、再选路」那一段补一句:认出的车道与凭什么写进计划「设计」页签最顶上的「场景判定」一块,日后复盘照它对,这一块机器不读。第八节「签字搬进看板签字区」那一段补上「签字」页签最上面、签字区之外的「高保真」一块:在核对命令生成的那一段之外、核对命令不生成也不刷新它;锁住这一版的是对着它的那条标准里写着的文件名与内容指纹(只写这条需求自己 preview 目录里的文件名、不写仓里的完整路径:计划归档之后路径会变,需求履历里的计划路径也会被剥成占位;标准原文进内容编号、一改签字作废,预览文件不进);守卫在签字那一刻不另记它的指纹;看板带进治理站点时这一块换成一句字。
- 文档 · 开发规则书(
.claude/rules/x-dev-rule.md,元治理专家改):「业务流程三档」表里小事、成条的事两行写到预览的那两句,照同一个做法改。 - 测试 · 业务开发的床(
.claude/skills/x-feature-dev/tests/feature-dev.test.js,体系工程师改):读真仓的计划模板、架构详图与开发规则书,钉住模板里这三块(场景判定、「设计」页签的高保真、「签字」页签在签字区之外的高保真)与新写法都在;改坏对照:在内存里删掉任何一块、或把新写法换回旧话,床就红。读计划模板的另两张床只重跑、不改;立项与出题那张床照抄真仓车道表「走哪几步」那一格比对,表形没变,跟着新写法走。 - 没动的:守卫(签字锁住的东西与内容编号一样没变,签字那一刻不另记高保真的指纹)、核对命令(照旧只写签字区那对标记之间)、复盘说明、立项命令(照抄车道表那一格,代码不改)。项目架构设计页里「签字之前附那一屏的截图或预览」那一句这次不改 —— 替用户定的取舍、他签确认时没有划掉:那一句照旧成立,改它就多一个版本单元,三个单元按七个风险标记算难事。
- 守不到(照实写):守卫在签字那一刻不另记高保真的指纹 —— 签了之后改了 preview 目录里的文件、标准没改,签字照样有效,要靠复盘时拿文件重算指纹、对着标准里写的看出来;一条需求改不改界面、该不该有高保真、嵌的是不是点过头的那一版,机器都不核;场景判定是写计划的人写的,机器不读,也不拿它与签字区顶上、复盘说明里机器按落点现算的车道比;治理站点上看不到高保真,看板带进站点时那一块换成「(高保真没有带上站点:标题)」这句字,要看原样去仓里的计划目录或归档目录。
- 与站点规范的关系:看板带进治理站点时把指不到的内嵌页框换成一句字,这一样归站点规范 x-harness v1.15.0(同一条需求的第 1 批先落 —— 不先改构建器,看板一嵌上高保真,发布前的全站引用核对就让整站发不出去);本版在架构详图第八节那一段只指过去,不另写判法。
- 资产 · 计划模板(
- v5.1.x
车道上机:签「确认」那一刻守卫按落点认流程、按七个风险标记算最低档,写低了签不上,认出的车道记进签字;改判定代码的需求同一时刻只办一条;出题、立项与复盘说明照车道走;发站点不再要会话回一句「这一轮结束」、签字没记上一律说原因、验收完结之后收尾与归档交给接力命令、只改业务设计页的需求只随治理站点上线;守卫核复盘者只认条目类型是 user;项目架构六道门改用阶段命名
设计指纹757cea69内容指纹db7e0ac5测试指纹503b6cff261d3738改动设计 8 个(CLAUDE.md、harness-engineering.md、ADR.md、x-dev-rule.md、SKILL.md、SKILL.md、SKILL.md、SKILL.md);代码 23 个(guard.js、checker-invoker.js、gate-measure.js、release-versions.js、requirements.js、session-ledger.js、stop-handler.js、verify-harness.js 等)
需求车道上机签字 466a已发布
为了:车道上机 —— 流程立法只立了法:认流程、最低档、改判定代码同一时刻只办一条都靠纪律,留给后一条需求上机;用户 10-16 签了这一条,要签「确认」那一刻由机器认车道(需求 1、2),顺带修昨晚记下的三个毛病(需求 3)与发布登记推格的毛病(需求 6),并进守卫小需求(需求 5)与项目架构六道门改用阶段命名(需求 7)。新增一类东西(签「确认」那一刻认车道的三道核),升第二位。
- 守卫 · 需求零件:签「确认」那一刻(与定档、同一块排队、阶段六的关口同一处)多三道核 —— 按落点认流程、按七个风险标记算最低档、签字锁住的目录碰到判定代码的需求同一时刻只办一条;认出的车道记进签字一那一笔、不进内容编号,机器镜像新加的两栏(permission 动权限与身份、breaking 改已发布字段或删功能)为真时进签字锁住的内容,记过车道的重签照新核;写保护的扣除项、判决依据、判定代码三份名单写成一处常量。像签字却没记上的一律说原因,验收那一支的重算放进子进程、有时限;完结那句回话的下一步写成跑一次接力命令收尾。阶段六的关口那一段回话的开头由「收场:」改成「收尾与归档:」。
- 守卫 · 会话台账、部署门测量与守卫入口:收窄到原料目录的站点发布(治理站点、官网、手机端网页版),别的会话名下内容没变、以前查过干净的文件当场重查,过了就放行并记成无主的干净结论;收尾补说一次签字没记上;核复盘者拿掉只给床留的扁平造法那一支,只认条目类型是 user。
- 体系守护技能与发布先查:立项照车道填「这条车道走哪几步」、删两个过时的回报节点、开闸关闸两个节点注明可划掉;出题多一句车道;排队一览多印判定代码那一行;复盘说明照抄车道表「复盘」那一格;接力命令多「完结之后」三步(刷新收尾单、预览清理归档、去向都定过又没人跑床建站才归档);十态里已完结与已发布两态的下一步改成跑一次接力命令;发布先查用同一个重查判法、只查不记;发布登记推格时,业务域那一行的目录至少写了一条、而且条条都落在业务架构目录下的(只改业务设计页)不按端推格,有一行这样的需求就带上「治理站点」一格,十态与收尾单第四栏用同一份推法。排队一览第五段改叫「卡在收尾与归档」,出题与用法说明里讲收场的几处同改。
- 检测引擎与元治理封版命令:版本契约与封版命令给人看的报文里讲门的几句改用阶段命名(讲门五的改「阶段五的关口」,「守着六道门的是框架的床」改「守着六个阶段那几道关口的是框架的床」)。
- 文档:宪法第四节括号与第五节两个环;架构详图第三、四、六、八、九、十四、十五、十六、十七节;决策记录加 ADR-106、ADR-107、ADR-108、ADR-109;开发规则书官网的说法;四份技能说明。架构详图、体系守护与业务开发两份技能说明里讲项目架构门号的地方改叫阶段号,术语表「收场」那一行换成「阶段」、「关口」那一行补一句(项目架构六道门改用阶段命名,ADR-109)。
- 测试:守卫的签字、排队、会话台账、部署门测量、收尾与守卫入口几张床,体系守护的立项出题、复盘说明、接力、清理归档、十态、发布登记与总自测,业务开发、发布与元治理技能的床照新规矩改写或新加;签夹具计划的床照新规矩调档或拆分;三张守卫床里的扁平造法换成真记录的形状;钉着旧门名与「收场:」的几条断言(体系守护总自测、排队一览、守卫回话)照新名改。
- v5.0.x
流程立法:守卫核复盘者时只认条目类型是 user 的提示词,平台写进执行体记录的请求拷贝不再被数成第二条提示词、复盘不再一律记成不可信
设计指纹193a5278内容指纹4388f08f测试指纹b5a5d2f8bc927f54改动设计 1 个(harness-engineering.md);代码 1 个(guard.js)
需求流程立法签字 17ba已发布
为了:流程立法 —— 10-15 傍晚起平台往执行体的记录里多写几类条目,其中请求的拷贝(api-request-blob)消息角色是 user,守卫把它数成第二条提示词、判成续跑,每一次独立复盘都记成不可信(治理站点首页那条需求的复盘先撞上,这条需求的复盘也躲不开);用户 10-16 凌晨重签时把它并进这条需求(需求 8、标准 10)。是订正:既有各道门的判法没有改写,升第三位。
- 守卫 · 复盘者收尾那一段(guard.js 的
firstPrompt与promptCount):认一条记录是不是用户消息,由「消息角色是 user,或者条目类型是 user」两样占一样就算,改成「条目类型是 user,或者整行没有类型而消息角色是 user」—— 带了别的类型的一律不算;取第一条提示词与数提示词用同一条。别的一样没动:平台注入的说明(isMeta、turnCompanion)照旧不算,只有工具结果的照旧不算,读不出的行照旧按提示词算(往安全的方向错),同一个提示词编号照旧只算一条。此前:平台从 10-15 傍晚起多写三类条目(api-request-shape、api-request-blob、api-request),其中 api-request-blob 是发出去的请求的拷贝,消息角色是 user(也有 system)、内容是文字块、不带提示词编号,头一份装着几块 system-reminder 加提示词全文 —— 它被数成第二条提示词、判成续跑、复盘记成不可信;它要是排在真提示词前面,取到的「第一条提示词」就是它,核不上「逐字就是程序生成的复盘说明」(今天它排在后面,这一处还没撞上)。 - 留下的一支(照实写):「整行没有类型而消息角色是 user」这一支只给床的扁平造法走 —— 守卫目录下的回归套件 verify-harness.js 与 block-ledger、record-effort-leftovers 三张床里,一共 13 处造法不带类型;真记录里没有这种写法(10-15 起 22 份执行体记录只读核过)。直接拿掉它就要连改这三处造法,其中两份不在这条需求签过字的落点表里,所以这一版留着它;下一条小需求把三处造法换成真记录的形状,再拿掉这一支。
- 测试 · 守卫的床(record-effort-leftovers.test.js)加一组 RE14–RE16,都经守卫入口、照真记录里条目的形状与次序造记录(夹具域名单多一个):RE14 程序生成的复盘说明后面跟着平台写的几类条目,判成没被续跑、这一笔可信;RE15 同样带着请求拷贝,另有一条类型是 user 的第二条提示词(另一个提示词编号),照旧判成续跑、标不可信;RE16 请求拷贝排在真提示词前面(拷贝里也装着说明全文,前面还有几块 system-reminder),照旧认得出复盘者、取到的第一条提示词就是那份说明、照记可信。改坏对照:整个换回旧条件,RE14、RE16 红;只换回数提示词那一处,RE14、RE16 红;只换回取第一条提示词那一处,RE16 红;RE15 三种都照旧过(它守的是真的续跑照旧判得出来)。原有各条用例一个字没改。
- 做法与验到什么程度(照实写):照签过的计划,在仓库外面的副本上改与跑床,开一次闸只落这两份 —— 守卫是脊柱,改守卫入口落地之前要把守卫目录下的床新旧两版全跑一遍。新版 20 张床里 19 张过、0 张没过,装配面那张直接跑要拿真仓的跑床锁、临时改真仓的固件,在副本里原地另跑、15 条全过;旧版只有 record-effort-leftovers 红了 RE14、RE16 两条,其余全过。落之前核真仓这两份与底稿逐字节相同,写完回读与副本相同;verify-harness.js、block-ledger.test.js 一个字没动。落进真仓之后按面重跑守卫的床,结果见本版测试指纹。真记录只用只读脚本数过(这条需求一位执行体的记录:旧条件数出 2 条、新条件 1 条),还没在一次真的独立复盘上走过 —— 这条需求的复盘入账时才算真验过。
- 文档 · 架构详图:文首版本改成本版;正文讲复盘者的几处(只按收到的第一条提示词认、续跑不可信)没写怎么认用户消息,照旧成立,没改。
- 守不到(照实写):守卫只认条目类型 —— 平台以后要是写进类型就是 user、却不是人写的提示词的条目,照旧会被数成提示词(往安全的方向错:判成续跑、复盘不可信,不会把真的续跑放过);不带类型的扁平写法在真记录里出现,照旧按角色认(今天没有)。
- 守卫 · 复盘者收尾那一段(guard.js 的
流程立法:五类架构改成自上而下的五层;需求不再一律走同一条流水线,按落点分五条流程(三条主流程、两条辅助),每条按大小分三档、共十五条车道;派工先认车道;设计只写当前这一版
设计指纹baf11efa内容指纹f78027c1测试指纹ac4fd5327697069f改动设计 4 个(CLAUDE.md、harness-engineering.md、ADR.md、x-dev-rule.md);代码 0 个
需求流程立法签字 6a7f已发布
为了:流程立法 —— 用户 10-15 定:不再让大小、种类不同的事都套同一条流水线,改成按落点分 Harness、规范、业务三条主流程与运维、分析两条辅助流程,每条按大小分三档;五类架构说成自上而下的五层、各答一个问题;每一类架构的设计只写当前这一版,历史只进变更历史。改写了宪法里既有的两段说法(第三节「两把尺子」、第四节讲需求流水线的那一段),升第一位。
文档 · 宪法(第三节、第四节三处与第二节、第六节第 1 条都在原行改写,行数没变;只写定性与存在性,没有数字、没有机制;别处一字不动):
- 第三节「两把尺子(定性)」(段首名字没改):由「五类架构(agent、业务、系统、框架、项目)说的是设计写在哪 —— 谁来干活、怎么组队,业务长什么样,写法要守什么规范,这套体系自己怎么拦,一条需求怎么从提出走到上线」(五类并列、不分上下)改成五类架构是自上而下的五层、各答一个问题:业务架构答「做什么、为什么做」,系统架构答「按什么规范写」,项目架构答「怎么一步步做成」,agent 架构答「谁来做」,框架架构答「凭什么保证做对」。住处那一句由「agent、业务、系统、项目四类住架构层的四个目录」改成按五层的次序「业务、系统、项目、agent 四类住架构层的四个目录」。新加两句:「从上往下读是落地:上一层要的,下一层接住;从下往上读是管控:框架管住 agent 团队,团队办项目,项目改规范与业务,规范约束业务的写法」(「agent 团队,团队办项目」是用户在审核点一定的);「五层不是严格的上下级:规范管的是写法,规范的检测对每一层的文件都起作用,横着管各层」。由「六层说的是谁管谁,它是框架架构里讲的内容,属于框架架构,不是又一类架构」改成「六层是框架架构里讲的控制骨架(上面那张 L0–L5 的图),说的是框架这一层里头谁管谁,不是又一类架构」。由「反过来,agent 架构是架构的一类,不是六层之外的又一层 —— 执行体纵贯各层干活,不占层号」改成先点明五层分的是架构、六层分的是控制骨架,同叫「层」不是一回事,再接「agent 架构是五层里的一层,却不是六层之外的又一层,执行体纵贯六层干活,不占层号」。「框架架构就是架构详图」与末句「两把尺子量的不是同一件事,不互相替代」照旧。
- 第四节:「五类需求,一条流水线(定性)」那一段整段换成「按落点分五条流程(定性)」。由「改 agent 架构、改项目架构、改框架、改系统规范、业务需求,走的是同一条需求流水线(§六.8),差别只在落在哪个版本单元、从哪个入口进、谁动手、往哪发 —— 入口表详 harness §十七」改成:改宪法、框架的机制(检测、守卫、工作流)、项目架构、agent 架构,以及五层怎么写、怎么管,走 Harness 流程;改一份系统规范,走规范流程;业务需求,走业务流程 —— 这三条是主流程。不改仓、只动线上的部署与版本,走运维流程;只分析、不改任何东西的,走分析流程,它是所有流程的入口 —— 这两条是辅助。每条流程按大小分三档,手续的轻重跟着档走,一条流程里的一档就是一条车道,五条流程共十五条车道;三条主流程每一档都要走 §六.8 的闭环。走哪条由落点(这件事落在哪个版本单元)定、不由人选;车道表详 harness §十五,入口表照旧详 harness §十七。三档各叫什么不写进宪法(归架构详图的车道表)。宪法全文不再有「五类需求,一条流水线」这一句的任何写法;「相关文档」表里的「五类需求入口表」是那张表的名字,没动。
- 第四节「运作方式」:由「派工先分级:手续的轻重与事情的大小相称,简单的事不许复杂化(§六.8 的闭环不因此省)」改成「派工先认车道:先由落点认出流程,再按事情的大小定档,手续的轻重跟着档走,简单的事不许复杂化(主流程的 §六.8 闭环不因此省)」。这一段别的句子一字没动。
- 第二节第一最高律下面三行与第六节第 1 条(用户在审核点一同意照五条流程的说法对齐):由「业务功能的增 / 改 / 删,统一经 /x-feature-dev 编排、内部 fan-out 到四端」「规范 / 规则自身的变更,经 /x-meta-dev」「框架、项目架构与 agent 架构的变更走需求流水线,没有专属工作流,封版用元治理封版命令」改成「业务功能的增 / 改 / 删走业务流程,统一经 /x-feature-dev 编排、内部 fan-out 到四端」「系统规范自身的变更走规范流程,经 /x-meta-dev;没有配对规范的规则书归框架,走 Harness 流程」「框架、项目架构与 agent 架构的变更走 Harness 流程,没有专属工作流,封版用元治理封版命令」;第六节第 1 条由「业务功能的增 / 改 / 删,统一走 /x-feature-dev;规范变更走 /x-meta-dev;框架、项目架构与 agent 架构的变更走需求流水线(第一最高律)」改成「业务功能的增 / 改 / 删走业务流程,统一经 /x-feature-dev;规范变更走规范流程,经 /x-meta-dev;框架、项目架构与 agent 架构的变更走 Harness 流程(第一最高律)」。
- 第二节「版本契约(存在性声明)」那一条(用户审核点三之后定的):在「封过的一版不能改」之后加一句定性「每一类架构的设计只写当前这一版的完整内容,版本与历史只写在变更历史与决策记录里,机制细节只写在架构详图一处、各设计页指向不抄」。原行改写,行数没变。
文档 · 架构详图(文首版本改成本版):
- 第十四节:三层文档分类那几条之后加一段「设计只写当前这一版」—— 五类架构的设计(业务域文档、系统规范的架构页、项目架构设计页、agent 架构设计页与本文)只写当前这一版的完整内容,正文里不写版本号、不写「此前」这类历史,改过什么只写在变更历史与决策记录里;机制细节只写在本文一处,设计页写一句指向、不抄;既有设计页里的旧注记改到哪一页就在那一次清(不为清注记单独升版、不回头改封过的旧版),本文自己的注记单立一条需求清;机器今天只守项目架构设计页一页。
- 第十五节「先分级、再选路」(粗体名字没改,免得连带引用它的几处):开头加「车道 = 流程 × 档」并点明五条流程;由「主控接到一件事先定档、再选路,手续的轻重跟着档走」改成先认车道(先由落点认出流程、再按大小定档)、手续的轻重跟着车道走;「机器规定必须走的只有五样……哪一档都不省」改成三条主流程哪一档都不省、运维与分析两条辅助流程不立需求。三档表(档 × 是什么、走哪几步、省掉什么)换成十五行的车道表(车道、是什么、走哪几步、跑哪些床、复盘、谁来做、今天靠什么):Harness 流程三行由原三档表改写,规范、业务、运维、分析四条流程的十二行是新加的;执行体照现在的名字写,业务小事照旧复盘一轮。表头避开同时出现「单元」「执行体」两栏 —— 立项命令认第一张这样的表当入口表。照方案改了两处现行做法(用户在审核点二认了):成条的事由「在仓库外面的副本上写好测好、要一次开闸窗口把文件落进仓」改成「开一次闸、真仓直改,不做仓库外面的副本」;难事删掉「落地前在副本上做一轮限时预审」,改成签字之前派多路只读设计一次、决策记录草稿随签字一一起签。另有一处跟着风险标记改:小事一行由「碰了测试面或写保护文件、按条数仍核成小事的,交工作会话办」改成「碰了测试面、按条数仍核成小事的,交工作会话办」—— 落点里有写保护文件至少是成条的事,与表后风险标记第一条一致(用户在审核点二定的)。表后新加三段:七个风险标记定最低档、规范流程的七个环节、跨流程的五条规矩。「三档各是什么样的事,定义只写在上表『是什么』一栏」改成每条车道是什么只写在车道表,写明三条主流程的三档就是机器镜像里那三个值、运维与分析的档名不进机器镜像;「仍然靠纪律的」最前面加认车道的三样(认流程、最低档、裁判单车道),写明下一条需求起靠机器。原「同一处只有一条车道」那一段改名「同一处一次只走一条」(意思没变,免得与车道表撞名),段里另两处「车道」跟着改;这一段里占着单元时可以提前做的准备,由「在仓库外面的副本上写和测」改成「出预览」(成条的事与难事都已不做仓外副本,主控在审核点三核原文时点的);「怎么派工」③ 按节点回报的清单去掉「仓外副本备好」这一个节点,同一个理由。角色表主控一行由「先分级、再选路(小事、成条的事、难事…)」改成「先认车道(先由落点认出流程、再按大小定档…)」。
- 第十七节:标题括号加 v5.0.0 这一句;术语表加「流程」「车道」「风险标记」「操作单」四条,「档」那一条改成每条流程各三档、主流程的三档进机器镜像、运维与分析的不进;入口表上方那段第一句由「五类走的是同一条需求流水线(…),差别只在这张表的六栏」改成前三行走 Harness 流程、第四行走规范流程、第五行走业务流程,运维与分析不立需求、不在这张表里,三条主流程走同一套闭环、差别只在这张表的六栏。入口表本身一个字没动(立项命令按表头与「单元」「执行体」两栏读名单)。
- 回看改掉的旧说法:第四节对照表两行(「§四 五类需求一条流水线」改成「§四 按落点分五条流程」并多指车道表;「§二、§三 agent 架构是架构的一类」改成五层的说法);第六节「五类需求各从哪进」由「五类走的是同一条需求流水线」改成前三类走 Harness 流程、系统规范走规范流程、业务走业务流程,三条主流程走同一套闭环,运维与分析不立需求;第十四节 agent 架构那一条由「五类架构里的一类,讲的是设计写在哪」改成五层里的一层(答「谁来做」);第十五节「它的设计住哪」「受治文件类」两段里「第五类架构」「设计写在哪」与旧次序改成五层的说法与次序。
- 文档 · 决策记录:最上面加 ADR-105(流程立法:按落点分五条流程、每条三档、一共十五条车道、派工先认车道;五类架构说成自上而下的五层)。取代 ADR-99 决定 ① 里「四类同一条流水线」那一部分、ADR-101 决定 ① 里「五类架构说设计写在哪」那一部分,改说 ADR-101 决定 ⑤,补 ADR-93、ADR-94;审核点三之后加了第四个决定「设计只写当前这一版」,写明项目架构设计页照它整页重写、难看的图重画;旧条目一个字没动。
- 文档 · 开发规则书(x-dev-rule.md):开头两个说明框之后加一节「业务流程三档」—— 只改展示、一个功能、动钱权限数据结构三档各走哪几步、谁来做,指向架构详图的车道表;本文后面四端各节一个字没动。
- 测试 · 体系守护总自测(harness-dev.test.js):加 L 组四条 —— L1 宪法、架构详图、项目设计页固定的几段里,五条流程与五层的名字齐全、次序对,三份文件的旧说法一句都不在;L2 架构详图第十五节车道表十五行(「流程 · 档」依次、每行七格不空、最后一格同时写机器与纪律、表头一字不差且不同时含「单元」「执行体」),第十七节四条术语各恰好一行、入口表表头一字不差、它上方那一句写明各行走哪条流程,立项命令照旧读得出入口表;L3 开发规则书「业务流程三档」一节(排在「开发顺序」之前、表头一字不差、三档依次、格格不空);L4 项目设计页十节的锚点与标题、「二」那一节的六道门小标题,与站点构建器名册一字不差。每条都对真仓断言一次,再在内存里改坏文本证明咬得住(一共五十八种改坏,每种只报它自己那一条);床头多点名一份站点构建器
x-harness/builder/project-site.js(L4 读它的名册)。原有各组一个字没改。
- v4.32.x
顶层收尾小修:写给人看的时刻按本机时间写并标时区;收尾报「封版之后删掉了」时先提示是不是误删;立项命令给项目架构与 agent 架构单元带上设计页、变更历史与锁清单;验收题多一行待立项目清单的提醒;宪法、原则书、变更历史抬头与架构详图几句旧话改口
设计指纹30fa4e16内容指纹f78027c1测试指纹1a6d7effd28931f2改动设计 5 个(CLAUDE.md、harness-engineering.md、ADR.md、x-constitution-rule.md、SKILL.md);代码 10 个(framework-lock.js、project-archive.js、requirements.js、stop-handler.js、plan-ask.js、plan-new.js、record-release.js、requirement-check.js 等)
需求顶层收尾小修签字 bfc5已发布
为了:顶层收尾小修 —— 顶层最后一条收尾:履历、复盘说明、发布段与三查结果单的时刻按本机时间写并标时区,收尾环报「封版之后删掉了」时先提示是不是误删、给出按签字基线核对放回的办法,立项命令自动带上项目架构与 agent 架构单元的三个文件,验收题提醒更新待立项目清单,另把宪法、原则书、变更历史抬头与架构详图里几句与现行规矩不符的旧话改准。都是订正与写法、记账方式的改动,没有新增闸,既有各道门的判法没有改写,升第三位。
- 守卫 · 写给人看的时刻(guard/requirements.js 新加
localTime,guard/project-archive.js 改用它):本机时间写到分、后面标明那一刻的时区偏移,形如 2026-10-14 20:42 +08:00,偏移从本机取、不写死东八区;写法只此一份,需求履历给人读的那一份(RECORD.md)、复盘说明、发布段、三查结果单都经它写。履历里改的是提出、签字一、签字二、每一次独立复盘、完结的时刻与「用时与返工」里的第一次签字(读不出写「—」)。机器读的不经它、照旧 —— 履历机器版(record.json)里的毫秒数,账本、签字基线、结果单与复盘说明留档的 json 里的时刻,判先后、判发布读的是它们,所以不动任何判定。已经封死的履历不重写(里面照旧是世界协调时),在办的在下一次重签或完结时照新写法重生成。此前直接取世界协调时、不标时区,比本机早八小时、凌晨的跨天,治理站点上看得见 —— 10-10 主控照履历报错过一次时刻。 - 体系守护 · 复盘说明、发布段、三查结果单的时刻(core/review-brief.js、core/record-release.js、core/requirement-check.js):都改经守卫需求零件的
localTime写 —— 复盘说明里「上一次入账复盘是 …」由世界协调时的日期改成本机时间到分带时区;发布段的 updatedAt、精确记下的与「联调」一格的 at、按台账推出来写进格里的 at 一律同一个写法(此前前三样是世界协调时、最后一样是本机时间却没标时区;已经写下的精确结论原样沿用,按台账推的那几格每次重算都换成新写法 —— 落地之后第一次全量重算(任何一条需求验收完结那一刻守卫会跑一次)会把现有发布段里这样的格补上偏移、重写那几份发布段,治理站点随之过期一次;读回去的只有十态命令算环收尾那一处,精度到分;发布登记从守卫零件目录装需求零件,装不上就一个字不写、退出码 1);三查结果单里第一查的基线时刻、每一笔复盘的时刻、抬头「算于 …」与看板签字区标题「签字(核对命令 … 生成)」同一个写法。 - 守卫 · 收尾的误删提示(guard/stop-handler.js 的
deletedOf与probeDeleteLines;guard/framework-lock.js 的极简比对多交一份「删掉了」的清单,判定不变;guard/requirements.js 导出带计划名的核对命令):这一轮报出「封版之后删掉(或移出)了这个文件、还没升版」或框架锁极简比对的「删掉了」、而那个文件此刻真的不在时,收尾报文最前面先多几行(只出在本会话被拦下的那段报文里,替无主改动复核的那一段不出)—— 先问是不是探针误删,是就别升版、别封版、别重建站点,先从仓外副本或编辑历史把它原样放回、指纹对上签字基线,再跑带计划名的核对;真要删的,再照原来的话升版、封版。逐条给出在办需求(签字作废的也算;先给本会话办着的,本会话一条都不办或认不出是哪个会话就给全部在办的,至多三条)签字基线里那份文件的指纹(原始字节 sha256 前 16 位,与写证据同一算法;基线里没有它就写没有)与带计划名的核对命令;一条在办需求都没有时写明没有基线可对、给不带计划名的核对命令。只加几行提示,拦不拦、红几处、原来那几段话一个字不变;需求零件装不上、基线读不了,照实写一句、不挡收尾。此前那一条只给升版的出路:探针误删真仓出过两次(10-10 那一次把架构详图删了六分钟),文件不在的那几分钟里各会话的收尾都报「删掉了、还没升版」,照做就把一次误删封成一版(v4.32.0 起封版还会自动认领落点表里没有写证据的删除)。 - 体系守护 · 立项命令(core/plan-new.js):命令行
--units里有project:overview或agent:overview的,新建骨架时在看板落点表与机器镜像 targets 里各自动带一行 —— 落点写「项目架构 project:overview」或「agent 架构 agent:overview」,哪一类写项目架构或 agent 架构,三格「设计页」「变更历史」「锁清单」对着那个单元目录下的 ARCH.html、CHANGELOG.md、version-lock.json,两边的目录逐字相同;照模板现有的样子插、模板不动,模板里原来那一行落点占位留着,打印里写明自动带了哪几行;插不进去(看板里找不到唯一一处「落点表」或表头不是那四栏、机器镜像里 targets 不是唯一一个数组、插完读回来对不上)就拒绝、什么都不写。计划已经在了再跑不补。此前全靠写计划的人自己列,落点有项目架构单元的计划漏列过锁清单 —— 封版命令写了它,算范围外的改动,只能补范围、重签一次(10-12),10-14 又手补了一次。agent 架构要改的执行体文件、别的单元的格,照旧由写计划的人填。 - 体系守护 · 验收题命令(core/plan-ask.js):
--kind=验收完结打印题目之前多打印一行「提醒:待立项目清单随这条需求更新了没有?更新的条目要随题给 BOSS。」;确认题没有这一行。只提醒、不核。10-14 验收完结时漏过一次这一步。 - 体系守护 · 入口(harness.js):帮助与路由注释照上面两条改。
- 文档 · 宪法:第七节「宪法边界」的允许清单补上第四节的「运作方式」(此前清单里没有它,而第四节那一段一直在);「相关文档」表两行 ——「检测引擎 + 三模式 -t/-v/-m」去掉检测模式的开关(第七节明说不在 L0 写检测模式),「L1–L5 内容」由建设期的「按逐层验证原则,通过 L0 验证后再逐层写入」改成指向架构详图第五到第九节(各层早已建成)。别的一字不动。
- 文档 · 原则书(x-constitution-rule.md):系统四件套那一段末尾「版本契约,三层同一份」改成「全部版本单元同一份版本契约」(三层是立契约时的说法,现在的单元有六类)。只改这一处。
- 文档 · 变更历史抬头:「标题下的四行记录(设计指纹、内容指纹、测试指纹、改动)」改成封版命令实际写的五行(多「需求」一行,v4.13.0 起就写了)。v4.32.0 及以下各节一个字没动。
- 文档 · 架构详图:文首版本改成本版。第四节宪法「只定义」的清单补上运作方式。第八节 —— 「项目架构与封存履历」② 后面新加「写给人看的时刻一律本机时间带时区」一段;「清理归档」③、「收尾单与治理站点一格」③、「履历多两栏」① 三处讲履历时刻写法的地方改成本机时间带时区、此前封死的是世界协调时;环3「版本契约」那一项加「误删提示」。第十三节 —— 「写法」一段列的记录行补上「> 需求:」;第 2 关收尾讲删掉的文件那一句接上误删提示;诚实边界 ⑪ 补一句收尾的误删提示只是一句话、封版的认领照旧不问。第十七节 —— 五类需求入口表上面那一段写明立项命令给项目架构与 agent 架构单元自动带那三个文件。
- 文档 · 决策记录:新增 ADR-104(写给人看的时刻改按本机时间写并标时区、收尾的误删提示;补 ADR-83、ADR-103)。
- 文档 · 技能说明:x-harness-dev —— 立项脚手架那一节写明
--units里有项目架构或 agent 架构单元时自动带一行那三格(只在新建时带),拒绝的情形补上那几行落点插不进去的几种,「守不到」里「它只填短名、目录名与档」那句跟着改;签字题那一节写明验收题打印题目之前多的那一行提醒,「守不到」补一句它只提醒、不核。 - 测试:用例点名的床各加一组 —— 守卫的履历床(project-archive.test.js)加 A11:经守卫入口签字一、三查全绿后再签验收,
RECORD.md里提出、签字一、签字二、独立复盘、第一次签字、完结六处时刻都是本机时间带时区偏移(期望值床里按本机偏移自己算)、整份没有一处不带偏移的时刻,record.json里照旧是毫秒数;复盘说明床(review-brief.test.js)加 B11:「上一次入账复盘是 …」写本机时间带偏移、不再只写日期,说明附件与留底里的 at 照旧;三查床(requirement-check.test.js)加 R28:结果单抬头「算于」、第一查复盘那一行、看板签字区「核对命令 … 生成」都是本机时间带偏移,整张单子与签字区没有一处不带偏移的时刻(当场抓出第一查「基线」那一行漏改,已改),sheet.json的 at 照旧;发布登记床(record-release.test.js)加 R20、R20c、R20a、R20b:updatedAt、精确记下的那一格、联调那一格、取自台账的治理站点那一格都是本机时间带偏移,updatedAt 经 Date.parse 读回等于写的那一刻(到分,钉住十态命令的读法),R20c 经命令行入口再验一遍,R20a、R20b 是床里自带的改坏对照;立项与签字题床(plan-new-ask.test.js)加 U6:--units带 project:overview、agent:overview、两个同写各立一次,机器镜像与看板的落点表多出那一行、格里恰好三个文件、守卫签字时核「看板与机器镜像一字不差」那一道不报,只带 framework:harness 的两边都没有;加 A7:小仓里把一条需求真办到三查全绿、经命令行入口出验收题,打印里恰好一行那句提醒、在题目之前、不进题目正文,照打印的题过得了守卫弹题前的核对,确认题没有这一行;收尾环床(stop-ring.test.js)加 S18:副本里真封一版整个 HARNESS、签一条在办需求,删一份锁住的框架文件跑真收尾环 —— 照旧拦、版本契约原话与封版命令照旧在,报文抬头后第一行先问「是不是探针误删?」并点名文件,接着给签字基线里那份文件的指纹(床里删之前自己算)与带计划名的核对命令,都排在原来的检测结论之前;对照:只改不删照旧拦、没有这一问,框架锁交来的「删掉了」也认得。断言旧写法的跟着改:履历两栏那张床(record-effort-leftovers.test.js)的 RE2;发布登记床的 R2、R8 与联调各类里九处联调格的 at,P 组与 R11e 的夹具(「联调零件装不上」的目录里放一份需求零件,否则发布段整个写不了),床头@covers挪进前 40 行(原在第 41 行、一直没被认到);三查床的 SP_DAY 与 R24 一处;十态床(plan-loop.test.js)L4 一处。这一遍(闸开着时经唯一运行器跑)守卫面与体系守护技能面共 34 张床全过(十态床先红在 L4,改了那一处断言后单跑 19 条全过),体系守护自测床也过。空壳对照下新改的 8 张床都咬住,没有一张是因为起不来才红;点状改坏对照 16 处全部咬住 —— 履历时刻改回世界时、复盘说明改回只写日期、发布时刻改回世界时、治理站点格改回台账原文、立项自动带的那几行撤掉 / 只带看板 / 只带镜像、验收提醒撤掉 / 确认题也打印(九处),三查结果单的「算于」、复盘那一行、签字区「核对命令 … 生成」、第一查「基线」那一行各改回世界时(四处,R28 红),收尾误删提示那一问整个撤掉、不给签字基线里的指纹、框架锁报的「删掉了」不认(三处,S18 红);另有发布登记床里自带的两处。 - 不在这一版里的(照实写):执行体定义里写死探针三句(agent 架构单元被另一条需求占着,派工底稿的固定部分已经写着这三句,下次开 agent 架构的版时顺手一句);x-governance 条款书 ARCH-A03(连同它架构页的派生区)列的「宪法允许写什么」还没补「运作方式」,与宪法第七节对不上 —— 那是 x-governance 那一域,系统架构复盘时随它改;项目架构设计页被体系守护自测钉着的两句过渡话(归项目架构单元)。
- 守不到(照实写):时刻写的是写下那一刻的本机时区,机器换过时区的,同一条需求前后几段的偏移会不同;这一版之前封死的履历里照旧是世界协调时。误删提示只在本会话被拦下、报「删掉了」时出,被改坏而没删掉的文件没有这句话;签字基线里没有这个文件就只能照实说没有;放回的原件要自己找,git 的恢复命令照旧不许用;探针在真仓目录里起仓外脚本照旧没有机器挡,靠派工时写死的探针三句。立项命令只在建骨架那一刻填,之后落点表改了不会自己补。验收题那一行只提醒:清单更没更新、给没给用户看,机器不核。细说在架构详图 §八(「项目架构与封存履历」里「写给人看的时刻」、环3「版本契约」里的误删提示)、§十三(第 2 关与诚实边界 ⑪)、§十七 与 ADR-104 的边界。
- 守卫 · 写给人看的时刻(guard/requirements.js 新加
守卫判错与补闸:履历连落点表也剥计划路径;封版自动认领落在需求落点表里的无主删除;发布登记「已生效」认全部业务域以外的单元;派发闸先拦平台内置的名字;接力命令照实走过没有规范管的改动;盯盘上状态的床路径进指纹、封版当场重跑;几处旧注释与旧说法改口
设计指纹8c4f6fbd内容指纹0deea47c测试指纹26429260e91043e3改动设计 5 个(harness-engineering.md、ADR.md、x-meta-rule.md、SKILL.md、SKILL.md);代码 12 个(guard.js、project-archive.js、requirements.js、team.js、test-faces.js、verify-harness.js、bed-runner.js、plan-run.js 等)
需求守卫判错与补闸签字 b894已发布
为了:守卫判错与补闸 —— 把 10-13 到 10-14 真撞过的守卫判错与缺口一次收掉:履历不剥落点里的计划路径、开闸期间的删除没人认领、发布登记不认 agent 架构、派发闸靠名册里恰好没有内置名字、接力命令把没有规范管的改动判成检测没跑成,另补一处记账缺口(盯盘上状态的床旧「通过」照算),顺手改几处旧注释与旧说法。新增一类东西(盯状态的名单与封版前置里的重跑、封版的一种自动认领),既有各道门的判法没有改写,升第二位。
- 守卫 · 履历剥落点路径(guard/project-archive.js):签字一与完结那一刻写需求履历时,落点表里指向计划目录的路径(逐格的目录写法;单元名、哪一类、格名照原样)与用例点名的床清单,同需求、签字原话、标准、用例、遗留一个剥法,给人读的与机器读的两份都剥,剥法本身没改 —— 此前这两样原样抄进去,落点里列了计划目录下某个文件的计划,写出的履历就带着计划路径,治理规范「真相源不引施工计划」那颗闸当场红,只能改落点重签(10-14 撞过)。剥掉的地方换上的那句话由「(计划目录,完结后删)」改成「(计划目录,完结后搬进归档)」—— v4.24.0 起计划完结后是搬进归档,这句一直没跟上。已经封死的履历不重写;在办的完结时照新口径重生成。
- 封版命令 · 删除自动认领(x-meta-dev 的 core/seal.js 包一层;封版记录在守卫的 guard/test-faces.js):无主一栏里的删除 —— 台账里没有任何会话的写证据(主人会话已结束、已不在线而按无主处理的那几种不算,它们有主人)、文件此刻已不在盘上 —— 同时落在这一版「为了」解析到的那条在办需求此刻的落点表里(与三查认「范围里」同一个判法)、又在本单元的锁清单里,封版时自动认领、照封,不再留旧指纹。认领了哪几个写进封版报文(预览说「将自动认领」,封完说「已自动认领」),封版记录多一栏认领清单
claimed(为了哪条需求、哪几个文件、为什么能认;没有认领就没有这一栏,收尾复核不比它)。代码不判「是不是开闸期间删的」,只认没有写证据。此前这类删除不封进去,锁清单里留着已经不在盘上的文件的旧指纹,单元一封完就又是改过的 —— 10-14 开闸期间删掉的那几份让 agent 架构多封了一版。锁清单照旧由检测引擎写、不记这一项,这一条不动检测引擎。那条需求不在办(已完结、签字作废、账本被改过)、需求零件装不上、锁清单读不了,一个都不认;落点表之外的删除照旧算无主、保留旧指纹;无主的修改(文件还在)照旧要带--adopt。 - 体系守护 · 发布登记(core/record-release.js):「已生效」一格改读版本契约现成的单元名册 —— 业务域以外的单元(整个框架、系统规范域、项目架构、agent 架构、业务总览)都出这一格,不再写死框架、规范、项目架构三种前缀另加业务总览一句。名册里此刻有这个单元,或它与名册里某个单元同一类(冒号前那一段相同,业务域除外),都算认得 —— 后来撤掉的规范域,全量重算时不会把早已「已发布」的需求翻回去;认不出的单元(或名册读不了)单独标一格「认不出的单元 · <单元>」,不再无声丢掉,它判不了,那条需求翻不了「已发布」。落点有 agent 架构的需求重算发布段之后多出「已生效 · agent:overview」一格,别的格不变;翻不翻「已发布」不受影响(「已生效」本来就算发了)。不改引擎。
- 守卫 · 派发闸(guard/team.js):先认平台内置名单(general-purpose、claude、fork、Explore、Plan,不分大小写),再查名册 —— 这一判不看名册:名册里有同名的一行、执行体目录下也有同名定义文件,照样拦,报文写明是平台内置的名字;名册读不到时报的也是这一句,第二行写明名册此刻读不到、先恢复。名册只用来写「换成谁」那一句,那一句不再列名册里写着内置名字的行。此前这几个名字被拦,只因为它们「本来就不在名册里」。平台自带的两个工具型照旧在读名册之前就放,名册里的正常执行体照旧放行,其余判法不变。
- 体系守护 · 接力命令(core/plan-run.js):第 1 步增量检测逐批看,一批退出码 0 而一个字没打印时,先问检测引擎现成的射程(与增量检测那一段同一套:索引器、规范发现、射程缓存,元规范不算):这一批一份规范都不适用 ⇒ 按「没有规范覆盖」照实走过、打印一句说明(这一步算过了),接着跑后面几步;有规范适用而没打印的照旧判没跑成,并点名哪几个文件、哪几份规范 —— 防检测程序被换成什么都不做的那一道照旧有效;射程判不了也算没跑成。此前一律判没跑成,一条只改说明文件的需求整条停在第一步,后面几步只能手跑(10-14 撞过)。只读借用引擎的射程,不改引擎;每个一字不打印的批次都要算一次射程,没有缓存时一次约 9 秒。
- 守卫与封版命令 · 盯盘上状态的床(新名单 guard/state-watch.json;guard/test-faces.js;x-meta-dev 的 core/seal.js;运行器 x-harness-dev 的 core/bed-runner.js):守卫目录新建一张名单,写明哪些床盯哪些路径 —— 19 张床、66 项,每项要么盯一个路径在不在、是文件还是目录,要么盯一层通配此刻匹配到哪些名字,各写了一句为什么盯。框架这一侧四张:守卫收尾环床、版本契约床、端类金丝雀床、体系守护自测床;规范这一侧十五张:看板规范盯计划归档目录的那张、治理规范的敏感数据床,以及查真文件、真函数目录、移动端生成物与母本包在不在的判据床(地址、订单、异常、权限、镜像、接口、移动端 backend、样式、详情页各规范)。设计初稿还列了发布流水线床,没登记 —— 它盯的发布脚本目录本来就在它自己的指纹里。名单上的床把盯的路径此刻的样子(不读文件内容)算进它自己的指纹:路径一变,旧「通过」在收尾、补跑、体检、三查、封版各处同时作废,原因写成「盯的某某变了」;名单以外的床指纹不变;名单写坏了判定当场报错。三类有测试的封版(整个框架、系统规范域、业务域)共用的测试前置多一步:先照账本判一遍,挑出只因盯的路径变了而作废的床,执行时逐张交唯一运行器当场重跑(每张都要等运行器的仓库级锁,最多 45 分钟),再判一遍 —— 重跑没过就不封并点名是哪张,封版报文逐张写重跑了哪几张、各自过没过;预览不跑,只列出封版时会先重跑哪几张;路径没变的不重跑;床本身、夹具、被测文件或上游改过的照旧不代跑,先跑再封。收尾环对这种床不算到任何会话头上,只提示、不拦。运行器的全量卫生检查多一项:名单里点名的床不在了、名单写坏了,报出来并计入失败。床本身一行不改。此前这些床的旧「通过」照样被沿用 —— 10-13 看板规范那张床就这样把一条该红的死条目藏了一天。装上那一刻名单上的床旧记录各作废一次,在下一次相关封版里补跑一回:这一版自己封框架时,会自动重跑收尾环床、版本契约床、端类金丝雀床三张;体系守护自测床这张床本身改过,不归自动重跑,要先手跑。
- 顺手改口(只改注释、不改判定):守卫本体(guard.js)文首两处注释 —— 顶层围栏那一句补上 agent 架构,派发闸那一句照新判法写;守卫回归套件(verify-harness.js)三处「顶层三类」的注释改成顶层版本单元的现行说法(v4.30.0 加 agent 架构之后没跟上,那一版的变更历史里照实记着没动),另有派 Explore 的那一条(RV7)断言跟着派发闸的新报文改;守卫需求零件(guard/requirements.js)两处旧注释 —— 讲「治理站点」一格的那句补上只有业务域落点的需求不带这一格,讲授权的那句改成「BOSS 只对 X大脑 说,X大脑 逐字转给部署会话」的现行口径;元治理四件套脚本(x-meta-dev 的 core/tetrad.js)一句「三层同一个流程」改成各类单元同一个流程。
- 文档 · 元治理规则书(x-meta-rule.md):场景 F 的标题、触发条件、版本号所在处与封版命令单子补上业务总览与项目架构两类,六类单元齐了;单子里写上「为了」那一行怎么写;末段「不带动整个 HARNESS 的版本」那一句补全各类单元。
- 文档 · 架构详图:文首版本改成本版。第八节 —— 环1 全景图的派执行体通道与环3「需求对账」里「派发闸」一段照新的先后改写(工具型放、内置名单拦并排在名册判断之前、在名册里且定义文件在的放、其余拦、名册读不到拦、有行没文件拦),「被拦时回两行」写明「换成谁」不列内置名,守不到加一条(内置名单写死在守卫里),床那一句补上 T8h、它在空壳对照下起不来而靠改坏对照,以及 RV7;「项目架构与封存履历」② 写明剥哪几样、落点表与床清单同一个剥法、换上的那句话,守不到加两句;「清理归档」⑧ 讲占位的那一句改成现状;「收尾单与治理站点一格」里「「已生效」一格出给谁」改成认单元名册(同一类也认、认不出的单独一格),加一句守不到;「接力命令」写明第一步怎么核检测程序的结论、没有规范覆盖时照实走过、射程判不了算没跑成与代价,守不到加 ⑦;环3 分账讲无主的那一条与「测试新鲜度」各补一句。第十三节 —— 第 3 关封版补「删除的自动认领」与前三类封版先重跑盯状态的床,诚实边界加 ⑪。第十五节 —— 角色表「关口」「项目经理」两行与第十七节术语表「关口」一条,讲「项目经理」改名时点的三处写成同一种说法:v4.5.0(ADR-75)到 v4.30.0 叫「项目经理」,v4.19.0 起是角色表里的一行,v4.31.0(ADR-102)起改叫「关口」(此前一处写「v4.5.0 到 v4.30.0 这一行」、两处写「v4.30.0 之前」,后两处少算了 v4.30.0 那一版);「这张表今天靠什么」讲派发闸那一句补上内置的先判。第十六节 —— 新加「盯盘上状态的床」一段(哪些床、名单怎么写、指纹里加什么、谁来重跑、名单收哪些、守不到八条);「卫生检查」加 ⑥(名单对得上);「只跑不新鲜的」「按张记录」、收尾「测试新鲜度」③、诚实边界 ③ 各补一句;宪法测试条文对照表四行各补一句(两行写指纹多算盯的路径,两行的守不到写明那条链没有床从头验到尾、空壳对照证明不了的几处靠改坏对照);「封版的测试前置」加「盯盘上状态的床当场重跑」一条(执行时怎么交运行器、等锁多久、预览只列不跑);「封版记录」多记一栏认领清单。第十七节 —— 入口表「改 agent 架构」一行的发布面写明记「已生效」一格;通则 ② 补「名册里有同名的一行也拦」;守不到里删掉「落点有 agent 架构的需求不出已生效」那一句,讲派发闸那一句补上内置名字。
- 文档 · 决策记录:新增 ADR-103(六处判错与缺口的改法与取舍,写明三处取舍 —— 盯状态的床为什么用名单加指纹、不用封版一律重跑;派发闸为什么把内置名单排在名册之前;认领为什么不写进锁清单。补 ADR-83、ADR-95、ADR-69、ADR-100、ADR-98、ADR-62,收窄 ADR-102 决定 ⑤ 的一处实现)。
- 文档 · 技能说明:x-harness-dev —— 跑床一节「只跑不新鲜的」补盯状态的床,按张记账那一句的指纹补上盯的路径,卫生检查清单加名单对不上那一项;接力命令一节写明第 1 步核检测程序打印的结论、没有规范覆盖时照实走过、射程判不了也算没跑成,守不到加一句;发布登记一节「已生效」一格改成业务域以外的单元都出、认不出的单元单独一格(两处)。x-meta-dev —— 统一封版命令那一段补删除自动认领(预览也列)与测试前置先重跑盯状态的床(预览列出会重跑哪几张、执行时每张等锁最多 45 分钟)。
- 测试:用例点名的六张床各加用例 —— 守卫的履历床(project-archive.test.js)加 A10:起守卫签字,核两份履历都没有计划路径、换上的是新的那句话,并真跑治理规范「真相源不引施工计划」那颗闸(NS-COMMON-0004),对履历零违规;封版命令床(seal-command.test.js)加 K2、W4:K2 在真 git 沙箱里核落点内的删除自动认领、落点外的照旧算无主,W4 用假运行器核封版重跑的命令行是
--action=beds --only=<床> --quiet --lock-wait=45,并核预览时不调;发布登记床(record-release.test.js)加 R19、R19a/b/c、R19d:agent 架构出「已生效」一格,没有设计页时出「认不出的单元」,R19d 走命令行入口;派发闸那一组(team-gates.test.js)加 T8h:名册里加 general-purpose、explore 两行并放同名定义文件,经守卫入口照样拦、报文写明是平台内置,床里自带探针式改坏对照;接力命令床(plan-run.test.js)加 B8:真引擎,只改一份没有规范管的文件,第 1 步打印「没有规范覆盖」、七步走完,反向对照会停在第 1 步;测试面判定床(test-faces.test.js)的 K 组加 K2c-1 到 K2c-10:设计里的九步,外加「重跑报错照样不放行」。断言旧说法的跟着改:履历两栏那张床(record-effort-leftovers.test.js)的旧占位,派发闸那一组与守卫回归套件 RV7 的旧报文;接力命令床里「一个字不打印就算没跑成」那一条摆一份夹具规范,让那批改动有规范适用;体系守护自测床(harness-dev.test.js)加 G30:名单里点名的床不在了、名单写坏了、判定模块读它抛了,全量卫生检查都报出来并计入失败。改坏对照 20 处全部咬住。空壳对照下改过的床都变红,但履历床、派发闸那张床、履历两栏那张床是因为床起不来才红(空壳守卫旁边没有技能目录,这个毛病早就有),测试面判定床的 K2c 与接力命令床的 B8 空壳碰不到 —— 这几处咬不咬得住,靠的是改坏对照。仓外副本里全部 37 张床全过(守卫目录 21 张、两个技能 16 张;装配面那张在树里原地跑过)。这一版没有新增测试文件。 - 不在这一版里的(照实写):已关会话名下从没查过干净的文件仍等 24 小时;执行体文件三处认法口径不一(版本契约只认下一层、名册闸递归子目录、围栏按目录前缀);审计里其余的守卫条目(正式发布自动登记、业务格按改了什么推、作废一条需求的出路等)—— 都留在待立项目清单。不改任何检测判据、不改计划模板。「复盘者收尾两次、第二笔打红第一查」那一条 v4.27.0 早已修好,不在这一版。项目架构设计页讲发布格的那一行还写着只有框架、规范、项目架构出「已生效」,这一版之后 agent 架构也出 —— 那一页不在这条需求的落点表里,留给「设计页小修二」顺手改。
- 守不到(照实写):履历只剥
.claude/plan/起头的写法,这一版之前封死的履历里那句占位照旧是旧的。删除的自动认领不问是谁删的 —— 没有写证据就分不出是这条需求删的还是别人误删的,落在落点表里就封进去,落点表写得越宽、误认的面越大;认领只记在封版报文与本机的封版记录里,锁清单看不出、账本清过就查不到。派发闸的内置名单写死在守卫里,平台新加的内置类型要人来加;写前拦截摘下期间照旧不在岗。「没有规范覆盖」信的是检测引擎的射程:射程把有规范管的文件算成没有、检测程序又恰好一个字没打印,第一步会照实走过。「已生效」认名册之后,业务域以外的单元一律算落盘即生效 —— 以后加一类自己另有线上发布面的单元,要回来改发布登记;名册读不了的那一次,业务域以外的单元全标成认不出、判不了,需求翻不了「已发布」(只会更慢翻,不会误翻)。盯状态的名单靠人维护(新床盯了状态却没登记、床改了盯的路径而名单没跟上,照旧沿用旧结论;卫生检查只核点名的床在不在);只看路径在不在、有哪些名字,不看文件内容;依赖整个仓库的床没法按路径记;两次封版之间没有人主动重跑;框架封版只核守卫、检测引擎、技能三类床,规范床要等那份规范自己封版;封版前的需求对账排在测试前置之前,用例点名的床若在名单上、只因盯的路径变了而作废,会先按用例没闭环拒封、轮不到当场重跑,要先手跑那张床;名单文件被删掉就当空名单,兜着的只有版本契约。测试这一侧:履历床的 A10 依赖治理规范的判据,而判据不在这张床的指纹里 —— 判据改了,它的旧「通过」照样算;K2 在进程内调封版、K2c-8 只走到收尾判定、W4 用假运行器,所以「封版、运行器、账本」这整条链照旧没有一张床从头验到尾;空壳对照证明不了的那几处只靠改坏对照。细说在架构详图 §八(「派发闸」「项目架构与封存履历」「接力命令」「「已生效」一格出给谁」)、§十三(第 3 关与诚实边界 ⑪)、§十六(「盯盘上状态的床」「卫生检查」「封版的测试前置」)与 ADR-103 的边界。
- v4.31.x
agent 架构二期:守卫加派发闸(派出的执行体类型不在名册就拦)与写域点名;已关会话名下、内容曾查过干净的改动不再干等 24 小时;立项命令按落点单元筛执行体;业务编排器各端打印执行体;项目经理成了一位执行体、原来那一面改叫「关口」;架构详图、宪法、决策记录、技能说明与开发规则书按真实机制改口
设计指纹fca70f76内容指纹0fd8c210测试指纹b916ea7e2f531788改动设计 15 个(CLAUDE.md、harness-engineering.md、ADR.md、x-dev-rule.md、SKILL.md、SKILL.md、SKILL.md、admin.md 等);代码 11 个(guard.js、session-ledger.js、team.js、verify-harness.js、publish-table.js、orchestrator.js、roadmap.js、bridge.js 等)
需求agent架构二期签字 7935已发布
为了:agent架构二期 —— 把 agent 架构从「立了层」做到「真能派活」,这一版是框架这一侧:派谁从软变硬一档(守卫加派发闸、立项命令按落点单元印名单)、授权在哪说统一成一句、项目经理成了一位执行体并进角色表与入口表,另修一处守卫缺陷(已关掉的会话名下的改动卡住发布)。新增一道闸、一处只点名的提醒、一种无主的认法与一个命令开关,既有各道门的判法没有改写,升第二位。
- 守卫 · 派发闸(guard.js 写前派执行体那一段接线,判法在 guard/team.js):每一次派执行体都判,只看派出去的类型 —— 平台自带的两个工具型 claude-code-guide 与 statusline-setup 放(在读名册之前就放);在 agent 架构设计页的名册表里、而且执行体目录下有同名定义文件的放;其余一律拦:不写类型、名册外的名字、平台内置的 Explore、Plan、general-purpose、claude、fork,名册读不到也拦,名册里有这一行而定义文件不在同样拦。带名字派的队友与不带名字派的同一个判法。它排在复盘那一道之后,报文打头「环1 派发:」;原先讲复盘、连着三次不过不让再派的那一道改叫「复盘派出那一道」,报文打头「环1 复盘:」,判法没动。领队派执行体这一下因此也要装组队零件,装不上照样拦。落地那一刻起全仓所有会话都派不出平台内置的通用执行体,查资料、找代码的活由调研员接。
- 守卫 · 写域点名(取写域与判越没越出住 guard/team.js,guard.js 收尾那一段把话说出来):领队收尾时,本会话的改动里此刻内容出自某个执行体的编辑工具的文件,逐个对它那份定义「闭环」一节「写域」一行里反引号包住的目录;越出去的在附注里点名一次。只点名、不拦,同样的内容只点一次(会话台账多一种事件记「已点名」),判不了的不点名。
- 守卫 · 已关会话的改动按无主复核(guard/session-ledger.js):别的会话名下的改动,主人都不在线或已结束、而且此刻的内容曾经查过干净(不论是在哪个判据组下记的)⇒ 归无主,任一会话收尾时替它复核、结论按内容记回,不再等满 24 小时。主人里有一位在线的、此刻的内容从没查过干净的,照旧。「不在线」读平台的会话名册;名册判不了就退回只按 24 小时判,并在收尾的附注里说一声。部署门的待检清单与发布之前的只读先查用同一个判法,报文写明主人已不在线;这类文件落在无主一栏,封版命令的认领开关可以认领它们。原来满 24 小时那一支与它的报文没动。
- 立项命令(x-harness-dev 的 core/plan-new.js 与入口 harness.js):多收一个开关
--units,派工底稿里的执行体名单按落点单元筛,三种情形 —— 命令行给了单元,只打印入口表里对得上的行;没给而这个目录名的计划已经在、机器镜像里有填好的落点表,照落点表筛(不建、什么都不写);两样都没有才整张打印并写明没给落点单元。给的单元对不上入口表的逐个点名,筛完一行都不剩不拿整张表顶替。名单没按落点单元查全的三种情形退出码 1(给的单元有对不上的、筛完一行都不剩、架构详图里只剩按层归谁的那一张而有单元要筛);落点只写了 none 的新建退出码 0。谁跑这条命令的叫法改成:档与入口由主控拍板,命令由项目经理跑。 - 业务编排器(x-feature-dev 的 core/roadmap.js、core/orchestrator.js):各端与删除这个动词带上领队该派的执行体,实施那一段每端一行印两样 —— 执行体(叫什么与执行体定义的名字)与这一端的活经什么做(技能或机制);执行体定义文件不在时当场打印提醒。数据端与删除两份 bridge.js、数据端 publish-table.js 打印的话同批改口:仓内的活由领队派的那位执行体办,往线上写的几步归部署会话在用户单次授权下做。
- 文档 · 宪法:第四节讲执行体分类的那一句,由「框架 / 四端 / 质量 / 治理 / 运维 / 能力」改成「设计 / 建造 / 质量 / 治理 / 运维与调研」。只改这一处。
- 文档 · 架构详图:第十五节 —— 角色表原「项目经理」一行改叫「关口」(管的事没变),新加「项目经理」一行(管流水线运行面的执行体,六样职责),主控一行改成只做决策、出设计、弹签字题三样,部署会话一行改成照发布技能自己动手、量大派运维发布专家,工作会话一行与「提速的八条规矩」第 5 条改谁刷新收尾单;执行体按层表整张照新名册换;x-agent 规范那一串去掉「拟增」、加注册表与名册一致的那颗闸;「这张表今天靠什么」加派发闸一句;「四块写域的归属」加站点工程师、视觉设计师的归属与写域点名;「谁来发布、怎么授权」换成统一的口径;新加「项目经理接住运行面」一段;「主控怎么交接」里封版认领那一句改成两条路;否决清单与生命周期各加一句。第十七节 —— 术语表加「项目经理」「关口」两条,改「主控」「部署会话」「收尾」三条;入口表五行「执行体」一栏每位写叫什么与执行体定义的名字,主控之外的每一位至少出现一次,每行写明项目经理的接力点;引子、通则与「守不到」照新机制改。第八节 —— 开头「零件用到才装」加组队零件的约定;环1 通道列表加「派执行体通道」;环3 分账那一条改成两种认法;需求对账里新加「派发闸」「写域点名」两段;台账事件加一种;「复盘进关口」改叫法并写成两条路,「办理会话」的守不到同一句照此改;「收尾单与治理站点一格」里起草两次那一句写明第二次谁跑。第三节全景图的强制层一格加三行;第九节「发布之前先只读查部署门」加一句。
- 文档 · 几样口径(散在上面各节里,同批改的):授权在哪说、谁动手统一成一句 —— BOSS 只对 X大脑 说,X大脑 逐字转给部署会话,部署会话以转来的原话为准、照发布技能自己动手、量大派运维发布专家,机器不核;框架这一侧写进架构详图(第十五节角色表、同节「谁来发布、怎么授权」、第十七节入口表的通则)、发布技能说明顶部与开发规则书开篇。这一句与项目架构设计页里转达的通则并存:「以转来的原话为准」指的是只认用户的原话、不认转述、不用他再去部署会话说一遍;部署会话动手之前照转达的通则到原话账本只读核一遍,核到就办、核不到回主控,这一步是纪律、机器不核;同一个口径写进了架构详图第十五节讲发布授权的那一段与发布技能说明顶部「发布授权约束」那一段。独立复盘连着三次不过之后谁再派写成两条路:由主控在用户对它说过话之后派(照代码读是通的,没有实跑过),实跑不通时退回老办法、用户去那个工作会话说一句。验收完结之后刷新收尾单与跑清理归档这两下,在办这条需求的会话里由领队派项目经理跑,清理归档执行之前经领队点头,收尾单里写错的那几行由办理会话改。
- 文档 · 决策记录:新增 ADR-102(agent 架构二期;推翻执行体注册表里「视觉设计不单设 agent」「项目经理是这套体系本身」两句旧定论,取代 ADR-75 决定 ⑧ 里两处、ADR-98 与 ADR-99 决定 ⑤ 里各一句,收窄 ADR-99 决定 ③ 与 ADR-101 决定 ④,补 ADR-82 等几条)。
- 文档 · 技能说明与参考文档:五份技能说明(x-feature-dev、x-deploy-dev、x-data-dev、x-module-del、x-harness-dev)、x-feature-dev 的六份参考文档与数据端的一份评测期望,照新名册与统一的授权口径改;x-deploy-dev 顶部写进授权那一句(x-feature-dev 的说明里也带了这一句);x-harness-dev 讲立项命令与清理归档的两节照新开关与谁来跑改。
- 文档 · 开发规则书:开篇「开发期联调上线」里「谁做」「要不要授权」两条。
- 测试:守卫的三张床(team-gates、stop-ring、session-ledger)与守卫回归套件随守卫同批改(回归套件里派平台内置类型的那一条改成期望拦);立项命令的床与业务开发技能的床同批加了断言。
- 不在这一版里的(照实写):agent 架构的设计页、名册表与执行体文件(新建项目经理、站点工程师、视觉设计师、调研员四份,规范裁判官下线,各位的写域与「输出经谁核」写准)记在 agent 架构自己的变更历史里;x-agent 规范新加的注册表与名册一致的那颗闸、部署规范讲授权的那一条、项目架构设计页各升各的版;治理站点的源码不归任何版本单元。
- 守不到(照实写):授权没有机器核 —— 转的是不是用户的原话、是哪个会话在发,都不认。派发闸只核类型在不在名册、定义文件在不在:派得对不对不核,不经派执行体那个工具起的执行体不过闸(经工作流工具起的也不过,这一条是推断、没核),写前拦截摘下期间不在岗;写域只点名、不拦,只看得见编辑工具写的;立项命令只打印名单,照不照名单派不核。项目经理那六样做没做、主控每次醒来派没派它,机器不核,它不在回合里醒不过来。无主复核的新认法依赖平台的会话名册,判不了就退回 24 小时;此刻的内容从没查过干净的照旧要等。细说在架构详图 §十五(「这张表今天靠什么」「谁来发布、怎么授权」「项目经理接住运行面」)、§八(「派发闸」「写域点名」、环3 分账里的第二种认法)、§十七「守不到」与 ADR-102 的边界。
- v4.30.x
agent 架构立层:四类架构升成五类;版本契约多认一类单元 agent:overview,执行体文件从整个框架移到它名下;守卫、封版命令、排队与立项脚本、计划模板都认它;宪法、架构详图、规则书与工作流说明照五类改口;主控有了执行体定义「X大脑」
设计指纹a1325689内容指纹1ff3c383测试指纹6d1902d6f9800d86改动设计 24 个(CLAUDE.md、harness-engineering.md、ADR.md、x-dev-rule.md、x-meta-rule.md、SKILL.md、SKILL.md、SKILL.md 等);代码 9 个(requirements.js、PLAN-TEMPLATE.html、scope.template.json、plan-new.js、plan-queue.js、plan-run.js、seal.js、meta.js 等)
需求agent架构立层签字 b781已发布
为了:agent架构立层 —— 用户 10-12 在「agent优化」那条线上定的:执行体不再只是框架名下的一类受治文件,立成与业务、系统、框架、项目并列的第五类架构,栏目名「就叫agent架构」。此前没有一页讲清有哪些执行体、谁派谁、怎么组队、受谁管;改一份执行体要升整个框架的版;主控只是一个约定俗成的窗口。这一版是框架这一侧要改的部分:让版本契约、守卫、封版命令、排队与立项脚本认得这类新单元,把各处「四类」的说法改成五类。新增一类版本单元,升第二位。
- 版本契约(检测引擎的 check/version-contract.js):多认一类单元
agent:overview(层名 agent,名字「agent 架构」,目录.claude/arch/agent,变更历史与锁清单在同目录)。锚只认设计页ARCH.html,文件在才是单元;版本读设计页页头的 version 标记,与项目架构同一种读法。设计是设计页,内容是.claude/agents/下一层的执行体文件与名册注册表。整个 HARNESS 这个单元不再包执行体文件:改一份执行体升的是 agent 架构的版,不再带动框架的版。封版与另外几类单元同一条元治理封版命令。 - 守卫(guard/requirements.js):顶层路径名单加
.claude/arch/agent/,执行体目录.claude/agents/那一行从整个框架名下挪到 agent 架构名下;顶层的层由三层(整个框架、系统规范域、项目架构)变成四层,加 agent;单元名给人看的写法认agent:overview、叫「agent 架构」,签字时落点单元不认得的那句回话里,认得的写法多它一个。agent 架构的设计页、变更历史、锁清单与全部执行体文件从此受顶层围栏管:办着落点表里列有这个单元的需求的办理会话才写得动(执行体文件此前算在整个框架名下,本来就在围栏里,变的是要办着哪个单元)。 - 封版命令(x-meta-dev 的 core/seal.js 与入口 meta.js):认
agent:overview。它的测试指纹如实写 none,那一行写明「agent 架构的设计页没有代码;守着执行体文件的是 x-agent 规范的床」;检测前置照系统规范域之外的写法,只跑增量检测。入口帮助里的单元清单写全六类,多一条封 agent 架构的示例。 - 排队、接力与立项(x-harness-dev 的 core/plan-queue.js、core/plan-run.js、core/plan-new.js):排队一览里这个单元叫「agent 架构」,按单元列的时候排最前(agent 架构、整个框架、项目架构、业务总览、系统规范域,业务域在后);接力命令封版那一步的说明加上 agent 架构(它与整个框架、系统规范域、项目架构同走元治理的封版命令);立项脚本里三处「四类需求入口表」的叫法跟着表名改成「五类需求入口表」—— 它按表头两栏找表,功能不变。
- 计划模板与机器镜像模板(x-feature-dev 的 assets/plan):认得的单元写法加
agent:overview;「哪一类」多了项目架构与 agent 架构;框架模块最后一格由「资产和执行体」改成「资产」,写明执行体文件归 agent 架构、另列一个落点。 - 执行体:新增
.claude/agents/x-brain.md—— X大脑,主控这个角色的执行体定义,只作主会话用,用claude --agent x-brain --name X大脑启动;名册注册表加它一行,并写明名册的真相源是 agent 架构设计页里的名册表。这两份文件随契约改动归 agent 架构那个单元,不再是整个框架的文件。 - 文档 · 宪法:第三节「两把尺子」写成五类架构(agent、业务、系统、框架、项目),住架构层目录的由三类三个目录改成四类四个目录,六层「不是又一类架构」,agent 架构「不是六层之外的又一层」;第二节「受治工件类」架构层分四个目录、执行工件是 agent 架构的内容,版本契约那一条的单元清单加 agent 架构,最高律第三条加 agent 架构;第四节改成「五类需求,一条流水线」,顶层的范围加 agent 架构,「会话身份怎么定」加半句「主控由 X大脑 执行体定义启动」;第六节第 1 条加 agent 架构;相关文档表多「agent 架构层」一行,「Agent 执行工件层」那一行改说明,入口表改叫五类。只写定性,启动命令不进宪法。
- 文档 · 架构详图:第十三节单元表加「agent 架构」一行,整个 HARNESS 那一行的设计清单去掉执行工件,新增一段「执行体文件换了单元」,「三层」的叫法与两个封版入口改成六行、六类,封版那一关与「升哪一位」各补一句,同批回看的站点入口页由六个改成七个;第十四节标题与正文加 agent 架构一条,写权分工加一句;第十五节改标题,加一段讲它的设计住哪、归哪个单元(是第五类架构的内容,仍不是六层里的一层),受治文件类加 agent 架构,x-agent 规范那一段加名册闸,角色表主控一行写明由 X大脑 执行体定义启动与启动命令,并写上这个启动方式 2026-10-13 由用户亲手验过的结果(开场守卫在岗、宪法照常加载、它自报是 X大脑、窗口标题是 X大脑),执行体按层表加 agent 架构设计页一行,写域归属加一块,否决清单注明 X大脑不是当年否决的协调者执行体,生命周期的落点由整个框架改成 agent 架构;第十七节标题与表名改成「五类需求入口表」,表里加「改 agent 架构」一行、改框架那一行去掉执行体文件,术语表加「X大脑」一条,主控与执行体两条各补半句;第八节讲顶层围栏的各处由三类版本单元改成四类(全景图、挂载、写前判定、围栏正文与路径预筛表、同一块排队的守不到),发布登记那一段写明 agent 架构这一类单元今天不出「已生效」一格;第十六节讲定版的单元清单与封版记录的键补上项目架构与 agent 架构;第九节治理站点那一行的入口页个数改成七个;第四节「宪法只留定性,机制各在哪」那张表改一行、加一行。全文「四类需求」「四类架构」改成五类。
- 文档 · 决策记录:新增 ADR-101(agent 架构立层;取代 ADR-70 决定 ⑥ 里「框架认领 agents/」那一半与 ADR-99 决定 ③ 里「不建主控执行体」那一半,收窄 ADR-99 决定 ②)。
- 文档 · 三份工作流说明:x-feature-dev —— 五类需求、落点单元的写法加
agent:overview、顶层围栏四类、元治理入口封全部六类单元、项目架构不再按序数叫第四类;x-meta-dev —— 封版的单元清单与示例加agent:overview、六类单元、agent 架构的测试指纹写 none;x-harness-dev —— 立项脚手架读的表改叫五类需求入口表,发布登记讲「已生效」与「治理站点」两格的两句补上 agent 架构。 - 文档 · 两份规则书:开发规则书「封全部五类单元」改成六类;元治理规则书场景 F 的触发条件里整个 HARNESS 锁住的原件去掉执行工件、单元加 agent 架构,版本号所在处与封版命令各加 agent 架构一条。
- 测试:版本契约床、守卫的需求对账床与门一床、封版命令床、元治理自测、接力命令床、体系守护自测七张床同批加断言(新单元在名册里、执行体文件只归它、agent 层算顶层、封它读得到设计页页头的版本、排队一览里的叫法与先后),每条新断言配改坏对照。
- 不在这一版里的(照实写):agent 架构自己的设计页、变更历史与首封记在它自己的变更历史里;x-agent 规范的名册闸、x-harness 规范与治理站点多出的那一栏、x-governance 规范的改口各升各的版;项目架构设计页由它那个单元改;治理站点的源码不归任何版本单元。
- 守不到(照实写):每次开工是不是先开了 X大脑、窗口是不是用那份定义启动的,机器不核。发布登记认单元名出「已生效」一格的那一处还没有 agent 架构这一类:落点有它的需求照旧有「治理站点」一格(只落这一类单元的就只有那一格),翻不翻已发布不受影响,这一版没改。守卫本体与守卫回归套件里几处写着「顶层三类」的注释这一版没动,不影响判定。入口表、执行体按层表写了 agent 架构设计页归框架架构师,那份执行体文件的写域一行跟没跟上,没有机器对拍。
- 版本契约(检测引擎的 check/version-contract.js):多认一类单元
- v4.29.x
联调与发布门:开发期联调上线有机器认得的口径(先跑联调开始、放行面是签过字的落点表);正式发布由机器核验收完结;发布登记只给已完结的需求记已发布、按完结时那一版比;数据表与微信原生包在体系之外发;只有业务域落点的需求不带「治理站点」一格;版本比对拦下时报文带封版命令
设计指纹cc1db3c6内容指纹1695f39d测试指纹763333adecb034b8改动设计 7 个(CLAUDE.md、harness-engineering.md、ADR.md、x-dev-rule.md、SKILL.md、SKILL.md、SKILL.md);代码 14 个(guard.js、mcp-policy.js、release-versions.js、verify-harness.js、create-deploy.js、publish-tests.js、deployer.js、PLAN-TEMPLATE.html 等)
需求联调与发布门签字 5104已发布
为了:联调与发布门 —— 用户 10-12 在框架复盘里点的两项:「乙:部署门认联调(推荐)」「甲:不带,那两格移出(推荐)」。此前机器只认一种状态 —— 全部版本单元封着才让云端写入:开发到一半要联调就得先封版,联调之后每改一行再封一次;正式发布从不核这条需求验收完结没有;发布登记会把在办需求的格记成「已发布」、之后不再与完结时的版本比;带数据表或小程序端的需求永远走不到「已发布」。这一版把四件事落到机器上:联调有口径、正式发布核完结、登记对得上版本、该发的格只留体系内能发的。新增一类东西(一道判定「联调还是正式发布」、守卫的一个联调零件、体系守护的一个动作),升第二位。
- 守卫 · 联调零件(guard/trial.js,新零件):纯判定加读写联调标记,用到才装。判一次要上线的东西是「联调」还是「正式发布」—— 联调成立要四样同时成立:有口径(有效的联调标记;脚本通道另认命令上的两个开关,给了就只认命令上那条需求、不读标记)、那条需求在办(签过字、没完结、签字没作废、账本可信)、这次要上线的全部东西都落在它签过字的落点表里、要上线的是云函数或数据表;缺一样一律按正式发布判,并给出一句联调为什么没成立。放行面就是签过字的落点表,不另设登记:云函数按函数目录下的源码文件(不算内核目录与依赖目录)、数据表按表文档、站点按原料目录对落点表的格。联调标记一份,住需求账本目录,记着需求的目录名与短名、哪个会话开的、起于何时、有效到何时;有效 30 分钟,到期自动失效(文件不删,读的时候判),另一条需求的标记还有效时开不了,同一条需求再开是续期。「正式发布核验收完结」那一道单独导出,给静态站点的发布准备用;这一道里「在办」的算法:签过字、没完结的按此刻的落点表,签字作废的照最后一次签字时留底的目录算,账本被直接改过的按在办算,机器镜像读不了而签过字没完结的照留底的目录算、连留底都没有就判不了;计划不见了的也算在办 —— 机器镜像被写成空值、被删、整个计划目录没了、或只剩仓外镜像里那份账本的,不在守卫的计划状态表里,另从账本认(账本目录里每一份需求账本,加上仓外镜像里有、账本目录里没有的那几份;有「确认」而没有「已完结」的算在办),照签字时留底的目录算、照旧拦并点名它(账本可信取最后一次签字的留底,不可信或只剩镜像里那一份取全部签字留底的并集),一条留底都没有就判不了。云函数的候选目录不止一个时两头取严的:联调要每一个都盖得住才放,正式发布任一个被盖住就拦。判不了(需求零件出错、联调标记在却读不出来、在办需求盖着哪里无从得知、账本目录或仓外镜像目录在却列不出来)抛出,由调用方按拦处理。
- 守卫 · 部署门(guard.js、guard/mcp-policy.js):待检清单之后、发布前版本比对之前多一道「联调还是正式发布」。这次调用要上线什么照现成的判定面取:代码推送是云函数,建数据模型是数据表(云端判定零件多一个纯函数,从数据模型的图里认出表名),带站点信息的上传是站点,其余变更(云存储、网关、权限、数据读写)不进这一道。判成联调:版本比对只放过这条需求落点表里的单元处于施工中,这些单元别的毛病照拦,别的单元照旧。判成正式发布:要发的云函数目录或站点源码目录被任一在办需求(签字作废的、计划不见了的也算在办)签过字的落点表盖住就拦,报文以「正式发布核验收完结」打头、点名那条需求、带上联调开始的命令;有口径而联调没成立时,为什么没成立那一句拼进这一道与后面每一句拦截报文。这一道在本进程里同步读盘,开头先核一次部署门的剩余预算。版本比对拦下那句的尾巴写明每一行后面就是它的封版命令。写后补判走同一段,照旧只判不跑床。
- 守卫 · 写后、收尾与完结那一刻:联调放行的那次云端写入成功之后,守卫当场只往本会话台账记一笔(哪条需求、标记是哪个会话开的、上线了什么:函数目录或表文档的路径),不当场写履历 —— 当场写出的发布段文件是一处没有干净结论的改动,同一轮紧接着的第二次联调上传会被待检清单拦下,云端工具通道一轮就只能传一个函数;只有标记文件在场时才装联调零件,出错只说一声、不影响别的记账。这一轮收尾时(第一次量工作树与归属之后;真写出了文件就重量一次工作树、重算归属 —— 排在量工作树之前的话,每一次收尾都要多整读一遍全部会话台账),守卫把本会话台账里还没写进履历的每一笔写进那条需求履历发布段的「联调」一格(一笔调一次发布登记),写出的发布段文件给本会话记写证据、在同一次收尾里被复核,全部写完往台账记一笔「已写进履历」(带各笔的结果,附注要说的话从它取):这一格里的时刻是写进履历的时刻(那一轮收尾)、不是上传的时刻,次数照上传的次数;会话没走到收尾就断了的,这个会话下一次收尾时补写;记不上的(需求没有履历、发布登记出错或装不上)不重试,收尾的附注里说一次并给补记命令;这一段不是闸,整段出错只在附注里说一声、不记「已写进履历」,那几笔下一次收尾再写,不拦收尾。脚本通道不变:一条命令发完一批、上传成功之后当场记一次。收尾时本会话凭联调标记上线过的,附注里点名一次(几次、哪条需求、标记是哪个会话开的、上线了什么,写明联调不算正式发布),只进附注、不拦、只说一次。记下「已完结」的那一刻顺手把发布段重算一次(内容没变的不重写,出错只说一声)。说话、编辑、普通命令这些路不因此多装零件。
- 守卫 · 发布前版本比对(guard/release-versions.js):多收一个「放过哪些单元的施工中」的名单(缺省是空的,名单里的单元别的毛病照报,名单外的施工中照报);每一行问题(判不了那一行除外)末尾带上那个单元的封版命令,命令取版本契约的那一份;子进程入口认同一个名单。三条发布通道原样打印这个函数给的行,不各自拼。
- 守卫 · 回归套件(verify-harness.js 与包着它的薄壳床):沙箱里常驻一条盖着函数目录与站点源码的在办需求,正式发布核完结落地之后,原先期望放行的那几条代码推送与站点上传改夹具或改期望(不为了让旧用例绿而放宽新判定);另补一组经守卫入口的用例:联调放行并留一笔、范围外按正式发布判、标记过期、需求不在办、正式发布被在办需求盖住就拦并点名、完结之后放、站点源码被盖住就拦、版本比对的报文带封版命令。「零件用到才装」的对照表补上新零件。
- 部署 · 两条发布出口与统一入口(server/core/deployer.js、release/publish-tests.js、create-deploy.js):云函数脚本出口过门那一步在版本比对之前接同一个判定 —— 被在办需求盖住就不过门、不上传,联调成立时版本比对只放过那条需求的单元,联调上传成功之后对成功的函数记一次「联调」并打印那一行。静态站点的发布准备只在准备发布时核验收完结,核两次:跑床之前一次(版本比对之前,不过就不跑床、不准备档案),打包发布档案之前再硬核一次(一律核、不看命令行);带着只验证或只装配看效果开关的那一次不往线上放东西,跑床之前那一次不拦、只打印一行说明 —— 手机端的需求封了版、还没验收时要先装配出来给用户亲手验,拦了就验不了、也就完结不了。统一入口认需求名与联调两个开关(要同给、只用于云函数、要点名函数目录、不与全量发布、只验证、只读查部署门同给,写法不对当场拒绝并说明);给对了先问一次联调零件这一次会怎么判,判不了或正式发布那一道就不过的当场拒绝,真正放不放由上传出口在上传之前再判一次。没给这两个开关时脚本通道没有自己的口径,上传出口按正式发布判,除非联调标记还有效;这时外面带进来的同名环境变量不算数(入口把它清掉)—— 这一句只在经统一入口时成立:直接跑云函数子入口或 bff 下两个入口时,手设那个环境变量等价于带了两个开关,放不放仍由联调零件判。统一入口里联调零件只在给了这两个开关时才装(上传出口每次过门都问它,判不了一律不过门)。
- 体系守护 · 发布登记(core/record-release.js):四处改记法。① 数据表与微信原生包两格记「在体系之外发」并写明在哪发(控制台、微信开发者工具),不算进该发的格。② 只有业务域落点的需求不带「治理站点」一格 —— 判法三样都成立才不推:判单元时不算落点表里字面写 none 的行(不归任何版本单元的文件,最常见的是测试);去掉之后至少有一个单元、而且全是业务域;并且落点表没有碰治理站点自己的源码(x-harness/ 之下)。碰了站点源码的照旧带这一格;其余需求(落点表里有整个框架、系统规范域、项目架构、业务总览的,或一个版本单元都没有的)照旧每条都有。③ 该发的格是联调格与体系外格之外的那些:已完结的需求,该发的格全部发了才翻「已发布」,一格该发的都没有也算。④ 发布当时的记法只给已完结的需求精确记「已发布」,记下的是这条需求完结时产的那一版(履历没记这个单元才用当下锁清单的版本);命中的需求还在办时不记已发布 —— 站点命中的什么都不记、也不进「联调」一格(静态站点没有联调),函数命中的只有落在这条需求签过字的落点表里的函数目录才记进「联调」一格,不在的不记(命中按站点名或业务域单元算,而没开闸时正式发布发得出去的东西必然不在任何在办需求的落点表里,命中就记的话记下的几乎全是别人的东西)。已完结的需求每次重算,精确记下的版本与它完结时那一版都有而不同即作废、记回「未发布」并带一句为什么;在办时留下的精确记录先不动,完结后的第一次重算照此判。
- 体系守护 · 十态、收尾单起草与联调命令(core/plan-loop.js、core/plan-wrapup.js、core/plan-trial.js 与入口):十态表第 7、8、9 态改口 ——「碰到的格」改成「该发的格」,第 8 态写明一格该发的都没有的也算,第 7、9 态部署会话那一项写明数据表与微信原生包在体系之外发、不算进该发的格;「台账里站点已上线、发布段没记上」那句提示只对该有治理站点一格的需求出。收尾单第四栏末尾那句,这条需求没有「治理站点」一格时改说它只有业务域落点、没有这一格。入口多一个动作 trial:联调开始(带需求名)、结束、只写动作名是看状态(只读);薄薄一层,判与写都在守卫的联调零件。
- 资产 · 计划模板:「固化与验收」页签讲发布的那一段照新记法改口 —— 只有业务域落点的需求(落点表里除了不归任何单元的那几行,单元全是业务域,而且没碰治理站点自己的源码)没有「治理站点」一格,数据表与微信原生包在体系之外发、不算进该发的格。
- 测试:新建两张 —— 守卫的联调床(判定函数层与守卫入口层都测:标记读写与过期、需求不在办、放行面三种对法、联调放行并记一格、范围外按正式发布判、另一个单元施工中时也拦并带封版命令、联调只放「施工中」这一样、正式发布被在办需求盖住就拦、计划不见了的在办需求照留底的范围拦、完结之后放、收尾点名只说一次)、体系守护的联调命令床(开始、续期、结束、状态,该拒绝的各被拒绝且什么都没写)。改五张 —— 版本比对床(每一行带封版命令、名单只放过名单里施工中的单元)、发布登记床(在办的不记已发布、站点命中不记联调、函数命中只记落在落点表里的、完结时那一版的比对、体系外两格、业务需求无站点格、零格即已发布)、十态床、清理归档床、发布接线床(被在办需求盖住不过门、联调成立时版本比对收到放过的单元、问题行带封版命令原样进拒绝理由;静态站点的发布准备只验证与只装配看效果不拦、打包发布档案之前硬核)。每一样新判定都配改坏对照:把判定换成空的,对应的床必须红。
- 文档:宪法第六节第 8 条的半句由「这条需求碰到的每一格都发了才算已发布」改成「该发的每一格」,别的一个字没动。架构详图 —— §三 全景图环1、环2、环3 各补上联调;§六「四类需求各从哪进」讲联调的那一段改口;§八 环1 MCP 通道新加「联调还是正式发布」一条,部署门、总预算与被拦时先报哪一样的三条各补一句,环2 新加「联调放行之后自动记」一条、写后补判与会话台账的事件补上联调,环3 收尾那一段新加「联调写进履历」一条、「项目架构与封存履历」讲门五的那一句补上这两道、新加「部署门认联调」一段(联调成立的四样、联调只放一道、放行面、正式发布核验收完结与在办怎么算、联调标记、三条通道同一个判定、写后与收尾、守不到),「收尾单与治理站点一格」③ 补上例外、讲联调一格的那一段改成机器自动记、新加「发布登记的新记法」一段,「清理归档硬控」里讲收尾单第四栏那一句补上第三种写法,「环的十态」里讲发布段的那一句改口,「同一块排队」的守不到 ② 补一句(删计划只放得开排队,放不开正式发布核验收完结那一道);§九「发布之前先只读查部署门」的守不到补一句;§十三 第 2、3、4 关讲施工中与发布的三处补上联调,诚实边界 ⑨ 补上核验收完结;§十四 十态表第 7、8、9 行照零件里的常量表重抄,「两个终点别混」那一句改口;§十五 角色表部署会话一行(做什么、不做什么两栏)、「一条需求一次封版收得了口」里讲版本比对拦发布的那一句、「谁来发布、怎么授权」与「今天靠什么」讲发布与授权的几句改口;§十六 诚实边界 ⑤ ㉑ 各补半句;§十七 术语表「落点表、格」一行写明发布段里的格分三种、新加「联调、正式发布」一行,入口表业务需求一行的发布面改口,通则 ④ 补一句。决策记录新增 ADR-100(八个决定、谁定的、否决过什么、这一次不做什么、与 ADR-83、ADR-99、ADR-96、ADR-71 的关系、守不到)。开发规则书「开发期联调上线」一段改口(联调开始命令带需求名、放行面是签过字的落点表、没开联调的一律按正式发布算、联调成功自动记),Data 端与 Server 端指回这一段的几处同批改准,Server 端第 6 步写明开发期联调上线时新建函数走脚本通道、带需求名与联调两个开关。三份技能说明 —— 部署技能新加「联调上线与正式发布」一节(联调怎么走、联调时新建函数走脚本通道、脚本通道的两个开关、正式发布核验收完结、被拦时报文长什么样、守不到),顶部授权约束的三条小项改口,讲新建云函数走哪条通道的几处(授权约束第 3 条、发布面总表第 2 行、选通道的判据、六步流程之后)各补上联调时走脚本通道;体系守护技能新加 trial 一节,发布登记一节照新记法重写,参数提示补上 trial,queue 一节讲删计划那条路的半句补上「只放得开排队」;业务开发技能讲「每条需求另有一格治理站点」的那一句补上例外。
- 不在这一版里的(照实写):部署规范另升了它自己的一版(条款 ARCH-E04 的发布目标加治理站点、架构页点名守「先查部署门」的那一组床、「守卫只拦 dev server 不拦构建命令」那句按现状改准),记在它自己的变更历史里。项目架构设计页是另一个版本单元,里面讲十态与发布状态的同类句子由设计页那条线改,这一版没动。
- 守不到(照实写):机器只认有没有有效的联调口径 —— 这一次是不是用户授权的、是哪个会话在发,不核;联调标记一份、全仓共用、谁都开得了,别的会话误用它能让落点表里的函数绕过正式发布核完结那一道,兜着的只有收尾时的那一次点名(只说、不拦)。放行面是落点表:落点表写得宽,范围里没改的函数也按联调放过去。云函数按「仓里同名函数目录此刻的文件」判:云端工具通道传上去的若是仓外的包,按 x-server 里同名的目录认,同名目录不止一个时两头取严的(联调要每一个都落在落点表里才成立,正式发布任一个被盖住就拦);找不到同名目录、上传目录又不在仓里的,联调成立不了,正式发布核完结这一道也拦不到它,后面还有上传内容核对兜着。机器认的联调只有云函数上传、建表与改数据模型:静态站点没有联调,网关、云存储、数据读写这些其余的线上写入没有联调这条路、也不核验收完结;控制台里用户亲手做的导入与发布不经发布门,机器看不见、不自动记。正式发布核完结只管云函数与站点源码,数据表不核;站点按落点表里的目录写法认、带通配的按字面前缀认,宁多拦不漏放 —— 落点写得宽的在办需求会把不相干的站点发布也拦住。签字作废的需求也算在办:它盖住的东西正式发布照拦,它自己的联调也不成立,重签之后才恢复。标记过了 30 分钟,之后的上传按正式发布判、被这条在办需求自己盖住而拦下,重开一次即可。联调自动记只是留痕,记不上不重试、只说一次并给补记命令,没有东西回头催;写前到写后之间标记正好到期的那一次不记;经云端工具上线的要到这一轮收尾才写进履历 —— 会话没走到收尾就断了的,台账里有那一笔、履历里还没写,要等这个会话下一次收尾补写,一直不再收尾就一直没写;「联调」一格里的时刻是写进履历的时刻,不是上传的时刻;脚本通道同一轮里紧接着再跑一次发布,会被它自己的先查部署门拦下,要先结束这一轮(与正式发布之后跑发布登记的现状相同);联调放行的那次云端工具调用,平台报成功而云端实际没成的,也会被记进「联调」一格 —— 机器只看得见工具返回了,不读返回里写的是成是败。计划不见了的在办需求(计划被删、被搬走,机器镜像读不成一个对象)从账本认得出、照留底的范围拦,看不见的只剩一种 —— 账本目录与仓外镜像两处都找不到它的签字记录,那时正式发布核完结这一道拦不到它盖过的函数与站点、收尾也点不了名;计划不在的需求联调开不了,把计划恢复回来才办得下去,收尾照旧会点名它一次;计划不在时账本里的「已完结」照读到的算、不核那一笔可不可信。占着落点而不办了的需求,它盖住的函数与站点正式发布一直被拦:删计划放得开同一块排队那一处,放不开这一道,只有等它验收完结(计划删掉了的先恢复回来)。内核不算进云函数的放行面:云函数按函数目录下的源码判,不算内核母本(x-core/server/sys),只改内核的需求在办时,正式发任何函数这一道都不拦,而内核会装配进每个上传包(手机网页版的原料目录带着母本包,改母本包的在办需求拦得住网页版的发布,两边不对称)。治理站点的正文取材于 .claude 下的受治文档,这一道只按站点自己的源码目录(x-harness)核:只改受治文档的需求封了版、没验收完结时,站点照样发得出去(发上去的是封过版的文档);发布登记却认定这类需求有「治理站点」一格 —— 一处问发不发得出去,一处问它完结之后发过没有。建路由不在联调里:联调只认云函数上传、建表、改数据模型,经云端工具新建函数之后的建路由算其余变更、照全量版本比对判,本需求的单元施工中时会被拦,所以开发期联调上线时新建函数走脚本通道(上传与配路由在同一条命令里)。守卫这一侧取站点原料目录靠发布库与端名册,装不上时退到站点自己的顶层目录,手机网页版的母本包目录就核不到;发布准备那一侧直接调发布库,装不上就起不来。直接跑云函数子入口或 bff 下两个入口时,手设联调那个环境变量等价于带了两个开关(放不放仍由联调零件判)。发布登记与完结时那一版的比对只对发布当时精确记下的格起作用。只有业务域落点的需求不带「治理站点」一格之后,它的履历页在治理站点上要等下一次站点发布才更新,守卫不再为它点名「待发布」。开闸期间守卫写前那一道不在岗,经云端工具的上传写后只补判、记一笔,拦不回来;两条脚本出口的判定在脚本里,照常。架构详图抄的十态表与零件里的常量表一不一致,照旧没有机器对拍。发布授权照旧没有机器核。
- v4.28.x
真相源拉通:四类需求写成一张入口表、名词写成一张术语表;宪法只留定性、机制细节下沉到架构详图;各处互相矛盾的说法改成同一个;执行体认领没人管的写域;体系守护技能加 new 与 ask 两条给主控用的命令;五个技能的自测各加一条「说明对得上脚本」
设计指纹3764856d内容指纹740cd02e测试指纹1fbf4684ff927403改动设计 27 个(CLAUDE.md、_registry.md、x-admin-engineer.md、x-adversarial-reviewer.md、x-architect.md、x-client-engineer.md、x-framework-architect.md、x-harness-auditor.md 等);代码 14 个(orchestrator.js、roadmap.js、feature.js、scaffold.js、scaffold.js、bed-runner.js、record-release.js、harness.js 等)
需求真相源拉通签字 1632已发布
为了:真相源拉通 —— 用户 10-11 下午:「我担心里面的逻辑是老旧的,不是串联和拉通的,我期望你发起一个专业的workflow来排查和分析当前的整个……harness引擎框架的所有内容,确定我们当前的项目架构所有需要修改的内容,我期望一步到位更新到最新的整个宪法+L0-L5+4架构,特别针对项目架构和实施的agents……禁止复杂化」。六路只读审计查下来:同一件事在宪法、架构详图、规则书、技能说明、执行体说明、治理站点里说法不一(互相矛盾的 22 处、过期的 15 处),4 块受治文件没有执行体认领,业务开发的工作流没接上需求闭环,宪法自己有几处写进了下层机制。这一版只做一件事 —— 把各处改成同一个说法(每处只改成审计表里写的那一个正解,不立新说法),并把四类需求(改项目架构、改框架、改系统规范、业务需求)怎么进、谁办、怎么封、往哪发写成一张表。不拆框架版本单元、不建主控技能与主控执行体、不动守卫、不动项目架构设计页。新增一类东西(一张入口表、一张术语表、体系守护的两条命令、五条「说明对得上脚本」的自测),升第二位。
- 文档 · 架构详图 · 新加第十七节「术语表与四类需求入口表」:术语表十三行 —— 主控(写明新接手先做三件事:跑环的十态命令、跑排队一览、读项目架构设计页与第十五节)、主会话与领队(同一个意思)、工作会话、办理会话(机器认的那一个)、部署会话、执行体、环(治理环与开发环 / 守卫的几个环,两种意思分开)、收尾(收尾环 / 收尾单 / 清理归档,三种意思分开,另注「环收尾」)、收场、档、开闸与关闸、落点表与格、机器镜像,每行指到细说的那一节。四类需求入口表四行六栏 —— 行是改项目架构、改框架、改系统规范、业务需求,栏是单元、入口、谁写计划、执行体、封版命令、发布面;表下写四栏的通则、不归任何版本单元的东西怎么列落点、守不到。
- 文档 · 架构详图 · 跟着改的各节:§二 新加「平台这一层的四条边界」(钩子超时等于放行;收尾钩子连拦八次后放行;会话之间的消息 —— 收信策略不写进项目设置文件,平台只认项目文件里的扣留与拒绝,接受要写在用户设置里、由用户本人选,守卫的钩子看不见消息本身;队友与领队同一个会话号)。§三 全景图里内核那一行去掉文件数。§四 新加「宪法只留定性,机制各在哪」一张对照表(宪法收回的每一句定性,机制落在本文哪一节)。§六 工作流表里业务开发那一行在封版与发布之间补上独立复盘与验收完结、发布写成交部署会话;新加「四类需求各从哪进」一段(改框架与改项目架构没有专属工作流;发布排在验收完结之后;开发期联调上线是部署会话在用户单次授权下做的一个动作,记进需求履历发布段的「联调」一格,不算正式发布,验收完结之后照旧要正式发一次才翻「已发布」);「结构约束」里写明开发流与现成的数据表技能、删模块技能的委托关系,旧称「主会话 depth-1」改成领队直接派执行体;技能开发规范那一条异常登记(harness-P-06)改成已处置。§八 讲项目架构那一段的门数改成现行六道门并列出六个名字;「收尾单与治理站点一格」里补上「联调是单独一种格」一段(命令、只留痕、拒绝的四种、守不到)。§十三 新加「三层这个叫法」与「两个封版入口,同一个核心」两段(元治理入口封全部版本单元,开发流入口只封业务两类,二选一、结果相同);「为了」一行的写法写成短名打头的完整形态;「更新流程」由走元治理工作流改成走需求流水线、封版用元治理的封版命令。§十四 「生命周期」改成指向项目架构的状态机,业务需求碰架构层的次序留在同一段、封版之后补上独立复盘与验收完结;「写权分工」加项目架构设计页归框架架构师、系统架构公共部件归元治理专家;讲项目架构是哪一类受治文件的那一句去掉序数;「框架不依赖业务」那一条由一个待落地的阶段名改成现状(没有单独的闸,有一张框架独立性床)。§十五 角色表部署会话一行写成一切线上写入都在它里面做、每一次都要用户单次授权、例外只有连带授权;执行体按层表加「项目架构设计页归框架架构师」一行,发布与下线那一行改成运维发布专家做线上写入与线上删除、模块下线专家只删仓内文件;新加「四块写域的归属」一段;「先分级、再选路」写明三档的定义只在这张表写一次;「谁来发布、怎么授权」把线上写入的范围写全;「生命周期」由建改执行体与它的治理规范都走元治理工作流,改成改执行体文件是改框架、改它的四件套是改系统规范;第三方登记闸那一条里 gpt-image-2 写成已卸载、登记行保留、仍标默认禁用、绑定照拦。§十六 「仓库级锁、不点名」补上拿不到锁是排队等、缺省最多等 45 分钟、开关可改上限;宪法测试条文对照表里「元规则、宪法与本文、执行体目录、项目设置不属于任何面」那一句改口 —— 它们自己不成一个面,但体系守护技能的自测在床头点名守着其中几份的说法(另有四份技能说明与业务编排器),改了那一张床就不新鲜、要重跑。
- 文档 · 宪法:第二节补一句「框架与项目架构的变更走需求流水线,没有专属工作流,封版用元治理封版命令」,版本契约那一条的「三层」改成全部版本单元,测试闭环那一条的记账规则收成一句指向;第三节去掉「回流序」那段带日期的迁移路线(换成一句「时点状态不入宪法」),层表里两处实现形态的字眼去掉;第四节生命周期图在封版与发布之间补上独立复盘与验收完结、发布写成交部署会话,工作流表与下面的引文去掉委托关系的实现字眼,新加「四类需求,一条流水线」一句并指向入口表,「运作方式」补上部署会话与「会话身份怎么定」(主控由用户在窗口里定、用户只和它说话;工作会话与部署会话由主控握手时指定;机器只认办理会话与非办理会话),顶层的范围点名项目架构设计页;第五节开发环的图同样补上独立复盘、验收完结与交部署会话;第六节第 1 条补上框架与项目架构走需求流水线,第 6 条的处置机制收成一句指向,第 7、8 条的「三层」改成全部版本单元,第 8 条只留定性加指向 —— 签字区怎么签、内容编号、写前写后收尾各对照什么、封版前先查哪两项、计划的页签都不再写,写明需求确认说固定那句话即可、实施交付必须对着亲手验的清单签,要用户签的只有这两次,发布排在完结之后、往线上放东西每一次都要用户单次授权且只在部署会话做;相关文档表加「术语表 · 四类需求入口表」一行,死命令那一行去掉数字。
- 文档 · 决策记录:新增 ADR-99(四类需求一条环;不拆框架版本单元;不建主控技能与主控执行体;发布排在验收完结之后与开发期联调上线的定义;一切线上写入都要用户单次授权与连带授权那一个例外;否决过什么、与 ADR-98、ADR-94、ADR-90、ADR-75 的关系、守不到)。
- 文档 · 体系守护技能的参考(x-harness-arch.md):不再自称「唯一架构真相源」,写明架构真相源是架构详图、本文件是体系守护技能的参考;去掉规范与规则书的份数;强制层「待建」、双区认路、双宪法这几句迁移期的旧话照脚本现状改掉,体检与闭环验证各查什么照现行脚本重写(强制层查三个钩子真挂没挂、闭环验证第五条是收尾到封版的测试链);跑床的锁本来就写的是排队等、缺省最多等 45 分钟,没有动。
- 资产 · 执行体与注册表(执行体目录受写保护,在开闸窗口里落):十三份执行体与注册表照角色表对了一遍。四块此前没人认领的写域各归一个执行体 —— 项目架构设计页与自研技能的参考文档归框架架构师;系统架构的公共部件归元治理专家;技能的模板资产归体系工程师;移动端的各 backend 与装配器归小程序前端专家;内核工具 manifest.js、closure.js 归云函数专家。云函数专家不再教往函数目录里装配内核目录(源码树里没有它,发布时才装进上传包);运维发布专家补上治理站点、线上资源的删除、发完跑发布登记,绑上体系守护技能,写明一切线上写入都要用户单次授权、只在部署会话做;模块下线专家只删仓内文件,线上残留出清单移交运维发布专家,多两个只读的查询工具;业务架构专家去掉决策记录的触发词;规范裁判官的端映射改成指向编排器里那张表(END_RULES)、不再写「中断等用户审核」;后台前端专家去掉 X6;「三件套」「四链路」两处旧叫法订正;各份里的「主会话」改成领队;注册表照角色表改、去掉「第四类」这个序数。执行体规范检测零违规,守着它的两张床全过。
- 文档 · 没配对的规则书三份:业务开发规则书(x-dev-rule)—— 文首加一段指向需求闭环;开发顺序照编排器的四端次序写,API 替换写成 Admin 端的收尾子步;新增「开发期联调上线」一节;授权约束改成一切线上写入都要用户单次授权、只在部署会话做;检测口径由「END_RULES 决定跑哪些规则书」改成增量检测按全部规范的适用面挑;示例目录换成真实路径;原来「全量检测之后中断、等用户审核」那一步并进签字二;封版写明两个入口同一个核心。技能开发规则书(x-dev-skill-workflow)缩成一页指针,加上按路径加载的文件头,不再每次会话整份加载。第三方技能登记(x-thirdparty-skill-rule)去掉三个不存在的技能名,gpt-image-2 的登记行改成已卸载、保留默认禁用。
- 体系守护 · 给主控用的两条命令(动作 new 与 ask):new 是立项的脚手架 —— 把看板与机器镜像两份模板拷进计划目录、填上短名与档、照实列出还没填的占位、打印派工底稿的固定部分(握手句、按档的回报节点、共用资源的规矩、按落点单元查到的执行体;执行体读的是架构详图 §十七 入口表的「单元」「执行体」两栏,不写死在脚本里)。ask 出签字题的正文 —— 预检、签不签得了、排队、刷签字区四样都过才打印可以直接贴的题目正文,并先把这道题交给守卫弹题之前的那套核对预演一遍;有一样不过就不打印正文、只报原因。两条都只读受治文件,new 只往计划目录写;各有床守着。
- 体系守护 · 自测、说明与运行器文件头:自测加六条 —— 说明里讲锁的那一句、说明对得上脚本、执行体的四块写域与用语、旧规则书退役、九组旧说法在宪法、架构详图、规则书、技能说明与编排器里全文为零、项目设置的拒绝名单有那四条且没有收信策略那个键。技能说明改口:跑床的锁是排队等;删掉一条指向早已不在的施工计划的死链,以及双区认路、强制层待建几句旧话;写明架构真相源是架构详图;参数提示补全。运行器文件头讲锁的那一句改成排队等(开闸窗口里落,只动注释)。
- 体系守护 · 发布登记加「联调」一种格:开发期联调上线做完,部署会话跑
node .claude/skills/x-harness-dev/scripts/harness.js --action=record-release --plan=需求名 --trial=联调上线了什么(逗号分开写函数目录、表名这类)。这条需求的发布段多出一格,格名「联调」,状态只有一种「已联调(不算发布)」,记最近一次的时刻、一共几次、联调过哪些东西(去重累加)。它是单独一种格,只在记过联调的需求上有,不是给云函数那一格加一个状态。只留痕:不翻任何别的格、不算进该发的格,在不在都不影响翻不翻「已发布」,云函数、数据表那几格照旧要在验收完结之后正式发一次才翻。拒绝并且什么都不写的四种:开关后面没写值、没有同给需求名、与记正式发布的站点或函数目录开关同给、这条需求没有履历。没有动守卫。自测加一条,把它改坏十种逐种验过都红。 - 检测引擎与部署技能:检测引擎的技能说明加「增量检测与其余开关」一节,讲详情开关别名的那一句改准,架构速查改成现状,禁止事项由不许改引擎改成「引擎可以改,改引擎属改框架」;检测引擎入口文件头七行用法注释换成现在的路径与真实示例(开闸窗口里落,代码一个字符没动);新建一张自测 skill-docs.test.js(说明对得上脚本)。部署技能说明顶部的授权约束改成一切线上写入都要用户单次授权、只在部署会话做,补上发布排在验收完结之后、发完跑发布登记;示例路径、参数提示、禁止事项、规则编号范围订正;自测加一组。
- 业务开发技能:编排器的阶段提示改成需求闭环的说法 —— PLAN 写起草计划、跑核对命令、主控弹签字一,原来的设计确认并进签字一,签字一签上之后才动受治文件;ARCH-SYNC 补上「为了」一行的写法;ARCH-SYNC 与 DEPLOY 之间多打印一行独立复盘与验收完结;DEPLOY 改成交部署会话,写明一切线上写入都要用户在部署会话单次授权。五个阶段、端次序与编排逻辑没动。入口帮助里三个动词的端次序照编排器现算,都带上 Client。云函数脚手架带执行开关时不再往源码树里写内核目录 —— 这是这一版唯一一处行为改动,让脚本与「源码树里没有内核副本」一致;头注与参考文档同批改。两个脚手架跑完的下一步提示改成 verify-feature.js --changed。技能说明:三道门改成六道门,生命周期图补独立复盘与验收完结,两个封版入口同一个核心,「为了」一行短名打头,架构速查补三个脚本,随「流水线提速」失效的五句照项目架构设计页改口;参考文档补 --parent-table。自测加五条:三个动词的阶段提示含那四样(签字一、独立复盘与验收完结、「为了」、交部署会话);假仓里脚手架跑完函数目录恰好六个骨架文件、没有内核目录;两个脚手架的下一步提示;开发规则书含三句、不含两句;说明对得上脚本(二十六条命令逐条核)。
- 元治理技能:入口帮助重写 —— 名字、用法,操作清单补上 audit 与 delete,单元清单补上 project:overview;路由与行为没动。技能说明的统一封版一节补上封项目架构的那条命令,「业务域的封版归开发流」改成两个入口同一个核心,「为了」一行改成短名打头,「三层」改成全部版本单元,架构速查补三个脚本;验证脚本的头注订正。封版命令里项目架构那一行注记的「五道门」改成「六道门」(开闸窗口里落,只这一处字)。自测加两条:帮助对得上路由表与五类单元、不含旧名字;说明对得上脚本(二十条命令)。
- 不归任何版本单元的几处(照实写,同一条需求另行改的):治理站点十五份源码页改口;项目设置文件的拒绝名单加四条命令行发布的写法;第三方技能 gpt-image-2 整目录卸载,仓根的技能登记里去掉它那一项。这几处改了不升任何版本,不在本版的改动清单里。治理站点规范另升了它自己的一版(v1.6.1),记在它自己的变更历史里。
- 守不到(照实写):入口表与术语表是指路,机器不核一条需求选对了哪一行、用对了哪个词;入口表的执行体一栏、第十五节的四块写域与各执行体文件的「写域」一行一不一致,没有机器对拍。开发期联调上线只留痕 ——「联调」一格不顶替任何一格的正式发布,联调做没做、做了登没登记,机器不拦也不催;验收完结之后补记联调也不拦,机器分不清那是补登记还是真在完结之后又联调了一次;「联调上线了什么」是跑命令的人写的字,机器不核它与线上对不对得上;机器也不拦验收之前的发布(发布前版本比对不看需求有没有完结)。发布授权照旧没有机器核。平台这一层的四条边界里,钩子超时、收尾钩子连拦上限、收信策略平台认哪几种,照平台官方文档写,本机没有实测。宪法第四节「运作方式」里的派工规矩没有收(它是此前几条签过字的需求放进去的定性话,没有数字与机制),宪法边界一节的允许清单里仍没有「运作方式」这一项,挂在「工作流目录」名下。架构详图里「x-constitution-rule 原则 14 的收尾义务没有执行点」那一条异常登记(harness-P-07)这一版没动,缺陷照旧。讲样式注册表的两处「第四类真相源」是另一件事(判据、条款、代码之外的注册表),没有改。跨会话消息的收信策略写在用户设置里,是用户本人做的,机器不核。删模块技能(x-module-del)的说明里「用户在控制台手工删」那几句不在这次范围、没改,与「线上删除由运维发布专家做」还差这一步;运维发布专家手上也没有能删数据表与数据库记录的工具。部署脚本帮助文字里的旧示例路径没改。业务开发技能的参考文档里,后台、小程序两份与架构说明那一份还留着逐条手写 -m 与「人机审批闸」等旧话,不在这次点名里、没改;它的轻壳子脚手架,移动端只落客户端一个端,没提师傅端。元治理封版核心脚本注释里的「三层」「为了:一句话」受写保护,这次只在开闸窗口里改了「六道门」那一处,其余没改。体系守护技能的自测在床头点名了那份缩成一页指针的技能开发规则书,哪天把它删掉要同批改床头那一行(点名了不存在的路径,那张床算不出指纹)。落地过程里,签字作废与开闸重叠的那几分钟有三路写过范围里的受治文件(领队的停手消息迟到),改动都在落点表里。
- v4.27.x
流水线提速:实施之后的机器节点一条命令接力;站点不再反复重建、谁改谁建不撞车;复盘之后看板的状态列可以动;收尾单五栏机器起草;确认题可以一题签几条;部署门能先查;写前拦截按办理会话判、办理会话可以改派;环的十态一条命令查得到;提速的八条规矩写成明文,宪法运作方式加一句
设计指纹7688bd80内容指纹06cc015e测试指纹d38e9c334905e03d改动设计 6 个(CLAUDE.md、harness-engineering.md、ADR.md、SKILL.md、SKILL.md、SKILL.md);代码 27 个(guard.js、command-policy.js、project-archive.js、requirements.js、stop-handler.js、verify-harness.js、deploy.js、create-deploy.js 等)
需求流水线提速签字 d89a已发布
为了:流水线提速 —— 用户 10-11 凌晨:「整套项目架构处理一个需求的速度太慢了,就算修改一个小东西,都可能需要整个大流程全部跑完几个小时……是否有重复,重叠,冲突的流程节点,是否可以优化速度的地方!……我不考虑测试的规模和成本,我只要最优秀的项目架构的流程!」同日下午另加:「明确项目架构环的启动和收尾……否则你这个主控也不知道啥时候是明确的项目架构环的启动和终止」。查下来时间不在测试上,在节点之间:靠主控搬信、靠会话等人,同一件事重做(站点一条需求重建多次、封版让固定检查过期再跑、勾一步就要重新复盘、会话号一换就要重签)。这一版把节点之间交给机器接力,把重复的删掉,并把跟着变的做法写成明文 —— 用户同日:「会话怎么排是主控的事,你需要清晰地告诉我」;此前架构详图写着主控不起草计划正文、一个工作会话办一条线、派复盘之前看板不再动、授权要在部署会话亲口说,这几句随机器落地都要改口,另有四条新做法没有地方写。封版前床全过、发布当场真跑、发布查全站、两次签字与独立复盘这四道墙一道不动。同批并进 10-11 六路只读审计查出的守卫四处补洞。新增一类东西(三个动作、一把锁、一个只读开关、一道按办理会话判的写前拦截,与提速的八条规矩各自靠机器还是靠纪律的明文),升第二位。
- 体系守护 · 接力命令(动作 run,core/plan-run.js):把实施之后的机器节点串成一条命令。复盘结论入账之前七步 —— 增量检测、按改动跑床、规范同步、封版、固定检查、三查、生成复盘说明,末尾是复盘说明的编号;入账之后再跑同一条命令走三步 —— 三查、开验收区、起草收尾单,末尾打印「可以弹验收题」。七步的名字与次序不变;封版那一步自己先把固定检查的账备好(登记了固定检查的,封版之前先调一次固定检查那个程序,没过停在第四步并点名哪一项),第五步沿用。走哪一段由它当场只读重算一次三查来认(第一查绿走三步);第一段的三查那一步不看退出码、看结果单:第二查第三查要绿,「只差复盘」只读三查结果单新加的那一栏(恰好只有「要再复盘」那一个键才往下;还红着别的、或那一栏不在,都停在第六步)。第二段的开验收区那一步不另起程序,用守卫的记号核验收区开着、记的就是刚算的那张单子。每一步起子进程调那一步原来的那一个程序,不复刻判法、不新增闸;红了停在那一步,打印到了第几步、那个程序的原话、修完从哪一步接着跑。自己不记账,重跑从第一步核起,各步靠各自的账很快走过;没有要做的那一步照实说并算走过;每一步走完核那个程序写出的产物在不在。开头与末尾各打印一次环里的态。
- 体系守护 · 环的十态(动作 loop,core/plan-loop.js):只读。带计划名打印这一条此刻在哪一态、凭什么、环几点启动、几点收尾、下一步该谁做什么;不带计划名列出计划目录与归档目录里每条需求各一行。十态:未立项、已立项、在办实施、已封版、复盘过、待验收、已完结、已发布、已归档、环收尾;启动是守卫记下签字一那一笔并建出履历的那一刻,收尾是已发布与已归档两样都成立的那一刻。每一态用的事实都取守卫与现成的账,不另判;签字作废、账本被直接改过这几种不另立态,在打印里注明。
- 体系守护 · 改派(动作 handoff,core/plan-handoff.js):跑这条命令的会话成为这条需求的办理会话,需求账本追加一笔(跑命令的会话、从谁到谁、几点),不重存机器镜像、不请用户重签。它只是薄薄一层:能不能改派与记账都在守卫需求零件里(见下「守卫 · 需求零件 · 写前、收尾与改派」),这里只取参数、调它、把结论说成人话。会话号只取环境变量,不设开关(接手的只能是跑命令的这个会话自己)。拒绝并且什么都不动:没带 --take、没写计划名、取不到会话号、计划目录里没有这条计划或名字对上不止一份、机器镜像读不了、账本被直接改过、还没签过字、已经完结;签字作废的需求照样可以改派;本来就是办理会话的照实说、不重复记。
- 体系守护 · 固定检查(core/plan-checks.js):记账算「范围里的改动」时不计各版本单元的变更历史与锁清单 —— 那两类是封版自己写的;哪两个文件算,问版本契约的名册,契约装不上就一个都不剔。
- 体系守护 · 三查(core/requirement-check.js):结果单多一栏「第一查红在哪几样」(落盘结果单与命令行摘要里的 c1Red;键的全集是导出的 C1_RED,七个键:账本被直接改过、没有可信的签字基线、会话台账读不了、没有会话可算、步骤没勾完、本会话有范围外的改动、要再复盘),从现成的事实派生、不新增判法,供接力命令判「只差复盘」。「要再复盘」的各种情形统一是一个键,第一查绿不绿就按这一栏空不空算、只判这一遍;判了一样没登记在键表里的当场报错。验收单的编号改口 —— 不进编号的一共六项:看板正文的指纹、步骤勾了几步、别的会话写的范围外改动、没有写证据的范围外改动、归别的需求范围的改动(别的在办需求的,或已完结需求交付的)、第三查里「不归任何版本单元的改动」那份名单;六项仍印在单子上,落盘的结果单里单独放 outOfId 一栏(进编号的事实仍放 facts 一栏:守卫认已完结的需求交付了哪些文件时照编号的算法重算它);重复的那一笔复盘与新加的那一栏也不进编号。复盘什么时候作废只剩两样:签字锁住的内容变了、范围里的受治文件变了;「复盘之后看板正文变了」那一支拿掉。重复的复盘不计(哪几笔算重复只问守卫)。改派不改历史、改动跟着需求走:范围里由办理过这条需求的会话写的、此刻内容还是那一份的改动,单子上注明算这条需求的,三处认它 —— 这条需求动没动过手(封版对账用)、改到的单元归谁(第三查判封没封)、落点格;落点格回看历史时数历次签字记下的与历次改派接手的办理会话;范围外的不认。没补这一条之前,改派后旧办理会话在范围里没封的改动会让这条需求变成「没改到任何版本单元」、单元没封第三查照样绿(假绿)。照旧进编号的:签字锁住的内容、范围里的受治文件、办理会话自己的范围外改动、床与固定检查的状态、各版本单元的封版状态、每一笔算数的复盘与「不过」、签字状态。验收那一刻当场重算三查必须全绿、用户看的那张必须是绿的,这两道没动。
- 体系守护 · 清理归档(core/plan-wrapup.js)· 起草:起草开关起草全部五栏 —— 第一栏照三查结果单与需求账本,第二栏照三查结果单与登记文件逐行的着落,第三栏把遗留逐条列出、各带「去向」(默认写「后放」),第四、五栏照旧现算。起草不等验收:接力命令第二段(复盘入账之后)起草一次,这时第三栏取看板「欠下的」逐条加账本里可信复盘的遗留;验收完结、履历封死之后再跑一次起草开关:已有收尾单不整份重写,只刷新机器管的几处 —— 开头写状态的那一句、第一栏「用时」那一行与用例后面的「等用户验收」、第二栏补新登记的行(已有的行不动)、第三栏照此刻的来源重排(改取履历的遗留;原文对得上的保留办理会话改过的去向,新出现的加上,来源里已经没有的去掉并点名)、第四栏与第五栏重填。办理会话写的别的字不动;认不出是不是机器写的原样的那一行不动、在打印里点名并写明此刻机器会写成什么;哪一栏的标题没有或有两处,那一栏不刷新并点名;刷新之后守卫认得的栏比刷新之前少就不写、照实报。五栏的名字与认法没动,起草出来的原样拿去归档认得过。
- 体系守护 · 清理归档 · 登记:登记文件里一行写的是某个会话的草稿目录本身、或各会话共用的那棵临时目录,一律判不合规 —— 不删、点名第几行与路径、写明该怎么改,写明保留也不算;逐行判,某一行读不了或权限不够只把这一行单列成判不了,不把整份登记文件报成还在。
- 元治理 · 规范同步与封版(core/lifecycle.js、core/seal.js):命令末尾不再重建治理站点 —— 同步真写了盘、封版走完都不再起构建器,「治理站点已重新构建」那一句随之不再打印(没有换成别的提示;站点过期由收尾环提示)。三层的封版(元治理入口与开发流的业务域入口)走的是同一处,一处拿掉、三层同时不建。统一封版命令挑「哪些别的会话的在途改动保留旧指纹」时多认一种:本会话办理着的需求范围里、由办理过这条需求的会话写的改动照封(改派不改历史、改动跟着需求走;问的是守卫的同一个判定器,需求零件装不上或没有那个函数就不认这一种,照旧保留旧指纹)。
- 部署 · 先查部署门(release/sources.js 与各发布入口):发布命令多一个只读开关 --sources,列出这次要发的原料目录里哪些改动还没经收尾环复核、是哪个会话改的,退出码 0、不写任何文件;五个发布入口正式跑时第一步就是它,有没复核的当场停(最多列十条);云函数的脚本通道同样先查,批量发布的两个入口各再查一次;只验证不发布、只装配看效果的用法不查。判法只有守卫那一份:量工作树与定待检范围调守卫新分出来的闸前测量零件,数待检清单调台账零件,部署脚本不另算;台账还没建时只看不建、照实说并按没过算;判不了按没过算。一处行为变化:云函数脚本通道此前不看这本账,现在照全仓数 —— 仓里任何目录有改动还没经收尾环复核,云函数经脚本就发不出去,与经 MCP 发云函数同一个严格程度。
- 守卫 · 闸前测量(guard/gate-measure.js,新零件):量工作树并判三种「测不出来」(git 量不出来、生产形态下仓根不是版本库、写证据台账还没建而工作树里已有改动)、装这次调用的待检范围,这两段从守卫主文件里分出来 —— 守卫的收尾环与部署门、部署技能的先查调同一份。台账没建那一样有两种做法、同一个结论:守卫当场建并把当前的改动记成存量、只拦这一次;只读的先查只看不建。部署门的判法没改,只是挪了住处。
- 守卫 · 收尾环(guard/stop-handler.js):治理站点过期从拦改成提示。三种过期各说一句,都只进附注、不拦、不算红数 —— 有本会话改的源(点名那几份,写明收尾环只提示不建站、谁改了源谁可以建一次、构建器有锁、发布处必建);全是别的会话改的(与此前逐字相同);构建器一份源都没点名(此前判不了就拦,现在带上它的原话提示)。传感器自己没跑成(构建器起不来、超时)同样只提示「没查成」,原来那个「传感器不可用」的码退役。
- 守卫 · 需求零件(guard/requirements.js)· 复盘:复盘结论只绑签字锁住的内容与范围里的受治文件,复盘之后勾步骤、改状态栏、填表、写遗留不让这一轮作废(看板正文的指纹照旧随那一笔记下,只留痕、不判)。复盘者对同一份任务说明收尾两次:三样都成立才算重复 —— 这一笔不可信、任务说明编号与前面一笔可信结论相同、结论也相同;重复的那一笔不计,也不算一轮复盘(结论不同的是改口不是重复,照旧按最后一笔判红;没记下任务说明编号的旧记录一律不算重复)。认法只有一份,四处调它:三查的第一查与编号、「正在办」那一行的复盘次数、办得超没超这一档的轮数上限、履历的「独立复盘」与「用时与返工」(履历零件 guard/project-archive.js 同批改:重复的那一笔照实列出、写明不计,轮数里不算)。
- 守卫 · 需求零件 · 签字与问答:确认题认多选,只许一种写法 —— 多选那一栏恰好是 true、每个选项各是一条固定写法的「确认」、各对上恰好一份没完结的计划、至少两份不同的计划,别的选项不放;认不出的照旧按「不是单选」拦。弹题之前对每一份各核各的(认计划、题目正文里这一份看板的完整路径与「签字」页签、签字区是最新的那一道),另有两道预判:几份的落点单元两两不相交;每一份此刻签得了(定档、同一块排队、收场当场现算)。答完之后按平台拼答案的分隔拆开,他勾到的每一项各走一次一键签、各记一笔、各核各的档与上限,哪一份签不上只它签不上;他另打的字只记成话。验收完结不做多选。每道选项题都核地址:题目正文里出现不带盘符的仓内相对路径就拦、报文给出该写的完整路径,不分是不是签字题、谁弹的;三样都成立才算相对路径(仓库根下面第一层真实存在的目录名加斜杠、前面不是一条更长的路径或网址的中间一截、斜杠后面那一段对得上那个目录里真实存在的一项),认不出的不拦。弹题前认签字题多认第三种写法,与答完之后认打字的是同一条文法(动词与名字连着写也认)。几句回话同批改口:签「确认」的回话、顶层围栏的回话带上改派命令;「待清理归档」那一行与验收完结那句回话里讲收尾单的半句改成五栏由机器起草、核一遍改掉写错的;「待发布」那一行从一律「要用户单次授权」改成只发治理站点的需求凭它验收完结那句话即可发、别的发布面照旧要用户单次授权。
- 守卫 · 需求零件 · 写前、收尾与改派:有在办需求时,写受治文件(编辑工具与命令行直写)与命令行闭集只放本会话是某条在办或签字作废的需求的办理会话的 —— 这一问只住一处,命令判定零件(guard/command-policy.js)问的是同一问;不是的,写受治文件拦,命令行照没有在办需求时那样只放闭集白名单(白名单本身没动,报文开头从「没签字」换成「不是办理会话」),回话点名正在办的是哪几条、各归哪个会话办,给两条出路(交给它的办理会话,或跑改派命令接手;是另一件事就另立一条需求)。计划目录、账本目录、仓外照旧不受此限;发布档案目录不是受治文件,命令行落点在它里面的照放(部署会话平时不是办理会话)。写后提醒多收会话号:盖住这个文件的全是别的会话办的需求时,改说它落在别的会话在办的范围里、收尾会点名。收尾对账只把本会话办理的需求范围当范围里;本会话写进别的会话在办范围的改动拦一次、点名落进了谁的范围、记进越界账(多一栏 into),它交出那条需求之前当办理会话时写的不点名;三查没有跟着收紧,照旧把这一类列在「归别的需求范围」一栏、不算越界。改派:账本多一种事件 handoff,能不能改派与记账合在一个函数里;办理会话的取值认「最后一次签字与其后的改派谁在后听谁的」,重签以新签那一笔为准;另导出历任办理会话、「范围里由办理过这条需求的会话写的」判定器(三查与封版共用)。
- 守卫 · 登记:登记落到草稿目录本身或共用那棵临时目录时回的提示,从「要清就自己记」改成「只登记你自己建的那个子目录」(整棵会话草稿目录、各会话共用的那棵临时目录、Claude 自己的目录都不记);登记的预筛与取目标改用同一份动词名单,加了 PowerShell 的同义动词(New-Item、Copy-Item、Move-Item 与它们的常用别名),只认 Bash 工具的命令里 powershell 或 pwsh 包着的命令串。
- 资产 · 计划模板:状态栏「走到哪一步」的九步改成与接力命令一致的叫法 —— 前六步不变;第 7 步「固化封版」改成「跑接力命令到复盘说明(检测、跑床、封版、三查)」,第 8 步改成「独立复盘,过了再跑接力命令到验收区」,第 9 步改成「你照交付物清单验(在签字页签的验收区里勾),完结」(用户验收从第 8 步挪到第 9 步;原第 9 步「三查,完结」不再单列:三查由接力命令跑、完结就是验收那一刻)。没有程序按这几个步名的字面取值。页首说明里讲收尾单怎么起草的那半句同批改到为真:原来写「第四、五栏由机器填,前三栏由办它的会话写」,改成五栏都由起草开关写出、一条需求起草两回(验收之前一回、验收完结之后再跑一回)、办理会话只改写错的那几行;同一行里别的字没动。页签、签字区与别的字没动。
- 不归任何版本单元的两处(照实写):治理站点构建器加一把仓库级的文件锁 —— 同一时刻只有一个构建在写产物,别处在建就等,打印谁在建、等了多久,持锁进程不在即失效,只读的两种检查不拿锁;这把锁不另写,调测试运行器现成的那一份,取不到运行器时当场报错、不建(退出码 2);缺省最多等 300 秒、开关可改,到上限照实报错(退出码 3)并给出锁文件的位置;锁文件在系统临时目录、按仓根的指纹区分;另多一个只供站点床用的开关把仓根指到假仓。站点床加构建锁一组三条(并发对照、旧锁与等到上限、锁的实现取不到),收尾环那四条改成只提示。这两处改了不升任何版本,不在本版的改动清单里。
- 测试:新建四张 —— 接力命令床(三十条:两张步骤表与走哪一段、红了停在哪一步与修完接着跑、每一步的程序换成什么都不做都认得出、封版之前备账、没有要做的照实说、帮助文字与改派动作的路由)、十态床(十七条:十态表与四处字眼、一条需求真走一遍各态、次序对调、只读、几种岔路)、改派床(八条:改派前后围栏与三查按谁算、账本那一笔、该拒绝的、三处命令写法对拍、改派不改历史)、闸前测量床(十六条)。守卫签字床加五条(每道题核地址、确认题多选弹出之前与答完之后、PowerShell 的同义动词、登记提示改口),原先钉住「连写的签字题认不出」那一条改成认得出并核地址;守卫需求床加五条(不是办理会话写不了、主控与部署会话别弄断各一条、谁都跑得了改派命令、签字回话改口),「待发布」「验收完结回话」「待清理归档」三条跟着回话改口;收尾环床加五条(站点过期三种与传感器没跑成都只提示、写进别的会话在办范围点名一次);履历床加两条(重复的那一笔不算一轮:履历、轮数上限与进度那一行);会话台账床两条改成在办理会话名下跑;主自测加一条、改五条(看过之后范围里的受治文件改了才判「有东西变了」、只在看板上多写一句照样记完结、连写的签字题两条、登记提示),薄壳床与量仓床各有几行跟着改。发布流水线床加五条(只读开关、发布准备停在第一步、云函数脚本通道、四个静态站点、测不出来不等于干净);固定检查床加一条(封版不让账过期);清理归档床加五条(在办也起草、起草两次及其边角、登记行指向整棵目录拒绝、盘点逐行判),起草两条改成五栏;三查床加六条(状态列可以动、改到锁住的才作废、收尾两次不打红、第一查红在哪几样、改派不改历史两条),「编号随什么变」一条改成新口径;元治理自测加一条(同步与封版跑完不重建站点);封版命令床加一条(改派之后的封版);站点床见上一条。落地前在仓外副本或台子里逐种把改的那一段换成什么都不做的对照:收尾单与固定检查 30 种(两轮各 15)、接力与十态 7 种、构建器的锁 4 种、部署门先查 16 种加闸前测量零件 14 种、签字与问答 21 种、收尾环与三查与元治理 24 种、按办理会话判与改派 28 种,每一种点名的条目都红了;四份副本合并之后又抽验 14 种,同样全红(含把合并后的三查脚本换回基线、主自测那一串红)。四方合并在系统临时目录的台子里对基线与合并后各跑一遍全套 38 张床,没有一条基线绿、合并后红;守卫主自测基线 1532 条、合并后 1534 条,都是零红。落进真仓之后经唯一运行器跑:守卫面 19 张全过、19 张空壳对照通过;体系守护、元治理、部署三个技能面与业务架构规范面 29 张全过、改过的 14 张空壳对照通过;治理站点规范面 2 张全过、站点床空壳对照通过(站点床现在 61 条,「站点过期」那一组四条换成读提示)。关闸之后在真实会话里实测:办理会话往受写保护的守卫主文件写被拦;主控会话写框架文件、项目架构文件、规则书各被拦一次并点名占着那个单元的需求与办理会话(按单元各点各的);题目正文带仓内相对路径的普通题被拦并给出完整路径。
- 文档:架构详图 —— §八 新加六段(接力命令、环的十态、写前按办理会话判、办理会话改派、一题签几条与每道题都核地址、复盘之后看板的状态列可以动),§九 新加两段(谁建站点与什么时候建、发布之前先只读查部署门),§十四 新加十态表与启动、收尾的定义;随这些行为改变不再成立的六十来处描述同批改掉(分在 §三、§六、§八、§九、§十三、§十四、§十五、§十六);十态表照零件里的常量表逐字抄;§十五「开闸、跑测试、验收、发布四个窗口由主控排」改成三个全仓共用的窗口(开闸、跑整面床、发布)、验收只排同一处 —— 验收单的编号改口之后,别的会话改别处不再让验收单作废,办理会话自己在那几分钟里别写文件。规矩明文(架构详图 §十五)—— 角色表下面新加「提速的八条规矩」一张表:顶层的需求由主控出设计与看板草稿;工作会话只补机器镜像与落地;主控派工之前告诉用户清哪几个会话、开哪几个、各叫什么;一个工作会话可以连办同一个版本单元上的小事,至多三条再清空;复盘与收尾单起草并行(起草不等验收:复盘入账之后机器起草一次,验收完结之后再刷一次);治理站点谁改谁建(收尾环只提示不建,发布处必建);几条小事可以一题签(只有确认题合并);只发治理站点的需求,「验收完结」那句话本身就算这一次发布授权(主控弹验收题时在题目正文里写明「并发布治理站点」;同一次发布捎带的其余已完结需求不另要授权)。每条写明今天靠机器还是靠纪律、细说在哪。角色表的需求方、主控、工作会话、部署会话四行跟着改 —— 主控对顶层需求由「只出设计要点、审计划」改成出设计与看板草稿,机器镜像它不写;工作会话对顶层需求由「起草计划」改成补机器镜像,并写明跑接力命令、收尾单的起草不等验收、改了站点的源可以自己建;部署会话写明只发治理站点的需求,那一句授权就是用户签的验收完结那句话本身。另六段跟着改:「这张表今天靠什么」;「先分级、再选路」(难事一档由比成条的事「多三样」删成「多两样」,去掉放几条要用户亲手验的用例那一样;小事一档补一句碰了测试面或写保护文件的交工作会话连办);「一条需求一次封版收得了口」(新加「连办」一小段);「三个全仓共用的窗口」(治理站点的构建不是第四个窗口;授权在哪说分两种;连带授权没有机器核);「怎么派工」(新加第零步;顶层需求的看板草稿由主控出;节点回报随接力命令收短);「主控怎么交接」(每条需求在环的哪一态有一条只读命令;办理会话可以改派)。§八 讲清理归档末尾与「待发布」那一行的两处照机器改了口的原话抄,讲会话什么时候清空的那一句补上连办。宪法第四节「运作方式」加一句定性的话 —— 节点之间由机器接力、不靠人传话,只在要用户出面的地方停下来等他;几条小事的确认可以合在一道题里签,每条仍各记各的;同一处的几件小事可以由同一个工作会话接着办。数字与机制不进宪法。决策记录新增 ADR-98(合并了哪些节点、删了哪些重复、哪四道墙不动、为什么不做机器代签;验收单的编号改口推翻了什么、现在由谁守着范围外的改动;改派推翻了 ADR-94 的哪一句)。三份工作流说明 —— 体系守护技能:新加接力命令、环的十态、办理会话改派三节;清理归档一节的起草改成五栏机器起草、一条需求起草两回、已有收尾单只刷新机器管的几处,登记行指向整棵目录一律拒绝、逐行判;固定检查一节写明记账不计变更历史与锁清单;被这一版改掉的几句旧话同批改掉(复盘之后看板的状态列可以动、哪些不进验收单的编号、确认题一题签几条与每道选项题核相对路径、排着的会话提前写由写前那一道挡、认错办理会话跑改派不用重签、会话什么时候清空补上连办)。元治理技能:写明规范同步与封版都不建治理站点、谁改了源谁建一次、发布处必建。发布技能:新加「发布之前先只读查部署门」一节,四个静态站点的流程图与云函数脚本通道各补上这第一步,治理站点的构建那一行写明发布处必建与构建器的锁;「发布授权约束」第 1 条与发布面总表治理站点那一行照连带授权改口(只发治理站点的需求凭用户签的验收完结那句话即可发、由主控原样转来,其余情形照旧要用户单次显式授权);授权的条款在部署规范,随它自己的版本同批改口。封版前照落地的代码逐项核过一遍:十态表按改定的常量表重抄(逐字对拍过);改派、签字与问答、写前按办理会话判、收尾对账与三查在哪一类上不再同一口径、站点过期的三句提示、构建器的锁、先查部署门、收尾单起草与守卫改了口的几句回话,照代码与原话改准;规矩明文落完之后全文再核过一遍,没有一句还与这八条相反,十态表的下一步、「待发布」那一行、清理归档末尾与收尾单第四栏那一句与 §十五 写的是同一套话。
- 守不到(照实写):接力命令串的是机器节点,派复盘者与两次签字仍要人,它不排窗口,中途被掐断不会自己续;改派不经用户,任何会话跑那一条命令就成为办理会话 —— 它防的是认错人、不是防人,留下的只有账本里那一笔;重签以新签那一笔为准,会盖掉此前的改派;改派之后前任的范围外改动,新办理会话的三查守不到,只靠前任自己的收尾对账;前任交出去之前用命令行写的(没有写证据)分不出先后;「办理过这条需求的会话写的」「哪几笔复盘算重复」三查与封版都只问守卫,守卫里没有那个函数时一个都不认、往不过的方向错;办着一条需求的会话写别的需求范围里的业务文件,写前照放、只在写后提醒一句与收尾点名一次,三查不把这一类算越界;多选的确认题里他另打的字按最保守的拆法认,只有恰好等于某个选项固定写法的那几段算签;「每一份此刻签得了」只在多选时弹题之前当场现算;相对路径那一样只认从仓库根下面第一层数起、指着真实存在的东西的写法;复盘之后看板上不在签字锁住内容里的文字改了不再作废;用户看过验收单之后、点完结之前,有人用脚本(没有写证据)改了一个不归任何版本单元的范围外文件,以后不会再要求他重看,这类改动只由收尾环与部署门接着(改到某个版本单元里的,第三查照旧把那个单元列进来判,完结照样记不成);登记认 PowerShell 的同义动词只对命令行里包着 powershell 的写法起作用,而且只在开闸期间(写前拦截在岗时那种写法本来就被拦),平台的 PowerShell 工具没接进钩子接线,经它直接建的仓外目录仍不登记,要接进去得改接线文件、归用户定,cmd 包着的建目录、目标带变量或由表达式算出来的同样不认;站点过期只提示,改了源没建本机产物旧一阵子,发布处兜着线上;构建器的锁依赖测试运行器那份代码,运行器一坏站点也建不了,这把锁判持锁的还在不在只看进程号、两个构建同一刻接手同一把旧锁有一道窄缝、只管一次构建(发布流程里构建、验收、备档案三步之间没有锁)、各会话要用同一个系统临时目录才排得上队、被硬结束的来不及放锁靠持锁进程不在即失效兜;收尾环认是哪几份源过期,靠构建器只读检查输出里那三种行的写法;先查部署门只查到跑的那一刻,查完到上传之间又有人改,由上传那一步守卫的部署门挡,「第一步在场」没有规范的闸守、只有床守,一次发两个手机端时先查按两端合起来数、守卫按每次上传各数各的,量仓零件另有两处直接调用(统一封版命令与三查脚本)没有改成经闸前测量那一个零件;十态只读,判错只会误导看的人;架构详图抄的十态表与零件里的那张表一不一致没有机器对拍。开闸期间写前那几道照旧不在岗。八条规矩里整条靠机器的只有「几条小事可以一题签」,一半靠机器的三条(签字那一刻认办理会话与改派、收尾单第一次起草、构建器的锁管不撞车),其余靠纪律 —— 主控出没出看板草稿、派工前说没说清、一个会话连办了几条、验收完结之后收尾单刷没刷、改了源建没建,机器都不数、都不拦;连带授权没有机器核,部署会话收到的是主控转来的话,题目正文里写没写「并发布治理站点」机器也不核;项目架构设计页第十节由并行的那条需求照这八条改,两边一不一致没有机器对拍。业务开发技能的说明里有几句仍是旧话,归「真相源拉通」那条需求,见下一条。
- 没改的几处(照实写,归排在后面的「真相源拉通」那条需求):业务开发技能的说明里讲「封完治理站点自己重建」「收尾单前三栏由办它的会话写全」「签字题必须单选」「派复盘之后看板一个字不动」「站点的发布要用户单次授权」的几句仍是旧话;治理站点入口页讲发布要用户单次授权的两处还没跟着改;治理站点规范的条款与架构页还没写构建器的锁与新开关,条款里「改判据走同步会顺手带上」那半句、架构页里同一个意思的两处、站点说明文件里「顺手重建」那一句、站点「测试」环节页里「封完之后治理站点自己重建」那一句仍是旧话;站点「需求」环节页里看板状态栏示例的九步仍是旧叫法。另有一处不归那条需求、留到下次动三查脚本时订正:第三查「不归任何版本单元的改动」那份名单把各单元自己的变更历史与锁清单也列了进去,与落点表里那一格重复显示(上一版就是这样;名单不进编号、不影响红绿)。
- v4.26.x
清理归档硬控:仓库外面建的临时目录由守卫自动登记,清理归档照登记逐行核、有一行没着落就不搬;仓里有已完结还没清理归档的需求时,新的需求签不上(门六 收场);唯一运行器每跑完一轮顺手清掉进程已不在的测试临时目录
设计指纹732aad5e内容指纹cdbce3cf测试指纹4af4bd8f607a9f42改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、SKILL.md);代码 8 个(guard.js、command-policy.js、requirements.js、verify-harness.js、bed-runner.js、plan-queue.js、plan-wrapup.js、harness.js)
需求清理归档硬控签字 1570已发布
为了:清理归档硬控 —— 用户 10-10 上午:「会话4我找到几个问题,看图,为什么没有门啊!清理归档竟然没有硬控?还是说刚刚专门负责清理的会话没有更新到会话4?,难道现在是可以清理也可以不清理?逻辑上在项目构建的时候构建了多少东西应该是在plan中很清晰记录的,最后收尾的时候也要按照这个清单去吧哪些临时目录和临时文件清理掉来一一核对啊!对不对啊!」此前清理归档做不做没有任何一道门拦,只有每次回话点名;仓库外面的临时目录靠办理会话自己往登记文件里记一行,记漏了命令就清不到;清理归档遇到登记文件里不合规的行只是跳过那一行、照样把计划搬走;测试跑挂留下的临时目录要等有人跑清理归档才清。这一版把三样交给机器:建的那一刻就记、收尾照清单逐行核、不收场下一条签不上。新增一道闸与一类自动登记,升第二位。
- 守卫 · 需求零件(guard/requirements.js)· 自动登记:新加登记的函数。办理会话(签字作废中的也算)这一次工具调用的落点按真实位置算在系统临时目录之下的,记进它办的那条需求计划目录里的登记文件(一行一个绝对路径,已经有的不重复写,只追加);办着几条的记进最近签字的那一条。登记到哪一层:落点在某个会话草稿目录之下的,登记草稿目录下的第一层;在系统临时目录之下、不在任何草稿目录之下、也不在 Claude 自己那棵目录里的,登记落点本身;落点就是草稿目录或系统临时目录本身、在 Claude 那棵目录里而不在草稿目录之下的不登记,回一句写明哪个路径、为什么、要清就自己记。每登记上一行回一句话;已经登记过的不再说;不是任何在办需求的办理会话不登记也不提示;仓库里面的落点不登记;出错不抛、不连累别的记账。
- 守卫 · 命令的认法(guard/command-policy.js):新加一个只读的取法,从一条命令里取出 mkdir、cp、mv、robocopy、xcopy 的目标(拆词、剥壳、cp 与 mv 的目标取法都用写前判落点的那一套)。只取字面路径:带变量、通配、反引号、花括号的不取,以波浪号打头的不取。同一条命令里先换目录再用相对路径建的,相对路径接在换到的目录后面;换到哪算不出的(不带目标、cd -、带变量、pushd、popd)之后的相对路径不取。
- 守卫入口(guard.js)· 写后记账那一支:命令或编辑工具做完之后,把落点交给需求零件登记,有话就放在工具结果旁边。先过一道便宜的预筛 —— 落点的字面写法看着像在系统临时目录里才去装需求零件(零件用到才装:普通命令与写仓里文件的编辑工具不因此多装一个零件)。挂在写后这一支,写前拦截摘下(开闸)期间照常在岗。
- 守卫 · 需求零件 · 收场这一道:签「确认」那一刻、记签字之前多核一道 —— 这份计划是第一次签确认(它的账本里还没有确认记录),而仓里有已完结、计划还留在计划目录的需求(不论是哪个会话办的),就签不上;回话逐条点名(短名与需求名)、带清理归档的命令,那一条的收尾单还没写或缺栏的在同一句里写明,并写明搬走之后重新刷新签字区再签。已经签过确认的需求重签不拦;只拦签字,不拦封版、发布与在办需求的写。它与定档、同一块排队出自同一个函数的同一段话,所以签字那一刻的回话、看板签字区「确认区还没开」后面的原因、排队一览三处一致。另导出两个给排队一览用的函数(谁等着清理归档、这份计划是不是被它卡着),与收尾单某一栏正文的取法(给清理归档认「写明保留」用,栏怎么切仍只住守卫一份)。
- 守卫 · 需求零件 · 两句回话:用户每说一句话时「待清理归档」那一行,与验收完结那句回话,各多半句 —— 它搬走之前,新的需求签不上;验收完结那句另写明登记的仓外临时目录有一行没着落也不搬。
- 体系守护 · 清理归档(core/plan-wrapup.js)· 逐项核:带需求名时(预览与执行一样),计划还留在计划目录的,在核过收尾单之后、搬计划之前,把登记文件逐行核一遍,每一行必须有着落 —— 此刻已经不在(算已清);合规、这一次会清掉;收尾单第二栏里写明保留,固定写法是单独一行「- 保留:这一行登记的路径 —— 理由」,理由不能空、路径要与登记的是同一个。有一行三种都不是就拒绝并点名第几行、哪个路径、为什么,什么都不动,退出码非零。计划已经搬进归档的重跑不再拦:不合规的行逐行拒绝、其余照清,写明保留的不删。没有登记文件、登记文件是空的照旧不算失败。
- 体系守护 · 清理归档 · 另三处:只读盘点多列一样 —— 已完结的需求(计划还留在计划目录的、已经在归档里的都算)登记文件里此刻还在的每一行,写明是哪条需求的、哪个路径、是等着清、写明保留(带理由)还是不合规(带原因);起草出的收尾单第四栏末尾那句说明按「治理站点」这一格发没发分两种写法;清测试临时目录的那一段做成一个函数,清理归档与运行器共用同一份认法。
- 体系守护 · 唯一运行器(core/bed-runner.js):每跑完一轮(床过没过都一样;一张都不用补跑的那一支也算跑完一轮;只列不跑的不算)调清理归档零件的那个函数,把测试目录下名字以进程号结尾、那个进程已经不在的测试临时目录清掉,每清一个打印一行,进程还在的不动,清不掉不影响这一轮的结论与退出码。改在判定口径区之外。
- 体系守护 · 排队一览(core/plan-queue.js):多一节「被收场卡着」—— 列出此刻已完结、计划还留在计划目录的每一条需求(短名、收尾单现状、清理归档的命令),以及因为它们而签不上的还没签过确认的计划;一条都没有时写没有。谁等着、谁被卡着只问守卫,守卫里没有这两个判法或当场出错就在这一节写判不了、前四节照出。入口(harness.js)的帮助改成现状。
- 测试:守卫单元床加四条(登记到哪一层、谁的落点记进哪条、命令的认法、先换目录再建的真登记得上),两句回话的两条跟着多核后果半句;守卫签字床加一条收场这一道各支,原有三条跟着新门改;门一床一条改成先被收场拦、搬走后签得上;主自测加两条收场的、一组经守卫入口的登记用例、「零件用到才装」对照表三行与它们的故障注入各两行,薄壳床的必跑名单跟着加;清理归档床加四条(逐项核与保留写法、盘点、起草说明两种写法、运行器收尾自清),一条改成新契约;体系守护自测床加一条排队一览「被收场卡着」一节,另加两条读真仓的项目架构设计页核它的样式形态(见项目架构 v3.0.0);其中一样是点名的每张床至少有一处取得到 —— 落地当天折行标记插进了床名,治理站点那张床按字面取不到床名而报红,订正设计页时补的这一样与它的改坏对照(见项目架构 v3.0.0「手机宽度」)。各床共用小仓的,把办到完结的夹具计划照生产里的做法搬进归档,后面的条目才签得了新的计划。落地前在仓外副本里逐处把被测的地方换成空的,守着它的条目都红了(十一次)。
- 文档:架构详图 §八「需求对账」里新加「清理归档硬控」一段(自动登记、逐行核、收场这一道、运行器跑完自己清,带守不到六条);「清理归档」一段里讲登记、盘点、三处提醒的几句与守不到三条改成现状;讲签确认那张表、签字区、排队一览的三处补上收场这一道;讲收尾单守不到的那一句里「治理站点不收计划目录、站点上看不到它」订正成现状;讲项目架构设计页里有什么的两处(§八「项目架构与封存履历」开头、§十四 项目架构那一条)由五道门改成六道。决策记录新增 ADR-97(五个取舍、否决过的五样、边界)。体系守护的说明:测试床一节加「跑完顺手清」,排队一节由四段改成五段并写明开新需求之前先看第五段,清理归档一节写明守卫自动登记、搬之前逐行核与保留的固定写法、没跑新的需求签不上,守不到一段改成现状。业务开发的说明:讲登记仓外临时目录与完结之后那几步的句子改成现状。宪法不改(第六节第 8 条已经写着完结之后清理归档)。
- 守不到(照实写):脚本在运行中自己建的目录守卫看不见(脚本里建目录、测试在系统临时目录里造的沙箱),仍靠手记;签字之前建的仓外目录不自动登记(那时这个会话还不是哪条需求的办理会话);命令里带变量、通配或反引号的路径认不出,解压、克隆、重定向新建文件这些别的建法不认;括号里换的目录出了括号就不算数,取法照样往后带(多登记的那一行指的目录不存在,清理归档按已经不在过);登记文件本身被手改(比如删掉一行)机器不核,保留的理由写得对不对机器不判、只认写法;收场这一道只拦第一次签确认、只拦签字,一条已完结的需求一直没人收场会把后面所有新需求卡住,出路是任何会话都可以替它写收尾单、跑清理归档;运行器只清测试目录下名字带进程号的那一类,进程号被别的进程重新用上的会被当成还在,不经运行器直接起测试留下的要等下一次运行器或清理归档。
- 落地时出的一个错(照实记):测试运行器受写保护,这条需求的计划却把它写成不用开闸;落地脚本在闸关着的时候把它改了(脚本在自己的进程里写,写前拦截看不见),随后用编辑工具补最后一笔时被守卫拦下才发现。当场报了主控,由用户再开一次闸收尾。写前拦截管不到脚本进程里的写,是既有的守不到之处;这一次是办理会话自己撞上的。
- 没改的一处(照实写):封版命令给项目架构每一版写测试指纹时附的那句说明是写死的,里面还是「守着五道门的是框架的床」;写这句话的脚本在元治理技能里,不在这条需求的落点表里,这一版没有动,项目架构 v3.0.0 封出来的记录行里因此仍是这一句。留给后面的需求。
- v4.25.x
收尾单与治理站点一格:验收完结之后先写一份固定五栏的收尾单,清理归档认不到它或缺栏就不搬;每条需求的发布登记多一格「治理站点」,站点在它完结之后发过一次才算已发布,没发的每次回话点名
设计指纹12f8ed93内容指纹00572a3c测试指纹5c5b2d7ad9fe69b9改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、SKILL.md);代码 6 个(requirements.js、verify-harness.js、PLAN-TEMPLATE.html、plan-wrapup.js、record-release.js、harness.js)
需求收尾与站点格签字 664e已发布
为了:收尾与站点格 —— 用户 10-10 上午:「最后你在会话里面也就是主控和分身竟然没有结尾的标志?比如会话1,在结束之后应该有一个正式的收尾,比如详细复述一下会话1的内容,做了什么,没有做什么,还有哪些残留可能需要新开会话,还是全部完结,然后plan的连接在哪里等,最后可能需要deploy来更新和发布harness,否则正式线上版本就会丢失掉你的这个计划啊,而且貌似这一环是断的,永远没有项目框架的历史记录的更新和部署这个环节啊!」此前一条需求验收完结之后办理会话只是停下:做成了什么、没做什么、遗留去了哪、链接在哪,没有固定的地方写,也没有固定的话说给用户;只碰框架、规范、项目架构的需求一完结就显示已发布,治理站点在它之后发没发没有任何一处记、也没有任何一处提醒。这一版补两样:清理归档之前必须有一份固定五栏的收尾单(认不到或缺栏就不搬);每条需求多一格「治理站点」(站点在它完结之后发过一次才算已发布,没发的每次回话点名)。新增一个开关、一格与一行点名,升第二位。
- 体系守护(清理归档 · core/plan-wrapup.js):带需求名时(预览与执行一样)在三样前置之后多核收尾单这一样 —— 计划还留在计划目录、里面认不到收尾单的,拒绝并写明文件放在哪、叫什么、要哪五栏、用哪条命令起草;收尾单在、但有哪一栏的标题没有或标题下面是空的(只有空白或注释也算空)的,拒绝并点名是哪几栏;拒绝时什么都不动(不搬、不清),退出码非零。计划已经搬进归档的重跑、计划两边都不在的旧需求、存量那一支不查。只读盘点里每份已完结还留在计划目录的计划多写明收尾单有没有、缺哪几栏。多一个起草开关(--note,带需求名;与执行开关、存量那一支不能同用):同样先核三样,计划还在计划目录、里面还没有收尾单才写 —— 五个标题都在;第四栏照落点表里的单元现算碰了哪几格,并当场对这条需求重算一次发布段、逐格写上状态,重算做不成的写「待登记」;第五栏写看板现在的位置与归档之后的位置、需求履历、治理站点上的记录页、封版时记着为了这条需求的各版本所在的变更历史;第一、二、三栏下面只留写法提示的注释(第三栏的注释里列出履历「遗留」一栏的各条),所以草稿原样拿去清理归档会被拒绝、点名这三栏;已经有收尾单时不覆盖、只报它在哪;三样缺一样、或计划已不在计划目录时拒绝、什么都不写。执行走到最后(搬完、清完)对这条需求重算一次发布段并打印它那一行,「治理站点」还没发的接着打印一句 —— 站点的发布归部署会话、要用户单次授权,发完再跑一次发布登记;重算没做成算一处没做成(退出码非零),已搬已清的不回退;预览不写发布段。
- 体系守护(发布登记 · core/record-release.js):每一条需求都推一格「治理站点」(不归哪个版本单元)—— 它的履历与它改到的受治文档都要随站点重建、发布才上线;此前「落点表碰到治理站点源码才加一格」的那一支拿掉,这类需求也只有这一格。这一格只有一种判法:入库的发布台账里最后一条治理站点「已上线」的记录,它的发布号所记的时刻(年月日加时分秒,到秒)晚于这条需求的完结时刻才是「已发布」;发布号读不出时刻的那一行按台账时间(到分)比;需求没完结、没有上线记录、最后一次上线不晚于完结,都是「未发布」。两边换成同一个绝对时刻再比:履历机器版里的完结时刻是毫秒数,发布号与台账时间按本机时间换算(履历给人看的那一份把时刻写成世界时,不拿那串字比)。发布当时带站点名跑的记法、此前记下的结论都不参与这一格 —— 在办的需求不会因为站点发过一次就翻。所以只碰框架、规范、项目架构的需求,完结之后状态停在「已完结」,站点在它完结之后发过一次、再跑一次发布登记才翻「已发布」。写出的发布段多记短名;状态、短名、各格都与上一次写出的一样时不重写文件(发布段是治理站点的源文件,白写一次会让站点显得过期,重跑清理归档也会白动一次履历目录)。另给起草用的两样:这条需求产的各版本(从各单元变更历史里封版记下的需求那一行反查,名字相近的另一条需求的不算)、起草要的事实(重算一次;做不成退到只列单元名与治理站点、状态写「待登记」)。
- 体系守护(入口):wrapup 动作认起草开关(后面带了值同样报用法);帮助里补上收尾单、起草与治理站点一格。
- 守卫(需求零件):收尾单的文件名、五栏的名字与「缺哪几栏」的认法只住这里一份并导出 —— 一栏算有 = 有一行二级标题逐字是这一栏的名字,而且它到下一行二级标题(或文末)之间有不是空白的字;注释先整段去掉,所以只有注释的栏算空。清理归档的命令从这里取用,没有第二份可漂。「待清理归档」那一行:这份计划里认不到收尾单文件时,在冒号之前多半句「收尾单还没写(先起草:起草的命令 再把前三栏写全)」;收尾单在而缺栏时这半句改成「收尾单还缺几栏(缺的栏名),写全再清理归档」;五栏齐全时整行与此前逐字相同;三种情形都以清理归档的命令结尾。验收完结那句回话:「需求履历已封死(…)。」后面改成「之后先收尾:把遗留清单发主控定去向;起草收尾单(起草的命令),把五栏写全(五栏的名字),交主控转给用户。再清理归档(计划整份搬进归档、过程文件清掉;认不到收尾单或缺栏就不搬;没有东西要发或攒着以后发的可以直接跑):」加那条命令,后面办得超了的那一句与遗留那一句照旧。新加一行点名:用户每说一句话,守卫读各条需求的发布段,状态是「已完结」、而「治理站点」那一格还不是已发布的,合成一行,以「【待发布】」打头,列出短名(多于八条的写前八条与总数),写明站点在它完结之后还没发过、站点的发布归部署会话并要用户单次授权,以发布登记的命令结尾;一条都没有就没有这一行;排在「待清理归档」各行之后、接进度之前;不往任何账本记(用户原话照旧记);哪一条的发布段读不了、或里面还没有这一格(这一版之前写的)就跳过。读发布段的那个目录守卫自己记了一份、不去装履历零件 —— 说话这条路只许装需求零件与会话台账(主自测「零件用到才装」那一组守着),与履历零件的那一份由测试对拍相等。
- 钩子接线文件:一个字没动。三处提醒都不挂在写前拦截上。
- 测试(清理归档床):加三条 —— 收尾单各支(没有收尾单时预览与执行都拒绝、整棵树不动、命令行退出码 1;五栏逐栏各弄缺三种办法,每次都拒绝、只点名那一栏;五栏齐全搬走,归档里的收尾单逐字节相同;已经在归档里的重跑不查;只读盘点对有、没有、缺栏三份计划各写对;文件名与五栏就是守卫导出的那一份)、起草各支(只多出草稿与这条需求的发布段两个文件;五个标题都在;第四栏逐格与重算出的发布段一致;第五栏的版本就是封版时记着为了这条需求的那一版、名字相近的另一条的不列;前三栏只有注释、第三栏的注释里列着履历的遗留;草稿原样去清理归档被拒绝、点名这三栏;已有收尾单时不改它一个字;重算做不成时写待登记;六种不该起草的各拒绝、整棵树不动;起草与执行开关不能同用;经入口各跑一次)、末尾重算发布段(预览不写;执行之后发布段是现状、打印了那一行与归部署会话那一句;重跑不再改写;台账里有完结之后的上线记录时是已发布、不打印那一句;重算没做成算一处没做成、已搬走的不回退)。原有夹具里已完结的计划都带上一份五栏齐全的收尾单,三处「整棵树除了这份计划别的都不动」的比对放过末尾写出的那一个发布段文件,真走一遍的那一条先核没有收尾单时经入口被拒绝。
- 测试(发布登记床):加两条 —— 治理站点一格的十种情形(上线在完结之前、追加完结之后的上线、发布号早于完结而台账时间晚于完结、发布号读不出时刻、完结与发布号相差不到八小时的两种方向、结果不是已上线的行、在办的需求带站点名跑、落点表碰站点源码的只有一格、业务域的需求也有这一格、状态与各格没变不重写)与起草用的两样事实;原有五条随格的推法改写(每条需求多一格、在办的不翻)。
- 测试(守卫的床与主自测):需求对账床加三条 —— 待发布点名(只列没发的那一条、在办的与还没有这一格的不点、点名前后各账本除多一笔原话外逐字节相同、改成已发之后消失、多于八条写前八条与总数、目录与履历零件对拍)、验收完结回话(遗留发主控、起草的命令与五栏的名字都排在清理归档的命令之前)、待清理归档那一行的三种情形与认法;主自测改写一条(完结回话)、新加三条(经守卫入口:待清理归档那一行讲收尾单、待发布点名、发布段翻成已发之后那一行消失),薄壳测试的必跑名单同批补上;业务开发技能的床加一条核看板模板的两处。
- 架构详图:§八「清理归档」一段补上收尾单这一样、起草开关、末尾重算发布段与守卫的三处配合,另加一小段讲治理站点一格的推法、判法与「待发布」的点名,各带守不到;文首版本改成本版。决策记录:新增 ADR-96。说明与模板:体系守护技能的说明在发布登记一节写明每条需求都有治理站点一格与它的判法,在清理归档一节加「先写收尾单,再清理归档」一段(五栏、先后、起草、多核的这一样、末尾重算)与守不到;业务开发技能的说明在完结之后的几步里补上先收尾与治理站点一格;看板模板页首讲做完之后怎么办的那一句写上先写收尾单、再清理归档,讲发布的那一段加一行治理站点与一句说明。
- 项目架构设计页同批改(流水线的说明与图、第五节的表与清理归档小节、第八节加五行守不到、第九节、第十节),那是它自己的一版(v2.1.0)。宪法没动:第六节第 8 条已写着每一格都发了才算已发布。
- 没做的(记进了计划的遗留):治理站点页面上这一格显示的是构建那一刻的状态、比登记慢一拍,改站点页面归后面的需求;发布脚本发完站点之后还不会自动跑发布登记,要部署会话手跑;归档进去的计划与收尾单不上治理站点;需求履历的「遗留」一栏会把复盘者报告末尾的文件清单当成遗留条目收进去,起草时第三栏的提示里也会跟着列出这些条;已经搬进归档、当时没有收尾单的计划不回头查。
- 守不到(逐条写在架构详图 §八与项目架构设计页的诚实边界,这里点最要紧的;不许读成「从此每条需求都有一份写对了的收尾、站点一定是新的」):机器只核收尾单在不在、五栏下面有没有字,写得对不对、主控转没转给用户、会话清没清空都不核;收尾单在验收完结之后写、不进履历,随计划进归档,站点上看不到它。「治理站点」这一格只按发布台账判:站点回滚到更早的一版、台账被直接改过它看不见;发布号读不出时刻时退到台账时间,卡在打包与上线之间完结的那种情形就分不出来。「待发布」的点名读的是发布段文件:一条需求完结之后既没清理归档、也没人跑过发布登记,它的发布段还是旧的,这时它由「待清理归档」那一行点着,清理归档末尾重算之后才由「待发布」接手;计划若被脚本进程内删掉(不是搬进归档),两行都不点它,要等有人跑一次发布登记。点名只在用户说话时出现,是守卫回给当场那个会话的话。这一步每次说话要读全部需求的发布段小文件:实测 25 条需求约 7 毫秒、100 条约 23 毫秒、300 条约 85 毫秒、1000 条约 297 毫秒,需求攒到几百条时该改成由发布登记顺手写一份名单,这一版没做。站点发没发、什么时候发,机器只提醒、不拦。
- 关闸后的现场(闸关着、真仓的守卫,本机 10-10 中午;守卫的四个文件落进真仓是 12 点 23 分到 24 分,落完随即关闸,其余九个文件与四份文档在关闸之后落):一、真仓里经唯一运行器按这次的改动跑床,12 点 41 分跑完:守卫与技能两类测试面命中的 28 张床对改后的内容全过、没有跳过的,其中守卫主自测 1504 条全过(改写的那一条与新加的三条都在内),需求对账床 55 条、清理归档床 19 条、发布登记床 10 条、业务开发技能床 23 条;这次改过的五张测试由运行器逐张做了空壳对照,五张都咬得住。二、接着跑了一次发布登记:23 条履历的发布段全部按新规矩重写,每条都带上了短名与「治理站点」一格 —— 已完结的 21 条这一格都是已发布(它们都在当天 10 点 41 分那次站点上线之前完结,最晚的一条完结在 10 点 36 分),其中 20 条状态是已发布、1 条因为业务端的格还没发仍是已完结;在办的 2 条这一格是未发布、状态在办。紧接着再跑一次,23 个发布段文件的修改时间与大小逐个相同,没有重写。三、只读调真仓守卫导出的函数(不经用户说话那条路):此刻已完结还留在计划目录的只有「看板不查归档」一条,守卫认到它的收尾单是「还没写」;待发布的名单是空的、没有那一行(这条需求自己完结之后才会第一次真的被点名)。用户说话时的那两行点名与起草出的草稿留给用户亲手验。
- v4.24.x
清理归档:已完结的计划不再删,由一条命令整份搬进计划目录下按日期分的归档并清掉过程文件;计划目录下的任何一份命令行删不了、挪不走;没清理归档的只提醒、不拦
设计指纹056d1aa8内容指纹f70878ec测试指纹fb8fb3b889da1104改动设计 5 个(CLAUDE.md、harness-engineering.md、ADR.md、SKILL.md、SKILL.md);代码 7 个(command-policy.js、requirements.js、verify-harness.js、PLAN-TEMPLATE.html、record-release.js、harness.js、plan-wrapup.js)
需求清理归档签字 3233已发布
为了:清理归档 —— 此前的规矩是计划做完固化进架构然后删,过程文件没有任何一步负责清,结果两头正好反了:该留的没留(此前完结的每一条需求,看板都按流程删了,只剩履历里的摘要),该清的没清(账本目录里的复盘任务说明、固定检查的输出、结果单的可读版、签字基线攒了一百多个,各会话在仓库外面的临时副本与测试床留下的临时目录也没人清)。用户 10-09 夜:「为什么会有残留呢?逻辑上应该是归档啊!意思就是项目架构应该部署之后的环节就是清理和归档啊!」这一版把两头改过来:流水线在部署之后多一个环节「清理归档」,由体系守护的一条命令把已完结的计划整份搬进归档、把过程文件清掉;守卫让计划目录下的任何一份命令行都删不了、挪不走,并在三处提醒。新增一个动作与一类环节,升第二位。
- 体系守护(清理归档 · 新零件 core/plan-wrapup.js):一条命令四种用法。只带动作名是只读盘点 —— 已完结还留在计划目录的计划(短名、需求名、完结日期、履历封没封死与那条命令)、账本目录里每条已完结需求还留着的过程文件、进程已不在的测试临时目录,不动任何东西。带需求名是预览,打印将搬什么、将清什么、哪些会被拒绝,不动任何东西(连空目录都不建)。带需求名与执行开关才真做:三样都成立才动 —— 账本没被直接改过、账本里记了已完结、需求履历已封死 —— 缺一样就拒绝并写明缺哪样(没签字、在办、签字作废、账本被改过、已完结但履历没封死),什么都不动。搬:把这条需求的计划目录整份改名搬到归档目录下「完结那一笔的本机日期」再下一层「需求名」里,只用一次改名、不做复制再删,搬完之后里面的文件逐个与搬之前相同、修改时间不变;改名失败原样报错,为这次搬新建的空目录收回去,源与归档目录都和跑之前一样,后面的清不做。判归档里有没有它,是到归档目录下逐个日期目录里找同名的、不只看算出来的那一天(完结之后换过时区,算出来的日期会变):源已不在而某一天下面有,报已归档并写明在哪一天下面、接着清;源在而任何一天下面已有同名的,拒绝,不覆盖、不合并、也不清;两边都不在(这条规矩之前就删掉了计划的旧需求),报没有可搬的、照样清。清三处,每清一样打印一行、有一样没清成其余照做:一、账本目录里这条需求的过程文件,按「需求名加固定后缀」逐个认、不按前缀(复盘任务说明两份、复盘说明留档、固定检查的结果与每项检查的输出、结果单的可读版、签字基线);账本目录里另有一条名字更长、有自己账本的需求而文件名以它打头的,归那一条 —— 「有自己的账本」按文件里记的是不是账本事件认,复盘说明留档自己就长成一份账本的名字,只看名字它永远清不掉。二、这份计划的登记文件里列的仓外临时目录(一行一个绝对路径,从计划此刻所在的地方读):按真实位置算严格在系统临时目录之下、不在仓库里面、也没把仓库包在里面的才删,不合的那一行拒绝并点名、其余照办,已经不在的写一行不算失败;删的时候遇到目录联接或符号链接只解开这一个链接、不进去,登记的那个路径本身是链接同样只解开它。三、测试根下名字以进程号结尾的测试临时目录:那个进程已不在的才删,还在的、判不了的不动;这一处不分是哪条需求留下的。一律不碰:账本本体、最后那张结果单的机器版、原话账本、没签字账本、名单之外的任何文件、仓外镜像、会话台账、任何测试目录下的测试。存量那一支:计划目录下一层、没有账本也没有机器镜像的旧目录或散文件,点名并给出真实的日期才搬,只搬不清;有机器镜像或有账本(账本只在仓外镜像里的也算)的拒绝,归档目录自己与带斜杠的名字不认。需求名只认计划的目录名、不认短名,大小写要与盘上的一致。有拒绝或有一样没做成退出码 1,其余 0;预览里登记文件有不合的行同样算拒绝。它只读着用守卫今天已经导出的函数(读计划状态、读账本、判账本完整性、判履历封没封死),不往任何账本写,不认是哪个会话跑的。
- 体系守护(入口与发布登记):入口的动作表加 wrapup,帮助里把四种用法写全;要带值的开关(需求名、存量的名字、日期、仓根)出现却没带值就报用法、退出码 1,不把「忘了写名字」当成只读盘点悄悄过去。入口文件头与帮助末尾那句「它只体检加验证」照实改成:体检与验证之外,它还带几条流水线自己的命令(三查、复盘说明、固定检查、排队一览、发布登记、清理归档)。发布登记打印每条需求状态的那一行:已完结(含已发布)而计划的机器镜像还在计划目录里的,行尾带一句「还没清理归档」与那条命令;已经搬走的、在办的不带;只是打印,写出的发布段文件与不加这一句时相同。
- 守卫(判「能不能删计划」那一处 · 需求零件与命令策略):这一处对计划目录下的任何路径都回一句原因,不再有放行的一支。路径第一段是归档目录的名字(先判,Windows 上不分大小写,不拿它去查账本)⇒ 归档的计划不删不挪;账本被改过 ⇒ 照旧;已完结且履历封死 ⇒ 由放改拦,回话写明已完结的计划不删、用清理归档的命令搬进归档,并给出带着这条需求名字与执行开关的命令;已完结但履历没封死、签过字没完结 ⇒ 照旧拦,回话里「之后再删」改成「之后再清理归档」;没签字 ⇒ 照旧拦。命令策略里为「全部是完结了的就放」留的放行分支(连同批处理那半句)拿掉,这一处从此只返回拦或不归它管。接到这一处的命令没有增减:rm、rimraf、del、unlink、git rm、mv、git mv、带路径的 git stash push。守卫另记一份归档目录名的常量并导出,由清理归档的测试床与那个零件自己的对拍相等。
- 守卫(验收回话与每次回话点名 · 需求零件):验收完结那句回话里「这份计划可以删了。」换成「之后清理归档(计划整份搬进归档、过程文件清掉;没有东西要发或攒着以后发的可以直接跑):」加那条命令,其余(履历已封死那半句、后面办得超了的那一句与遗留那一句)一个字没动、次序不变。用户每说一句话,守卫对状态表里每一份已完结的计划各出一行,以「【待清理归档】」打头,带短名、需求名与那条命令,排在「正在办」那几句之后、接进度之前 —— 状态表只列计划目录下一层、带机器镜像的目录,搬走之后它不在表里,这一行自然消失;在办的、签字作废的、没签字的、账本被改过的、机器镜像读不了的不出这一行;不往任何账本记(用户原话照旧记)。新增一个函数给出那条命令(wrapupCommand),与清理归档零件自己给出的同一句,由测试对拍。
- 钩子接线文件:一个字没动。三处提醒都不挂在写前拦截上。
- 测试(新测试 plan-wrapup.test.js · 清理归档):在系统临时目录造小仓逐支核 —— 搬走之后逐文件内容与修改时间不变、原处没有了;三样里缺一样的五种各拒绝一次,跑前跑后整棵树(含账本目录与仓外镜像)指纹不变;目的地已在源不在、两边都在、两边都不在三种情形;改名失败之后源与归档目录原样、不接着清;存量那一支不给日期、日期写错、有机器镜像、有账本各拒绝;盘点与预览跑前跑后整棵树不动;换一个会话号输出与结果相同;命令行与经入口各跑一遍核退出码;经入口时要带值的开关没带值、执行开关后面带了值,报用法、退出码 1、什么都不动;三条名字相近的需求只清其中一条,另两条的文件一个不少,账本本体、结果单的机器版、原话账本、没签字账本、仓外镜像、会话台账与测试目录下的文件都在,清完之后账本完整性为真、计划名单里没有它、收尾对账仍认它验收时交付的文件;登记文件里的仓外目录被删、里面指向真目录的联接只解开、真目录里的文件还在,登记的路径本身是联接同样只解开;不合的行各被拒绝并点名、合规的照办;进程已不在的测试临时目录被删,活进程的、名字不合规矩的不动;归档目录名与那条命令和守卫的对拍相等;最后真走一遍签字、验收完结、被点名、经入口清理归档。
- 测试(守卫的床与主自测):需求零件的床里「完结与删计划」一组的两条改成一律拦 —— 真走完结那一条里判删的那一句、判定函数逐支那一条 —— 核各支回话(已完结的带命令与需求名,归档目录里的写不删不挪,其余各支不再出现「再删」),另加验收回话与每次回话点名的用例(点名前后各账本除了多一笔用户原话之外逐字节相同;在办的、签字作废的、没签字的不点名;在办一条、已完结待清理两条同时在场时互不挤掉);履历零件的床里删计划那一条改成封死之后也拦,并加一条经命令判定逐种命令核;主自测里删已完结计划的那一条由放改拦(经守卫入口);批处理包着的两条照旧是拦、原因换成删计划目录那一句并带上命令;履历没封死那一条回话改口;另加五条 —— 挪走、git rm 删已完结的计划与删归档目录里的一份(这三条经守卫入口)、完结之后再说一句话被点名、点名没往这条需求的账本记;走到已记完结的那一条多核回话里的命令、且不再说可以删了;薄壳测试的必跑名单同批补上。发布登记的床加一条核打印的四行(已完结、已发布而计划还在的两行带那一句与命令,计划搬走的、在办的两行不带)与计划还在、搬走之后两次写出的发布段文件逐字节相同;业务开发技能的床核看板模板里讲做完之后怎么办的三处写的是归档。
- 宪法:第六节第 8 条「计划归档成需求履历、固化进架构之后删」改成「这条需求封存成需求履历、固化进架构;之后清理归档 —— 计划本身归档、不删,过程文件清掉,长期守着代码的测试不动」;第 5 条括号里「闭环即删」改成「闭环即归档挪走」。只写定性,没有目录名、没有命令;两句都在原来的行里改。
- 架构详图:§八「需求对账」里新增「清理归档」一段(谁跑什么时候跑、三样前置、搬什么、清什么、不碰什么、存量那一支、守卫在哪几处配合、叫法、守不到八条),排在讲封履历的那一段之后;那一段的段名由「项目架构与归档」改成「项目架构与封存履历」,里面「归档」那一小条改叫「封存履历」,删计划那颗闸的前置一句、回填时补的那一笔各加半句现状。讲删计划的各处改成现状:文首「文档性质」里计划「闭环验收后可删除」改成搬进归档;「三查接关口」里「完结了的放」与「被脚本删掉的收尾点名一次」各加版本注;「组队与执行体」顺带补的那一条加注(搬走之后照旧兜着);需求对账开头列账本文件的那一句、讲用户说话那一刻的那一句各加半句;环 3「存档点提醒」里「计划还没删」改成「计划还在原处」;§十四 项目架构那一条补上清理归档这个环节,「生命周期」末尾的「删 plan」改成清理归档;§十五 角色表主控一行补上清理归档的先后由它排,「遇到顶层问题的两种走法」里「计划删了它还在」改成搬进归档之后它还在。文首版本改成本版。
- 决策记录:新增 ADR-95(删改成搬、由命令做不由钩子做、只要求已完结不等发布、清什么不碰什么、签字基线为什么可以清且只清仓内那一份、仓外临时目录靠登记、计划目录下任何一份命令行删不了挪不走、三处只提醒不拦;否决了钩子自动搬、等发布翻成已发布再搬、先复制再删、按前缀清、给已删的旧计划补空位五样)。它取代 ADR-73「计划做完固化进架构然后删」与 ADR-83「计划照删」「计划留着当档案不推翻」两处。既有条目一个字没改。
- 说明与模板:业务开发技能的说明里两句讲删计划的改成计划不删、由清理归档的命令搬进归档,并写明每建一处仓库外临时目录就在计划目录的登记文件里追加一行。体系守护技能的说明加「wrapup:清理归档」一节(四种用法、三样前置、搬与清、不碰什么、登记仓外临时目录、什么时候跑谁排、三处提醒、别用命令删或挪计划、守不到),激活场景表与架构速查各加一项,发布登记一节加一句,固定检查一节末尾那句「清单与脚本随计划归档」写准;「它是什么」表加一行、禁止事项里「本 skill 只做体检加导航」那一句照实改成它还带着流水线自己的几条命令,另一句「本 skill 只 BFF 聚合自检」改成了「本 skill 对别的 skill 只聚合它们的自检、不调度它们」(文档头的格式栏没动)。看板模板里讲做完之后怎么办的三处(页首说明、步骤页签的标题、欠下的那条横幅)改成归档。
- 项目架构设计页同批改(流水线图加「清理归档」一格,第五节加一小节,第八节加五行守不到,门四各处改成归档与封存履历,第六节「升哪一位」补「或环节」三个字),那是它自己的一版(v2.0.0)。
- 没做的(记进了计划的遗留):存量没有搬 —— 计划目录里的历史材料、此前完结的需求留在账本目录里的过程文件、各会话留在仓库外的副本,命令做好之后由主控另排;治理规范条款书里「闭环即删」的措辞属于另一个版本单元,没改;需求履历里把计划路径替换成的那句占位仍写着完结后删、回填说明里仍写着计划已删,没改;此前已经删掉的旧计划不补;清理归档的命令没有进守卫的写保护名单;机器不卡「发布了才准清理归档」。
- 守不到(逐条写在架构详图 §八「清理归档」一段末尾与项目架构设计页的诚实边界,这里点最要紧的;不许读成「从此没有残留、计划丢不了」):脚本进程内删计划拦不住 —— 那颗闸只挡命令行的直写形态,换目录、变量展开这类写法照旧拦不住,闸开着期间它不在岗(验收回话与每次回话点名照常);已完结的计划若被脚本进程内删掉(不是搬进归档),没有任何一处点名,三处提醒也跟着消失,唯一还看得见痕迹的是清理归档命令的只读盘点,要人去跑。归档进去的文件命令行删不了、挪不走,但编辑工具与脚本仍改得了。仓外临时目录靠登记,没登记的清不到;计划早先就删掉的旧需求没有登记文件可读,同样清不到。搬过去的文件没有写证据,要等一轮收尾查过才有干净结论,这之前待检范围含着它们的云端写会被部署门拦。清理归档靠人跑,机器只提醒:点名只在用户说话时出现,新开会话那一刻的开场清单不点名已完结待清理的;它是守卫回给当场那个会话的话,用户看不看得到取决于执行者转述;先后也不由机器管,机器只要求已完结。git mv 与带路径的 git stash push 拦是拦的,但回的只是一句通用的话、不带命令。测试临时目录按进程号认,进程号被别的进程重新用上的会被当成还在留下。
- 关闸后的现场(闸关着、真仓的守卫,本机 10-10 上午;守卫落进真仓是 9 点 49 分,约 9 点 50 分关闸):一、办理会话对已完结的「定档排队主控签」计划目录下一个不存在的文件发了一条 rm,写前被拦,回话以「删计划目录」打头,写着这份计划已完结、已完结的计划不删、用清理归档的命令搬进归档,后面跟着带它需求名与执行开关的那条命令;对归档目录下一个不存在的文件发同样一条 rm,也被拦,回话写明那是计划的归档目录、归档的计划不删不挪。两次的目标都不存在,拦不住也删不到东西。二、用户在主控说了一句话,主控转来守卫的回话里带着两行以「【待清理归档】」打头的点名,分别是此刻已完结、计划还留在计划目录的两条需求,各带那条命令。三、对「定档排队主控签」跑了一次不带执行开关的预览:报将搬到归档目录下它完结的那一天、将清五个过程文件与三个进程已结束的测试临时目录、这份计划没有登记文件所以跳过仓外那一处;跑前跑后计划目录逐项相同,归档目录没有被建出来。真搬的那一次留给用户亲手验。
- v4.23.x
定档、排队、只在主控签字:签字时按档核条数上限、同一个版本单元上一次只签得上一条、办得超了点名、账按办理会话算、不是办理会话的会话写不了顶层文件
设计指纹cf81a86a内容指纹61bbcedd测试指纹b19dd948936dca56改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、SKILL.md);代码 11 个(guard.js、command-policy.js、project-archive.js、requirements.js、verify-harness.js、PLAN-TEMPLATE.html、scope.template.json、requirement-check.js 等)
需求定档排队主控签签字 8d95已发布
为了:定档排队主控签 —— 主控守顶层这条线上有四样此前只是纪律:一条需求有多大(已完结的需求里最大的一条写了十八条标准、从签字到完结一百多个小时、复盘三十四轮);同一处同一时刻只落一条(10-07 整个框架这个单元上同时有四条签过字的需求互相卡着,10-08「发布只查原料」被迫拿掉一个落点、请用户重签了一次);用户只在主控签字(账绑在签字的那个会话上,交给工作会话办的需求还得去那个会话签);业务的会话不碰顶层(写前只问仓里有没有在办的需求)。这一版交给机器:签「确认」那一刻按档核条数上限;同一个版本单元上已有别的需求占着就签不上,谁占着、谁排着一条只读命令看得见;办得超了这一档的用时或复盘轮数点名;签字那一笔记下办理会话,三查与对账都按它算,两次签字都能在主控签;写前多一道顶层围栏。另让落点格认办理会话签字后的写证据。新增三道会拦人的闸与一个只读动作,升第二位。
- 守卫(定档与上限 · 需求零件):机器镜像多一栏「档」(键名 tier),只许三个值 —— 小事、成条的事、难事;没写按小事算。签「确认」那一刻(看板贴回、对话框一键签、对话框里带话的签字三条路汇合的那一处,直接打固定那一句也走这里;排在核落点单元与短名之后、核签字基线之前)按档核四个数:标准条数、用例条数、其中要用户亲手验的条数、落点表里不重复的版本单元个数(none 不算)。每一档这四个数最多各是几,机器用的是守卫里的一张常量表,给人看的数字只写在项目架构设计页(最大的那一档前三样不设上限)。档写成这三个值之外的、或任一项超了,这一笔不记签字(基线也不记),回话点名按哪一档核的、超的是哪一项、最多几条、现在几条,并给两条出路 —— 拆成几条需求,或把档改成这四个数放得下的最小那一档(要用户亲手验的条数连最大的一档都放不下时,出路换成拆、或把几条亲手验的改成自动用例)。验收那一刻不核这四个数:这道闸没有放进签字前查计划齐不齐的那个函数(它在验收那一刻也会被调,放进去会把此前签下的在办需求挡在验收门外),「要用户亲手验的用例不多于十五条」那一条旧上限照旧在那里。签上的那一笔多记一栏当时按哪一档核的。档进内容编号,但只在写了、而且不是小事时才进:没写档或写「小事」的计划,内容编号与此前的算法逐字相同,全仓已经在办的需求签字不受影响;写了另两档或三个值之外的才进(写坏的按原样进),签过字之后改了档、编号因此变了的,签字作废。命令行算内容编号的那条命令在原有的「计划缺哪些部分」之外加报定档这一道(排队、单元名、签字基线它都不报)。新增一张常量表 TIERS(三档各六个数:标准、用例、亲手验、版本单元、办的时间、复盘轮数,不设上限的留空)与两个函数:tierOf(一份机器镜像按哪一档、四个数各是几、超了哪几项)、signHoldWhy(定档与排队合在一起:这两道过不过,不过回原因;签字那一刻与看板签字区共用)。记签字之前核的几道收成一张五道的表,按先后:账本被直接改过、计划写没写全、落点单元与短名认不认得、定档与排队、签字基线在不在与被没被改过(机器镜像读不了的排在这张表之前就回了,别的都不判);确认那一支按它走(回话与收成一张表之前逐字相同),另导出一个函数 confirmHolds 把这张表从头问一遍(此刻真去签会被哪几道挡住),排队那个只读动作只调它,两边不会各走各的。
- 守卫(同一块排队 · 需求零件):签「确认」那一刻(与定档同一处,排在它后面),这份计划新要占的版本单元上已有别的需求占着,这一笔不记签字。占着:那条需求的状态是在办、签字作废或账本被直接改过(封了版在等用户验收的也是在办,算占着),而且它的落点表 —— 此刻的,或它最后一次签字时留底的 —— 列有这个单元;机器镜像读不了、而账本里有确认没有完结的需求照旧算占着 —— 此刻的落点表读不到,按它最后一笔确认留底的单元算,回话里照样点名它(它没有短名,写目录名,并注明机器镜像读不了);那一笔确认没有留底的老签字认不出它占着哪些单元,也就不算占着(守不到;守卫与排队动作一致)。新要占:这份计划此刻的落点表里列着、而它自己上一次签字时没列的单元;重签自己已经占着的单元不查,所以前一条签字作废时它自己重签得上,此前已经同占一个单元的两条各自重签得上、第三条签不上(上一次签字时列了哪些取那一笔留底的内容;没有留底的旧签字,内容编号与此刻相同按与此刻相同算,不同按一个都没列算,往拦的方向错)。落点单元写 none 的不排队;列了几个单元的,任一个被占就签不上。回话逐个单元写明:这个单元被谁占着(短名)、它哪天签的字、步骤还剩几步没勾、独立复盘过没过(看最近一笔可信的复盘),没人占的单元写空着;并给两条路 —— 等它验收完结,或把这一条并进它。不加新的计划状态(排着的那一条就是没签字),没有插队的口。签完之后提示范围重叠的那一句留着,但同一个单元上的第二条现在签不上,它只在单元不同或落点写 none、而目录相同时才出得来。排队被挡时的回话末尾多带一句:占着的那条需求要是不办了,队不会自己放开 —— 今天没有「作废一条需求」这句话,只能照现成的删计划那条路放开;签字区、结果单抬头与排队动作里写的是同一段原因,也都带着。新增一个函数 unitHolders(此刻占着某个版本单元的需求:短名、状态、哪天签的、还剩几步、复盘过没过、办理会话)。
- 守卫(办得超了点名 · 需求零件):每档另有两个上限 —— 办的时间(从第一次签字算起,不含等用户验收的那一段)与独立复盘的轮数(各档是多少同样只写在项目架构设计页)。按最后一次签字那一笔记下的档比。两个数取现成的那一组、不另算一套:复盘轮数就是账本里复盘的笔数(过、不过、不可信都算,与「正在办」那一行「复盘几次」、履历「独立复盘几轮」同一个数);办的时间,完结那一刻用刚封进履历的那一组数(总用时减去等用户验收的那一段),在办的时候从第一次签字算到此刻,「等用户验收的那一段」只在最后一笔可信的复盘是「过」时才扣(从它到此刻),最后一笔可信的复盘是「不过」、或还没有可信的复盘时不扣;按整分钟比。超了任一个:用户每次说话时守卫回的「正在办」里,这条需求自己的那一行多一句点名 —— 超了这一档的哪一个上限、上限是多少、现在是多少。这一句单独算、单独接(新增一个函数 overNoteOf):接在那一行原有的那一句(步骤数,或签字作废时催重签的那一句)之后、进度那一段之前,不跟进度那一段走(不占它封顶的额度,不会被截掉)—— 进度那一段签字作废的不接、在办的需求多于六条时只给前六条接,点名不受这两样限制:排在第六条之后的、签字作废的,超了同样点名,签字作废的按它最后一笔确认记下的档比;算不出时那一行写「超没超上限读不到」;签字至今还没到上限时不去算办的时间。完结那一刻的回话里同样点名。只点名,不拦:超了照常签得了验收。签字那一笔没有记档的需求(这一版落地之前签的)只记数、不比、不点名。
- 守卫(办理会话 · 需求零件):签「确认」那一笔多记一栏办理会话 —— 写证据台账里最后一个把这份计划的机器镜像写成此刻这份内容的会话(执行体写的记在派它的会话名下,按派它的会话认);台账里没有这样一笔、或台账读不了,就记成签字的那个会话。认这一下只在签「确认」那一刻做一次。签字回话里写明认成了谁(会话号前八位),以及是按「这份计划的机器镜像是它写的」认的、还是认不出退回成签字的会话(这时写着原因,并写明办理的其实是另一个会话的话,让它用编辑工具把机器镜像重存一遍、再请用户重签一次)。没有这一栏的旧签字,办理会话就是签那一笔的会话。「谁在办」那一个取值函数 handlerOf 改了取法(最后一笔确认记下的办理会话,没有这一栏就是那一笔的会话号);守卫里此前按签字的会话或当场的会话算的几处改成按它算 —— 验收那一刻当场重算的三查、签字作废期间认谁的范围、越界点名记到谁的账上(从「本会话签过任一笔确认」改成「本会话是这条需求的办理会话」);「正在办」那一行里的「谁在办」与被拦几次跟着变。不设登记命令,机器不认谁是主控。签字基线不绑会话,没动;封版命令这次也没有动 —— 它需求对账那一处仍把签那一笔的会话传给核对命令,靠核对命令里办理会话盖过传进来的会话成立(封版命令的床有一条守着);它那一段的两行注释仍写着按签字那一笔的会话算,注释没改,留作欠下的。
- 守卫(顶层围栏 · 需求零件、主文件与命令判定零件):写前多一道,编辑工具与命令行直写共用 —— 要写的文件归整个框架、某个系统规范域或项目架构这三类版本单元时,写的会话必须是某条在办或签字作废、而且落点表列有该单元的需求的办理会话,否则写前拦下;在办的认它此刻的落点表,签字作废的只认它最后一次签字时留底的落点表(不然往自己那份作废的计划里添一个顶层单元就能给自己开门);机器镜像读不了的计划围栏不认(方向是拦)。回话写明这个文件归哪个单元、本会话不是办它的会话、此刻占着这个单元的是哪条需求(短名与办理会话号前八位;没有就写此刻没有),并告诉它找主控立项。归不归、归哪个单元只问版本契约的名册(单元自己的变更历史与锁清单也算归它),守卫不另立一套判法;执行体按派它的会话算。不归这三类单元的文件(业务代码、业务域的设计、计划与看板、运行时目录、不归任何单元的文件)不受这道围栏影响,原来怎么判还怎么判。版本契约装不上、名册列不出的,按拦处理。便宜的判断放前面:守卫先用一张路径预筛表(十三个前缀,含 x-test 下那两份归整个框架的文件)放掉不可能归这三类单元的写,写业务文件不装版本契约;预筛表由守卫导出,与版本契约的名册由一张床对拍。落地时量过一次:写业务文件前后几乎不变,写顶层文件多三十来毫秒。写前那一个判定函数多收一个会话号,排在「账本被直接改过」之后、「有在办需求就放」之前;主文件的写前分支与命令判定零件的直写那一半各把会话号传进去(守卫里的三处调用都带),不带会话号直接调它的(测试里)不判围栏、其余与此前逐字相同。新增一张表 TOP_PATH_PREFIXES(预筛)与一个函数 topUnitOf(一个文件归不归这三类单元、归哪个;判不了就抛,调用方按拦处理)。
- 守卫(履历零件):只动了一处 —— 完结时把刚封进履历的那一组用时数带回给完结回话,用来点名;履历的内容与格式没变,履历里不记档、也不记办理会话。
- 三查核对命令:签过字的计划一律按它的办理会话算归属 —— 谁跑、带不带会话号,出的结果单同一个编号;传进来的会话号盖不过办理会话,只在这份计划一次都没签过字时兜底;不带计划名时几份计划各按各的办理会话;结果单抬头多一行写明办理会话是谁、单子里的「本会话」指它,「谁写的」一栏同样按它算;认不出办理会话(那一笔没记下会话号)时照判不了算红。生成确认区之前先问守卫这份计划此刻签不签得了(与签字那一刻同一个函数):档与四个数各是几条、上限几条那一行出在两处、同一份内容 —— 整个签字区最顶上,与「需求」那一组最顶上;签不了(超了、档不合法、新要占的单元被占着)时不开确认区,写「确认区还没开:」加守卫给的原因,最顶上那一行照样出,命令打印的单子抬头也带这一句。重签时档变了,横幅与那一行标「改了」。第三查判落点表里的每一格:一格里此刻的改动全归别的会话,但办理会话(各次「确认」记下的都算)在第一次签字之后对这一格里某个变过的文件有过编辑工具的写证据,这一格不判坏格,那一格的说明写明有几个文件是按这一条认的;只放宽、不收紧 —— 原来不判坏的照旧不判坏,办理会话只在签字之前写过、从没写过、或这一格变过的文件都没有它的写证据的,照旧判坏格;按这一条认下的格进结果单编号,用不上这一条的单子编号与此前逐字相同。复盘任务说明的生成程序同样:在哪个会话里生成、带不带会话号,说明里的改动清单与结果单编号都一样,说明里写明「本会话」指这条需求的办理会话。
- 体系守护入口(排队那个只读动作 · 新零件 plan-queue.js):多一个动作 queue(可带 --root 指到别的仓根)—— 不写任何文件,出四段:每个版本单元上此刻谁占着(短名、状态、哪天签的字;读不了的那一条写成「计划读不了(照它最后一次签字时列的单元算占着)」);同一个单元上谁排着(还没签字、而落点表列有这个单元的计划);没在办也没完结的计划(还没签字的、签字作废的、账本被改过的、读不了的)此刻签得了还是签不了,签不了的写守卫给的原因;此刻签得了的几条里,落点单元互不相交、可以同时办的。「占着」只问守卫的 unitHolders,「签不签得了」只问守卫的 confirmHolds(确认那一支记签字之前核的那张表,确认那一支自己也走它),与签字那一刻的结论一致。帮助文字里核对命令那一句讲会话号的地方改成现状。
- 计划模板:机器镜像模板加「档」一栏(键名 tier),说明里写明三个值、没写按小事、签「确认」那一刻按档核四个数、办的时间与复盘轮数超了只点名、各档的数去项目架构设计页看(签字核的四个数在门一)、档一改签字作废;看板模板在「要动的目录或单元名一改,签字作废」那一句后面补上「档一改,签字也作废(档只写在机器镜像里,看板正文不另写)」。
- 钩子接线文件:一个字没动 —— 不加工具分支、不加钩子时刻。
- 落地那一刻要做的两件事:一、还没签字的旧计划(连同测试里的旧夹具)没写档、而条数超过小事那一档上限的,落地之后签不上(按小事核超了),要先在机器镜像里写上档;已经在办的不受影响。二、在办与等验收的需求都重跑一次核对命令再弹题,正在复盘的重新生成一次任务说明再派 —— 只有两种单子会变号:上一张不是办理会话跑出来的;有一格原来只因「此刻全归别的会话」判坏、而办理会话签字后用编辑工具写过其中的文件。属于这两种的,签字区里记的旧编号与守卫当场重算的对不上,用户点了会白点一次。
- 测试(守卫的门一床 project-gates.test.js · 定档与排队):新增 G6a–G6i(定档)与 G7a–G7l(排队),直接调判定函数逐支核账本。定档 —— 三档的上限与四个数的数法(恰好到上限不算超、多一条才算);没写档、条数在小事上限以内的计划签得上,那一笔记着小事、档没进内容编号;没写档、标准多出一条的不记签字(基线没记、履历没建),回话点名哪一项、最多几条、现在几条与两条出路;写「成条的事」的签得上、编号与不写时不同;写三个值之外的不记签字;看板贴回、一键签、带话的签字三条路同一处判;验收那一刻不核条数;签过字只改档的变成签字作废;命令行算内容编号的那条命令同样报这一道。排队 —— 同一个单元上甲签了、乙签不上,回话点名甲与单元、它哪天签的、还剩几步、复盘过没过与两条路;封了版只等验收的那一条照样算占着;不同单元的都签得上,落点写 none 的不排队;列两个单元只撞一个的,点名撞的那个、另一个写空着;甲完结之后乙签得上;甲签字作废时乙仍签不上、甲自己重签得上;两条已经同占的各自重签得上、第三条签不上;重签时新加一个被占的单元签不上;账本被直接改过的也算占着,签字作废的那一条此刻新写上、还没签过的单元也算;没有留底的旧签字重签(内容没变签得上,变了按新要占的查);三条路被同一道挡下;占着的那一条机器镜像读不了时照旧按它最后一笔确认留底的单元算占着、回话写目录名并注明读不了,读不了而且从没签过字的不算占着。
- 测试(签字床 requirements-signing.test.js · 签字区与办理会话):新增 G17a–G17f(定档与签字区)、G18a、G18b(排队与签字区)、G19a–G19e(办理会话)。没写档或写「小事」的计划,内容编号与加这一栏之前的算法逐字相同(三份金标一个字不差,两千份随机造的机器镜像逐份对拍),已经在办的需求签字不受影响;签字区最顶上与「需求」那一组最顶上各一行档与四个数;超了不开确认区并写原因、单子抬头写同一句、这道签字题弹不出来、一键签不认;重签时档变了标「改了」;验收那一刻不核条数。要占的单元被别的需求占着时签字区同样不开、写同样的原因,占着的那条完结之后重新跑核对命令就开;重签时新加一个被占的单元同一个判法。甲会话用编辑工具写计划、乙会话签「确认」:那一笔记的办理会话是甲,回话写明认成了甲、是按计划是它写的认的;机器镜像没有写证据的(或写证据记的是另一份内容)办理会话记成签字的会话并在回话里说明,两个会话先后把它写成此刻这份内容的认最后写的那个;没有这一栏的旧签字按签那一笔的会话算;乙会话签「验收完结」(贴回、一键签、带话的签字各一次):三查按甲算,全绿记完结;对照:同一份夹具只是办理会话没记成甲,三查按乙算、单子转红、记不成完结。
- 测试(守卫的需求对账床 requirements.test.js · 超了点名与顶层围栏):新增 P1–P7、P5b(点名)与 F0–F8(围栏),改写 S5(签完提示范围重叠的那一句,夹具改成第二条落别的单元 —— 落同一个单元的第二条现在在排队那一道就签不上)。点名 —— 办的时间超了这一档上限,「正在办」那一行点名超了哪一个上限、上限多少、现在多少;复盘轮数超了同样点名;等用户验收的那一段不算进办的时间,最后一笔可信的复盘是「不过」时不扣;签字那一笔没记档的只记数、不点名;三档各自的两个上限恰好到上限不点名、多一分钟或多一轮才点,不可信的复盘也算一轮;点名单独接在那一行上(步骤那一句之后、进度各栏之前)、不占进度那一段的字数,在办的多于六条时后面几条照样点名,签字作废的那一行也点;完结那一刻的回话里同样点名、超了也照常签得了验收,履历里封进去的就是点名的这一组数。围栏 —— 路径预筛(业务代码、业务域的设计、计划与看板、临时目录落在预筛之外;大小写、反斜杠写法同判);归不归、归哪个单元只问名册;一条顶层需求都没有时乙写架构详图、规则书、判据文件、项目架构设计页都被拦、回话写此刻没有;甲办着落点表列有整个框架与项目架构的需求时,乙与只签了字的主控被拦、回话点名单元、占着它的需求与办理会话,甲写放行,甲写它的落点表没列的那个顶层单元的文件照拦;签字作废的顶层需求照样算数、只认签字时留底的落点表;乙写业务代码与业务域设计放行,而且不装版本契约;版本契约装不上按拦、业务文件不连坐;乙用命令行直写同样被拦;预筛与名册对拍,往名册的副本里加一条落在预筛之外的路径就报出来。
- 测试(守卫主自测 verify-harness.js 与包着它的薄壳床 verify-harness.test.js):主自测新增 TQ 组 76 条(TQ1–TQ7 定档、TQ10–TQ14b 排队、TQ20–TQ26c 办理会话、TQ27–TQ29g 经收尾入口、TQ30–TQ40b 围栏),经守卫入口把超上限与排队各再签一遍,甲写计划、乙签确认、乙签验收走一遍并核账本里的办理会话与完结笔,换一个会话号用编辑工具写顶层文件被拦、用命令行直写同样被拦;「零件用到才装」的对照表新增 LZ32、LZ33(带出 FM32、FM32b、FM33、FM33b),改写 LZ7、LZ14、LZ23(多核一句版本契约零件没装)。主自测由 1414 条变成 1496 条。薄壳床的必跑名单补上这些号,多一句核这一组有没有中途出错(TQX)与五行「版本契约零件装了/没装」的字样检查。
- 测试(收尾环的床 stop-ring.test.js):新增 Q1–Q5,签字的会话与办理会话故意不是同一个 —— 越界点名记进办理会话的账(主控自己的越界记进没签字那本账,不进工作会话办的那条需求的账本);对照:去掉计划的写证据,办理会话退回成签字的主控,账跟着换地方;签字作废期间签字时的范围只替办理会话认(没有别的在办需求、另有一条在办需求两支都核);没有办理会话一栏的旧签字按签那一笔的会话算。
- 测试(三查核对命令的床 requirement-check.test.js):新增 R20、R21,改写 R3、R6、R16、R17。核对命令在办理会话里跑、在别的会话里跑、带着别的会话号跑,出的结果单同一个编号,抬头写着办理会话、单子里的「本会话」指它;签过字却认不出办理会话的算红,传进来的会话号顶不上。办理会话签字之后用编辑工具写过某个文件、之后别的会话又改了它,这一格不判坏格,结果单写明有几个文件是按这一条认的;办理会话只在签字之前写过、或从没写过,照旧坏格;这一格变过的文件都没有它的写证据,照旧坏格;原来不坏的格照旧不坏。
- 测试(验收单的床 acceptance-sheet.test.js):改写 A1、A3、A4 的夹具 —— 四条用例的那份计划写上「成条的事」(不写按小事核就签不上、也就没有基线);A3 的两份计划各落各的单元(此前两份落在同一个单元上,现在第二份签不上)。
- 测试(体系守护的床 harness-dev.test.js · 排队动作):新增 Q1–Q7。在小仓里造几份计划:排队那个只读动作经命令行真跑退出码 0(有读不了的、签不了的计划也是 0),跑前跑后仓里(连同需求账本与它的仓外镜像)没有文件变化;按单元列着占着的与排着的;此刻签得了的与签不了的,签不了的写的就是守卫签字那一刻回的那段话;可以同时办的按落点单元互不相交分组;与真去签对照 —— 它说签不了的八份真去签也签不上,说签得了的五份真去签签得上;「占着」「签不签得了」只用守卫的判法(换一个守卫进去,结论跟着它变);一份计划都没有的仓照常出。
- 测试(封版命令的床 seal-command.test.js):新增 R8,改写 R5、R6、R7、F6 的夹具。R8 —— 字是主控签的、办理的是工作会话,封版前的需求对账按办理会话算:工作会话在本单元动了手、另有一个范围外的改动,拒封并点名那个文件(对照:同一个范围外的文件是签字的主控写的,不算这条需求的越界、不拦);工作会话的用例没闭环,拒封并指向第二查(对照:在本单元动手的只有签字的主控、办理会话没动过手,不拿它的用例闭环拦)。
- 测试(业务开发技能的床 feature-dev.test.js · 两份模板):新增两条 —— 机器镜像模板里有「档」一栏、说明里写着三个值与没写按小事;看板模板里有「档一改,签字也作废」这一句。
- 测试(反证与结果):在仓外副本上把新判定逐处换成空的或改松,共 65 处(定档 8、排队 6、办理会话与按它算 8、落点格 7、围栏与预筛 9、点名 7、签字区 6、排队动作 7、模板 5、另 2),对应的用例每一处都变红;其中「守卫主文件编辑工具那两处不传会话号」只有经守卫入口的主自测咬得住。落进真仓之后,经唯一运行器对改过的十五张床做空壳对照,全部通过。真仓里的结果:守卫这一面 18 张床全过,主自测 1496 条全过;体系守护、元治理、业务开发三个技能面改过的床全过。没核成的(照实记):预审提的两条线索 —— 命令行直写的目标带变量、通配或反引号时写前不判;Windows 上的路径别名会不会绕过预筛 —— 没有核成(见下「落地前的一次事故」),守不到里讲命令行直写的那一句是读代码读出来的,没有实测。
- 架构详图 §八(六样的落点):需求对账一段末尾新增六小段 —— 定档与上限、同一块排队(连同排队那个只读动作)、办得超了点名、办理会话(怎么认、用在哪五处)、落点格认办理会话签字后的写证据、顶层围栏(预筛、名册、办理会话与单元、回的话),各带各的守不到,并写了落地那一刻的两件事;这一段里因此变假的句子改成现状(内容编号里的档、确认那一笔多的两栏、写前多问的那一句、验收那一刻的三查按谁算、签字作废认谁的范围与越界记到谁账上、门一后面再接两道、「谁在办」与被拦几次的取法、履历仍只记数、连着三次不过之后那一次发话没改)。「挂载」一段写明版本契约过了预筛才装;环 1 通道图的编辑通道加一条、「拦截出口」里被拦归到谁改成办理会话;文首全景图强制层加四行;§十三「唯一实现」写明契约多一个读者;文首版本改成本版。
- 架构详图 §十五(会话分工):角色表主控一行改成两次签字都由它弹题、用户在主控签,审计划只提意见、不动机器镜像,不替用户授权发布;工作会话一行写明它是这条需求的办理会话、签字报主控、不自己弹签字题、不自己发布;新加「部署会话」一行(全部发布在它里面做,没有用户亲口说的那一句授权不发)。「这张表今天靠什么」三条改成现状:守卫认办理会话与文件归不归顶层三类单元、仍不认谁是主控;业务的会话不碰顶层从纪律变成写前有围栏;两次签字在主控签,「主控不对交给工作会话的需求跑核对命令」取消(核对命令谁跑结果都一样)。「先分级」「一条需求一次封版收得了口」两段的「今天靠什么」改成一半是机器;排窗口那一段把谁来发布、怎么授权写成三句,并写明授权没有机器核;「怎么派工」写明签字题由主控弹、签完把守卫回的那一行转给工作会话;「主控怎么交接」改成照四步做,其中验收与对账按谁算的两条改成现状。
- 决策记录:新增 ADR-94(九条决策;为什么按档只核条数、为什么排队不加新状态也不留插队的口、为什么办理会话按「计划是谁写的」认而不设登记、为什么围栏按办理会话不认主控、为什么便宜的判断做成预筛加对拍而不做计时用例;否决了登记、主控的机器身份、排队状态、插队口、字数上限、超时就拦、宽口径围栏、计时用例等十三样)。它逐条写明哪几句不再是现状:ADR-93 四处(它「上限数字只写在设计页」那一条照旧)、ADR-90 四处、ADR-75 两处、ADR-74 两处、ADR-73 一处;并照实写了封版命令没有动、它那一段的两行注释没改(留作欠下的)。既有条目一个字没改。
- 说明(体系守护技能与业务开发技能两份):核对命令与生成复盘任务说明的命令不用再带会话号 —— 签过字的计划按办理会话算,谁跑结果都一样,传进来的会话号只在一次都没签过字时兜底;新写一节排队那个只读动作(出哪四段、守不到哪四样);讲两次签字的那一段写明交给工作会话办的需求由主控弹签字题;写明落地那一刻要重跑核对命令再弹题。业务开发技能的说明另写明计划里要写档(没写按小事,条数超过小事的上限就签不上)、各档的上限去哪看、同一个版本单元上已有别的需求占着时签不上与怎么看谁占着、改顶层文件要是办它的会话。
- 项目架构设计页同批改(门一写全各档的数、写明同一块排队;门二写明顶层围栏;门五里读起来像机器在核的「用户单次授权」挪到守不到;第十节把两次签字改成在主控签、写明换主控的四步与发布归谁;诚实边界里因这次变了的行改成现状),那是它自己的一版(v1.6.0)。
- 落地前的预审:落地之前在仓外副本上做了一轮限时的只读预审,只对着标准判,点出两处并在落地前改了 —— 办得超了的点名在两种情形下不出(在办的需求多于六条时排在第六条之后的、签字作废的);占着单元的那条需求机器镜像读不了时不算占着。它读代码时另读出三样守不到,都是原有的口径、不是这一版引入的,照实添进了下面的守不到(四里命令行直写那半句与点名最重的两样、九)。
- 落地前的一次事故(照实记):落地之前,为了核预审提的一条线索(Windows 上路径别名会不会绕过预筛),派给测试的探针要在文件系统上真写真删;其中一项用了相对路径,而起脚本时所在目录是真仓,于是 10 月 10 日 0 点 01 分往架构详图末尾追加了一行记号、随后把它删掉了。执行体当场发现、当场上报,没有用版本库的恢复命令(工作区里这份文件带着三条需求没存档的改动)。约六分钟后原样放回:在仓外把一份套过草稿的副本逐处反换回原件,原始字节的指纹等于这条需求签字那一刻守卫记下的那一个;放回后用带计划名的核对把全仓受治文件对着签字基线核了一遍,零改动。没有别的文件受影响。起因是派活时没有写死「真写真删只许对临时目录里的沙箱、路径一律绝对、起脚本的所在目录不放在真仓」;守卫这一侧没有哪一道失灵 —— 脚本进程里自己做的写和删守卫看不见,这本来就在守不到里;事后是收尾环按版本契约把「封版后删了这个文件」报出来的,但它给的处置提示是升版,照做就错了。那两条线索因此没有核成。
- 关闸后的现场验证(守卫落进真仓、关闸之后,在真实会话里做的前三样;时刻取自守卫的账本,本机时间,都在 2026-10-10 凌晨、闸关着):先确认守卫在岗 —— 钩子接线文件里写前拦截那个键是在岗的写法,另发了一条该拦的命令(node 的输出接截断命令),被守卫当场拦下。一、0 点 24 分,办这条需求的工作会话(办理会话)用编辑工具改了框架变更历史里的一行(整个框架这个单元自己的变更历史),照常写得了,守卫写后回的那一句:『【需求对账】.claude/harness/CHANGELOG.md 在设计范围里:tier-queue-main-sign → framework:harness / 变更历史与锁清单。做完这一步记得在计划上勾掉。』(那一句里的 tier-queue-main-sign 是这份计划的目录名。)二、0 点 24 分 40 秒,主控会话(不是办理会话)用编辑工具改架构详图文首那一行,写前被拦、文件没变,守卫回的原话:『⛔ 环1 需求对账:顶层围栏:.claude/harness-engineering.md 归版本单元 整个框架(framework:harness),只有办着「落点表列有这个单元」的需求的那个会话写得了,本会话(c860a79e)不是。此刻占着这个单元的需求:「定档排队主控签」(办理会话 a8e91ff6)。要改它,找主控立项(顶层的需求由主控立项、交给办理会话办);手上的顶层计划只是还没签字的,先让用户签「确认」。办别的需求时发现的是顶层问题:会让手上的需求做错或做不下去就停下报主控,别扭但做得对就记一笔接着做。』—— 点名了单元与办理会话。三、办理会话把「成条的事」写进这份计划的机器镜像,签字随即作废;刷新后签字区最顶上那一行是『改了 档:成条的事 标准 9 条(上限 10 条)、用例 11 条(上限 12 条)、其中要你亲手验的 2 条(上限 5 条)、版本单元 2 个(上限 2 个)』;0 点 27 分,用户在主控点了「全选执行:确认 定档排队主控签」,签成了,守卫回主控的原话:『【签字】已认出签字一「确认 定档排队主控签」,记进需求账本。基线沿用第一次签字那一刻的(5238 个文件,不重记)。 需求履历已建(在办)。 办理会话:a8e91ff6(按「这份计划的机器镜像是它写的」认的;此后三查、越界、封版前对账都按它算)。』—— 认成的办理会话前八位是 a8e91ff6,就是办这条需求的工作会话,不是主控。旁证:几分钟前另一条由别的工作会话办的需求(只占看板规范那一个单元)也在主控签了确认,办理会话同样认成写它计划的那个会话。第四样(这条需求的验收在主控签成)是验收那一刻的事,不记在这一版里。超上限与排队两道闸没有在真仓里造假计划试签,靠经守卫入口的主自测。
- 没做的(记进了计划的遗留):连着三次复盘不过之后那一次发话仍只认派复盘的那个会话;暂停与恢复、机器核发布授权、签字题的封口扩到整问各段、历任办理会话的交接;占着单元的那条需求不办了、又没人删它的计划,队放不开 —— 今天没有「作废一条需求」这句话;排队那个只读动作里不印用时;封版命令里两行过时的注释没改(判法没动);执行体注册表里「agent 是第四类受治工件」「领队是主会话」两句与框架架构师定义里的写域仍是旧话,这次不办,留给后面单独一条。
- 守不到(逐条写在架构详图 §八 新增各小段末尾、§十五 各段的「今天靠什么」与项目架构设计页的诚实边界;不许读成「从此小需求不会长大、同一处不会相撞、顶层没人改得动」):一、条数挡不住单条标准写得宽 —— 五件事写进一条标准就绕过去了;档由写计划的人填,机器不判该是哪一档,超了把档改大就签得上,难事前三样不封顶。二、排队只挡签字,不挡排着的会话提前往仓里写 —— 顶层三类单元有围栏挡着不是办理会话的会话,业务域的单元没有,仍靠在仓库外面写和测的纪律。三、办理会话会认错的两种情形 —— 用脚本写机器镜像的没有写证据,退回成签字的会话;别的会话后来改过机器镜像就认成它(主控审计划时顺手改一处就认成主控,工作会话的改动全算别的会话、顶层文件它自己也写不动);兜着的只有签字回话里认成了谁的那半句与「主控不动机器镜像」的纪律。四、围栏守不到脚本进程内的写与开闸期间的写;不归任何单元的受治文件围栏不管 —— 最重的两样是钩子接线文件、守卫与技能目录下的测试(钩子接线文件与守卫自己的测试另有脊柱写保护,技能目录下的测试没有),另有部署门登记表、治理站点的源码与构建器、官网;还没出生的单元名册不认(全新的技能目录、新规范的第一个文件),围栏不拦;删除不过围栏;写前那个判定不带会话号直接调时不判围栏(守卫里的三处调用都带);命令行只挡直写落点的常见形态 —— 直写的目标带变量、通配或反引号时写前那个判定不判,围栏的命令行那一半跟着看不见(这一句是读代码读出来的,没有实测);Windows 上的路径别名会不会绕过预筛,没有核实;平台另有的 PowerShell 工具与笔记本编辑工具守卫不处理。五、连着三次复盘不过之后那一次发话仍只认派复盘的那个会话,还得去那个工作会话说。六、机器不认谁是主控,工作会话里照旧签得成,「签字题由主控弹」是规矩;业务的会话自己起草一条列着顶层单元的计划、用户在它那里签了确认,它就写得动顶层。七、占着某个版本单元的那条需求不办了,队放不开 —— 今天没有「作废一条需求」这句话,只能照现成的删计划那条路放开,排队被挡时的回话里带着这一句。八、两条排着的需求在同一刻各自去签同一个空着的单元,两条都会记上 —— 判定(读各份计划的状态)与记账(追加确认那一笔)之间没有东西挡着,中间还隔着记基线与认办理会话,没有加锁;记上之后两条都算占着,各自重签得了、第三条签不上。现实里用户一次只点一道题,所以它是守不到、不是要修的毛病。九、签字作废的需求改了落点表,判「占着」时认的是「此刻的或签字时留底的」,所以它不经签字就能多占一个单元(围栏只认签字时留底的那一份,那一半方向是对的)。另有:卡住的那一条没有插队的口,单元不同而目录重叠的不排队,机器不记先来后到;机器镜像读不了的那一条只按它最后一笔确认留底的单元算占着,没有留底的老签字不算;排队那个只读动作说的「签得了」不含看板签字区是不是最新的那一道、也不含用户这一次贴回的结论本身对不对,它的「可以同时办」只列落点单元一个都不重的,落点表里写了版本契约不认得的名字时它前两段照原样把它当一个单元列出来,它出的是此刻的样子、看完之后别人签了字结论就变;办的时间是墙上时间,过夜、等开闸、等别的需求让路都算(只有等用户验收的那一段不算,在办期间这一段只在最后一笔可信的复盘是「过」时才扣),复盘轮数连不可信的那几轮一起数,超了只点名、没有任何东西被挡住,上限是拿顶层需求的记录定的、对业务需求没有数据,这一版落地之前签下的需求只记数不比;落点格治不了的三样 —— 只含锁清单这类没有写证据的文件的格照旧会红、别的会话在同一个单元上还没封版时第三查照红、共享文件一变已过的复盘作废,而且认的是「写过」不是「此刻的内容是它的」;一条需求做到一半换会话接着做,哪边当办理会话第三查都会红;主控记签字的同一刻办理会话的钩子也往同一本账追加会把账本的链撞断,靠「报完请签字就停手」的规矩;上限的数字有两处 —— 守卫里的常量表与项目架构设计页,两处没有机器对拍;发布授权机器不核,换主控的四步是纪律。
- v4.22.x
看得见、记得住:守卫每拦一次留一笔、每次回话列出各条需求走到哪、用时与返工和遗留进需求履历、到了存档点守卫直接说;提速的办法写成明文
设计指纹5186c69a内容指纹65216707测试指纹481d27773be75be1改动设计 4 个(CLAUDE.md、harness-engineering.md、ADR.md、SKILL.md);代码 8 个(guard.js、project-archive.js、requirements.js、session-ledger.js、verify-harness.js、PLAN-TEMPLATE.html、review-brief.js、archive-point.js)
需求看得见记得住签字 1b18已发布
为了:看得见记得住 —— 主控守顶层这条线跑了一天真实需求,露出两类毛病。一类是看不见、记不住:主控要知道各条线走到哪只能等工作会话来报、或请用户去那个会话看一眼;守卫拦了什么只是当时屏幕上的一行字;做到一半记下的发现写在计划里、计划完结就删,复盘者写的遗留只在他的报告里;一条需求办了多久、返工几次没有数;到了可以存档的点要靠主控记着说。另一类是慢,用户 10-09 原话「速度太慢太慢了……禁止简单问题复杂化」:一件事被切成八条、每条走一遍全套手续,小事也派三路人审计划,派工不带设计、没握手。这一版让机器把前一类的五样接过去(全是往账上多记一笔、在现成的时刻多说一句,不加任何会拦人的闸),并把提速的办法写进宪法、架构详图与项目架构设计页(今天全靠纪律)。新增一类东西,升第二位。
- 守卫(拦截留痕 · 主文件的拦截出口与会话台账零件):守卫里所有的拦都从主文件里同一个出口走;这个出口在退出之前往本会话的台账追加一笔拦截 —— 时刻、在哪一刻被拦(写前、执行体停下那道关、复盘者收尾、收尾)、工具名、拦在哪(编辑取文件的仓根相对路径,命令取开头一百二十个字,云端工具取动作名、带服务名的写成「服务名:动作名」,派执行体取类型)、原因的第一行(二百字以内),执行体发出的带上它的编号与名字。守卫自己运行出错而拦的那一种(文件末尾的总兜底)也尽力记一笔并标明是守卫出错。记账包在 try 里:记不下时原来的报文与退出码一个字不变;放行的调用不多读不多写,被拦的那一次只多一次追加。会话台账零件新增两个函数:记一笔拦截(recordBlock)、按「哪个会话、哪个时刻之后」数拦截(blocksOf,只读那一个会话自己那一份台账,分写前、收尾、其它三栏,执行体停下那道关与复盘者收尾归其它,带最近一次)。不记的:放行的;本来就不拦的时刻(说话、开工、接线变更);守卫启动失败;写后复判判出的「本该拦」(照旧用它自己那一种记录)。不记「是哪条需求的」—— 归到需求是读的时候按「谁在办、第一次签字之后」算。这一种记录算会话的动静:判「主人会话已结束」的那一处认任何带时刻的台账事件,被拦一次也算这个会话还活着。
- 守卫(每次回话列进度 · 需求零件):用户说话那一刻(打字,或在选项题里自己打字)回给当场会话的「正在办」那一行,每条在办的需求后面多接一段(签字作废的那一种不接,它那一行照旧只催重签;步骤数那半句不动),二百四十字封顶、超长先去掉最近一次被拦的原因。依次带七样、全取现成的不重算:谁在办(本会话,或「会话某某在办、它最后一次动静多久之前」—— 只看那个会话台账文件的修改时间);第一次签字至今多久、签了几次;三查与封版(只读账本目录里落盘的最新一张结果单并带上它是几点算的(本机时间),绝不重算;单子上的内容编号与计划现在的不同时多一句「算的是改之前的内容」;没有就写三查还没算过);复盘几次与最新结论;验收还没签、签过几次没成、用户说过几次不过;最后一次签字的那个会话在第一次签字之后被拦了几次(写前、收尾、其它分开数,带最近一次原因的开头);看板「欠下的」一栏有几条(一条都没有写「没有欠下的」)。新增两个函数:handlerOf(「谁在办」全仓只经它取,今天 = 最后一次签字那一笔的会话,以后口径变了只改它)、progressLine(拼这一段;任何一栏读不到就写「读不到」,其余照出,绝不抛)。对每个会话都注入(守卫分不出谁是主控),内容没变也照发;在办的需求多于六条时只给前六条接这一段。这一刻不起子进程、不量工作区、不重算三查。
- 守卫(用时与返工 · 履历零件):验收完结、封履历之前,从账本现成的事件算出一组数写进履历。机器读的那一份多一栏(effort);给人读的那一份多一节「用时与返工」,排在「产生的版本」之后、「遗留」之前,六行 —— 第一次签字的时刻;签字次数;用户说「不过」的次数(数的是账本里全部的不过,含签字一那一步没勾全记下的那一种,不含验收没成的次数);独立复盘几轮(过、不过、不可信分开数,不可信的不算进过与不过);总用时(第一次签字到完结);其中等用户验收多久(最后一笔可信的复盘到完结,没有可信的复盘时这一行写「没有可信的复盘,算不出」)。时长舍去不满一分钟的零头;时刻沿用履历现有的写法(世界协调时、没标时区)。在算产出指纹之前写,照样封死。新增一个纯函数 effortOf(不读盘;账本里没有签字那一笔就不出这一栏)。只记数,不比任何上限,不数封了几版,不加新的账本事件。之前封死的十七份履历没有这一栏,一个字不动、也不回填:没有这一栏的履历重新渲染出来与原来逐字相同。
- 守卫(发现留得住 · 需求零件与主文件复盘者收尾那一支):验收完结、三查全绿、封履历之前,把两个来源的遗留逐条并进履历的「遗留」一栏 —— 计划看板「决策与遗留」页签「欠下的」小标题下的内容(只认列表与段落:每个列表项一条,没有列表项就每段一条;含方括号占位的条目当模板占位跳过,整条是「无」的不算),前缀标「计划欠下:」;账本里每一笔可信的复盘带着的遗留,前缀标「复盘遗留(第 N 次):」,N 是这一笔在全部复盘里的次序。逐字相同的只留一条(按正文比,不含前缀),每条三百字封顶、合计最多四十条,超出的在完结那句回话里说另有几条没写进履历;机器读的那一份也剥掉指向计划目录的路径。复盘者的遗留是他收尾那一刻取的:守卫从他最后那段话里取「遗留」一节(标题单独一行写「遗留」,也认加粗的写法、冒号写在加粗里面外面都认,别的不放宽;到下一个标题或结论行为止,以短横打头的行才算一条,整条是「无」的不算),随复盘结论那一笔记进账本(多一栏,不多写一笔;每条三百字、最多二十条,写多了的后面几条静默丢掉),回给领队的话里说明认出了几条;没有这一节不拦收尾、不改结论,只在回话里说没认出并写明该怎么写。完结那句回话后面写明「遗留 N 条已写进履历」并逐条列一次、交主控定去向,没有就写没有遗留;取遗留出错不挡完结,按零条处理并在回话里说没取出来与原因。新增两个函数:boardLeftovers(取看板「欠下的」)、parseLeftovers(取复盘者「遗留」一节)。「遗留」这一栏履历的写法里早就有,只是唯一的生产调用从没传过,此前每份履历都没有这一节。
- 复盘任务说明的生成程序:「结论怎么写」那一段把遗留的写法写死,并把「你实际核了什么」挪到「遗留」之前 ——「遗留」紧挨着结论行单独一节,标题单独一行写「遗留」,下面每条一行、以「- 」打头,没有就写一条「- 无」;最后一行仍只写结论。别的没动(判法、预算、派发闸、结论行格式)。
- 计划模板:页签六「欠下的」改成一条一行的列表,说明放在提示框里(写明完结那一刻钩子把这里逐条写进需求履历的「遗留」一栏,每条要写成离开这份计划也看得懂的一句话);页签五固化对照表「决策与遗留」那一行补半句同样的话。
- 守卫(存档点提醒 · 新零件 guard/archive-point.js 与主文件收尾最后那个放行出口):到了干净的点,守卫在那一轮收尾放行时直接对用户说一句固定的话 ——「【存档点】现在可以存档:没有在办的需求,全部版本单元都已封版。」用的是收尾环本来就在用的那种直接给用户看的输出(原来有话就另起一段接在后面,原来没话就单独输出);不写成待办、不问存了没有、不报有多少改动。判的先后,先便宜后贵:工作区量出来了、而且有计划目录与账本目录之外还没存档的改动(账本目录指整个运行时目录 —— 需求账本、原话账本、会话台账都在里面;原话账本进了版本库,用户每说一句话它就变,不排除的话他刚存完档说一句话守卫又会说一遍);再读计划,没有在办、签字作废或账本被改过的(没签字的、已完结的、读不了的不算);再取当前存档点的编号;最后才起子进程跑发布前版本比对,结果为空才成立(与部署门同一个比对,最多等二十秒,真仓实测单跑约 3.8 秒;从守卫进程启动算起用掉超过九十秒的这一轮不判)。同一个状态每个会话只说一次:状态是当前存档点的编号加上这两个目录之外还没存档的文件清单(只看是哪些文件,不看改了几遍),用户存了档之后又有新的没存档改动才算新状态。结论记进会话台账,带两个指纹:状态指纹只管说没说过;内容指纹(文件清单的路径加修改时间)只管别的会话记下的版本比对结论能不能沿用 —— 两个都相同才沿用,内容指纹不同就重判。出错不拦:版本比对判不了或超时,完全不说、不拦、不记;零件装不上、运行出错、结论记不进台账,照旧放行、不说那句话,只在这一轮收尾的附注里说一句(三种开头:「存档点零件装不上,这一轮没判:」「存档点零件出错,这一轮没判:」「存档点的结论记不进台账,这一轮不说:」)。这个零件不走守卫顶部的装载口,只在放行出口用普通的装法现装 —— 那个口的约定是装不上就拦,是给闸用的。
- 钩子接线文件:一个字没动 —— 不加工具分支、不加钩子时刻。写前拦截的每一条判法、每一句拦截报文与退出码也都没动。
- 测试(新测试 block-ledger.test.js · 拦截留痕):经守卫入口 —— 被拦一次台账恰好多一笔、各栏对得上、报文与退出码不变;放行不多记;执行体被拦带它的标记;收尾被拦标成收尾;台账写不进去时照拦且原因不变;数拦截的函数只数指定时刻之后的、只读那一个会话的、三栏分开。
- 测试(新测试 progress-line.test.js · 每次回话列进度):本会话签的与别的会话签的各出什么;有结果单、没有结果单、结果单是坏文件时不抛;结果单的内容编号与计划现在的不同时写明算的是改之前的内容;复盘零次、一次不过、过;验收没签、签过没成;拦截只数最后一次签字的那个会话签字之后的;封顶与超长时先去掉哪一段;多于六条只给前六条接;签字作废的那一种不接。
- 测试(新测试 record-effort-leftovers.test.js · 用时与返工、遗留):两次签字、一次不过、三轮复盘的需求封出来六行各数对得上、指纹核得过;没有签字那一笔不出这一栏、不抛;没有可信复盘时那一行的写法;旧履历重新渲染逐字不变。完结后履历两份文件里都有遗留、条目与前缀对得上看板与账本;空的、模板占位、「无」不出这一节;带计划目录路径的被剥掉;超出上限时回话里说另有几条;取遗留出错照样完结。
- 测试(新测试 archive-point.test.js · 存档点):判纯逻辑 —— 没有这两个目录之外的改动、有在办需求、同一个状态已经说过,各自不成立;只有计划目录与账本目录里的改动不算;状态指纹只看是哪些文件、内容指纹看修改时间,内容指纹不同就重判;用时超过九十秒这一轮不判。经守卫入口走收尾 —— 成立时输出里有那句话;同一个状态第二次收尾不再说;零件装不上、出错时照常放行并在附注里说那一句;版本比对超时时不说、不拦、不记。
- 测试(守卫主自测与任务说明的测试):主自测只做了最小改动 —— 写前被拦的两条现成用例(A5、A7)多核一句「本会话的台账多了一笔拦截,目标与原因的第一行对得上」;新加一条 TS1,把存档点零件里「用掉多久之后这一轮不判」「取存档点编号最长等多久」「版本比对最长等多久」与接线文件里收尾钩子的时限绑在一起(三样之和加三秒余量要小于钩子的时限,零件里抄的那一份不许比接线文件里的大),改任一边都要过它;「零件用到才装」对照表里收尾那两行(LZ12、LZ29)的名单加上存档点零件,故障注入那两格(FM12、FM29)写成例外 —— 闸那几个零件坏了每次都退出码 2,存档点零件坏了收尾照常放行、输出里说一声装不上。薄壳测试的必跑名单补上 TS1、LZ12、LZ29、FM12、FM29、A5、A7。任务说明的测试加一条(B10):生成出来的说明里有写死的遗留写法,守卫照这个写法认得出。
- 测试(反证):在仓外副本上把十九处新判定逐个换成空的 —— 记一笔拦截、数拦截、拦截出口的记账;拼进度、取谁在办、往「正在办」那一行接进度;算用时;取看板欠下的、取复盘者遗留、复盘那一笔多记的一栏、完结那一刻取遗留;存档点的前两条判据、判定、状态指纹、内容指纹、收尾出口的接线、取版本比对结果;任务说明里遗留写法的样子(两处)—— 对应的用例每一处都变红,没有咬不住的。
- 宪法:第四节「运作方式」那一段加一句定性的话 —— 派工先分级,手续的轻重与事情的大小相称,简单的事不许复杂化(第六节第 8 条的闭环不因此省);改同一处的几件事合并成一条办,互不相干的并行办;同一处同一时刻只落一条,下一条可以先备好。「顶层的需求由主控立项,同一时刻只办一条」改成「由主控立项、排先后」;段末指路的那一句补半句「分几档、各走哪几步」。只写定性,没有数字、没有机制;都在同一行里改,行数没变。
- 架构详图 §十五(提速的办法):新增「先分级、再选路」一段(三档各走哪几步、省掉什么,机器规定必须走的五样哪一档都不省,审查只留两层,两个冻结点;每档的上限数字只写在项目架构设计页,这里不抄);「需求切小到一次封版收得了口」一段改成「一条需求一次封版收得了口;落在同一处的几件事并成一条」(同一处只有一条车道、等的是验收不是封版、能不能多开会话只看版本单元与目录重不重叠);排窗口那一段从三样变四样,加上验收(从出结果单到用户签字的那一小段,别的会话别动受治文件),并写上发布攒到一段落再发一次;新增「怎么派工」一段(主控先出设计、派工带设计;先握手;按节点回报;要用户动手的事先报主控)。每一段末尾都写了今天靠什么 —— 这几样今天全靠纪律,机器只做到事后记数与每次回话列进度。角色表跟着改:主控一行加先分级、握手、四个窗口,「同一时刻只办一条」改成立项并排先后;工作会话一行里「顶层的工作会话同一时刻只开一个」改成落在同一处的不同时往仓里落、后到的只做准备;项目经理一行的「不说话」说准(它对用户说的只有收尾时的提示与存档点那一句)。「遇到顶层问题的两种走法」写明记进计划「欠下的」一栏、完结时进履历,去向仍没有账;「主控怎么交接」里对应的两句改成现状。
- 架构详图 §八(五样功能的落点):环 1 通道图末尾加「拦截出口」一条;环 2 台账的事件清单补两种(拦截、存档点结论),并写明它们算会话的动静;需求对账一段里「用户说话」那一句、「复盘判法与固定检查」的两处(任务说明写死遗留的写法;「守不到」里「遗留只在复盘者的报告里」改成现状)、「复盘进关口」(复盘者收尾时取遗留)、「项目架构与归档」的归档那一句改成现状,并新增「每次回话列进度」「履历多两栏」两小段;收尾环末尾加「存档点提醒」一条;「挂载」一行末尾写明存档点零件不走装载口、为什么。每处都带着各自的守不到。文首全景图强制层四行跟着改;§十四讲履历的那一句补上两栏;文首版本改成本版。
- 决策记录:新增 ADR-93(五样各一句、提速的办法;为什么拦截进会话台账不进需求账本、为什么进度只读落盘的结果单、为什么「谁在办」只经一个函数取、为什么存档点挂收尾不挂完结、为什么存档点零件不走装载口;否决了去向台账、折叠去重、拦截汇总进履历、单独的查询命令、「离存档点还差什么」、只给主控注入等九样)。它取代 ADR-90 的三处并给它加一样:「同一时刻只办一条」、「大战线是一串小需求」的切法、否决「硬控一口气全上」的那条理由,以及排窗口从三样变四样;ADR-87「守不到」里讲遗留的那半句不再是现状。既有条目一个字没改。
- 说明:体系守护技能的说明里讲复盘判法的那一段,「遗留由执行者抄进看板,机器只认结论行」改成现状 —— 任务说明写死遗留的写法,复盘者收尾时守卫随结论记进账本,完结时进履历;不用再把复盘者的遗留抄进看板。
- 项目架构设计页同批改(第十节加「先分级」「怎么开一个工作会话」两行,第四节、门二、门四与诚实边界里因这五样变假的句子改成现状),那是它自己的一版(v1.5.0)。
- 关闸后的现场看过两样:守卫落进真仓、关闸之后,在真实会话里 —— 一、2026-10-09 19:07:18(本机时间)办这条需求的会话故意跑了一条会被写前拦下的无害命令(node 的求值开关),守卫照旧拦下、报文与原来逐字相同,本会话的台账当场多出一笔拦截,各栏对得上:写前、工具 Bash、目标是那条命令的开头、原因是「环1 node 求值 (-e/--eval/-p)」那一行;开闸期间那几次收尾被拦也各记了一笔,标的是收尾。二、2026-10-09 18:56 前后(守卫文件已落进真仓、闸还没关;这一样挂在说话那一刻,不经写前拦截,与闸开没开无关)主控会话收到的「正在办」那一行带出了新加的那一段,七样都在,照录(需求全文略):「步骤 13 步,还剩 6 步没勾;会话 b35f0d18 在办,它最后一次动静 不到 1 分钟前;签字至今 0 小时 6 分;三查(10-09 18:53 算的)一红、二红、三红,单元 1 个封了 0 个;还没复盘;验收还没签;被拦 写前 0 次、收尾 2 次(最近:环3 本轮检测结果:);欠下 8 条」。复盘者收尾时守卫回话里「遗留几条已随这一笔记下」那一句,要到封版之后派正式复盘才出现,不记在这一版里。存档点那句话与履历里多出的两节,要到验收完结之后那一轮才出现,同样不记在这一版里。
- 落地时的一次次序疏漏(照实记):这一批改动里,计划模板不受写保护、守卫的测试受写保护;计划把模板排在关闸之后与文档一起落,开闸窗口里核模板的那条新测试因此在真仓红了一次,把模板提前落进去之后才过。跨着写保护线的一组改动,落地次序要按测试核的是哪些文件排,不能只按要不要开闸排。
- 没做的(记进了计划的遗留):发现的「去向」台账;进度那一行内容没变就折叠;拦截汇总进需求履历;单独的查询命令;「离存档点还差什么」的提示;治理站点入口页的需求卡印用时;进度只给主控注入;开工那一刻也列进度;给之前封死的履历回填用时。让机器在签字之前核档与上限、在签字那一刻挡住同一处的第二条,是这条线后面的需求。
- 守不到(逐条写在架构详图 §八、§十五各段末尾与项目架构设计页的诚实边界,这里点最要紧的;不许读成「从此都看得见、都记得住、不会再慢」):拦截只记经守卫出口的 —— 守卫启动失败、钩子输入读不了连会话号都没取到的那一次、平台自己的禁止名单拦的、钩子超时被平台掐掉的不记,封版命令拒封与签字没记成不在这本账里;写证据台账第一次建立时那一次提示性的拦也被数成被拦;台账写不进去时照拦、少一笔、没有提示;被拦命令的开头(前一百二十个字)原样留在本机的会话台账里,命令里带着密钥的话也留在那里(台账不进版本库、保留三十天);今天只有「正在办」那一行读它。进度那一行的三查与封版读的是落盘的结果单,可能是旧的(行里带着几点算的);会话只有编号没有名字;只在用户说话时才出现,工作会话卡住了机器不提醒;「谁在办」今天等于最后一次签字的会话,被拦也只数这个会话自己的台账(别的会话替它干活被拦的不算,重签换了会话之后前一个会话的不算);只说话只读文件的会话不往台账记,看上去像没动静;进度与完结时的遗留清单都是塞给执行者的话,用户看不看得到取决于执行者转述。用时是墙上时间,过夜与等待都算,只记数、不比上限、不点名;之前封死的履历不回填。遗留的去向没有账;遗留一进履历就随治理站点公开、封死后改不了,进去之前不先给用户看;只取「欠下的」那一栏、只认列表与段落,写成表格的老看板一条都取不到;复盘者没按写法写时认不出、记成没有,只在他收尾那一刻提示一次;完结那一刻取遗留出错按没有处理,履历已封死、之后补不进去;不可信的复盘带的遗留不进。存档点那句话在几条线并行时可能很久不出现,不成立时不说差什么,谁收尾碰上就在谁那里说;只在收尾最后那个放行出口判(「红项没减少先放行」等另两个出口不判),收尾用时超过九十秒的那一轮不判;一次存档都没有过的仓库永远不说;被忽略的文件与草稿区的改动不算;内容指纹只认修改时间、不读内容;说过之后内容再变不会再说;台账记上了而平台丢了那一次输出,这个状态不会再说;「都已封版」比不到不归任何单元的文件,测试此刻新不新鲜不判;说了之后用户存没存档机器不知道。提速的办法全靠纪律:机器不认档、不核每档的上限,同一处上第二条需求照样签得了字、照样往仓里写得了,握没握手、报没报节点没有机器核。
- v4.21.x
签字题带地址:签字题、验收题弹出之前守卫先核题目正文带没带看板的完整路径与「签字」页签、签字区是不是最新的那一道,缺一样弹不出来;对话框里自己打固定那句、后面跟着话的照认签字
设计指纹5e07f50f内容指纹4bcbbafe测试指纹8c37593959651632改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、SKILL.md);代码 3 个(guard.js、requirements.js、verify-harness.js)
需求签字题带地址签字 71eb已发布
为了:签字题带地址 —— 10-08 验收「主控立规」时,弹到用户面前的验收题题目里没有看板地址,他的原话「在哪里验收啊……怎么丢失了?」「为什么丢失地址这个事情我记得以前是硬控的……要顺带闭环这个事情啊」;后一句是他在验收题的「其他」里照着固定那句打字、跟在后面顺带说的,机器没认,他又点了一遍(10-07 同样白点过一次)。查下来地址从来没有被机器核过:v4.4.6–v4.7.12 写前挂过选项题,核的是选项、三查与预先填好的答案,不核地址;v4.8.0 签字搬进看板之后写前这一道整个摘掉,「题目里写明看板路径」只剩守卫提醒执行者的一句话,验收那一道连这句提醒都没有。这一版把写前这一道装回来,核地址与签字区是不是最新的,并多认一种签法。新增一道闸,升第二位。
- 守卫(写前 · 选项题这一支,新增):分发器多一支管选项题。题弹出之前,先看带没带答案 —— 工具输入里答案一栏不是空的就拦,不分是不是签字题(答案只能由平台在用户点了之后填;报文以「环1 选项题:」打头);再用一句便宜的判断筛掉不可能是签字题的 —— 整道题里「确认」「验收完结」「全选执行」三个词一个都没有的,不装需求零件、直接放;剩下的交给需求零件,一次弹题有几问就逐问各自判。需求零件为这次新增四个函数:planAtStart(名字到哪为止)、askGateWhy(写前逐问判)、onAskAnswers(写后认答案)、onTypedSign(带话的签字)。
- 守卫(需求对账 · 弹出之前逐问怎么判):每一问按固定的先后走,先碰到哪一样不过就拦在哪一样。封口排在最前,这一问认没认成签字题都生效:选项标签以「全选执行」四个字打头的只许恰好是固定写法「全选执行:确认 〈名〉」或「全选执行:验收完结 〈名〉」,不是就不让弹。然后看是不是签字题,只认两种写法,认不出的直接放、普通选项题照旧(读计划目录出错、判不了这一问是不是签字题的,按拦处理,方向是拦不是放)—— 一、某个选项的标签整条恰好是固定写法;二、这一问里执行者写的任何一段字(题目、标题栏、每个选项的标签、说明、预览)写着「确认 〈名〉」或「验收完结 〈名〉」,动词与名字之间隔着空白,〈名〉是一条没完结的计划的目录名或短名,而且名字到此为止(名字里的字只有文字、数字、英文连字符、英文下划线,后面是结尾或不是这几样的字就到头;同一处对上几个名字取最长的那个,最长的那个恰好对上一份计划才算)。被认成签字题的再过下面几样:谁弹的(带执行体身份的不让弹);只签一道(必须是单选题,一问里认出的动词与计划合起来只能是一份计划的一道);认计划(固定写法里的名字对上恰好一份,对不上、对上不止一份、已经完结、账本被直接改过、机器镜像读不了都不让弹);题目正文两样(只看题目正文,不看标题栏与选项,先路径后页签:看板的完整路径 —— 盘符开头的那一整串,正斜杠反斜杠与大小写怎么写都认,但必须正好指到本仓里这份计划的看板文件,后面紧跟着别的文件名字符的、前面紧挨着英文字母或数字的都不算;「签字」与「页签」两个词挨着出现,谁先谁后都认,中间只许隔引号、空白、星号这类不是文字也不是数字的字符,最多四个);签字区(看板里读不到就拦并写明怎么修;读得到再比现成的三个记号 —— 签字区里记着的内容编号等于此刻的内容编号、签字区现在开着的那一道就是这一问要签的那一道、验收题另比结果单编号等于账本目录里落盘的最新一张)。这一步不重算三查,用户点下去那一刻的重算照旧。
- 守卫(需求对账 · 被拦时回什么):被认成签字题而不过的,报文以「环1 签字题:」打头,一次弹了两问以上的前面加「第 N 问:」。认成签字题之后被拦的每一种,回给执行者的话固定带三样 —— 把这一问认成签字题的那一处(哪一段、原文是什么);一句「这不是签字题的话,把这一处改个写法」;这一次不过的是哪一样和怎么改:缺路径的以该写的那一整串看板路径结尾,缺页签的以一句可以照抄的话结尾,签字区读不到的写明开头与结尾标记要成对、缺了先补一对空的再跑带计划名的核对命令,签字区在而没有开着的一道的带着签字区里写着的那句话、不说成去刷新。封口那一支有自己的话:点名那个标签,说这四个字留给签字用;它被拦时的报文同样以「环1 签字题:」打头。普通的选项题撞上了,改一个写法就过。
- 守卫(写后 · 认答案):答案只取平台回的那一份,平台没回才退回工具输入里的。单选题里他自己打的一句(答案的键逐字对上恰好一问的题目、那一问是单选、答案不等于这次弹的任何一个选项标签、也不以任何一个不是恰好固定写法的标签打头),以「全选执行:确认」或「全选执行:验收完结」开头(冒号全角半角都认,各处有没有空白都认)、接着是一条计划的目录名或短名、而且名字到此为止的,照认签字 —— 与点固定选项的一键签同一份判法(看板签字区必须是最新的那一道,验收照旧当场重算三查);名字后面的话去掉打头的标点与空白之后记成他的意见,说的是什么(哪怕是不同意)都照认;整句进原话账本,签字那一笔记的原话是这整句、另有一栏记意见、来路另记一种(对话框里打的,与一键签分开);回给执行者的话末尾带上他的意见,并写明这是他的意见、要当场回应。多选题的答案、认不出属于哪一问的答案,只留「整段恰好等于固定写法那个选项」一种认法,以固定句开头的、贴回的整段看板结论、「确认 〈名〉」一律只记成话。答案以一个不是恰好固定写法的选项标签打头、后面多出一截的,整句只记成话,哪一种签字都不认(写后这一处的「恰好固定写法」指匹配固定写法、而且名字对上恰好一份计划)。这两种情形,只有这句长得像签字时(以「全选执行」开头、是贴回的整段结论、是固定句)守卫才回一句说明为什么没记签字,别的不回。答案整段等于某个选项标签的,照旧只认恰好是固定写法的那一种(执行者把固定句加一段话写成标签、用户点了它,不认);带执行体身份的答案照旧不记、不认。
- 守卫(说给执行者听的三句):签字作废时的两句、没有在办需求时的一句,里面的「写明看板路径与步骤」改成说准的 —— 题目正文写上看板的完整路径与「签字」页签,缺了这道题弹不出来;题目里写明「请点第一项,或照第一项的字打,后面可以加话;别的说法不算签字」。
- 钩子接线文件:写前名单加上选项题这个工具(AskUserQuestion),只这一处,别的一个字没动。它受写保护,是用户开闸之后改的;开闸由用户做,关闸由用户授权主控会话代关(把那个键改回在岗的写法),所以它最后一笔改动记在主控会话名下。它不归任何版本单元,所以不在这一版的改动清单里,在这里记一笔。
- 测试(守卫主自测):断言「写前不管选项题」的两条(LZ15、RQ47)改写成新规矩 —— 题里「确认」「验收完结」「全选执行」三个词一个都没有的普通选项题,写前直接放、守卫一个字不说(RQ47),也不装需求零件(LZ15);核「守卫加了分支、名单跟没跟上」的那一条(MR1)照旧通过。新增写前一组 AQ0–AQ55(59 条),经守卫入口逐条弹题:提到动词却没写计划名字的、动词与名字连写的、名字后面紧跟文字或数字的、名字是已完结计划的,认不出、照常弹出;选项里摆着固定写法的,题目、标题栏、选项标签、说明、预览里写着「确认 名字」「验收完结 名字」的,名字后面跟破折号或符号的,被认成签字题、被核;「全选执行」打头的标签后面多一个后缀、冒号写成半角的(封口)不让弹;题目正文缺路径、路径指到别的计划或别处、路径后面多出一个点再加字母或多出字母数字、路径前面紧贴着英文字母、「签字」与「页签」不挨着,各自被拦,报文带着认成签字题的那一处原文、「这不是签字题的话,把这一处改个写法」与该写的那一整串路径或一句可以照抄的话;路径写成正斜杠、反斜杠、整串小写(本机是 Windows)、后面紧跟中文、前面是斜杠的,「页签」写在「签字」前面、中间隔着引号或星号的,照 10 月 8 日那道真实验收题的句式的,都放行;不是单选、一问里认出两个动词或两份计划,固定写法里的名字对不上(名字后面贴着一截的同样按对不上报、不报成一问两道)、对上不止一份、计划已经完结、账本被直接改过、机器镜像读不了,看板里没有签字区或标记不成对、内容编号不是此刻的、开着的不是这一道、在而没有开着的一道、验收题的结果单编号不是落盘那张,各自被拦并写明是哪一样;样样都过的确认题与验收题弹得出;一次弹两问逐问各自判、报文点名第几问(含 10 月 6 日那次真实的两问);带着预先填好答案的普通题与签字题都拦、答案一栏是空对象的不算;带执行体身份的签字题拦、普通题照放;另有一条钉住守不到的边界 —— 动词与名字连写、没带看板路径的题写前放行。新增写后一组 AA0–AA22b(46 条),经守卫入口逐条答题:单选题「其他」里打「全选执行:验收完结 名字,后面一句话」记成验收与完结,打「全选执行:确认 名字,后面一句话」记成签字一,回话带着意见并写明要当场回应,账本那一笔标明是对话框里打的、原话是整句、意见去掉了打头的逗号,整句进原话账本一次,完结之后需求履历「签字二」那一行记着他打的整句;名字后面直接跟破折号、冒号写成半角而且各处没有空白的都认,后面的话是「但第三条不对」的也照认;名字后面紧跟文字的不认,两份计划名字一长一短时不认错;签字区不是最新的不记签字、意见照带,开着的不是这一道的也不记;执行者把「固定句加一段话」写成标签、用户点了它不记,答案以这个标签打头、后面多出一截的只记成话;多选题的答案以固定句开头的、是两个标签拼出的整段看板结论的、是「确认 名字」的都不记,只有整段恰好等于固定写法那个选项的照认并记成一键签;答案的键对不上任何一问、或对上两问的只记成话;带执行体身份的答案不记、不认;工具输入里多出几个假键、平台回的是真答案时只认平台回的那一份,平台没回答案才退回工具输入里的;答案的值是数组而且不止一个非空元素的按多选处理;另有一条钉住同一条守不到的边界 —— 他照着在「其他」里打连写的固定句,写后照记签字。「零件用到才装」的对照表加一行签字题 LZ31(合规的签字题只装需求零件与台账零件、照放),连同它带出的故障注入两条 FM31、FM31b(用得到的零件逐个坏掉都拦并点名坏的那个、用不到的全坏了照常)。主自测由 1305 条变成 1413 条。
- 测试(包着主自测的薄壳床
.claude/hooks/tests/verify-harness.test.js):把这一版的新用例号补进必跑名单;另加一条,核主自测 MR1 那一行印出来的写前名单里有选项题这个工具 —— 守卫写前这一支与接线文件的写前名单两边一起被拿掉时 MR1 自己照绿,由这一条守。 - 测试(签字床
.claude/hooks/tests/requirements-signing.test.js):由 16 条变成 57 条,新增 G15、G15a–G15x、G15e2、G16a–G16o,直接调需求零件的判定函数。弹出之前逐支:名字到哪为止的四样字、同一处对上几个名字取最长的那个、认不认得出、封口、路径(含前面紧贴英文字母或数字的不算)、页签、被拦的话固定带三样而且只看题目正文、只签一道、认计划、签字区、样样都过才弹得出、一次弹两问逐问各自核、谁弹的与几样同时不对时先报哪一样。带话的签字与防替签逐支:记成验收与完结两笔、记成签字一、各种写法都认(后面的话只去掉打头的标点与空白,符号留着)、不同意的话照认、名字没到头的不认、名字一长一短不认错、签字区不是最新或开着的不是这一道时不记而刷新之后同一句记得上、不是以固定那句开头的不归带话的签字管、标签写成固定句加一段话的不记、以不是固定写法的标签打头的只记成话、多选题的答案、认不出属于哪一问的答案、取答案、答案是数组、钉住守不到的那条边界。 - 测试(守卫单元床
.claude/hooks/tests/requirements.test.js):一条用例的标题订正 —— 原来说对话框里的一句话与打字同等,这一版之后不完全同等(对话框的答案先过认答案那一关:多选的、认不出哪一问的、以选项标签打头的只记成话,单选题里自己打的固定句加话另认),标题里写明。 - 测试(反证):在仓外副本上把新加的判定逐处换成空的或改松,共 44 处,签字床里对应的用例每一处都变红;把写前、写后两支的新判定换成空的再跑守卫主自测,新加的用例成片变红;落进真仓之后,改过的三张床(签字床、守卫单元床、包着主自测的薄壳床)经唯一运行器做空壳对照,三张都通过。
- 架构详图:§三 全景图强制层讲签字题的那一句(它说的还是 v4.8.0 之前的样子,一直没跟着改)、§八 挂载那一行(写前名单、写前挂不挂选项题、需求零件坏了哪些事件照拦)、环 1 通道图(加选项题一条)、需求对账一段里讲选项题的三句,改成现状;需求对账一段新增「签字题带地址」「带话的签字」两小段与守不到;「记洞不改」里「写前那一关留着当第二道保险」那一句改成现状(v4.8.0 摘掉、这一版装回);文首版本改成本版。同批订正五处引用这两处结论的旧说法:挂载那一行「写后多出的 Agent 与 TaskStop」改成现状(这一版起写后比写前只多 TaskStop);「对话框一键签」那一句里固定写法的冒号原来印成了半角,改成全角并写明动词与名字之间有一个空格(这一版起半角会被封口拦下,照着抄弹不出题);「贴回经对话框」那一句里「选项只放不构成签字的话」后面补半句现状(v4.15.0 起第一项固定放固定写法那一项,这一版起题目正文不带看板完整路径与「签字」页签弹不出来),当时的叙述不改写;「守卫提速的几处口径」里「弹验收题之前的那一查……弹题被拦」改成现状(那一查 v4.8.0 摘掉;这一版起弹题之前只比现成的三个记号、不重算三查,量仓零件坏了不影响弹题这一步,答完验收题当场的那一查照旧);「看板与机器镜像一致才让签」里「这一核在三处……v4.8.0 起改在核对命令生成签字区时核」订正成现状 —— 此前这一句与代码不符,核对命令里没有这一核:今天只在记签字一、记签字二那一刻两处核,v4.7.12 加的「弹验收题之前」那一处随 v4.8.0 摘掉,核对命令生成签字区时不核,这一版装回的写前那道闸也不核,想在弹题之前先核一遍可以手跑守卫需求零件的 --hash 那条命令。带版本号的旧版选项题签字那几段叙述没动。「组队与执行体」里「执行体弹签字题写前拦」那半句一个字没改 —— v4.8.0 写前摘掉选项题之后它落了空,这一版起重新成立。
- 决策记录:新增 ADR-92(为什么只认两种写法加一条封口、为什么只核题目正文两样、为什么只比现成的三个记号不重算三查、带话的签字为什么照认且反对的话也照认、防执行者替签靠哪五条、一问只签一道、测试题与现场验证;否决了弹题前重算三查、把一键签写法放宽成后面可跟任何字、枚举「全部执行」等说法、多选答案按逗号拆、核「那里列着什么」、仓外一次性探针验平台)。签字的形态不变,是在 ADR-78、ADR-79、ADR-86 上加一道写前的闸、多认一种签法;ADR-78 决策④、ADR-79 决策②、ADR-77 决策③ 各有半句的现状变了,在新条目里逐条写明。既有条目一个字没改。
- 说明:体系守护技能与业务开发技能的说明里,讲「弹一道对话框接他」的那两段整段改写。原来写着「选项只放不构成签字的话」「不认选项标签」,从 v4.15.0 有了一键签起就对不上了。改成:单选题,一问只签一份计划的一道;题目正文写上看板的完整本地路径与「签字」页签,缺了这道题弹不出来;题目里写明「请点第一项,或照第一项的字打,后面可以加话;别的说法不算签字」;第一项固定放固定写法,另两项「看板我打不开,发我路径」「稍后再弹」;不要带着预先填好的答案弹题;他在「其他」里粘看板「复制结论」的整段照旧认,打固定那句、后面跟着话也认;选项标签只认恰好是固定写法的那一种。业务开发技能说明里「共同的规矩」那一句同批改成现状。
- 项目架构设计页同批改(门一多一条硬控,门四与第十节里讲签字的几句跟着改),那是它自己的一版(v1.4.0)。
- 关闸后的现场验证(标准 8):守卫与接线文件落进真仓、关闸之后,在真实会话里做了三样。一、确认写前拦截在岗 —— 接线文件里那个键是在岗的写法;同一时段故意发了一条该拦的命令(node 的输出接截断命令),被守卫当场拦下,写前拦截在那个会话里确实在岗。二、弹一道不带看板路径的测试题 —— 题目正文里写着「测试」与「验收完结 签字题带地址」、没有看板路径,不摆固定写法的选项,选项只放不构成签字的话(漏出来点哪个都签不成):守卫在它弹出之前拦下,用户没有看到这道题。时刻:2026-10-09 17:57(北京时间)。守卫回的原话:「⛔ 环1 签字题:这一问被认成了签字题 —— 题目正文「验收完结 签字题带地址」。这不是签字题的话,把这一处改个写法(比如动词与名字别隔着空白连着出现)。是签字题的话,这一次不过的是「题目正文」:缺这份计划看板的完整路径(题目正文里没有这一串;这一串前面紧贴着英文字母或数字的不算,那不是盘符开头;后面紧跟着英文字母、数字、下划线、连字符、斜杠,或一个点再加字母数字的也不算,那指的是另一个文件)。把这一串原样写进题目正文:〈看板在本机的完整路径,略〉」—— 照录,只有末尾「该写的那一串」不抄:那是这份计划看板在本机的完整路径,计划完结后会删,不进受治文档。平台回给执行者的整行以「PreToolUse:AskUserQuestion hook error:」打头,这一截是平台加的,说明是平台在选项题弹出之前叫的守卫。三、紧接着弹一道普通的选项题,照常弹到用户面前,他点了一项,答案照常收到。依据另有两样:官方文档写明选项题弹出之前会经过这一类钩子、钩子以退出码 2 结束就等于拒绝;本机 10-03 的会话记录里,选项题被这一类钩子真实拦下过四次(那是六天前的平台版本)。验收那一刻当着用户再弹一次同样的测试题,由他亲眼看,那一次不记在这里。
- 守不到(六样写进了架构详图 §八 与项目架构设计页门一,这里照列,不许读成「签字题从此一定写得清楚」):「那里列着什么」机器不核 —— 题目里有路径、有「签字」页签这几个字就放,写得清不清楚靠执行者;写前拦截摘下(开闸)期间这道闸不在岗 —— 不带地址的、多选的、带答案的签字题都弹得出来,用户答完之后的认定照常,开闸时预先填的答案只有平台没回答案的时候才可能被当成答案;签字区新鲜度只比现成的编号、点下去那一刻重算仍可能对不上 —— 弹题之前不重算三查,也不核看板正文与机器镜像一不一致,只比那三个记号,对不上时照旧告诉执行者刷新重弹;「全部执行」这类不以固定句开头的话照旧不认;认不出的题不核地址 —— 两类都不被核:不提固定句的(执行者弹一道既不摆固定写法、也不提固定句的题来接粘贴),提了固定句、但写成机器认不出的样子的(动词与名字连着写、名字后面紧跟别的字、名字加了引号,其中连着写的那一种,用户照着打「全选执行:确认名字」还签得成),靠工作流说明里「签字题第一项固定放固定写法」的规矩;路径只核指到这份计划的看板文件、打不打得开不核。另两样只在这里与架构详图里说:钩子接线文件不归任何版本单元,写前名单哪天被改回去,只有守卫主自测里核名单的那一条会红,没有别的东西逼着重跑它(报给主控,归这条线后面的小条或守卫盘点);直接在对话里(不经对话框)打「全选执行:……」不认,要它也认另开一条小需求。还有三处要说在前头:现场验证只验了当时那一个平台版本、领队在对话窗口里弹题这一种方式,平台一换版本要照架构详图 §八「挂载」的规矩重核;写前新挂的这一支是全仓共用的,守卫启动失败、或题里有那三个词而需求零件装不上时,选项题一律弹不出来(方向是全关不是放行,所有会话都受影响);两份工作流说明里「第一项固定放固定写法」「题目里写明怎么答」是规矩,题目里有没有那一句、另两项放的是什么,机器不核。
- v4.20.x
发布查全站:发布准备时在本机把每张页面写死的引用逐条核一遍;新文件传完、换首页之前把每个文件在每个访问入口各比一遍
设计指纹5defcb9f内容指纹66696025测试指纹ab5b1ab5d09df5c4改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、x-deploy-dev-arch.md);代码 3 个(release.js、stage.js、site-refs.js)
需求发布查全站签字 22c8已发布
为了:发布查全站 —— 10-08 第二次关着闸发完治理站点,想照技能说明把整站按页面里写的引用抓一遍,没抓成:这一步一直只是技能说明里的一句话,靠当时的会话临时写一个仓库外的脚本去做,而没有在办的需求时守卫不让跑仓库外的脚本(守卫没有错)。发布工具现成的两步各缺一半 —— 发布准备只核首页引用的文件在不在,新文件传完只在默认域名上比、访问域名要等换了首页才第一次被比到。把「查全站」做进这两步:不动守卫、不新增步骤、不再靠仓库外的临时脚本。新增两样核对,升第二位。
- 发布库(发布准备 ·
release/stage.js):首页按内容改名、改写之后,联网读线上清单与建档案目录之前,新增一道全站引用核对 —— 拿这一版上线后的样子(文件名用改名之后的、首页用改写之后的)交给新零件核,有一条不过就抛错:不留下发布档案、线上零改动、连线上都没去读;有「清单里没有」而且首页改过名时,报文另加一句写明改成了什么名。通过时把核了几张网页、几份样式表、几条引用记进发布记录的准备那一步(steps.prepared.siteRefs),发布档案摘要多一行「全站引用核对通过」;记「准备发布之前过了哪些检查」的那一栏一个字段没加。零件交回的结果里一张网页都没有(首页一定是一张)就拒绝准备 —— 核对没真跑起来不当通过。原来只管首页的两处核对(首页含以 / 开头的引用、首页引用了产物里不存在的文件)并进了全站核对;「没带指纹的按需脚本」那条拒绝还在,排到了全站核对之后;那两处核对并走之后,改名那一段会先碰到产物里没有的文件,补了一句跳过改名、由全站核对点名;首页解析里没人读的一个字段同批删掉。后台、手机网页版、官网、治理站点都经这同一个发布准备,同一套判法,没有例外名单、没有按站点分支。 - 发布库(新零件 ·
release/site-refs.js):全站引用核对的判法只住这一个文件,纯计算 —— 不读盘、不联网、不引发布库别的文件。网页只认真标签上的 href 与 src(属性名不分大小写,值带不带引号都认,同名属性只认第一个);浏览器只当字读的地方不算(注释;脚本块、样式块、页面标题、文本框、关着脚本时才显示的那一块等从开标签之后到各自结束标签的那一段,这些标签写成自闭合时照空标签往下读);样式表认 url() 与 @import。空的、只有锚点的、带协议的、以两个斜杠开头的不核;其余每一条按它所在文件的位置照浏览器的规矩解析,去掉问号与井号后面的部分、解掉引用里写的百分号转义,必须逐字(区分大小写)等于本版发布清单里的一个文件,或正好是站点根目录。不过的分五类:以 / 开头的站内引用(恰好拼得出一个存在的文件也不放过)、爬出站点根、指向目录而不是文件(只有正好落在站点根目录的放行)、只差大小写、发布清单里没有这个文件。报文点名文件、引用与类别,最多列三十条并写总数。零件自己不抛错:网页、样式表写得再坏也交回结果。认什么、怎么判、查不到什么、会多报什么、读法到哪为止,都写在它的文件头上。 - 发布库(新文件核对 ·
release/release.js的 assets 检查点):从只在默认域名上比,改成对发布档案里记下的每个入口都核(准备发布时定下并记进档案的:默认域名 + 网站注册表登记的每个访问域名)。先默认域名,首页那一组(首页、构建名片、发布清单)之外的每个文件都取得到、逐字节一致;它不过,这一次就不再去核访问域名,提示里写明这一次没有核。再每个访问域名:先取一个文件探路,最多 3 次请求,取不到回答(连不上、超时,或 3 次都是服务器出错)就判这个入口不通、其余文件不再逐个试;拿到了回答(哪怕是 404)才把全部文件逐个比。任何一个入口有一个文件不过,这一次不记通过;通过时这一步记下每个入口各核了多少个文件(steps.assets.entries)。不过的提示分两种:默认域名上有文件不过,重新上传再跑;默认域名全过、只有访问域名不过,不要换首页、先原样重跑一次、两次都不过再查该域名的网关路由。检查点的名字与先后(前提表)、换完首页之后那一步的判法都没动。 - 测试(发布流程床):新增两组。一组守全站引用核对(直接调准备函数与零件):不算错的写法照常成功并记下三个数;各种坏写法逐条被拦并点名页面、引用与类别;不过就不留档案、不读线上;超过三十条只列三十条并写总数;四种发布类型同一套;另有一批钉零件读法与判定细节的用例(只读两种文件、判定表、残缺输入不抛错、只当字读的标签整段跳过、脚本块里像注释的那一层、所在目录名不二次解码、自闭合照空标签读)。一组守新文件核对(起本机假线上走真检查点命令;假线上多了第二个访问域名入口,并能只对某一个入口回 404、掐断连接、回服务器出错、回内容不对的文件):只有访问域名入口取不到一个文件、登记两个访问域名只坏第二个、访问域名上取得到但内容不是这一份,都不记通过并点名入口与文件,第一种另验了换首页之后那一步被拒;访问域名整个不通时只花探路那几次请求,探路拿到回答则接着逐个比;两种提示;检查点名字与先后、记检查的那一栏没多字段、带访问域名的全流程照旧走通。同批改了两处旧断言:原先钉着只管首页的旧报文的两条,改成全站核对的报文。
- 测试(反证):在仓外副本上每次只改坏一处、跑这张床 —— 把新文件核对改回只走默认域名,守「每个入口」「探路」「两种提示」的用例变红;把引用核对换成永远没问题的空壳,守引用核对的那一组用例里,除了只验报文怎么写的那一条(它不经引用核对本身),其余都变红;去掉探路,守探路的用例变红(报出实际发了多少次请求)。写代码的工程师做过一遍;另一位没参与的测试工程师独立重做时,试出新文件核对那一步有四处床咬不住(登记两个以上访问域名时只核第一个、访问域名上只看取不取得到不比内容、入口不通时给成重新上传的提示、探路拿到 404 也当成入口不通),四处都补成了用例,并各自反证变红;定稿之后,前面那三处(只走默认域名、空壳、去掉探路)与「探路拿到 404 也当成入口不通」这一处又在仓外副本上各重做了一遍,对应用例都变红、别的用例没有被误伤。
- 测试(部署技能自测床):发布库的文件名单加上新零件;新增一组三条,钉部署技能说明里那一步的改动 —— 旧的手工那一句全文不出现、新的说法逐字在、讲每一步核什么的那张表里上传新文件那一行恰有一行并写着每个入口。三种改回旧说法的写法各自让它变红。
- 说明:部署技能的说明里,治理站点流程「换首页核对通过后按页面里写的引用把整站抓一遍」那一步删掉,改成由发布准备的全站引用核对与 assets 检查点的逐入口核对承担;四个站点流程的发布档案那一步写上先过全站引用核对;「静态托管发布执行」一节写明发布准备先在本机核引用、上传新文件那一行核的是每个入口、这一步不过的两种提示、通过过一次之后再跑不过没有机器挡、一次发多个端时前面的端已备好的档案留着。脚本架构文档同步:文件表加上新零件,发布准备与检查点两行、各流程图与依赖图改成现状。
- 架构详图:§八 上传档案闸那一条补一句 —— 换首页的上传以 assets 检查点通过过为前提,这个检查点现在对每个入口都核,守卫这段一个字没改,通过过一次之后再跑不过守卫照旧放行(守不到);§九 新增一段「发布准备的全站引用核对与新文件逐入口核对」,写清两半各核什么、为什么是这两半、与治理站点构建器产物验收的关系、代价与守不到;文首版本改成本版。
- 决策记录:新增 ADR-91(拆成「准备时本机核引用」与「换首页前逐入口核文件」两半;否决放松守卫、把临时脚本原样搬进仓、新增检查点、并进换完首页之后那一步、设例外名单;相对旧行为收紧与放开了什么;仍查不到的全表)。不取代任何一条既有决策。
- 同批的 x-deploy 规范域:条款书讲检查点的两处与架构页(设计机理、取舍、测试床点名、诚实边界、数据链图的两处说明)改成现状,五个站点各自最近一份发布档案按新规则空跑的结果表写在那一版的变更历史里 —— 那是它自己的一版(v3.10.0),判据与检测器没动。
- 没动的:守卫目录下的任何文件;检查点的名字与先后;四个部署脚本;发布前测试的推导;线上核对的取法(重试几次、怎么绕开缓存)。没有新增步骤、没有新增命令。
- 落地时的只读实测(2026-10-08):五个站点各自最近一份发布档案按新规则空跑,不过的引用都是零条;拿治理站点线上现行那一版的发布记录副本(仓外)只读跑了一遍新的 assets 核对,默认域名与访问域名两个入口全部逐字节一致、没有被限流。后台、两个手机网页版、官网「每个文件在访问域名上取得到」第一次真跑,是它们各自的下一次发布。
- 守不到(全表在 ADR-91、x-deploy 架构页的诚实边界与新零件的文件头,这里点最要紧的;不许读成「不会漏」):这两样核对通过,说明的是「读得到的站内引用都指向本版要发布的文件;其中首页那一组之外的文件,在档案里记下的每个入口上此刻取得到、内容对(首页那一组换完首页由 live 检查点比)」,不是「全站没有断链」。只核写死在网页与样式表里的 href、src、url() 与 @import:脚本运行时拼出来的地址、别的属性与带前缀的写法、行内样式、关着脚本时才显示的那一块、别种文件里的地址、锚点存不存在都不核。读法只照浏览器分词的规矩走:只当字读的标签在普通网页里写成自闭合、里面又夹着没收尾的注释或引号时,更后面的真标签会被吞掉(漏),这一处没有钉用例;内嵌图形与下拉框里面的判定可能与浏览器不一致。少见的命名字符写法、页面直接引用发布清单自己,会被多报成「清单里没有」。四个部署脚本产物闸里原有的、按文本扫「以 / 开头」的检查没动,排在发布准备前面 —— 「注释里的不算」只在发布准备这一道里成立。一次发多个手机端时逐端准备档案,后面的端引用不过,前面的端已备好的那份档案留在盘上。assets 检查点通过过一次之后再跑不过,只记一笔失败、不撤掉先前那次通过,换首页的前提与守卫都还认先前那次 —— 这时「不要换首页」只是提示。首页那一组之外没有文件的站点,访问域名不会被核到。访问域名上被限流会判成不过(提示里叫做的第一件事就是先原样重跑一次);探路「超时」那一种床上没有走。从没通过过这一步的档案,换首页那次上传是守卫在写之前拦的 —— 开闸期间写前不在岗,那时只剩换完首页之后那一步事后拒绝。入口只认档案里记下的那一组,注册表没登记的域名不核。这两样核对没有系统规范的闸守着:被改坏了,只有发布流程床会红。
- 发布库(发布准备 ·
- v4.19.x
主控立规:一个主控会话守顶层、每条需求线交给一个工作会话、具体的活交给 agent;运作方式写进宪法与架构详图,今天没有机器拦的地方照实写出来
设计指纹8246db69内容指纹ed274a1b测试指纹db4cd9be6f187cc9改动设计 3 个(CLAUDE.md、harness-engineering.md、ADR.md);代码 0 个
需求主控立规签字 7689已发布
为了:主控立规 —— 用户 10-08 定:他平时只和一个主控会话说话,主控守「宪法 + 四类架构 + 六层」这个顶层、不办实施,专项的事交给别的会话与 agent,并且要拆成多个上下文。此前架构详图只写了「领队只派活、不替关口放行」,没有分守顶层的会话与办需求的会话;做到一半遇到顶层问题是停是不停没有规矩;四类架构与六层是什么关系宪法里没定,执行体又被叫作「第四类受治工件」,与第四类架构撞名。这是这条线的第一条:只立规矩、不改守卫,每条规矩今天是机器在拦还是靠纪律照实写。新增一类东西(三层运作方式与四条规矩),升第二位。
- 宪法:§三 加「两把尺子」—— 四类架构(业务、系统、框架、项目)说设计写在哪,六层说谁管谁、属于框架架构;§四 加「运作方式」—— 主控会话只有一个、守顶层、不办实施,每条需求线交给一个工作会话、它自己带 agent,顶层的需求由主控立项、同一时刻只办一条,并写明顶层指什么、不改代码的小事主控直接派一个 agent、主控与工作会话在各自的会话里都是领队;§四 把「第四类受治工件」改叫「执行工件类」;§五「反向反馈」下加遇到顶层问题的两种走法 —— 会让手上的需求做错或做不下去的停线先修顶层,别扭但能照规矩做对的记下来、做完再修。只写定性,机制与今天靠什么都不进宪法。
- 架构详图 §十五「角色与六层各归谁」:加一张角色表(需求方、项目经理、主控、工作会话、agent 五行,各写做什么、不做什么),原来「领队 = 主会话」那一句拆成主控与工作会话两行;写明此前的「领队」「主会话」指一个会话里派执行体的那条主线、主控与工作会话在各自的会话里都是领队;写明顶层指整个框架、各系统规范域、项目架构三类版本单元锁住的东西;写明这张表今天靠什么。执行体按层那张表没动。
- 架构详图 §十五 补四段:遇到顶层问题的两种走法(红灯停线、黄灯记下来;发现的会话当场自己停,暂停与恢复由用户发话,放行权归体系)、需求切小到一次封版收得了口、开闸与发布与全量测试由主控排窗口、主控怎么交接。每段末尾写「今天靠什么」,逐句对着守卫、版本契约、封版命令、测试运行器的现状。
- 架构详图 §十五「四类受治文件」去掉计数、补上项目架构,加一句与四类架构的区别;「动机」末句的「第四类受治文件」改成「一类受治文件(执行工件类)」。文首版本改成本版。
- 架构详图 §八「组队与执行体」顺带订正一个分句:此前写「写域只列不拦」「结果单列出谁写了什么」,说大了 —— 写域机器不判、也不拦;结果单「谁写的」一栏只列领队与各执行体名下各几个文件、以及共写的文件名。只订正这一个分句,不改设计。
- 决策记录:新增 ADR-90(三层运作、两种走法、需求切小、排窗口、交接、两把尺子;否决了什么;在 ADR-75 的角色上加一层区分、不取代它)。
- 代码与测试:没动。守卫、检测引擎、封版命令、测试运行器一行没改。
- 项目架构设计页同批改(第十节加谁在哪个会话做什么、两次签字在哪签、遇到顶层问题怎么办;诚实边界加五行),那是它自己的一版(v1.3.1)。
- 守不到:这一版立的规矩大半靠纪律 —— 守卫分不出哪个会话是主控、哪条需求是顶层的;没有「暂停」这个状态;交给工作会话的需求,两次签字都要去那个会话签;做到一半记下的发现写在计划里,计划完结后删掉,需求履历不带它;换主控没有手续。机器今天管到哪,逐条写在架构详图 §十五 各段末尾与项目架构设计页的「诚实边界」里,这里不抄。「第四类受治工件」这个说法在三处现行文字里还在,这一版没有改:执行体注册表(同一份里「领队是主会话 …… 主会话写计划」一句也与新的角色表对不上),执行体治理规范的判据简介,执行体治理规范的系统架构页 —— 前一处受写保护,后两处属于系统规范域的版本单元,都不在这条需求的落点表里,留给后面的需求。执行体注册表与业务架构专家的定义不在这次的范围里(两份里指着本文 §十四、§十五 的那几句没有同批回看)。
- v4.18.x
发布只查原料:部署门的待检清单对治理站点、官网、手机网页版只数这次发布物的原料目录;回滚与清理旧文件不看仓库状态;治理站点发布准备当场扫一遍要公开的内容
设计指纹310fdb52内容指纹ed274a1b测试指纹db4cd9be6f187cc9改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、x-deploy-dev-arch.md);代码 8 个(guard.js、mcp-policy.js、session-ledger.js、stop-handler.js、worktree-probe.js、verify-harness.js、deploy.js、hosting-scope.js)
需求发布只查原料签字 17e1已发布
为了:发布只查原料 —— 10-08 关着闸发治理站点,第五次被部署门的待检清单拦下:点名 624 个改动,没有一个在站点自己的目录里(此前 10-04、10-06 各一次、10-07 两次同样被拦,五次点名的文件都与站点无关)。此前只能请用户开闸才发得出去,这一次用户要求不绕、暂时不发、先把守卫这条判断处理好。病根是待检清单数的是「工作区里此刻有多少在途改动」,不是「这次传上线的东西查过没有」;发布路上的测试早已按被发布物推导,检测这一半还停在数全仓。改既有闸的判法并新增一步扫描,升第二位。
- 守卫(云端策略 · 静态托管的上传与删除):一次调用里全部条目都是回滚上传(发布档案的回滚目录)时放行,结论不带「进部署门」的标记;清理清单内的删除、回滚删除清单内的删除(首页换回已核对)同样。这几种不往线上放新内容,守卫里「看仓库状态」那一整段因此都不进 —— 不只待检清单与发布前版本比对两臂,这一段开头的量仓(版本库命令出故障、生产形态下仓根不是版本库、台账首次建立,这三种本来都按拦处理)与这一段的部署门总时限检查也不发生;只由上传档案闸把关。只要有一条是往线上放新内容的上传,照旧进部署门,并把这次调用涉及的站点目录与各发布档案记的种类带给部署门。原有的每一条拦截判据一个字没动;路由与域名的写动作照旧进部署门。
- 守卫(部署门 · 待检清单的范围):往线上放新内容的上传恰好落在一个站点、而且站点认得出是治理站点、官网或手机网页版(手机端名册里的端)时,待检清单只数这个站点原料目录里的改动 —— 治理站点 x-harness/,官网 x-website/,手机网页版是端目录加 x-core/mobile/、x-core/tools/。原料目录取发布前测试的同一份定义(发布库的 inputDirsOf),路径从仓根开头逐段比,中段带同名字样的、只是前缀相同的别的目录都不算。站点从这次调用要传到的托管目录认,发布档案记的种类只拿来对一遍。认不出的一律照旧数全仓:站点是后台、站点不在手机端名册里、一次调用跨站点(涉及的站点不是恰好一个,两个手机端同传也算)、档案记的种类为空或与站点对不上、发布库装不上或抛错、原料目录为空、含空串或不含站点目录。云函数、云存储、数据库、权限、网关这些变更类调用的判法不变。
- 守卫(范围零件 · 新文件):算范围的判法住新增的
.claude/hooks/guard/hosting-scope.js(算范围、出报文里「只数了……」那一句),不触盘、不装别的零件。守卫主文件新增一个函数,把手机端名册与发布库的原料目录取法装好交给它,装不上就交空的 —— 名册空了手机端一律认不出,取法空了哪个站点都认不出,认不出就照全仓。范围零件用到才装(只有带着站点信息的上传走到部署门时);它自己装不上走守卫启动失败(退出码 2、点名坏的零件),不悄悄照全仓 —— 发布库是守卫之外的东西,坏了退回更严的判法;范围零件是守卫的一部分,坏了就是守卫坏了。 - 守卫(部署门 · 报文与版本比对):被待检清单拦下时原有两句不变,收窄时另加一句写明只数了这次要发的哪个站点的哪些目录、范围外另有几个没数。紧跟的发布前版本比对一个字没动:往线上放新内容时,仓里任一版本单元没封版、封版后改过照样拦。开着闸时的写后补判走同一份代码,判法自动一致。收尾时提示「有无主改动复核未过」的那一句附注改了说法:不再一概说部署门会挡,只说发布时落在部署门待检范围里的会被挡。
- 守卫(会话台账):待检清单的出口多一个可选的第三个参数(范围目录数组),不传就是全仓;有版本库与没有版本库两种形态同一个判法。返回的数组上另挂两样:这一次是不是真按范围数的、范围外另有几个没数。范围的写法认不出(不是数组、空数组、任一项不是规范的仓根相对目录)时照全仓数,并如实标成没按范围数 —— 守卫只在范围零件给出了范围、台账也真按它数了时才在报文里说「只数了」。
- 守卫(注释):守卫主文件、会话台账、云端策略、工作区探针、收尾零件里写着「全仓」「不问是谁的 —— 推上生产的是仓库状态」「叠加,不替换」「由部署门挡」的几处改成现状。
- 治理站点部署脚本:产物闸里、产物验收通过之后加「公开内容扫描」—— 对受治文档树与站点目录各跑一遍治理规范的扫描(含查真实手机号、证件号、密钥、邮箱的那一条),两段结果都打印,任一次不过产物闸就不过:不打发布档案,线上零改动。10-08 实测受治文档树三百多个文件、站点目录不到十个文件,零违规,各两三秒。
- 测试(守卫主自测):新增一组场景 DS1–DS23,另有 DS11b、DS12b,并改了 HS24 的夹具。DS1–DS3 治理站点只数 x-harness/(范围外有未复核放行、范围内有未复核拦并只点名它、路径中段带同名字样不算);DS4、DS5 官网只数 x-website/(同名前缀的兄弟目录与后台目录下的放行、x-website/ 下的拦),HS24 换成同一口径的夹具(官网原料目录里有未复核仍拦,后台目录那一个不数不点名);DS6a、DS6b、DS6c、DS7 手机网页版(端目录、x-core/mobile/、x-core/tools/ 各拦一次;x-core/server/、别的端目录、同名前缀的兄弟目录放行);DS8–DS12 与 DS11b 认不出照全仓拦(后台、站点不在手机端名册里、档案记的种类与站点对不上、一次调用跨两个站点、两个手机端同传、发布库装不上);DS12b 范围零件装不上走守卫启动失败(退出码 2、点名坏的零件),不悄悄照全仓;DS13–DS19 回滚与清理(仓里到处是未复核改动并且有单元没封版时,回滚上传、回滚删除、清理清单内的删除放行;清单外的删除、检查点顺序不对的回滚上传照旧被上传档案闸拦;对照:同一现场下往线上放新内容照拦;写后补判回滚上传不记);DS20 范围内干净、范围外有未复核、有单元没封版时被拦,报文说的是版本没封、不是待检清单;DS21–DS23 报文里的目录与个数,写后补判范围外不记、范围内记下与写前逐字相同的那一句。云存储、数据模型、云函数的既有场景原样通过。包着主自测的那张薄壳床把这些编号补进必跑名单,核它们真跑到了;它的床头另加一行 @covers,点名发布库的
.claude/skills/x-deploy-dev/scripts/release/publish-tests.js—— 这组场景起的真守卫按自身位置读发布库的原料目录定义,发布库不在守卫目录里、按位置推不到,不点名的话那份定义变了这张床的旧记录仍算数。 - 测试(会话台账床):新增 L24(带版本库的沙箱里造已删除、未跟踪、复核未过三种文件,直接调待检清单的范围参数:范围内三种都在、范围外三种都不在并数进「范围外」、不带范围六个都在、范围写法认不出照全仓)、L24b(没有版本库的形态同一个判法)、L24c(带版本库、守卫住在仓里的沙箱里起守卫走一遍:范围外有未复核时云存储上传照全仓拦、治理站点上传不拦在待检清单上;x-harness/ 下新冒出一个没人复核的文件就拦、清单只有它一个)、L24d(版本库命令出故障时 —— 让守卫子进程找不到 git:先做前置对照,往线上放新内容的上传过了上传档案闸、被部署门的量仓拦下、报「git 测量失败」;再做正题,同一个现场、同一份在用档案的回滚上传照样放行、不量仓。它守的是「回滚跳过的是看仓库状态那一整段,含开头的量仓」;反证做过:把量仓那一行挪到「进不进部署门」的判断之前,这张床只有 L24d 红、红在回滚上传那一步)。床头另加一行 @covers,点名发布库的同一个文件:L24c 把真仓的发布库抄进沙箱,沙箱里的守卫按自身位置读它的原料目录定义。
- 测试(范围零件的床 · 新文件):
.claude/hooks/tests/hosting-scope.test.js,范围零件的纯函数用例 —— 不起守卫、不建沙箱,直接调算范围与出报文那两个函数。认得出的三种站点各一组;退回分支十几条,每条都从一个收得窄的底子只坏一处(档案记的种类为空或混着一份对不上的、不是恰好一个站点、两个手机端同传、名册没给、原料目录的取法没给或抛错、取到空数组、含空串、不含站点目录)—— 这些大半在主自测里造不出来(真发布库不会这样返回);报文那一句逐字核;种类对照表只有治理站点与官网两个;零件源码里没有加载语句、跑完名下没有子模块。 - 测试(部署接线床):新增 C6 —— 治理站点部署脚本的产物闸里两次扫描在场、失败即退、位置在产物验收之后、打发布档案之前,删掉这一步就红。
- 说明:部署技能的说明里,治理站点流程的产物闸写上公开内容扫描这一步;「静态托管发布执行」一节写明回滚上传、回滚删除、清理删除不看仓库状态(不被仓里的改动或没封的版本拦住),检查点顺序与上传档案闸照旧要过;往线上放新内容的上传被部署门拦时报文会写明只数了哪些目录。脚本架构文档同步。
- 架构详图:§八 部署门那一条改成现状(待检范围按被发布物定、认不出照全仓、哪些调用不变、回滚与清理「看仓库状态」那一整段都不进、谁算范围与谁按范围数、这一臂守不到什么);零件用到才装那一段补范围零件;被拦时的先后、写后补判、无主改动与目录级下载「由部署门挡」的几处加上范围限定,收尾附注的新说法写上;静态托管发布面物理闸那一段把「叠在部署门之上、不替换」改成现状,并写清守卫加载发布库里那一个函数与「守卫不依赖系统规范代码」的关系、范围零件装不上走哪条路;§九 治理站点补「发布准备的公开内容扫描」一段(连同它的代价与守不到);§十三 发布那一关补一句回滚与清理不进部署门;§二 并发会话那一行的「由部署门挡」加限定;文首版本改成本版。顺带订正两处旧错:§十六 测试闭环的诚实边界 ⑤ 此前写写后复判「不复判部署门有未复核改动那一臂」,§十三 版本契约的诚实边界 ⑨ 此前写「开闸期间 MCP 的写后复判不含版本比对」,两句自 v4.6.0 起就与守卫不符 —— 写前拦截不是确定在岗时,待检清单与版本比对两臂都补判(守卫主自测 PU14、PU16、VG2 一直守着),只是事后拦不回来;这一版动的正是这一类,两处改成事实,⑤ 另写明真不补的是哪四样。决策记录新增 ADR-89(在这几种调用上取代 ADR-50 决策⑤,并给 ADR-51 否决的「守卫依赖发布库代码」开一个口)。项目架构设计页同批改:门五的射程变了,按它自己的规矩升第二位,那是它自己的一版(v1.3.0)。
- 守不到:待检清单这一臂只看得见还没存档的改动,存档之后一个都不数 —— 它本来就不是墙,墙是发布前版本比对与发布前当场跑的测试。原料目录信的是发布库那一份定义,它写窄了待检范围跟着窄。守着这一份定义的有两样:发布库受写保护、归整个框架这个版本单元,改它要升版封版、跑技能面的床;守卫面有两张床(包着主自测的那张薄壳床、会话台账床)在床头点名了发布库那一个文件,它一变这两张床的旧记录作废、守卫面要重跑(以后改这个文件,按改动选床会连守卫面一起选中,这是有意的)。范围零件自己的床不读发布库,不在此列。床头点名只管「它一变旧记录作废」这一件事;这两张床的结果是不是真依赖发布库,由 DS1–DS7、DS12 与 L24c 这些场景守着,不靠空壳对照证明。以后新增站点类顶层物默认不收窄,要收窄得在范围零件里登记。回滚与清理跳过的那一整段里,场景守着的是待检清单与版本比对两臂(DS13–DS15、DS19)与量仓里版本库命令出故障那一种(L24d);另两种量仓的拦(生产形态下仓根不是版本库、台账首次建立)与总时限检查没有另造现场 —— 它们与前面几样住在同一个分支里,结论不带进部署门的标记就整支不进。后台、云函数与其余变更类调用仍数全仓,关着闸时照旧可能被无关的改动拦。别的会话封了一版之后,站点原料目录里它名下改动的旧结论要等它再收尾一轮才算数。公开内容扫描只管 md 与 html:治理站点取材面里的 json(需求履历的 record.json —— 原样印进页面 —— 与 releases.json、项目架构目录下其余 json、架构设计模板名册,各单元的锁清单与系统架构页的链路图数据同属这一类)与 .claude 之外只把版本号印上页面的文件(x-core/server/package.json、x-admin/package.json、移动端母本包各包的 package.json、各端的工程配置)两次扫描都够不着,也都不在治理站点的待检范围里。扫描跑的是整份治理规范,别的会话在受治文档里任何一处在途的红都会挡住治理站点发布 —— 卡的是要公开的内容,但它仍是「等别人改好」的缩小版。这一版没动:无主改动每轮查 40 个的上限、干净结论随判据组指纹作废、无主批次怎么记账、干净结论与红结论并存时认哪个。
- v4.17.x
脚本去重(第一批):测试运行器能只补跑不新鲜的床,带筛选的运行不再扫全仓做卫生检查,流程里三条多余的命令不再要求跑
设计指纹ff6ef614内容指纹0ea45eb7测试指纹f5897cce53fb7942改动设计 3 个(harness-engineering.md、SKILL.md、SKILL.md);代码 3 个(bed-runner.js、layer-auditor.js、harness.js)
需求脚本去重签字 111d已发布
为了:脚本去重 —— 用户 10-08 要求把全部脚本的效率复盘一次(禁低效、重复执行、重叠执行)。十片只读复盘的结论:单条命令都已经不慢,时间花在测试床与「同一件事做几遍」上 —— 运行器选中就重跑(全体床串行一遍约 30 分钟,大半是对同一份内容原样重跑);按改动、按面、按名字跑床,每次顺带把全仓扫一遍做卫生检查,而这份结果按设计本来就不计;体系守护自测那张床同一套取数原样做几遍;流程说明里有三条命令其实不必跑。这是第一批,只动运行器判定口径区之外的代码与说明,守卫与检测引擎没动。新增一个开关,升第二位。
- 运行器(新开关「只跑不新鲜的」
--stale):选完床之后、起床之前,把账本里「对当前内容已经通过、该做的空壳对照也做过」的床挑出来不跑,汇总里写明沿用了哪几张。认法只有一处 —— 判定模块的面状态(收尾与封版认的同一份账本、同一个状态),是「通过」才沿用;从没跑过、内容变过、上次没过、跳过、登记豁免、还没做空壳对照、没咬住、床头写坏的,以及判不出状态的,一律照常跑。床里调了持锁函数、自报会临时改真仓的照旧跑。登记在部署门的函数床按函数整体交给部署门入口,同一个函数下只要有一张要跑,这个函数登记的床都归到要跑的那边(报成沿用的床必须是真的没起过进程)。沿用的床超过 12 张时只报张数、不逐张列。选中的全都新鲜时一张不起、不拿锁、退出码 0;一张都没选中照旧算失败。不带开关时选中多少跑多少。只在判定口径区之外加了一步筛选,别的床的旧记录不作废。 - 运行器(卫生检查):带筛选的运行(按规范、按根、按套件、按名字、按面、按改动,含只列不跑)不再做全仓卫生检查;不带筛选的全量运行照旧做、照旧计入失败。此前带筛选时照查、只是不计,「只报告不计失败」那一支随之删掉。
- 运行器(顺带修一处老红):需求履历算历史记录,里面提到的旧路径不再当成死床路径。「删复制品」完结之后,履历里照实写着被删掉的那个旧测试目录,全量卫生检查与体系守护自测那张床从那时起一直红(上一版只跑了守卫面的床,没碰到它)。
- 六层体检:有测试面不新鲜时,「测试闭环」那一行下面多印一行,写明怎么只补跑不新鲜的;没有不新鲜的面就没有这一行。测试闭环那一栏的判定模块可以换桩(只供自测喂一份指定的测试面状态)。
- 测试(体系守护自测那张床):新增三条用例 —— 「只跑不新鲜的」(三张真床换桩:要跑的恰好是不新鲜的与自报持锁的、另一张沿用;全都新鲜真跑一次一张不起、锁没人碰;对照同样的锁有一张不新鲜就得去拿锁;不带开关一张不少;零选中照旧失败;只有「通过」一种状态才沿用;自报持锁只认真调用、不认字符串与注释里提到的名字;同一个函数下有一张要跑,这个函数登记的床都归要跑)、「卫生检查只在全量做」(按名字、按面、按改动三种筛选只列不跑都没有卫生这一项;不带筛选时注入的一条假卫生问题报出来并计入失败)、「体检的补跑提示」(喂有不新鲜的面多一行、全部新鲜没有、只差登记豁免没有)。三条旧用例各加一组断言:按名字选床真跑一张时没有做卫生检查;真跑体检命令时提示与报告里的不新鲜面数对得上;履历里的旧路径不算死床路径。同一套取数只做一次、几条用例共用:六层体检的取数、闭环验证的取数(另有命令行那一遍)、不带筛选的只列床各一次(命令行那一层的参数解析与退出码改用带筛选的只列床核,它不扫全仓)。这张床经运行器实测从 76 秒降到 34 秒,原有用例的名字一条不少,空壳对照咬得住。
- 说明:体系守护技能的说明写上新开关、卫生检查的新口径、体检的补跑提示;业务开发技能的说明里,派复盘之前不必再单跑核对命令(生成任务说明的那一条自己会重算并落盘最新的三查结果单),封版预览标成可省(直接执行也是先核后写)。「一圈需求最少跑哪几条命令」写在项目架构设计页第十节,那是它自己的一版(v1.2.3)。
- 架构详图:唯一运行器的取舍改一条(卫生检查只在全量做)、加一条(只跑不新鲜的);卫生检查第 ⑤ 项补需求履历不查;体检那一段补补跑提示;测试闭环的诚实边界 ③ 补新开关沿用的是同一份记录;文首版本改成本版。
- 守不到:新开关认的是账本 —— 在真仓上跑、却没在床里调持锁函数的床,账本里通过就会被沿用(与收尾、封版今天认账本是同一条边界,没有更松);自报持锁按「床里有一行以调用持锁函数开头」认,换一种写法调它的床认不出、同样被沿用。自报持锁的床每次补跑都重跑,眼下 9 张合计约 5 分半,全仓都新鲜时补跑一次也要这么久 —— 值不值得留给下一批定。装配套件被沿用了一部分时,本次跑的不是整套,装配面新鲜度戳不写。体系守护技能自己的设计文档不在这次的落点表里、没有动,它那一段话仍然成立,只是没写新开关。计划的步骤表把改运行器写成「不用开闸」,写错了 —— 运行器与检测引擎同级受写保护;实施时写前拦截恰好停着,改动才落得下去。
- 运行器(新开关「只跑不新鲜的」
- v4.16.x
订正(入口路标):守卫说给新会话听的两句话不再误导 —— 没签字的计划那一行、没签字被拦的那一句
设计指纹13a08d25内容指纹ac84f1cc测试指纹7030d4cbd96aaf5d改动设计 1 个(harness-engineering.md);代码 3 个(guard.js、command-policy.js、verify-harness.js)
需求入口路标签字 fa88已发布
为了:入口路标 —— 「流水线实跑」第 1 轮:把一条真实需求交给全新的会话照项目架构走,它还没开工就被两句话带偏 —— 开场把别人 9 月 30 日那份没签字的计划说成「还没签字,先别动受治文件」,它分不出与自己有没有关系;没签字时命令被拦的提示只说「要改东西先建计划」,而只做分析的会话并不想改东西,照这句话去建计划又签不了字(落点表为空的计划签不了字)。只改说法,拦与不拦的判法一个字没动,升第三位。
- 守卫(开场提示):没签字的计划那一行改成「最后改于 M 月 D 日;它自己还没签字,还不能照它动受治文件 —— 不是你手上的事就不用管它」(日期取这份计划机器镜像的修改时间,读不到就不写日期)。正在办的、签字作废的两种说法不变。
- 守卫(没签字时的命令白名单):每一句被拦的提示句尾补「只做分析就只跑仓里现成的脚本,新的怀疑留到修它的那条需求里先写测试复现」,并指向项目架构设计页的「怎么开一条需求」。白名单本身没动。
- 测试(守卫主自测):新增两条场景 —— SS1c 没签字的计划那一行带日期与新说法、整段输出没有「先别动受治文件」;WL19 没签字时跑仓外脚本被拦、提示带新补的那一句与设计页的路径。包着主自测的那张床核这两条真跑到了。
- 测试(会话台账床,顺带修一处偶发红):L22 最后一步「没有时间窗的文件不归 G」此前靠中间几步的耗时碰巧超过时间窗两端的余量,机器闲、跑得快时不够,那个文件被归到 G 名下、这一步红(这次连红三次,换回改动前的守卫照红,与本版改动无关)。改成明确等过余量再写,余量取台账模块自己导出的那个数。守卫代码没动。
- 架构详图:§八 开工注入那一句补上没签字的计划怎么说,命令行那一句补上被拦的提示写了什么;文首版本改成本版。「怎么开一条需求」写在项目架构设计页,那是它自己的一版(v1.2.2)。
- 守不到:这两句都只是说法 —— 新会话读不读、照不照做,机器判不了。会话中途闸的状态变了仍然没有提示(它去写文件会被拦并说明原因,自己会纠正)。保护名单按路径里的字样认,仓外的守卫副本只要路径里带同样的目录名也会被当成保护目标(这次往仓外复制副本时撞到,换了目录名)。
订正(签字区标改动):签字作废了,签字区就不许说「一字不差」—— 单元名与动不动钱也参加比对,对不出差别如实说
设计指纹5cf10d65内容指纹de440cc0测试指纹9ae3bf96109fecf3改动设计 1 个(harness-engineering.md);代码 1 个(requirement-check.js)
需求签字区标改动签字 cee6已发布
为了:签字区标改动 —— 本需求第二轮入账复盘(结论不过)实测:留底里的单元名从不参加比对,只改落点表里的单元名时内容编号变了、签字作废,签字区的横幅却写「改了 0 条、新增 0 条、删了 0 条,其余一字不差」,用户看不出为什么要重签;动不动钱翻转是同一个毛病。复盘者同时指出 v4.16.3 写明的那条守不到(一个文件既单列在落点表又是用例的测试、两处一起删)可以靠签字那一刻建的在办履历分清。设计结论没变,升第三位。
- 核对命令(签字区的逐条比对):范围组每一行连它归的单元一起比 —— 单元变了的行标「改了」、新单元名标黄、折叠里写之前的;动不动钱翻转算一条改了,横幅单写一句、那一组带「改了」(改成不动钱时那一组没有了,只在横幅写)。
- 对准的依据:签字那一刻钩子建的在办履历带着当时整张落点表(哪个目录归哪个单元、哪一格),履历重算出的内容编号等于那一笔签字的编号才用(与旧账本取底同一道核对);有它就逐行对得准 —— 折叠里是那一行当时的单元与格,两个单元并成一个也对得出,v4.16.3 那条守不到(两处一起删)也照报。取不到就退回只凭留底判。
- 兜底:内容编号变了而逐条都对不出差别 ⇒ 横幅写「没找到差在哪一条,请整份再看一遍」、一条都不标、没有「只看改动的」—— 不再出现「改了 0 条,其余一字不差」。
- 测试(签字床):新增一条,六组断言 —— 只改单元名(没有落点表可对)两行标改了、单元名标黄、折叠里写上次签的单元;有落点表时折叠里是当时的单元与格;并单元有落点表只标那一行、没有落点表如实说没找到且不出现「一字不差」;两处一起删有落点表照报、没有只在用例上报;动不动钱两个方向。
- 架构详图:§八「范围组只比落点表里的目录」之后补本版一段,守不到收窄成「只在取不到签字那一刻的落点表时」;文首版本改成本版。项目架构页门一的「守不到之处」同批补一句,那是它自己的一版(v1.2.1)。
- 守不到:只在取不到签字那一刻的落点表时 —— 一行当时归哪个单元分不出;一个文件既单列在落点表、又是用例点名的测试,两处一起删掉时范围组不报删(用例那一条照报)。格的名字不是签字锁住的,改格名不标。
订正(签字区标改动):范围组只比落点表里的目录,横幅不再多算;验收题的一键签补测试;三处说明跟上
设计指纹397314e9内容指纹362116e1测试指纹a6497954e3923e85改动设计 1 个(harness-engineering.md);代码 2 个(requirements.js、requirement-check.js)
需求签字区标改动签字 cee6已发布
为了:签字区标改动 —— 本需求第一轮入账复盘(结论过)实测出一处毛病并记了几条遗留:留底里「落点目录」那一项是落点表目录与用例点名的测试文件的并集,签字区的范围组却只列落点表里的目录,于是删一条自动用例横幅会写「删了 2 条」、范围组下多出一行把它的测试文件报成删了;换一个测试文件,旧的报删、新的不算新增。另有:验收题的一键签(「全选执行:验收完结 〈名〉」)只有代码没有测试;标黄那条断言的数据分不出「只标改动段」与「全标」;签字作废时守卫的提醒没提对话框里可以一键签。设计结论(签字留底、重签只标改动、对话框一键签)没变,升第三位。
- 核对命令(签字区的逐条比对):范围组两边都只留落点表里的目录,用例点名的测试文件归用例那一条管 —— 它的正文写着「测试:…」,改了、删了在那一条上标。底里只有并集,分不出一个测试文件当时是不是也单列在落点表里:此刻落点表里有它就当它是,没有就当它只是测试文件、不在范围组里报删。
- 核对命令(三查单第一查那一栏):有归已完结需求的改动时,栏名写「归别的需求范围的改动」,括注把两种认法都写出来(完结之前本会话写在它范围里的,或内容与它验收那一刻结果单上记的一样的)—— v4.16.1 多认了后一种,这一句当时没跟上。没有这类改动时栏名与此前相同;单子的编号不看这几个字。
- 守卫(需求对账):签字作废时的提醒补一句「对话框里放一项全选执行:确认 〈名〉,他看过没问题可以直接选」;两处只写了老认法的注释订正(v4.16.1 的遗留)。判定没改。
- 测试(签字床):新增两条 —— 范围组那一条(删一条自动用例只报那条用例、横幅删了 1;换测试文件只那条用例标改了、范围组零新增零删;真删一个落点目录照报;三段里只改中间一段恰好一处标黄、前后两段在标黄之外);对话框一键验收那一条(全绿且签字区是最新的验收那一道 ⇒ 验收与完结两笔都标明来自对话框;他看过之后范围里的文件又变了不记完结;签字区还停在「确认」那一道不认;已完结再选不重记)。
- 架构详图:§八「签字区留底与只标改动」之后补「范围组只比落点表里的目录」一段与守不到之处;文首版本改成本版。
- 没办、写明原因:标准 3 写的是「组标题的括号里写改了 N 条」,成品写在组标题下面那行说明的末尾 —— 位置与用户确认过的预览一致,不动成品也不改标准;从履历取底那一段的测试用的是床里手写的履历、不是签字钩子真写出的那份(字段若不同形只会落到「分不出」)。
- 守不到:一个文件既单列在落点表、又是用例点名的测试,这一次两处一起删掉 ⇒ 范围组不报删(用例那一条照报)。
订正(复盘提速):复盘者的抽查不许绕开超时与关进程、不许单跑会改真仓的床;固定检查「只沿用过了的」等三处说明写实
设计指纹9162da66内容指纹634e9755测试指纹d48ee08bcd341796改动设计 3 个(x-adversarial-reviewer.md、harness-engineering.md、SKILL.md);代码 2 个(plan-checks.js、review-brief.js)
需求复盘提速签字 6d7b已发布
为了:复盘提速 —— v4.16.0 的任务说明里有一句让只读的复盘者「在计划目录里直接跑清单里那一项的命令,或单跑那张床的文件」。直接跑清单里的命令绕开了固定检查那条命令的超时与跑完关进程(真浏览器的检查一项几分钟到半小时,上午用户看到的几十个空白窗口就是这一类没人收的进程);单跑会临时改真仓的床不持跑床的锁,站点床还会重建多会话共用的产物;这一句与同一份说明里「不跑唯一运行器」也对不上。10-07 另一个会话审这批脚本时指出,本需求的第一轮入账复盘(结论过)也把「没过的不沿用」「本命令被杀时子进程收不走」「退出码 124 记成超时」三处记成说明没写到。设计结论(只对着签过字的标准判、给增量与机器结果、可登记固定检查)没变,升第三位。
- 复盘任务说明的生成:「机器已经查过的」一节末尾那一句拆成四行 —— 最多抽查三项、抽查只有两种做法:固定检查读它落在账本目录里的完整输出(写明路径的样子),不自己跑清单里的命令;测试床只许单跑只在临时目录里造沙箱的那种,会临时改真仓、要持锁或会重建站点产物的不跑;拿不准就在报告里写明要执行者重跑哪一项、为什么。逐项列出的状态与命令那几行不变(命令告诉复盘者去读哪份脚本)。
- 测试:任务说明床 B8 补三条断言(两种做法的原话在、交回执行者的那句在、旧的那句不在);文件头「本床守护」一句补上 B4–B9 守的东西。
- 固定检查脚本的文件头:「守不到」补两条(本命令自己中途被杀时,正在跑的那一项连同子进程收不走;退出码 124 一律记成超时),并写明沿用只沿用「过了」的、上次没过的每次都重跑。代码没改。
- 技能说明:「判法与范围」补抽查的两种做法;「checks」一节补「只沿用过了的」与「过不过只看退出码、账本与三查单原样显示退出码,检查想把没跑成与没过分开就自己用不同的退出码」。
- 执行体定义(对抗审查):「不从头重做机器查过的」那一条补抽查的两种做法。
- 架构详图:§八「复盘判法与固定检查」一段里「最多抽查三项」之后补本版的口径与原因;文首版本改成本版。
- 没办、写明去向:固定检查脚本不在守卫的写保护名单里(它决定第二查的一半)—— 这是给守卫加一道闸,不在本需求的范围里,登记给「守卫盘点」那条需求;「没跑成」与「没过」在账本里不另分状态 —— 退出码原样记着、原样显示,再加一种状态不改变任何判定。
- 守不到:测试床「是不是只在临时目录里造沙箱」由复盘者读床头注与代码自己判,说明里没有逐张标;他照旧可以无视这几句(复盘者是只读的执行体,守卫不拦它跑命令)。
订正(完结不误报):已完结需求交付的文件只要内容没再变,就不再算任何会话的范围外改动
设计指纹c5f1c5b6内容指纹244e0dd4测试指纹83993b97ca38fe53改动设计 2 个(harness-engineering.md、ADR.md);代码 2 个(requirements.js、verify-harness.js)
需求完结不误报签字 7443已发布
为了:完结不误报 —— 「归已完结需求、不算越界」只认编辑工具的写证据,而封版命令写出的变更历史与锁清单没有写证据,写入的时刻又可能落在别的会话一条命令的运行期间而被记到那个会话名下。10-07 真仓:「托管限流」验收完结之后,它封版写出的两份文件在另一个会话四条在办需求的三查单上都成了「本会话 2 个范围外改动」,第一查红、验收签不上,而两份文件的内容与它验收那张单子上记的一字不差。设计结论(范围与归属逐个文件判、收尾与三查同一个判定器)没变,只多认一种情形,升第三位。
- 守卫(需求对账):「归一条已完结需求、不算越界」的判定器多认一种情形 —— 文件此刻的内容指纹,等于那条需求验收那一刻结果单「范围里的改动」上同一路径记着的指纹,就归那条需求,不看是谁写的、有没有写证据;内容再变就不再豁免。原有的那一种(落在它的范围里、本会话最后一次写它在它完结之前)照旧。
- 结果单从哪取:账本目录里落盘的那张,只认完结那一笔记下编号的那张 —— 编号对不上(完结之后重算过)、单子里的内容照编号的算法重算对不上(被改过)、单子不在了(临时目录清理过),都一个不认、不报错,照旧按写证据判。结果单用到才读(多数收尾没有范围外的文件);计划目录已删的已完结需求同样取得到。
- 收尾对账的两支(有在办需求、没有在办需求)与三查结果单仍共用这一个判定器:三查单把这类文件列进「归别的需求范围」一栏并标「已完结」,不计入「本会话的范围外改动」;收尾对账不再为它点名。
- 测试:需求对账床新增一条(判定器:内容对得上就标、对不上不标、清单里没有不标、在办计划盖住的不标、旧形态条目不抛错),完结那条路的用例补一组断言(没有写证据记在本会话名下、换一个会话、完结后又写但内容没变都不拦;改一个字拦一次;结果单重算过、被改过、不在了都不认;没有在办需求那一支同样;计划目录删了之后交付清单照样取得到),并把原先「完结之后用同样的内容再写一遍也拦」的三处断言改成「完结之后改了内容的照拦」—— 同样的内容再写一遍仓里没有任何东西变,按本版不算改动。核对命令床新增一条(三查单与收尾对账同一口径的四步)。
- 守卫主自测(订正上一版留下的暗伤):它把三查脚本抄到临时副本里跑「贴回验收结论 → 记完结」那三行,v4.16.0 起三查脚本要装同目录的固定检查脚本、副本里没跟着抄 —— 当场重算的单子多出「固定检查模块读不了」、编号与落盘那张对不上,三行都不记完结。本版补抄。真仓里两份脚本本来就在一起,验收完结这条路没受影响;坏的只是自测的副本。它没在 v4.16.0 封版时暴露,是因为这张床的指纹只含守卫目录、不含它经守卫间接跑到的三查脚本,那一版没让它重跑(见守不到)。
- 架构详图:§八 需求闭环「守卫提速的几处口径」之后补「完结不误报」一段与守不到之处;文首版本改成本版。
- 决策记录:ADR-88(判据是「此刻的内容 = 验收那一刻结果单上记着的内容」;否决让封版命令给自己记写证据、把已完结需求的范围整片豁免、改命令时间窗的归属算法、让受影响的会话重记基线)。
- 守不到:结果单的编号只有四位,是核对不是防伪造;临时目录清理之后这类文件会再被点名一次(方向是多拦不是放行)。守卫主自测经守卫跑到技能目录里的三查脚本与固定检查脚本,这两份不在它的指纹里 —— 只改它们时这张床的旧结论不作废,要靠改的人自己记得重跑守卫那一面(本版就是这样漏过一次);补法(把这两份算进它的上游)留给守卫盘点那条需求。
复盘提速:复盘只对着签过字的标准逐条判、只看增量、直接用机器检查的结果;一条需求可以登记固定检查
设计指纹ccf0034c内容指纹83fd4a4a测试指纹4a5734e25a214e6a改动设计 4 个(x-adversarial-reviewer.md、harness-engineering.md、ADR.md、SKILL.md);代码 4 个(requirement-check.js、review-brief.js、harness.js、plan-checks.js)
需求复盘提速签字 6d7b已发布
为了:复盘提速 —— 「入口页模板」入账复盘十五轮都不过,一轮一个多小时:复盘任务说明只写「要证明它错」,找到任何一条就判不过,题目没有边;机器检查的结果没有固定的地方给复盘者用,他每一轮从头重做、工具每轮重写(实测最近两轮复盘本身 54 分与 75 分,真正查改动的只有十来分钟)。用户 10-07 原话「十五轮了依然无法闭环……一轮下来一个多小时……如果十分钟一轮……只要不复杂化,多几轮也不是不行」。10-07 照新做法试跑一轮:同一个执行体、同一个模型,12 分钟、结论过。新增「按标准判的复盘判法」与「固定检查」两样能力,不是改写既有契约(结论行格式、派发闸、「最新一次入账复盘过了才能完结」都没变),升第二位。
- 复盘任务说明的生成(体系守护技能):开头不再写「要证明它错」;新增「怎么判」一节 —— 只对着签过字的「怎样算做完」逐条判达标 / 没达标,没达标要有能复现的证据、而且是标准写明要有的东西没有或不对,全达标就是过,标准之外的发现写「遗留」、不影响过不过;新增「上一次入账复盘之后改了哪些文件」一节(生成程序每次把当时范围里的清单留底,与账本里那一笔复盘的范围指纹对得上才用;还没有入账复盘、留底没了或对不上,都让复盘者按全部看);新增「机器已经查过的」一节(每条自动用例点名的床与它的状态、固定检查逐项的状态与命令,写明别从头重做、最多抽查三项);新增「预算与纪律」一节(十分钟左右、工具调用三十次以内、没核到的如实写;不全盘查找、命令超时不转后台、收尾关掉自己起的浏览器与命令)。第一行的标记、任务编号的算法、结论行的固定格式不变。
- 固定检查(体系守护技能新增一份脚本与一条命令
harness.js --action=checks):清单住计划目录checks.json、脚本住计划目录checks/,命令在计划目录里执行;结果按「范围里的改动清单 + 清单与脚本的内容」记账,内容没变再跑沿用、不重跑,--force强制、--only只跑一项;同一时刻最多两项;每项结束(正常结束或超时)把它起的进程连同子孙一起关掉 —— Windows 装进作业对象、结束时整个作业一起终止,别的系统自成进程组、结束时整组终止。清单写坏(不是合法 JSON、名字重复、缺命令、空清单)如实报出、算没过。 - 核对命令(三查单):第二查多一行「固定检查」—— 登记了的显示几项过、没过、过期、没跑过,并点名没过的;有一项没全过,第二查红、给出该跑的命令。没登记固定检查的计划,这一行不出现,单子与编号都和此前一样。
- 测试:任务说明床补六条(判法、预算与纪律、增量清单的三种情形、留底改坏退回全部、机器结果、标记与结论行格式不变且守卫认得出);新增固定检查床九条(真的起进程跑:记账、沿用、重跑、只跑一项、同一时刻不超过两项、子进程跑完不在、没过点名、清单写坏、删掉清单回到原样);核对命令床补一条(固定检查进第二查的五种状态)。
- 技能说明与执行体定义:体系守护技能的说明补「判法与范围」一段与「checks」一节;对抗审查执行体的定义「需求复盘」一节补三条(过不过只看签过字的标准、不从头重做机器查过的、不留尾巴)。
- 架构详图:§八 需求闭环补「复盘判法与固定检查」一段与守不到之处;文首版本改成本版。
- 决策记录:ADR-87(复盘只对着签过字的标准判、给出增量与机器结果、可登记固定检查;否决给复盘设轮数上限并让用户签带遗留完结、两份任务说明并存、复盘改在施工中做、机器解析遗留)。
- 守不到:遗留只在复盘者的报告里,由执行者抄进看板,机器不解析;预算靠复盘者自觉,超了没有闸;固定检查读了范围之外会变的东西(别的会话重建的产物、线上数据),指纹不知道;Windows 上起进程到装进作业对象之间的一瞬、检查主动让子进程脱离作业的,关不掉;无头浏览器的页面在本机会列进任务切换,限两项只是减轻。
- 项目架构页(project:overview)门四同批补了这两样的设计,那是它自己的一版,不带动本版。
- v4.15.x
订正(托管限流复盘):两句「下一次发布会清」改成实话;接力所依据的线上那一版记进发布记录、备份时对不上就拒绝;备份读回补写盘故障用例;手工入口补提醒
设计指纹5a351ed9内容指纹13e1db3e测试指纹4db775667bbd6e91改动设计 3 个(harness-engineering.md、SKILL.md、x-deploy-dev-arch.md);代码 4 个(plan.js、relay.js、release.js、stage.js)
需求托管限流签字 a82b已发布
为了:托管限流 —— 第一次独立复盘点出四处:回滚完成后与旧式清理计划里各打印一句「下一次发布会清」,备份改成只取回本次要写的路径之后这两类文件不在任何发布清单里、永远进不了清理候选,那两句成了假话;发布档案准备之后线上换过版本时,接力清单是按旧的那一版算的,会静默漏记旧文件;备份「写完读回再比一遍」没有用例咬得住;手工入口没写明放错文件的后果。v4.14.0 已封、改不了,订正另起一版;设计结论(备份由发布检查点自取、清单接力)没变,升第三位。
- 发布库 release / stage(两句提示改成实话):回滚完成后打印的那一句与清理计划里「上一版是旧式发布」那一句,原先都说「下一次发布会清」。v4.14.0 之后清理候选只从备份目录算,而备份只取回本次要写的路径与接力清单 —— 回滚留下的带指纹新文件、旧式发布留下而本版不再用的文件两样都不在任何发布清单里,后面发多少版都进不了候选。两句改成同一句实话,只住
release/stage.js的常量UNLISTED_LEFTOVER_NOTE:它们会一直留在线上、只占存储不影响访问,要清走手工入口(准备好下一份发布档案之后、跑备份检查点之前,把它们放进那份档案的backup目录;只按名字进可删清单、不核有没有页面还在引用,只放确定没人用的)。另加一句常量HAND_PLACED_NOTE(手工放进backup目录、不在任何发布清单里的文件不会被接力,下一次要重新放),拼在「清理推迟」与「回滚后跑清理」两句后面 ——「下一次发布会重新算」只对接力清单记着的旧文件成立。release/plan.js里两处同源的注释同批改掉。 - 发布库 release / stage / plan(接力依据记账并核对):准备档案时把接力清单所依据的线上那一版记进发布记录
record.json顶层的relayBase一栏({ exists, releaseId },三种形状:线上没有发布清单 / 有清单没有发布号 / 有发布号);「从一份清单认出是哪一版」只有plan.js的relayBaseOf一个函数,准备档案与备份检查点共用。备份检查点首次取回时先看发布记录里有没有这一栏、形状对不对(不对直接拒绝,不读线上);再与线上此刻那一版比,对不上就拒绝并点名准备时与现在各是哪一版,备份目录都不建;提示重新准备发布档案。已定格的重跑不走这一段。此前这种情况不报错、退出码 0:接力清单少记了中间那一版独有的文件,它们从此不在任何清单里。 - 发布库 release(顺带三处):线上没有首页而线上那份发布清单读得到却认不出时(不是合法 JSON、缺 files)也报出来不放行;备份通过后报上一版改用与拒绝报文同一套说法(发布号 / 有发布清单但没有发布号 / 没有发布清单),不再打印 null;发布库里「档案的发布清单没有
lingering一栏按空算」的兼容去掉(这种档案先被接力依据那一道拒掉)—— 本版之前准备、还没过备份的档案一律要重新准备。 - 测试:发布管线床新增 A7(接力依据的三种形状与同一版的判定)、E9a / E9b(档案准备之后线上换过版本,备份不放行、一个字节都不写)、E10(发布记录没有接力依据或只写了一半,不读线上、不写备份)、E11a / E11b(写完读回再比一遍:落盘的不是要写的字节、根本没落盘,都不通过、点名那个文件)、E12(线上清单没有发布号时照常通过、不打印 null);B7 / D1 / D2 / E1 / E6 / E7 加了断言。写盘故障由床用预加载脚本只注入备份那一个子进程,产品代码没加测试口;每一处都做过换回旧行为的对照,对应用例都变红。
- 工作流说明:部署技能说明「静态托管发布执行」一节四处 —— 开头一段补「准备档案时把接力所依据的那一版记进发布记录」;回滚那一条原先写「带指纹的新文件下一次发布按宽限期清理」,与同一节清单接力那一条「回滚之后被撤下那一版的带指纹新文件不在任何清单里」自相矛盾,改成同一口径(留在线上、只占存储,要清走手工入口);备份那一步补「线上在档案准备之后换过版本、或发布记录里没有接力依据,备份命令会拒绝,照提示重新准备发布档案」;手工入口补提醒:只放确定没有任何在线页面还在引用的旧文件 —— 手工入口不与线上比对、也不核引用,只按名字进候选,上一版首页还在引用而又不在上一版清单里的文件放进去会被算成可删;手工放进去的文件不会被接力,这一次没删掉下一次要重新放。脚本架构文档同步发布记录的
relayBase一栏、relayBaseOf、备份检查点的这道比对与两句新常量。 - 架构详图:回看 §八 守卫 MCP 环「备份口不再被流程用到」那句括注与 §十六 讲发布档案的几处,没有因本版而不再成立的话;只改文首版本。
- 决策记录:本版不新增、不改;ADR-84 的结论(备份由发布检查点直接取回线上,不经 MCP)不变。
- 守不到 / 没做:手工入口放进去的文件有没有在线页面还在引用,机器不核,靠放的人判断;回滚留下的带指纹新文件与旧式遗留文件不会自动清走,不处理就一直占着存储;回滚完成时不列出留下的那些文件的名字 —— 要列得让回滚计划多记一栏,属于加功能,这一轮没做。
- 部署规范域(spec:x-deploy)同批订正,那是系统规范域自己的一版,不带动本版。
- 发布库 release / stage(两句提示改成实话):回滚完成后打印的那一句与清理计划里「上一版是旧式发布」那一句,原先都说「下一次发布会清」。v4.14.0 之后清理候选只从备份目录算,而备份只取回本次要写的路径与接力清单 —— 回滚留下的带指纹新文件、旧式发布留下而本版不再用的文件两样都不在任何发布清单里,后面发多少版都进不了候选。两句改成同一句实话,只住
签字区标改动:签字那一笔留底、重签只标改动;对话框「全选执行」一键签
设计指纹acb7e894内容指纹6696456c测试指纹777c44e0aff17acc改动设计 2 个(harness-engineering.md、ADR.md);代码 4 个(guard.js、requirements.js、verify-harness.js、requirement-check.js)
需求签字区标改动签字 cee6已发布
为了:签字区标改动 —— 签字那一笔只记编号不留内容,内容改过要重签时拿不到「上次签的是什么」,签字区只能全列、只能说一句「内容改过了」;同一条需求因措辞订正连签四次,每次都要把二十多条从头看一遍。另外签字搬进看板之后每次都要复制结论贴回对话框。本版给守卫加了「签字留底」、给核对命令加了「重签只标改动」、给签字题对话框加了一项固定写法的一键签,是新增能力、不是改写既有契约,升第二位。
- 守卫(需求对账):签字一记进需求账本时,把内容编号盖住的那份内容(需求原文、怎样算做完、用例、落点目录、单元名)原样一起记下,底与编号同一笔;账本带链,留底改不了。
- 守卫(选项题):签字题的对话框里一项固定写法的选项「全选执行:确认 〈需求名〉」、验收题的「全选执行:验收完结 〈需求名〉」认成签字,账本那一笔记明是对话框一键签的;看板签字区必须已是最新内容(内容编号对得上、那一道的头对得上,验收还核结果单编号),否则不认并回话写明原因;别的选项标签照旧只记成话、不算签字。有意见的那条路不变(看板里不勾、写意见、贴回)。
- 核对命令(签字区):内容在上次签字之后改过时,拿当前内容逐条对上次留的底,判成没变、改了、新增、删了;改了的条目左边橙色竖条、淡橙底、「改了」标签、改动的片段黄色高亮(按句读切段,改一个字整句黄,宁多标不漏标)、条目下折叠着之前写的原句;新增的绿色竖条;删了的在组标题下列出;没变的原样、不变灰;顶部横幅写清各几条;底部多一个「只看改动的」按钮。老账本那一笔没留底时,从签字那一刻建的在办履历取底,履历重算出的编号等于签字编号才用;两样都没有,横幅写明分不出、一条都不标。第一次签字零标记;验收区本版不标。
- 测试:签字床补用例(留底在、只标改的那一条、新增、删了、老账本分不出、首次零标记、「只看改动的」按钮在;对话框一键签记成签字、看板不是最新时不认、别的标签照旧不算);守卫回归套件同步。
- 架构详图:§八 需求闭环补「签字留底与重签只标改动」「对话框一键签」两段;文首版本改成本版。
- 决策记录:ADR-85(签字留底、重签只标改动)、ADR-86(对话框固定写法的一键签,给「选项标签一律不认」开一个口)。
- 交代一句:上一版 v4.14.0(托管限流)写的 ADR-84 与架构详图 §八 那句括注,因两条需求共改同一份文件、归属按最后写入者算,没有进 v4.14.0 的锁清单,随本版进锁。
- 守不到:一键签省的是复制粘贴,不是「看过看板」—— 用户没打开看板也能选,机器只核签字区是最新的。
- 项目架构页(project:overview)同批写了「签字」一节的设计,那是它自己的一版,不带动本版。
- v4.14.x
托管限流:静态站点的备份由发布检查点自己取回并定格,零次 MCP;仍经 MCP 的调用写明做法
设计指纹1f0fb268内容指纹f6d3702e测试指纹777c44e0aff17acc改动设计 2 个(SKILL.md、x-deploy-dev-arch.md);代码 9 个(deploy.js、deploy.js、deploy.js、online.js、plan.js、release.js、stage.js、deploy.js 等)
需求托管限流签字 b2bb已发布
为了:托管限流 —— 10-06 治理站点发布实测:备份一步经 MCP 下载撞管控接口限流、静默少文件(整站 439 个只到 62 个),按小目录逐个下用了 60 多次调用;对整个站点目录列清单让三个会话的 MCP 断线。发布检查点本来就从公开默认域名逐文件取线上内容做比对,让它顺手把取到的内容写进备份目录并定格,备份一步零次 MCP。发布链多了「检查点自取备份并定格」与「发布清单接力」两种能力,守卫、威胁模型与治理拓扑都没变,不是改写既有契约、也不是只改写法的订正,升第二位。
- 发布库 release:backup 检查点由「核对操作者下载来的备份」改成「从公开默认域名取回本次要写的路径与本版
lingering里的文件(比只取上一版lingering宽:上一版独有的文件也取回,清理候选不变)、写进<档案>/backup、逐字节核对、通过后定格」—— 有任何一处不放行就一个字节都不写,写完重新取指纹再比;重跑只核对备份目录与当时记下的指纹,不读线上、不写备份;备份目录已有文件时补齐缺的、已有的只比指纹不覆盖,已有但与线上不一致的、本次要写的路径线上没有备份里却有的照旧报错不放行;线上已有却不在上一版清单里的要写路径只打印一行提示、不拦。 - 清单接力(备份只取回本次要写的路径之后,清理候选靠「备份里有整个站点」会恒为空,旧文件只增不减且不报错):发布清单
release.json加一栏lingering(不属于本版、但线上还在的文件)。准备档案时读线上那份上一版的清单并逐个探测它那一栏里的文件还在不在(新文件release/relay.js,只读线上一次、线上零改动;线上没有清单按「没有可接力的」算,读不出来、不是合法 JSON、探测出错一律拒绝准备、不留半个档案);本版这一栏 = 上一版清单里有而本版没有的 ∪ 上一版那一栏里线上还在的(纯计算plan.js的relayList),备份时一并取回,清理候选照旧从备份目录算。三处边界照实不处理:改造后第一次发布认不出此刻已留在线上的更早版本文件(上一版清单没有这一栏,按空算);回滚后被撤下那一版的带指纹新文件不在任何清单里;旧式发布留下、不带指纹也不在任何清单里的文件接力永远认不出 —— 三类只占存储,要清就在发布前把它们放进backup/(手工入口:这类文件不与线上比对,只按名字进候选)。探测由online.js新加的「只问有没有」完成(只取第一个字节)。准备档案因此不再是纯本地;四个部署脚本的main()与stageRelease(调用形态一行没改。 - 发布步骤里给操作者照做的两句只住
release/stage.js(BACKUP_STEP_NOTE第 1 步说明、HOSTING_CALL_PRACTICE调用做法),四个部署脚本与发布检查点打印的都是它;四个部署脚本各导出打印发布步骤的四段函数,供自测捕获打印。 - 四个静态站点部署脚本(后台、网页版、官网、治理站点)打印的第 1 步改成备份命令,不再出现任何 MCP 下载指令;第 2–4 步写明仍经 MCP 的调用做法:一条一条调、不并发;报限流等两秒再试;以核对命令为准;不对整个站点目录列文件清单。
- 工作流说明:部署技能说明「静态托管发布执行」第 1 行改成跑备份命令,加「仍经 MCP 的调用做法」一段;流程 6 里「备份这一步要特别当心」那套整目录下载、按子目录补、逐文件补的做法整段删掉;四条流程的流程图与文字同步。脚本架构文档的 backup 检查点与发布档案描述同步,补上治理站点那条入口。
- 架构详图:§八 守卫 MCP 环 1 那一段补「备份口不再被流程用到」;文首版本改成本版。
.claude/harness-engineering.md与.claude/harness/ADR.md这两份文件同时被另一条在办需求改过,归属按最后写入者算,本版的改动清单与锁清单不含它们;本需求写的 §八 括注与文首版本随下一版(v4.15.0)进锁。 - 决策记录:ADR-84(备份由发布检查点直接取回线上,不经 MCP;否决只写说明、利用上游写反的缓存判断、脚本拿云密钥直读存储桶、给守卫加新拦截)。
.claude/harness-engineering.md与.claude/harness/ADR.md这两份文件同时被另一条在办需求改过,归属按最后写入者算,本版的改动清单与锁清单不含它们;本需求写的 ADR-84 随下一版(v4.15.0)进锁。 - 部署规范域(spec:x-deploy)同批加「经 MCP 的托管调用不撞限流」条款、判据加「部署脚本里出现 MCP 下载指令即红」一臂、架构页加「托管调用与限流」一节 —— 那是系统规范域自己的一版,不带动本版。
- 发布库 release:backup 检查点由「核对操作者下载来的备份」改成「从公开默认域名取回本次要写的路径与本版
- v4.13.x
订正:门五逐版核需求绑定;增量检测核履历指纹;回填带床清单;封死只认最后一笔;短名不撞别的计划;发布段真跑一次
设计指纹c555962c内容指纹2526e7f9测试指纹da5216596016a082改动设计 1 个(harness-engineering.md);代码 5 个(project-archive.js、requirements.js、verify-harness.js、check.js、version-contract.js)
需求项目架构签字 357f已发布
为了:项目架构 —— 第三次独立复盘点出:门五「基线之后封的每一版都绑着需求」实际只核锁清单的当前版本,中间漏绑的一版再封一版绑上就没人报;封死履历的产出指纹只在全量与部署门核,收尾跑的增量检测看不见;四条回填履历把结果单里有自动床的用例写成「要用户亲手验」;账本里两笔归档任一指纹都算封死,写错的旧版整份放回去照样绿;短名只查履历不查别的计划;重算命令在真仓一次没跑、发布段整列空。订正,升第三位。
- 检测引擎版本契约:对契约生效后封的每一版(版本高于基线)逐版核记录行里的需求绑定,缺哪一版点哪一版(门五床 G4 改成中间漏绑照旧点名);增量检测的改动面含需求履历时对项目架构单元核履历指纹(履历床经 check.js --changed 真跑一遍)。
- 守卫 project-archive:封死只认账本里最后一笔完结 / 归档的指纹;回填的用例作证里写着「测试:」而床清单没留下的,渲染成「(回填:床清单没留下)」而不是「要用户亲手验」。四条回填履历重写(床清单从复盘简报取)、各追加一笔归档。
- 守卫 requirements:门一的短名也不与别的计划相同(在办、作废、没签字的都算);床 G2。
- 架构详图 §十三:门五的提示只走脚本通道的标准错误输出(守卫通道没有提示出口),改掉「放进比对结果的单独字段」那句。
- 真仓跑一次事后重算:五条履历各有发布段文件;设计页诚实边界补「在办履历是签字那一刻的快照」(项目架构 v1.0.3)。
订正:清单页渲染提出日;母本包里的客户端面推得出格;「五个入口页」改齐;「为了」分隔规则只在契约定一次
设计指纹4c34d8dd内容指纹dbaed2a5测试指纹c60747657c51356a改动设计 1 个(harness-engineering.md);代码 1 个(record-release.js)
需求项目架构签字 357f已发布
为了:项目架构 —— 第二次独立复盘点出:名册生成站点数据时漏了提出时刻,清单「提出」整列是「—」;重算命令只认两个端目录,客户端面写在母本包 x-core/mobile 的五个域推不出任何客户端格,只碰这类域的需求永远「已完结」或误翻「已发布」;架构详图顶层物表与治理站点判据各剩一处「五个入口页」;「为了」的分隔规则在站点两处各抄了一份。订正,升第三位。
- 体系守护 record-release:客户端面在 x-core 的域按两端各推网页版与原生包;认不出的端根单独标成一格、不无声跳过;床 R1b。
- 治理站点:名册的站点数据带提出时刻,站点床 G14 对每条断它等于履历里的;「为了」的短名改调契约的 forShortName,站点不再抄分隔规则。
- 架构详图顶层物表 x-harness 一行「五个入口页」改六个;设计页诚实边界补「新建业务域的需求签字时域还不存在」(项目架构 v1.0.2);治理站点判据的规则表与正文改齐(x-harness V1.2.1)。
订正:发布段只对已完结的需求翻「已发布」、按这条需求产的那一版比封版日;履历记提出时刻;回填只按短名对
设计指纹37fc2bd7内容指纹a87c4d15测试指纹82a7a0be0c1844af改动设计 1 个(harness-engineering.md);代码 3 个(project-archive.js、requirements.js、record-release.js)
需求项目架构签字 357f已发布
为了:项目架构 —— 独立复盘点出四处行为不对:重算命令不看完结态就把在办需求翻成「已发布」;事后重算按当下锁清单的封版日判、域再封一版旧结论就翻回「未发布」;回填用子串对「为了」把 v4.12.0 / v4.11.5 对回了错的需求;需求清单没有提出日。订正,升第三位。
- 体系守护 record-release:状态「已发布」要先有完结段与产出指纹;事后重算按履历 closed.versions 记的那一版读变更历史里的封版日,没记的才按当下锁清单;床加 R5(在办不翻)、R6(域再封新版旧结论不动)。
- 守卫 project-archive:履历记「提出」时刻(计划目录出现与账本第一笔取早的),渲染进签字段。
- 门五床 G4 另断言脚本通道真打印了基线没写的提示;契约床 P1 那条恒真的断言改成直接断「版本两处对不上」。
- 四条回填履历重写、各追加一笔归档:产生的版本按「为了」短名精确或前缀对回(守卫提速 4.6.0、需求闭环 4.11.4),带提出时刻;别名表去掉对错的两条。
- 治理站点:名册对在办需求一律记在办、读提出时刻;清单页「提出 / 签字」两个日期都渲染;站点床 G15 加「为了」链接指向的需求短名要与行文一致。
- 守卫 requirements:闸的开关不算改动 —— settings.json 只把写前拦截摘下或挂回去(PreToolUse ↔ _PreToolUse 这一个键名)按同一份内容算受治指纹,收尾对账与三查共用;权限、别的钩子改了照算(此前闸开着时它被算成范围外改动、封版当场拒,逼用户来回开关闸);床 T5。
项目架构:流水线立成第四类架构,三道门补硬控,每条需求一份封存记录
设计指纹81b52078内容指纹efcb17ce测试指纹fa733987448ff856改动设计 5 个(CLAUDE.md、harness-engineering.md、ADR.md、SKILL.md、SKILL.md);代码 12 个(command-policy.js、release-versions.js、requirements.js、verify-harness.js、PLAN-TEMPLATE.html、requirement-check.js、harness.js、seal.js 等)
需求项目架构签字 357f已发布
为了:项目架构 —— 用户 10-05 要第四类架构:「需求 → 实现 → 部署」这条流水线本身要硬控、要与三类架构串联;此前五道门都在但没有一页说它是什么,证据散在三处本机文件里,封版与发布都不问「为了哪条签过字的需求」。新增一类受治文件(项目架构设计页与需求履历)、三道门的硬控、一栏站点,升第二位。
- 宪法:受治工件类的架构层加第三个目录
arch/project/;§六.8「计划固化进架构之后删」改成「计划归档成需求履历、固化进架构之后删」,完结不是终点、每一格都发了才算「已发布」;相关文档表加项目架构一行。 - 架构详图:§八「项目架构与归档」一段(门一核单元与短名、签字建履历、完结先封履历与指纹进账本再记完结、删计划前置、脊柱与免检、守不到);§十三 单元表加 project:overview、「为了哪条需求」一段(机器形态、解析到恰好一条签过字的需求、落点表核本单元、锁清单需求字段与记录行互核、门五基线 frozenBefore 与「没写之前不判」)、第 4 关加需求字段一项、站点入口页五改六;§十四 加第四类文档。
- 决策记录:ADR-83(取代 ADR-73 否决栏那一句)。
- 守卫与钩子:签字一核单元与短名并建履历、验收完结封履历、删计划前置、免检面与脊柱名单加履历目录、守卫回归沙箱补夹具域;发布前版本比对接上契约新加的那一项并把提示打印给脚本通道。
- 检测引擎与封版核心:版本契约认 project:overview(锚、页头版本、封版命令表与用法文案、履历不进锁)、「为了」形态与解析、锁清单需求字段与记录行互核、frozenBefore、整体比对加「基线之后的版本必须带需求」、核履历指纹;封版核心的需求对账段按解析拒封、project 层测试前置分支。
- 体系守护:record-release 动作(发布当时按锁清单记、事后按台账与封版日推);需求对账的「谁写的」不再把免检面的文件算进去。
- 工作流说明与计划模板改口;治理站点构建器第四栏、新页 project.html、五源页导航、首页四类、自检路由集。
- 回填四条已完结需求的履历(账本追加「归档」笔);本条需求的履历从签字那一笔补建。
- 宪法:受治工件类的架构层加第三个目录
- v4.12.x
订正:整条路径都是字面量才按仓根相对判,任一段带 shell 会展开的东西一律照旧任一段
设计指纹72caa311内容指纹dff49eeb测试指纹b40750423b133df6改动设计 1 个(harness-engineering.md);代码 2 个(command-policy.js、verify-harness.js)
需求发布修补已发布
为了:发布修补(第五次独立复盘点出)—— v4.12.3 只核第一段是字面量:
A=..; cp a.ts docs/$A/x-admin/src/m/b.tsx第一段docs是字面量、按第一段放过,而变量里装着..,shell 真正落到的是仓内的 x-admin;cp / mv / tee / 重定向与仓内绝对写法实测全放,改前按任一段判是拦的。病根与前两次一样:判「这条路径落在哪」时只要有一段算不出,整条就算不出。行为订正与补床,升第三位。- command-policy.js:按仓根相对、只看第一段的前提收紧为「整条路径都是字面量」(只含字母、数字、点、下划线、连字符、斜杠与盘符);任一段带
$、~、%、括号、反引号、通配符、引号、空格的,照旧按任一段判。守卫回归加 RR4n(A=..; cp a.ts docs/$A/x-admin/…)、RR4o(tee docs/$A/x-admin/… < a.ts)两条对照拦,薄壳床名单与注释同步。 - 架构详图 §八 同批写明一条守不到的:守卫按路径字面判、不解析符号链接 —— 在 x-release 下建一条指向业务目录的链接再往里写,字面上仍是 x-release;记洞不改。
- command-policy.js:按仓根相对、只看第一段的前提收紧为「整条路径都是字面量」(只含字母、数字、点、下划线、连字符、斜杠与盘符);任一段带
订正:第一段不是字面量的路径不按仓根相对判、照旧任一段;收尾提示只数真跑成的
设计指纹cd39e644内容指纹23ed8acf测试指纹673a6da91f3d7fdb改动设计 1 个(harness-engineering.md);代码 3 个(guard.js、command-policy.js、verify-harness.js)
需求发布修补已发布
为了:发布修补(第三次独立复盘点出)—— 「当作仓根相对、只看第一段」的条件仍比「真能换成仓根相对」宽:
$PWD/x-admin/…、${PWD}/…、$CLAUDE_PROJECT_DIR/…、~+/x-admin/…没有盘符、不以 / 开头、没有..,被当成仓根相对,第一段是$pwd这类变量、不是顶层目录就放过;shell 真会把它们展开成仓内的业务源码,cp / tee / 重定向 / sed -i 四条通道实测全放,改前按任一段判是拦的;仓内绝对路径里夹一段变量(<仓根>/$X/x-admin/…)同病。与第二次复盘抓的..越界是同一个病根:判「这条路径落在哪」的那一段必须是字面量,否则守卫不知道它展开后是什么。行为订正与补床,升第三位。- command-policy.js:按仓根相对、只看第一段的前提再加一条 —— 第一段必须是字面量(只含字母、数字、点、下划线、连字符);带
$、~、%、括号、反引号、通配符的第一段展开后落在哪守卫不知道,照旧按任一段判(更严的那一支);仓内绝对路径同样核仓根相对的第一段。守卫回归加 RR4j(cp a.ts $PWD/x-admin/…)、RR4k(cp a.ts ~+/x-admin/…)、RR4l(tee $PWD/x-admin/… < a.ts)、RR4m(cp a.ts <仓根>/$X/x-admin/…)四条对照拦,薄壳床名单同步。 - guard.js:收尾提示「主人会话已结束的 N 个改动按无主复核」只数本轮真跑成、记了结论的(与「无主改动复核未过」那一句同一口径);到点或引擎没跑成的不算、归入「还有 K 个下轮再查」。
- command-policy.js:按仓根相对、只看第一段的前提再加一条 —— 第一段必须是字面量(只含字母、数字、点、下划线、连字符);带
订正:以 .. 越出起点的相对写法不当作仓根相对、照旧按任一段判;收尾提示按本轮实际复核数说
设计指纹753a42da内容指纹01ae8f66测试指纹15e96bd8a372dfcf改动设计 1 个(harness-engineering.md);代码 4 个(guard.js、command-policy.js、mcp-policy.js、verify-harness.js)
需求发布修补已发布
为了:发布修补(第二次独立复盘点出)—— v4.12.1 把相对写法一律当作仓根相对,而路径归一时开头的
..是「越界 pop 无害」地丢掉的:../<仓目录名>/x-admin/src/m/b.tsx折叠成x/x-admin/…、第一段不是业务目录就放过去了,Bash(cp / mv / tee / 重定向)与托管下载两条通道都多了一个改前没有的绕法(改前相对路径按任一段判、是拦的),标准 1「仓内真业务目录的写保护照旧」不成立,回归套件对这个形态零覆盖。另:ADR-82 记的日期 10-04 是拍板那天(需求当天夜里),实现封版在 10-05,不是笔误。行为订正与补床,升第三位。- command-policy.js:相对写法里以
..越出起点的(折叠时 pop 过空栈)不当作仓根相对 —— 它真正落在哪取决于当前目录,守卫不知道,照旧按任一段判(更严的那一支);没越出起点的相对写法仍按仓根相对、只看第一段。mcp-policy.js:托管与云存储下载的单文件、整目录落点把原写法交给写保护判定(各子判定自己归一),不再先折叠一遍 —— 先折叠会把开头的..丢掉,命令通道一直是交原写法的。守卫回归加 RR4h(cp a.ts ../<仓目录名>/x-admin/src/m/b.tsx→ 拦)、RR4i(托管下载落点../<仓目录名>/x-harness/index.html→ 拦),薄壳床名单同步。 - guard.js:收尾提示「主人会话已结束的 N 个改动按无主复核」按本轮真进复核的那一段计数(无主每轮至多 40 个),超出的另说「还有 K 个下轮再查」。
- command-policy.js:相对写法里以
订正:仓外路径的业务源码判法补床、相对写法当作仓根相对;主人已结束的改动在三查「谁写的」里算别的会话;24 小时边界钉进床
设计指纹6c0573a3内容指纹3fd39ac6测试指纹09c6aff8692f04af改动设计 1 个(harness-engineering.md);代码 5 个(guard.js、command-policy.js、requirements.js、test-faces.js、verify-harness.js)
需求发布修补已发布
为了:发布修补(第一次独立复盘点出)—— 签字作证里写的第三类路径「换不成仓根相对 → 照旧按任一段判」此前没有任何床守着,把那条回退分支删掉守卫回归照绿;本来就是相对写法的落点(没有盘符、不以 / 开头)被当成「换不成仓根相对」而回退到任一段判,手敲相对路径仍会复现 10-04 的误拦;ADR-82 写「归属的其它用途照旧按写证据」,而三查「谁写的」把主人已结束的改动记成「没有写证据」;24 小时这个数三张床都没钉住,改成 1 小时照绿。行为订正与补床,升第三位。
- command-policy.js:相对写法的路径当作仓根相对、按第一段判(
../折叠后同样按第一段,只会更严);仓外绝对路径照旧任一段。守卫回归加 RR4f(仓外临时目录里的 x-admin/… → 拦)、RR4g(相对写法的档案备份落点 → 放),薄壳床名单同步。 - requirements.js:三查「谁写的」对主人会话已结束的改动记「别的会话」(它有写证据,只是那个会话不会再来),不再记「没有写证据」;收尾附注与测试新鲜度报文里「无主」的解释补上「或主人会话已结束」。requirements 床加一例。
- 会话台账床 L23:断言 24 小时常量;主人最后一笔挪到 23 小时前仍归它、再挪到 25 小时前才按无主。
- command-policy.js:相对写法的路径当作仓根相对、按第一段判(
归属多一类情形:主人会话已结束的改动按无主复核;业务源码判定按仓根相对路径首段锚定
设计指纹8b82b6a8内容指纹35c01f08测试指纹8c95d4e8574b29b1改动设计 2 个(harness-engineering.md、ADR.md);代码 4 个(guard.js、command-policy.js、session-ledger.js、verify-harness.js)
需求发布修补已发布
为了:发布修补(需求 1、2)—— 治理站点 10-04 首次全量发布(发到 v4.11.5)时部署会话报回两处守卫问题:① 命令策略判业务源码的正则对路径任一段同名即中,发布档案备份目录里 doc/system/x-data、x-harness、x-website 这些与顶层同名的子目录被当成业务源码,托管下载落点全拦;② 守卫提速会话(10-03 结束)留下的 21 个守卫文件改动在部署门上显示「未经收尾环复核」—— 干净结论按(文件、内容、判据指纹)记,10-03 后别的会话改了检测引擎、判据指纹变了,旧结论全作废,而收尾环只复核本会话与无主的改动、不复核别的会话的,那个会话不会再来,这批改动永远挂着、每次静态托管上传都被拦,只能开闸绕过。归属多了「主人会话已结束」这一类情形,升第二位(ADR-82)。
- session-ledger.js 归属分类:一个改动的全部主人会话都已结束(它最后一笔台账事件在 24 小时之前;本会话永远算活着)⇒ 归无主,保留原主人供报文点名;收尾环原有的「无主改动不拦人、只出结论、每轮最多 40 个、结论按内容记回」直接接住它;部署门报文写「主人会话已结束,按无主复核」,收尾提示写明「主人会话已结束的 N 个改动按无主复核」。主人 24 小时内有事件的照旧归它自己。
- command-policy.js 业务源码判定:仓内路径先换成仓根相对路径、只看第一段;换不成仓根相对的(仓外、另一棵工作副本)照旧按任一段判;测试根的排除照旧。
- 部署门两种形态同一句话:有仓库按归属分类判,无仓库形态(只按写证据自证)同样核主人会话是否已结束,报文一致。
- 床:会话台账床加「旧会话写证据 + 判据换过 → 归无主、另一会话收尾复核后部署门清;主人活着 → 照旧」(L23),随机台账对拍(L21)加活会话与已结束会话混排、索引与全表扫在这一类上也逐项相同;守卫回归加托管下载落点一放一拦四条(RR4b–RR4e)与部署门报文一条(MW18d),薄壳床核这五条真跑到。顺带修了会话台账床的桩检测器读到自己源码就崩的夹具问题(L11 往桩里追加一行后它成了无主改动,同批的无主文件全记成没跑成)。
- 同批(不进框架版本):治理站点构建器自检把指向目录的站内链接判为断链(x-harness/builder/verify.js,不归任何版本单元)、治理站点床 V3b;六个业务域去掉 parts/ 目录链接各升一版。
- v4.11.x
补写法:需求闭环计划洞清单里的四条洞写进 §八「记洞不改」
设计指纹10026479内容指纹47014023测试指纹903be9924df072d0改动设计 1 个(harness-engineering.md);代码 0 个
需求需求闭环收尾已发布
为了:需求闭环收尾(需求 1)—— 「harness 需求闭环」那条需求 10-04 完结,它的洞清单里五十八、五十九、六十、六十一这四条此前只在计划看板上,架构详图 §八 没有;按宪法「计划固化进架构之后删」,删那份计划前先把四条写进设计的诚实边界。设计内容没变、只把已经存在的边界写进设计,升第三位。
- §八「记洞不改」加四句:命令时间窗归属漏掉脚本在命令末尾写出的文件(结果单记成「没有写证据」,只列不挡);用户粘回签字区结论时自己多打的一行恰好长成项的形态会被当成一项吞进去(不改变判定);第三查按锁清单比而框架锁清单不含测试文件(封版后改测试第三查照绿,靠测试指纹与发布门兜);执行体写过又被删掉或领队重写的文件在结果单「谁写的」一栏不留痕、停下来那道关那一行不点名。每条写明补法留给下一条需求。
签字区底部悬浮条加「全选」:看了都没问题一键勾全,再点「复制结论」
设计指纹68e80b58内容指纹47014023测试指纹903be9924df072d0改动设计 3 个(harness-engineering.md、SKILL.md、SKILL.md);代码 2 个(PLAN-TEMPLATE.html、requirement-check.js)
需求需求闭环已发布
为了:需求闭环(需求 10)—— 用户 10-04 验收时贴回结论并说「给我一个打勾勾的全选按钮,现在都是我一个一个打勾的,如果我看了下都没问题,我期望可以一键全选」;同一次贴回末尾夹了这句话,守卫按规矩只记成他的话、没当签字,于是签字区的提示加一句「粘的时候别在后面加字」。签字语义不变,只加一个便利控件与一句提示,升第三位。
- 核对命令生成的签字区:底部悬浮条在「复制结论」左边加「全选」(勾全部组与全部明细,进度随之更新);需求确认区与验收区的说明各加一句「都对可以点「全选」」;悬浮条下的提示加「粘的时候别在后面加字 —— 结论里夹了你自己打的字只当你说话、不算签字」。
- 床:签字床 G4 加断言「验收区带「全选」按钮」。
- 架构详图 §八 签字区一句、开发流与体系守护两份说明的悬浮条描述同批补「全选」;计划模板状态栏第 8 步「发布,你点用例」改成「你照交付物清单验(在签字页签的验收区里勾)」(第二十三次复盘点出的旧口径)。
修计划模板:「签字」页签点中之后文字变白看不见
设计指纹72ac2604内容指纹1d9afeae测试指纹328ea72596288b66改动设计 1 个(harness-engineering.md);代码 1 个(PLAN-TEMPLATE.html)
需求需求闭环已发布
为了:需求闭环(需求 10)—— 用户 10-04 验收时指出签字页签点中后看不见文字:那个按钮为醒目单独写了黄底的内联样式,选中态样式的白字留下、深底被内联黄底压掉。只改模板样式,升第三位。
- 计划模板:签字页签按钮的内联样式换成 class
sign,样式表加两条 —— 平时黄底,选中时橙底黑字;页签切换脚本只增删on,不碰别的 class。 - 同批(不进框架版本):本计划看板同一处同改。
- 计划模板:签字页签按钮的内联样式换成 class
订正说法:计划模板状态栏那句「钩子装上之前由我手填」改成现状;开发流说明写明重签之后先改状态栏再派复盘
设计指纹d55f2583内容指纹15df5a2a测试指纹e0e590967b45c58e改动设计 2 个(harness-engineering.md、SKILL.md);代码 1 个(PLAN-TEMPLATE.html)
需求需求闭环已发布
为了:需求闭环(需求 10)—— 第二十一次独立复盘指出计划模板文首还写着「钩子装上之前,状态栏由我手填」(钩子早已装上),以及执行者在用户重签落账之后没改看板状态栏就派了复盘、派出后看板又不能动,用户验收时首屏与签字页签自相矛盾;只改说法与说明,升第三位。
- 计划模板状态栏下那句改成「状态栏的文字由我手填:每次派独立复盘之前,照最新一张结果单与账本改成现状;机器只数步骤的勾」。
- 开发流说明:派独立复盘那一步写明次序 —— 用户重签落账之后、生成任务说明之前,先把看板状态栏改成现状,再生成任务说明、派复盘;派出之后到验收完结之前看板一个字不动。
- 架构详图 §八 组队一段原本就写着停下来那道关的上限边界(「一次停不下来最多连着拦若干次、拦够了放行都记一笔」),不另改;计划的标准 16 与洞清单没写,登记为洞六十二。
- 同批(不进框架版本):计划洞清单加六十一(执行体写过又被撤掉或重写的文件在结果单「谁写的」一栏不留痕、停下来那道关那一行不点名)、六十二(停下来那道关的五次上限,标准没写)。
补洞:node 自己会落盘的开关与 NODE_V8_COVERAGE 当成写入落点,不许落脊柱、没签字只准落仓外
设计指纹0aa85df7内容指纹12fa37f2测试指纹81066c53262bd366改动设计 1 个(harness-engineering.md);代码 3 个(command-policy.js、verify-harness.js、requirement-check.js)
需求需求闭环已发布
为了:需求闭环(需求 10)—— 第十九次独立复盘活体:
node --test --test-reporter=tap --test-reporter-destination=.claude/hooks/guard.js <受治脚本>经写前入口放行(签字态与没签字态同一段代码),node 真把 TAP 文本覆盖进守卫主程序,守卫退出码变 1 后全部关口失效;同族还有 --cpu-prof-dir / --heap-prof-dir / --diagnostic-dir / --report-directory / --redirect-warnings / --snapshot-blob / --trace-event-file-pattern 与环境变量 NODE_V8_COVERAGE。补洞不改契约,升第三位。- command-policy.js:node 的落盘开关值(
=粘连与空格隔开)、不带值往当前目录写生成名文件的开关(--cpu-prof / --heap-prof / --prof / --build-snapshot / --trace-events-enabled / --report-on-*)记成落点「.」、NODE_V8_COVERAGE 的目录、NODE_OPTIONS 里写的同类开关,一律与重定向 / cp / sort -o / git --output 同判:落在保护目标拦,其余进直写清单过需求闸;没签字时只准落仓外或计划、账本目录。回归 WL6p–p8(拦五种、放三种对照)、RQ13c–e(有签字也不许落脊柱;仓外放)。 - 签字页签在三查有红时写明具体原因(哪一步没勾、越界几个、复盘怎么了),不只写「第一查红」(第十九次复盘第 3 条)。
- 看板状态栏「等你」一栏的过期句子订正;洞清单与审查记录加 11.31。
- command-policy.js:node 的落盘开关值(
复盘结论绑住复盘者看的那份看板正文:复盘「过」之后改看板一个字,那次复盘作废
设计指纹10493aa0内容指纹77c03e0f测试指纹720841dd0d2d58c2改动设计 2 个(harness-engineering.md、ADR.md);代码 5 个(guard.js、requirements.js、verify-harness.js、requirement-check.js、review-brief.js)
需求需求闭环已发布
为了:需求闭环(需求 10)—— 第十七次独立复盘指出复盘结论只绑范围内文件的指纹与内容编号,复盘「过」之后执行者改设计页、洞清单(用例 10、11 要用户亲手验的正是它们)复盘照旧算数;此前 v4.4.5 按设计不改(怕连打勾都要再复盘),现在看板指纹本来就剥掉签字区、步骤早在复盘前勾全,代价已经不成立。新加一道绑定,升第二位(ADR-81)。
- 任务说明生成时把看板正文的指纹(剥掉签字区)记进
<名>.review-brief.json;守卫在复盘者收尾时把它记进复盘那一笔(board);三查第一查多一支「复盘之后看板正文变了(要再复盘)」。旧记录没记 board 的不判。 - 床:核对命令床 R7 加两步(看板指纹对不上红、对上不红);守卫回归 RV2c(复盘那一笔带着任务说明里的看板指纹)。
- 同批订正看板设计页两段旧话(「在选项里点验收完结」「账本改了发现不了」);新增洞五十八(命令时间窗归属漏掉脚本在命令末尾写出的文件,封版命令写的变更历史与锁清单在结果单上列成「没有写证据」,只列不挡)。
- 任务说明生成时把看板正文的指纹(剥掉签字区)记进
- v4.10.x
订正说法:计划模板是六个内容页签加一个签字页签
设计指纹708aa478内容指纹a289f310测试指纹2c9e61b5e4fc6a0a改动设计 2 个(harness-engineering.md、SKILL.md);代码 1 个(PLAN-TEMPLATE.html)
需求需求闭环已发布
为了:需求闭环(需求 10)—— 第十六次独立复盘指出 v4.10.0 加了第七个「签字」页签之后,模板自己的说明、开发流的说明与计划的用例 14 还写着「六个页签」,用户按验收单亲手验会验不过;只改说法,升第三位。
- 计划模板文首、开发流说明里的「六个页签」改成「六个内容页签加一个签字页签」;计划的机器镜像里用例 14 的预期与作证同批改口(用例 7 作证里对守卫单元床 C1 的描述也照床的实际分支改准),签字作废、用户重签。
签字搬进看板的「签字」页签:逐条明细各一个勾、底部悬浮的「复制结论」;验收单逐条需求写明「满足 / 不满足」
设计指纹26048bf7内容指纹362de6bf测试指纹07e4f5a53b02958a改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、SKILL.md);代码 3 个(requirements.js、PLAN-TEMPLATE.html、requirement-check.js)
需求需求闭环已发布
为了:需求闭环(需求 10)—— 用户 10-04 看到签字区把范围写成「六个目录 等」时推翻:「必须是明细啊!太粗了……我怎么知道我需要签字的有哪些啊!而且你需要在模板里面单独有一个 tab,就是用来专门用于签字的,里面就是一个一个明细的签字条目和内容,然后底部是一个悬浮的确认按钮」;同批订正第十五次独立复盘指出的三处(验收单只写「N 条全过」靠读者推、床 S4 的名字还是旧语义、标准 11 的措辞超出实现)。签字页签是新的一类东西,升第二位(ADR-80)。
- 计划模板加第七个页签「签字」,
<!--签字区-->标记搬进这个页签(没有标记的旧看板仍插在 body 开头)。核对命令生成的内容改成逐条明细:需求组列这条需求、每条「怎样算做完」、每条自动用例(预期、作证、测试);范围组列落点表的每一个目录(按单元 / 格),一个不省;要亲手验的清单组列每条用例的在哪看、怎么验。每组一个总勾(勾它 = 这一组全勾),每条一个勾、一个意见框;底部一条悬浮条(进度 / 总意见 / 「复制结论」),不用滚到底。复制出来的结论仍按三组写(守卫认的三样不变),组里没勾的条目与写的意见并进那一组的意见里;验收区每条要亲手验的用例一组、同一条悬浮条。 - 结果单的验收单每条需求写明「自动用例:满足(N 条全过)/ 不满足(哪几条没过)/ 没有」,要亲手验的写「以你的勾为准」;床 S4 改名「对话框输入位里粘的或打的那一句」。
- 账本与仓外镜像一起删掉:试过拿签字基线当物证判成「被改过」,守卫单元床里凡清理账本的夹具都红了(12 条),代价大于洞,按设计不改;改成写进标准 11(「只删掉仓内那一份」认得出;「与镜像一起删掉」只能当没签字、要用户重签、分不出是谁删的)、架构详图 §八 需求对账一段与洞二,床 L1 加一步钉住这个边界。
- 同批(不进框架版本):计划的机器镜像里用例 16(「旧账本按原样认」是 v4.7.2 已撤掉的行为)、用例 22(「开头写着」改成「『闭环』一节写着」)、标准 11 改了措辞,签字作废、用户重签;看板多处过期正文订正。
- 计划模板加第七个页签「签字」,
- v4.9.x
签字区的结论经对话框粘回:执行者弹对话框接用户的粘贴,守卫认输入位里的整段、不认选项标签
设计指纹695dae25内容指纹1582ec8c测试指纹1ac46d2539635e41改动设计 4 个(harness-engineering.md、ADR.md、SKILL.md、SKILL.md);代码 6 个(guard.js、command-policy.js、requirements.js、verify-harness.js、requirement-check.js、seal.js)
需求需求闭环已发布
为了:需求闭环(需求 10)—— 用户 10-04 看到 v4.8.0 的流程停在「等你贴回」时说清了要的交互:「通过一个对话来强制我把复制的内容粘贴回来……指定某个文件,审阅里面的东西,点击复制审核内容,然后粘贴到你给我的交互行中,然后提交」;贴回从「靠他记得回到对话里贴」改成「执行者弹对话框接着」,新增一条签字通道,升第二位(ADR-79;主版本仍留 4)。
- 守卫写后的选项题(AskUserQuestion)答完:答案整段等于某个选项标签的只记成他说过的话;其余(他在「其他」输入位里粘的、打的)与在对话里说的同一份判法 —— 签字区结论认签字,固定句认签字,别的只记话。标签是执行者写的,不这样挡,执行者把签字结论写成标签、用户一点就替他签了。
- 复制按钮把结论连成一行(段与段用「|」隔开),粘进对话框的单行输入位不被换行截断;守卫的 parseBoardSign 换行与「|」都认。签字区旁的提示、按钮文字改成「粘进我弹出的对话框里提交」。
- 守卫给执行者的几句提示(说话提醒、写前拦截、写后提醒、收尾点名、开工报文、没签字时的命令提示、封版拒封)都写明「刷新签字区后弹对话框接用户粘回」;此前 v4.8.0 封版后收尾环点名时它们还写着「用官方选项让用户再点一次」,照它做走不通(选项题的答案已不认签字),一并订正;要亲手验的用例上限 15 条留着,理由改成清单太长用户验不过来。
- 测试:签字床 G3 加「连成一行与多行认成同一个结论」;守卫回归 RQ37c–g(对话框输入位里粘回 ⇒ 签;答案等于标签 ⇒ 不签;多行贴到对话里照认)。
- 工作流说明:刷新签字区之后必须弹对话框(题目写明看板路径与三步,选项只放不构成签字的话),用户在「其他」输入位里粘贴提交;宪法 §六.8 不改(「在计划看板的签字区里勾选、复制结论贴回」仍成立,贴回的落点是对话框)。
- v4.8.x
两次签字搬进看板签字区:勾选、复制结论、贴回;对话里的签字题全部去掉
设计指纹81e6ea38内容指纹6f3fcb9e测试指纹cd16bec6000b0358改动设计 5 个(CLAUDE.md、harness-engineering.md、ADR.md、SKILL.md、SKILL.md);代码 5 个(guard.js、requirements.js、verify-harness.js、PLAN-TEMPLATE.html、requirement-check.js)
需求需求闭环已发布
为了:需求闭环(需求 10)—— 用户 10-03 看到验收题当场推翻对话里的勾选题(「给我访问地址,让我在需求的 html 中全部处理完之后点击一个类似复制结论的按钮,然后把结论复制到这里给你即可」),拍板「对话里的勾选题全部去掉」;新增签字区这一类东西,升第二位(ADR-78;主版本按用户 10-03 的话暂留 4)。
- 核对命令(reconcile)每跑一次把签字区写进看板
<body>开头的<!--签字区-->…<!--/签字区-->里:没签字 / 签字作废 ⇒ 需求确认区(需求 / 范围 / 要你亲手验的清单[/ 动不动钱]各一个勾、总意见框、「复制结论」按钮);在办且落盘的结果单全绿 ⇒ 验收区(验收单 + 每条要亲手验的用例一个勾一个意见框、在哪看怎么验);有一查红 ⇒ 写明哪一查红、不开;完结 ⇒ 「已完结」。勾用 data-sign、默认全空;结果单编号剥掉签字区再算,刷新签字区不改编号。 - 守卫在用户说话那一刻认签字区「复制结论」生成的整段(parseBoardSign):内容编号对不上 ⇒ 签字区旧了;结果单编号不是落盘那张 ⇒ 不是最新的那张;少一样不算;有「不对」记「不过」、他写的意见就是原因;全「对」再当场重算三查、核那张是绿的才记完结;夹着别的行只记成他的话。打字「确认 <名>」照旧算签字一,「验收完结 <名>」不带单子编号照旧按没看过单子记账。
- 写前不再挂选项题(settings.json 写前名单去掉 AskUserQuestion);写后的选项题答案只记成说过的话;弹题前的三查前置、带答案弹题的拦、分组合并、「有一项不对」那一套随选项题一起去掉。
- 测试:签字床 G2–G5、G11 改成经看板文本签字(G4 另测生成器:签字区内容、刷新不改看板指纹、红单不开验收区);守卫单元床 C1 / C5、团队床 T4c / T4d、守卫回归 RQ24 / RQ29 组 / RQ37–RQ47 / LZ15 / LZ19–LZ21 / TM4 组改成看板文本。
- 计划模板留
<!--签字区--><!--/签字区-->占位;x-feature-dev 与 x-harness-dev 的说明改成签字区流程;宪法 §六.8 的「经官方选项点选」改成看板签字区。
- 核对命令(reconcile)每跑一次把签字区写进看板
- v4.7.x
看板与机器镜像一字不差:弹验收题与签字二也核,不只签字一
设计指纹becb80dd内容指纹0a056cbf测试指纹825dcba6402005f9改动设计 1 个(harness-engineering.md);代码 2 个(requirements.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 10)的第十三次独立复盘在 v4.7.11 之后指出标准 15「不一致时签不了字」只在签字一那一刻核,签字一之后改看板照样能弹题、能记完结,补洞不改契约,升第三位。
- 此前「看板与机器镜像一字不差」(每条「怎样算做完」的原文、每条用例的「拿什么作证」、落点表的每个目录、用例一条不多一条不少)只在签字一那一刻核;计划目录是免检面,签字之后谁都能改看板,于是改掉一条标准或作证再派复盘、弹题、签字二,整条链放行,用户对着一份与锁住内容不一致的看板签字。现在弹「验收完结」那道题之前与记签字二那一刻都再核一遍:对不上就不让弹、不记完结(账本记一笔 board-diff),点名哪一条。
- 测试:签字床加 G11(签字一之后改一个字 → 弹不出、签字二不记完结、改回去放);守卫回归加 RQ45a0(经守卫入口弹题拦)。
- 诚实边界:复盘者另指出「需求账本每一笔带链、不经守卫改就认得出」的四道闸只对各计划的账本成立 —— 说过的话、没签字那份、「计划和账本都没了」那份小账三份的完整性只在收尾与派发时核、或根本不核(洞五十五已登记一份,这一轮把三份一起写进去);标准 2「每写完一个文件都被告知在不在范围里」只对编辑工具成立,命令行直写要等收尾点名(用例 2 早已写明,标准原话没有)。
订正 v4.7.10 的误拦:2>&1 / >&2 是描述符复制,不是落点
设计指纹58ea7370内容指纹5a3c4690测试指纹f2d134deb89fc199改动设计 1 个(harness-engineering.md);代码 2 个(command-policy.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4)的第十二次独立复盘在 v4.7.10 之后指出换目录闸把
2>&1/>&2的「1」「2」当成相对路径落点,cd 子目录 && 只读命令 2>&1在有签字时被误拦且报假原因,订正不改契约,升第三位。- 直写清单此前把每个带
>的重定向目标都收进去,包括>&加数字的描述符复制;v4.7.10 的换目录闸对清单里的相对路径一律拦,于是「1」「2」被当成落点。现在描述符复制不进直写清单(与没签字白名单那一句同口径);cd 子目录 && echo x > a.txt这种真落点照拦。 - 测试:守卫回归加 WL6k3b、WL6k5b–WL6k5c(换目录 + 描述符复制放、换目录 + 相对落点仍拦,两种签字状态各一)。
- 诚实边界:复盘者另指出两处与代码不符的旧说法已改(看板洞三十七 / 三十九 / 四十三 / 四十四 / 四十六按现状改写,架构详图两处「旧账本按原样认」改成 v4.7.2 之后的判法),并把「账本追加两步、没有跨进程排队,两个钩子同时落笔会让整本账判成被改过」记成洞五十七(方向是全关不是放行,留给下一条需求加文件锁)。
- 直写清单此前把每个带
换了目录之后相对路径的落点一律拦;env -C、git grep -O、LESSOPEN / TMPDIR 同补
设计指纹4c2da436内容指纹832d15d0测试指纹2f65d3de76afb3a4改动设计 1 个(harness-engineering.md);代码 2 个(command-policy.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4)的第十一次独立复盘在 v4.7.9 之后指出 cd 进深层目录后用相对路径写能覆盖守卫与设置、删写证据台账,两种状态都放行,补洞不改契约,升第三位。
- 落点此前一律按仓根解析:
cd .claude/plan/某计划 && cp 仓外文件 ../../hooks/guard.js、rm -rf ../tmp/ledger的落点被算成仓外或别处,保护目标比对、直写清单、没签字免检面三处都看不见(路径归一还把开头的..直接丢掉),有签字时cd .claude && cp 仓外文件 hooks/guard.js同样放行。现在与脚本那一支(v4.7.7)同一条规矩:命令里换了目录(cd 到仓根之外、pushd / popd)或钩子说当前目录不在仓根,相对路径的落点(重定向、cp / mv / rm / mkdir / touch 等带路径参数的写命令、tee / sed -i / dd / git 输出文件 / 只读名单里的写旁路)一律拦、不分签没签字;绝对路径的落点照常判。 env -C / --chdir=<目录>换着目录跑命令与 cd 同病,与-S同判一律拦。git grep -O<程序> / --open-files-in-pager拿命中的文件起别的程序,没签字时拦(与 -c diff.external 同类)。LESSOPEN / LESSCLOSE(less 的预处理器,「|程序 %s」形态照样起程序)与TMPDIR(决定 mktemp 落在哪)并进「决定跑哪个程序 / 写到哪」的变量名单。- 测试:守卫回归加 WL2e5–WL2e5b、WL6k–WL6k5、WL6m–WL6n2;签字床文件头 G6 一句过期注释订正(正文早已改成「不认领旧账本」)。
- 诚实边界:复盘者另指出版本锁的内容清单不含设置文件与守卫测试目录、与落点表口径不一(洞十三已登记,不另开洞)。换目录之后只写绝对路径照常可用,相对路径一律拦是取「算不出就不放」而不是复刻 shell 的目录语义。
- 落点此前一律按仓根解析:
git 的输出文件开关当成写:保护目标拦、进直写清单、没签字时按免检面判
设计指纹3c756c92内容指纹fb38e492测试指纹6294fa471b785fbb改动设计 1 个(harness-engineering.md);代码 2 个(command-policy.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4)的第十次独立复盘在 v4.7.8 之后指出
git log -1 --format=… --output=<受治文件>没签字时整条放行、内容任意、文件真被覆盖,三处判定都不把它当成写,补洞不改契约,升第三位。- git 只读子命令(log / diff / show …)的
--output=<文件>与--output <文件>会把输出写进那个文件,--format还能让内容任意;format-patch 与 archive 的-o/--output-directory、bundle create 的第一个位置参数同类。此前保护目标比对、直写清单、没签字白名单三处都只认子命令名、不看这些开关。现在这些落点与 sort -o 那一类同判:保护目标(守卫、账本、设置)不分签没签字一律拦;有签字时进直写清单(写后按归属点名、收尾对账);没签字时按 cp 同一套免检面判,落仓外或计划、账本目录才放。 - 测试:守卫回归加 WL6j–WL6j5(四种写法拦、仓外与计划目录放、有签字时保护目标仍拦与业务目录放)。
- 诚实边界:这是第十次同一个病根(白名单只按命令名放、不看它写不写文件)的补法,枚举的是「有输出文件开关的 git 子命令」,
git help -w起浏览器这类不写文件的旁路没有拦。
- git 只读子命令(log / diff / show …)的
命令组真正切段:函数体与 case 分支体独立受判;没签字时函数定义、git -c 起程序一律拦
设计指纹671967b2内容指纹d5da97c1测试指纹cc49676d3e0600b1改动设计 1 个(harness-engineering.md);代码 2 个(command-policy.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4)的第八次独立复盘在 v4.7.7 之后指出 shell 函数定义、case 分支体、git -c 三种写法没签字时放行且真执行,连脊柱只读一并绕过,补洞不改契约,升第三位。
- 分词把
( ) { }只当词边界、不切段:name() { cp … 保护目标; }; name与case x in x) cp …;; esac里的 cp 留在 name / case 那一段的后面,整段按第一个词判 —— 没签字白名单与脊柱只读(C2 / 保护目标比对)都没看见那个 cp,真仓实跑真拷出。现在( ) { }与;一样切段,函数体与分支体里的每条命令独立受判;${VAR}与 find 的{}占位符并进当前词,不当命令组。 - 没签字时定义 shell 函数(
name()、name ()、function name)本身也拦:它改写了白名单命令名指向什么,与 hash -p、改 PATH 同类。 - git 的全局选项
-c key=value能让只读子命令起别的程序(diff.external、core.pager、core.fsmonitor、alias、filter、textconv …),枚举黑名单写不全:没签字时 -c 只放一张显示类小名单(颜色、路径引号、换行、分页器关掉、日期与 diff 显示方式、用户名邮箱、不签名),其余一律拦;--config-env、--exec-path=同拦;靠环境变量起程序的那几个(GIT_EXTERNAL_DIFF、GIT_PAGER / PAGER、编辑器、ssh、askpass、代理命令、GIT_CONFIG_*、GIT_EXEC_PATH)并进「决定跑哪个程序」的变量名单。子命令自己的 -c(git log -c)不在此列。 - 测试:守卫回归加 WL6i–WL6i6(三种写法各拦与对照放、占位符与变量不误切)。
- 诚实边界:复盘者另指出洞清单正文写的总数(四十四)与表里实有(五十六)对不上,已改成实有数。
- 分词把
没签字时换了目录或当前目录不在仓根,相对路径的脚本一律拦
设计指纹efa59524内容指纹7dae0cc8测试指纹e169a27fb5d0e1d8改动设计 1 个(harness-engineering.md);代码 3 个(guard.js、command-policy.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4)的第七次独立复盘在 v4.7.6 之后指出
cd 计划目录 && node 受治相对路径没签字时放行、node 实跑的是计划目录里可随意写的同名文件,与标准 1 不符,补洞不改契约,升第三位。- 「受治树里已有的脚本」此前按仓根解析相对路径,而
cd .claude/plan/某计划 && node .claude/skills/x-harness-dev/scripts/harness.js实跑的是计划目录下同名相对路径上的文件 —— 计划目录是免检面,没签字也写得进去;cd 自己又在只读名单里,钩子输入里的当前目录(cwd)从不看,Bash 的工作目录还跨调用持久(先 cd、再分一条写同样绕过)。现在没签字时:命令里换了目录(cd 到仓根之外、cd 不带目标或cd -、pushd / popd)或钩子说当前目录不在仓根,node / python 相对路径的脚本(主脚本与预加载都算)按「解析不出是哪一份」拦,提示写绝对路径或不换目录从仓根跑;cd 回仓根、绝对路径的脚本、换目录后跑只读命令照放。守卫把钩子输入的 cwd 交给命令判定(guard.js 一行)。 - 测试:守卫回归加 WL2e–WL2e4c(三种换法、两种当前目录、三条对照放)。
- 诚实边界:当前目录按钩子输入的 cwd 判,平台若不随 Bash 的持久工作目录更新它,分两条写的那一路只剩命令里的 cd 可认。复盘者另指出两处不构成不过、记进洞清单(五十五、五十六):「计划连同账本一起没了」的提醒看的那份小账不在完整性核对里;结果单「归别的需求范围」一栏的「本会话在它完结之前写过」不看此刻内容是谁写的。
- 「受治树里已有的脚本」此前按仓根解析相对路径,而
没签字的白名单:命令词写成路径、改 PATH、hash -p 一律拦
设计指纹f34f5eed内容指纹3f072577测试指纹ac61ae2ee35d41d9改动设计 1 个(harness-engineering.md);代码 2 个(command-policy.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4)的第六次独立复盘在 v4.7.5 之后指出没签字的闭集白名单只按命令词最后一段放行,
./ls、/tmp/evil/cat、PATH=/tmp/evil ls实测全放,仓外脚本能跑、与标准 1 不符,补洞不改契约,升第三位。- 命令词写成路径(
./ls、计划目录里的 ls、/tmp/evil/cat、C:/…/cat)此前被 normName 剥成 ls / cat 整条放行,跑的其实是那条路径上的任意程序 —— 计划目录与仓外谁都能写,先写一个叫 ls 的脚本再按路径跑它,整条链不用签字;包裹词写成路径同病(/tmp/evil/env ls)。现在没签字时命令词连同被剥掉的包裹词里带路径分隔符的一律拦:白名单里的命令写裸名字,受治脚本写node <脚本>。 - 同一条路的另两种走法一并堵:命令行上改 PATH / BASH_ENV / ENV / CDPATH / LD_PRELOAD / LD_LIBRARY_PATH / PROMPT_COMMAND(裸前缀、env 前缀、export / declare / typeset / readonly / local / read / printf -v);
hash -p / -d改命令查找表。 - 对照放:别的变量带斜杠的前缀(
FOO=/tmp/x ls)、export 别的变量、hash -r、路径只出现在参数里。 - 测试:守卫回归加 WL6g–WL6g7。
- 诚实边界:复盘者另指出用例 25 的作证写「守卫回归 TM5、TM8」偏重 —— 回归里那两行只验「没写过东西不拦、引擎缺席判不了也不拦」,真正咬住红项拦停的是执行体床 T3;它判「不构成缺陷」,改作证要用户重签,这里记下不改。
- 命令词写成路径(
env -S / --split-string 把整串命令装进一个参数:一律拦
设计指纹71f7ad2b内容指纹3e7cd9e0测试指纹46bb31b162b509b2改动设计 1 个(harness-engineering.md);代码 2 个(command-policy.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4)的第五次独立复盘在 v4.7.4 之后指出
env -S'tcb fn deploy x'被剥壳整条吞掉、发布闸与没签字白名单双双放行,补洞不改契约,升第三位。env -S'…'与--split-string='…'(含 GNU 认的长选项缩写--split=、短选项簇-iS…):一整串命令装在一个参数里、由 env 自己切开执行。剥壳只看见「一个选项」,剥成空词表后按「无命令词」放行 —— 命令行直接发布闸与没签字的闭集白名单都看不见里面的tcb fn deploy,被 nohup / timeout / exec 包着照样。现在不分有没有签字一律拦:不复刻 env 的切法(它有自己的转义、引号与${VAR}展开,复刻一半就是下一个洞),剥壳给词表打标记、判段据它拦,要跑什么直接写出来。- 对照放:env 不带 -S(
env A=1 cat …、env -i ls)与别的命令的 -S(curl -sS)不受影响。 - 测试:守卫回归加 WL6f–WL6f6(三种写法、三种包裹、对照放、有签字仍拦)。
- 诚实边界:
env -u 变量 命令这类带值选项仍按旧剥法(值不以 - 开头就当命令名),不在本次射程。
把命令串挂起来或藏起来执行的写法:trap 带命令串、awk 管道到命令与 getline、没签字时的命令替换
设计指纹f3f66005内容指纹f58b1204测试指纹6037cba6e6f33b62改动设计 1 个(harness-engineering.md);代码 2 个(command-policy.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4)的第四次独立复盘在 v4.7.3 之后指出没签字的闭集白名单仍有执行任意命令的写法,补洞不改契约,升第三位。
trap '命令串' 信号与 eval 同类、不看签字一律拦:命令串在引号里、分词认不出里面的发布与重定向,shell 退出那一刻才跑,守卫看不见(活体:trap 'tcb fn deploy x' EXIT绕过发布门、trap ': > .claude/hooks/guard.js' EXIT退出时把守卫清空且收尾兜不住)。trap -l / -p、trap - 信号(复位)、trap '' 信号(忽略)照放。- awk 起别的程序的三种写法同判:system( )、
print … | "命令"(含 |& 协程)、"命令" | getline;此前只拦 system( )。 - 没签字时命令里带命令替换或进程替换(
$( )、反引号、<( )/>( ))一律拦:里面的命令照样执行、输出被当成参数收走,闭集白名单只看得见外面那个命令名(cat "$(node /tmp/evil.js)"的命令名是 cat)。有签字时照旧。 - 测试:守卫回归加 WL6a–WL6e2(拦与对照放,含有签字时 trap 仍拦、命令替换照放)。
- 诚实边界:没签字时引号里的字面
$((grep '\$(' 这种)也会被拦,宁多拦不漏拦;有签字时命令替换里写了什么仍只由收尾按时间窗归属(守不到之处早有登记)。
只读名单里的写旁路:sort -o、uniq / xxd 的输出文件、mktemp、tree -o、history -w、rg --pre
设计指纹54f922df内容指纹65e0c767测试指纹01ad4c89a9a108fa改动设计 1 个(harness-engineering.md);代码 2 个(command-policy.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4)的第三次独立复盘在 v4.7.2 之后指出没签字的只读名单放过会写文件的命令形态,补洞不改契约,升第三位。
- 没签字的命令白名单:只读名单里几个命令的写旁路按 PATH_CMDS 同一套免检面判落点 —— sort 的 -o / --output=、uniq 与 xxd 的第二个位置参数(输出文件)、mktemp 的模板与 -p / --tmpdir(模板不带目录时建在当前目录)、tree -o、history -w / -a;起别的程序的开关(rg --pre、sort --compress-program)一律拦。此前
sort -o .claude/hooks/guard.js /dev/null没签字时整条放行,活体实测能当场把守卫清空。 - 有签字时这些落点与 cp 同一道保护目标比对、同样进直写清单。
- 测试:守卫回归加 WL4f、WL5a–WL5e2(拦与对照放)。
- 诚实边界:只读名单其余命令按「没有写文件的开关」逐个核过一遍(cut / tr / paste / column / nl / rev / tac / comm / diff / od / base64 / jq / wc / grep / rg 的其它开关);带值选项的值与文件分不清的(xxd 的 -l / -s / -c / -g / -o、sort 的 -k / -t / -S / -T 等)按已知清单跳过,清单外的带值选项会把值当成文件多算一个落点,只多判不少判。
- 没签字的命令白名单:只读名单里几个命令的写旁路按 PATH_CMDS 同一套免检面判落点 —— sort 的 -o / --output=、uniq 与 xxd 的第二个位置参数(输出文件)、mktemp 的模板与 -p / --tmpdir(模板不带目录时建在当前目录)、tree -o、history -w / -a;起别的程序的开关(rg --pre、sort --compress-program)一律拦。此前
再补三处:node 尾随 -v 放行、install / ln / rsync 的落点、凭空新账本被认领(旧账本认领整个撤掉)
设计指纹8ae4daec内容指纹98ea7113测试指纹5da43f46fd74c2a0改动设计 1 个(harness-engineering.md);代码 3 个(command-policy.js、requirements.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4、6)的第二次独立复盘在 v4.7.1 之后指出同一道白名单仍有三处放行,补洞不改契约,升第三位。
- 没签字的命令白名单:node 的 -v / --version / -c / --check 只认写在主脚本之前的(
node ../evil.js -v脚本照跑,此前整条放行);install / ln / rsync 的落点与 cp 同一道保护目标比对、同样进直写清单;免检面(计划、.claude/tmp)里的脊柱(写证据台账、需求账本、射程缓存)不免检。 - 需求账本:迁移前旧账本的认领整个撤掉(v4.7.1 加的名册随之删掉)—— 没有链也没有仓外镜像的账本一律判成被改过;守卫给没有镜像的账本第一次记账时,仓内已有的内容没有链就不抄进镜像。真仓三份账本早已带链有镜像,不受影响。
- 测试:守卫回归加 WL3h / WL3i(尾随开关拦、前置开关放)、WL4b–WL4e(三个命令的落点);requirements 床 L1 与签字床 G6 改写成「凭空出现的账本判成被改过、守卫再记一笔也洗不白」。
- 诚实边界:重算链之后再改镜像的洗白(洞二)照旧;install 的 -m / -o 这类带值选项的值会被当成一个来源、只多算一个落点,不少判。
- 没签字的命令白名单:node 的 -v / --version / -c / --check 只认写在主脚本之前的(
补两个洞:没签字时 node 预加载仓外脚本放行、需求账本去链删镜像后被重新认领
设计指纹d059a409内容指纹86c070a2测试指纹df675055755107a1改动设计 1 个(harness-engineering.md);代码 3 个(command-policy.js、requirements.js、verify-harness.js)
需求需求闭环已发布
为了:需求闭环(需求 1、4、6)的独立复盘在 v4.7.0 之后抓出两处必须改,补洞不改契约,升第三位。
- 没签字的命令白名单:node 的预加载开关(-r / --require / --import / --loader / --experimental-loader / --env-file,含「=」粘连写法)的值与主脚本同判 —— 必须是受治树里已有的脚本,否则拦(此前只核主脚本,
node -r ../evil.js 受治脚本放行,活体实测仓外脚本先跑、真写进受治目录)。 - 需求账本:有过镜像的账本登进镜像目录里的名册(
_adopted.json,只增不减;换上这一版之前就有镜像的账本第一次读到就登进去),不再按迁移前的旧账本认领;镜像不见了就是被改过(此前去掉每一笔的链、追加一笔没链的「已完结」、删掉镜像,下一次读时与旧账本同形、被重新认领成已完结)。 - 测试:守卫回归加 WL3e–WL3g(预加载拦与对照放)、TM8d(队友写脊柱照拦);requirements 床 L1 加「降级洗白不得重新认领」一段(用 v4.7.0 的守卫跑会红)。
- 诚实边界:名册与镜像住同一个仓外目录,连名册一起删仍能洗白;
--env-file的值按脚本同判(.env 没签字时一律拦)。
- 没签字的命令白名单:node 的预加载开关(-r / --require / --import / --loader / --experimental-loader / --env-file,含「=」粘连写法)的值与主脚本同判 —— 必须是受治树里已有的脚本,否则拦(此前只核主脚本,
团队模式进强制层:停下来那道关、执行体身份记账、带身份的事件不认签字、同时改同一个文件写前拦
设计指纹09b37d3a内容指纹ebc5b18c测试指纹ea146b1d6df79a1a改动设计 3 个(harness-engineering.md、ADR.md、SKILL.md);代码 5 个(guard.js、requirements.js、verify-harness.js、requirement-check.js、team.js)
需求需求闭环已发布
为了:需求闭环的需求 12(需求方 2026-10-01:「我需要加入 agent team…各司其职」),依据两次探针的实测(ADR-77)。
新挂一个零件、守卫多两道关、结果单多一栏,升第二位。
- 新零件
guard/team.js与 guard.js 的接线:身份与写证据标记、停下来那道关(SubagentStop)、同时写同一个文件(PreToolUse)、队友活着时领队的收尾(只推迟还没放手的那一位写的文件;放出来的文件按新的一轮全拦并点名是谁写的;有文件新被推迟时红数变少不算减少)、领队停队友按名字补记(PostToolUse 认 TaskStop)、带名字派复盘者拦、包着队友标签的话不记成用户原话。 - 三查结果单:第一查加「谁写的」与两个执行体都写过的文件(这一栏出现才进编号)、停下来那道关拦过几次、没查就放了几次、只查了一部分几次。
- 需求零件:已完结需求的范围也认计划目录已删、账本还在的(范围取最后一次签字记下的目录)—— 守卫会话 10-03 实测报来的空档。
- 钩子接线文件:写后的工具名单加 Agent 与 TaskStop;环境变量加团队开关。
- 测试:新床 team-gates(28 条)、team-attribution(8 条);守卫回归加 TM1–TM9(含收尾推迟的十几种序列)、LZ22–LZ30,MR1 的「不该认上」改成按写前、写后各算;requirements 床加「计划目录删了的完结需求」一段。
- 说明:开发流说明加「什么时候组队、怎么组」;架构详图需求对账与执行体两节;§八「平台遇到预填答案还弹不弹题未查」改成 10-02 实测结论(照常弹、不认预填)。
- 没有副作用:没有执行体写过东西的需求,结果单与编号和此前逐字相同。
- 新零件
- v4.6.x
守卫提速与补洞:守卫只在该起时起、同一件事只留一份判法、云端与命令行补洞、检测引擎复用射程、回归用例咬得住
设计指纹4363e13d内容指纹3dfe18f3测试指纹0a88283003e67f6c改动设计 2 个(harness-engineering.md、ADR.md);代码 16 个(guard.js、checker-invoker.js、command-policy.js、mcp-policy.js、release-versions.js、requirements.js、session-ledger.js、stop-handler.js 等)
需求守卫提速已发布
为了:「守卫提速」这条需求(需求方签过字的那份计划:照守卫盘点定下的方案改守卫与检测引擎,让守卫只在该起时起、同一件事只留一份判法、补上查出的洞,每一处改前改后用测试对拍)(ADR-76)。
新挂一个时刻、检测引擎多一个模块、守卫零件换了装法,升第二位。 守卫盘点(复盘看板 D-04 之后的那一轮)把守卫与检测引擎里「白起的进程、重复的判法、咬不住的用例、没堵的洞」逐条列了出来;本版照定下的方案一次做完。改动先在工作副本上分批做、每批对拍,再与 v4.4.6–v4.4.8 合并,最后合到 v4.5.0(需求闭环第一段)之上;合并版上又过了两轮独立审查与一轮少墙对拍(真仓现版与合并版逐条命令、逐个事件对着比):第一轮查出的少拦已修掉,第二轮查出的咬不住的用例已逐条补上并改坏验证,少墙对拍查出的五类不在计划里的少拦、少记已修掉并补了用例;之后一轮复验又查出其中两类各留着同一类里的另一种写法,也已补上并补了用例;再一轮复验在其中一类里又查出第三种写法,这一次不再一种一种补 —— 取「shell 包着的命令」改成照各家 shell 自己的参数文法走,写后另留此前原来的取法作第二种读法,并把三种 shell 的开关组合成批生成出来对拍(一千一百多万条写法:此前记的这一版都记,照文法真会执行的这一版都认得出;另抽样真跑)。合到 v4.5.0 时:需求对账的共用判定接到 v4.5.0 的取范围上;v4.5.0 重写的签字题两段照零件用到才装的规矩过了一遍,进了故障注入对照表;真仓 v4.5.0 与这一版逐条命令、逐个事件又对着比了一遍。合并之前的最后一轮复验换了一套生成办法,在 powershell 那一支又查出一处少拦(带值开关写成守卫认不出、powershell 自己认的样子,后面跟脚本文件再跟执行开关);修它时逐个真跑 powershell 的开关表、把真跑的判法从「看屏幕上有没有记号」换成「看记号文件」,又查出同一个病根的另外三种(带冒号的开关、圆括号里的命令、反斜杠并词),一并改成「判不了就拦」,并另造一套带花样的开关词成批生成出来对拍。
- 挂载范围与起法:写前、写后只挂守卫按工具名分支处理的工具(名单带
^$,cloudbase 按前缀认),读文件、搜索、别家 MCP 不再起守卫;这两个时刻改成直接起程序的写法(command只写 node,脚本与事件名在args里),不再先起两层 shell。新挂PostToolUseFailure(只认 Bash)到写后那一支:命令执行失败时平台不走写后,此前失败的命令不记时间窗、它写出的文件到收尾算无主。收尾等其余时刻保持原写法(换写法实测基本打平)。 - 零件用到才装:守卫的零件第一次被用到时才装,装不上照旧走启动壳报文、退出码 2(直接结束进程,调用处的 try 吞不掉)。与这个事件不相干的零件坏了不再连坐说话与配置变更;用得到它的事件照拦 —— 含写前 Bash:没签字的闭集白名单与直写落点的需求闸经守卫的装载口取需求零件,命令判定自己装不上也按拦处理。
- 编辑前少读台账:先按「没写过」问该不该拦,放就不读;要拦、而且本会话写过,再按「写过」问一次;只读本会话那一份,文件名逐字对上才读。
- 部署门:总预算从守卫进程启动那一刻算(此前只管推代码那几臂,前面的 git 测量与版本比对最坏能把写前钩子拖过平台时限,被掐等于放行);git 测量只拿剩下的时间;发布前版本比对挪进子进程跑同一个函数,超时、退出码不是 0、没出标记行、读不出数组一律拦;回归套件把预算与写前钩子的时限绑住。被拦时先报最便宜的那一样(运行时配置绕过 → 待检 → 版本 → 推代码各臂)。同一处版本问题只报一次(契约已报整个 HARNESS 时,极简比对那一行不再追加)。打包器剥离臂按上传目录的真实路径再问一次(仓外联接指回仓内同拦),上传目录是 UNC 路径一律拦。
- 写后:写前另有的四类(运行时配置绕过、全仓没复核的改动、版本没封、上传目录缺内核或会被剥掉)在写前拦截不是确定在岗时也补判,与写前同一份代码、只判不跑测试床;云存储与静态托管的单文件下载落进仓里记写证据;包着的发布命令写后认得出,取法照各家 shell 自己的参数文法走:bash 类把选项(连同它的值)走完,剩下的整串就是命令串或脚本文件(
bash tcb fn deploy x这种把命令行的启动壳当脚本跑的也算;多字母选项的名单照本机bash --help,只此一处);cmd 在每个词里找「斜杠加 c、k、r」,开关粘在前面的(/d/c、/s/q/c)也认 —— 这一种此前写前写后都认不出,顺带补上;powershell 不带开关、-Com简写、斜杠与长横开头的开关、-o-i-ea-p这类带值开关后面的执行开关都认(带不带值拿不准的两种读法都取);另有一种「每个参数先去首尾空白、空词只在开关位置跳过、连 bash 会去掉的反斜杠一并去掉」的读法(powershell 自己就是这么取参的:" -c" "<命令>"、"" -Com "<命令>"、-e\p x.ps1 "<命令>"真执行),四种读法各取一遍、任一种认出发布就记;powershell 可能从第一个它不认的开关词起就把整串当命令串,那一串也另认一遍;cmd 与 powershell 的命令串里圆括号里的命令照样执行,括号换成分号再认一遍;cmd 的参数里不止一处「斜杠加 c、k、r」时每一处后面的整串各认一遍(cmd /k/c "<命令>":第一处被 Git Bash 改写掉了);bash 的thendoelseelif与 cmd 的call、@前缀后面的命令照常认(此前这一段的第一个词是关键字,后面整个不判:有在办需求时写前放、写后不记);.cmd启动壳同认;eval、source、.、iex、Invoke-Expression 后面的整串写后也向内再判一层(powershell -wd . "<命令>"的命令串就是「. <命令>」、照样执行;此前不往里看,顺带补上)。写后记账另留此前(到 v4.5.0 为止)原来的取法作第二种读法:任一种读法认出发布就记,记账不比此前少;写前任一种取得出命令就拦。 - 云端策略:auth 只放查状态、发起登录、登出,
set_env与login_by_api_key核目标环境;数据库实例销毁、取原始连接信息拦;callCloudApi的 ssm、kms 与 sts、cam 同拦;PostgreSQL 两个工具与 MySQL 同一套语句分级;运行时配置绕过闸连params里带的超时与内存一起看;已下线的三个工具的登记删掉;下载落点名单里退役的.githooks换成.git。 - 命令行:cp / mv 先定目标与源(
-t写法、带值选项按 GNU 规则取)、只判一遍真实落点,这份取法与 python 一族的名单各只留一份,判落点与没签字的闭集白名单共用;包管理器跑哪个脚本只一个取法(选项写在前面也认得,run 的别名同认;脚本名不是起服务器的名字时再看其余词,只对查询、安装类子命令免拦;子命令前面的带值选项按 npm、pnpm、yarn 各家自己的表与并表两种读法都看,任何一种读法取出起服务器或生产构建的脚本名都拦,两种读法取出同一个词才免拦);py、pythonw内联执行拦;包着的命令(bash / cmd / powershell)写前写后同一个取法;powershell「跑脚本文件」放行之前判不了就拦 —— 走过的开关词里有一个认不出的(词里带空白、反斜杠、$的都算)、表里认而 Windows PowerShell 5.1 不认的开关(带冒号的写法、pwsh 才有的、截得太短的)后面有分号、竖线、圆括号、大于号、位置上的.ps1自己或后面的词里有这些记号、参数里有 bash 会改写的记号($、反引号、反斜杠)又有执行开关,都不算跑脚本文件(这几样里带执行开关的写法此前的合并稿放、v4.5.0 拦,是少拦,已补;不带执行开关的 v4.5.0 同样放,顺带补上);命令名的.cmd、.bat后缀与.exe一样去掉,只用在拦的方向(没签字的白名单、删已完结的计划这两处放行的地方不放批处理);没签字白名单里 rsync 只看最后一个路径;cmd、powershell 带执行开关词(-c、-e、-Command这一类)而整条命令里有东西喂标准输入(管道、<<<、<<、<、进程替换、coproc)时照拦(echo "<命令>" | cmd -c、powershell -File - -c x <<< "<命令>"真执行:此前的合并稿放、v4.5.0 拦,是少拦,已补;标准输入会从外层继承,所以按整条命令看);mv 把保护目录本身挪走拦(检测引擎那棵树、空壳桩目录、名叫 sys / templates / .umi 的目录、装配产物目录:-t写在前面的写法此前的合并稿放、v4.5.0 拦,是少拦,已补;最简写法 v4.5.0 同样放,顺带补上;cp 往外复制不动原件、照旧放);剥包裹词时新剥的 then / do / else / elif、call、@ 前缀只用在拦的方向(没签字的白名单与命令名混淆闸照 v4.5.0 的剥法:call ls、@名字=值 …照旧拦)。守卫文件头的说明改成与事实一致。 - 需求对账:收尾与三查判「写没写范围外」用同一个函数 —— 范围就是 v4.5.0 定的取法(在办的认此刻的范围,本会话签的、签字作废的只认签字那一刻记下的目录),这个函数逐个文件问它盖没盖住;「刚完结的需求范围里、完结前本会话写的改动不算越界」三查也认(并进「归别的需求范围」一栏、标「已完结」);三查脚本自己装的量仓零件装不上,与量仓出错同样按判不了红(零件用到才装之后守卫不再一启动就装它,此前走到三查会静默退回只看写证据:弹验收题拦、答验收题不记完结);没签字白名单里 v4.5.0 新加的「受治且文件存在」那一句经同一个装载口取需求零件;看板有几步只有一份数法(只数带步骤编号的勾选框);已完结的需求再说「不过」回话「已经完结」,不追加 reject;收尾时对账或计划目录核对算不出来按拦处理、拦一次。
- 收尾:台账一轮只整读一次、归属比对前按文件建索引;本会话一个受治文件都没写就不算全量指纹;无主改动的复核同归收尾总时限管;继续拦比的红数改成不过的检测结果条数(违规加基础设施异常,无规范规则书的报备不算,放行那一轮点名报备的是哪本);继续那一轮不把写后复判标成已报;只提示的上游牵动面只列名字、不逐面核。
- 检测引擎:
--changed的全仓射程按「引擎代码、全部规范、文件与目录清单、母本包说明」四样的指纹缓存复用(新模块check/scanners/scope-cache.js),拿不准一律现算;缓存目录.claude/tmp/.scope-cache进脊柱写保护,守卫起检测引擎时从环境里去掉X_SCOPE_CACHE_DIR。业务树覆盖金丝雀从守卫回归套件挪到检测引擎面的床(床头@covers点名 references 目录),套件不再有「金丝雀报警」的退出码。删掉只给测试用的specCoverageGaps。 - 回归:只核退出码、换成空壳照样拦的用例补「报文里要有什么」;写前 Bash、「结论只由云端策略决定」的用例与写后 Bash「认不认得出发布」的各种写法改在套件进程里直接调判定,端到端名单两路都跑、逐字比报文(写后那几条比台账;每类命令判定至少一条,需求闸与闭集白名单也在名单里);新增各组:挂载范围 MR、零件用到才装 LZ、零件坏了 FI 与「事件 × 零件」故障注入对照表 FM(同一行事件的放行方向只起一次守卫:用不到的零件全换成一装就留记号再抛的桩,LZ 多核「一个都没去碰」;v4.5.0 重写的签字题两段各有一行 —— 弹验收题、答签字一、答验收题)、编辑前读台账 RL、失败后时刻 PF、部署门总预算 TB(守卫副本里把预算、门槛与慢桩同比例缩小实跑;留给「守卫启动加前面几样跑完」的余量两秒半以上 —— 缩到一秒出头时机器一忙对照用例会被预算误拦;对照与「判的东西和预算无关」的五条用守卫原样的预算与门槛跑,只有到点才拦的四条用缩小的)、版本比对子进程 VG、写后补判 PU、剥离臂 SA(含 UNC)、射程缓存 SC、命令行 CX / TD / PK / PY / W / CL / WL 各组的增补;装配面床改用秒退的检测桩。新床:射程缓存床、覆盖金丝雀床;需求对账、会话台账、收尾环、测试面、版本比对、工作树探针、三查核对各床有增补(会话台账床有一条把「失败的命令写出的文件 → 失败后时刻记时间窗 → 收尾归到这个会话 → 拦」整条链一口气走完)。
- 有意少拦、少做的(计划里定的,写明):往
.githooks下载不再拦;继续拦按结果条数比,同一批只修好一部分文件时少拦一轮;cmd -c、cmd -e不算代码执行(cmd 不认这两个开关;参数里另有$、反引号、反斜杠这类 bash 会改写的记号时照拦,整条命令里有管道或输入重定向喂标准输入时照拦),powershell -File之后的词算脚本参数、第一个位置参数是.ps1时它后面的执行开关算脚本的参数(powershell x.ps1 -c "…")、带值开关把执行开关当值吃掉而后面取不出命令时不算代码执行(powershell -v -Command -se "…")—— 这三种只在「走过的开关词都认得出、从 powershell 可能当命令串的那个词起没有语句记号、带着执行开关整词时参数里没有 bash 会改写的记号、整条命令里没有管道或输入重定向喂标准输入」时才放,认不出的开关词不在此列、一律按拦;三种都成批真跑过、不执行(这几样说的是写前不拦;写后记账留着此前原来的取法,它记的照旧记),cp -t <仓外> <保护目标>这类往外复制不拦;cp / mv / install / ln 照 GNU 规则取目标之后,v4.5.0 因为把最后一个参数或选项的值错当成目标而拦下的写法不再拦(mv -t <别处> <业务源文件或普通目录>、只有一个操作数、多个-t只看最后一个、-S/--suffix/--no-preserve/--sparse的值、长选项的缩写 —— 与不带-t的同一件事同判;mv 挪走保护目标与保护目录本身照拦),没签字时 rsync 的-t、-S不再当成目标目录;查询、安装类子命令里碰巧出现 start、dev 字样不再误拦;本会话没写受治文件时收尾少一行「别人的范围外改动」的附注;只提示的牵动面不逐面核;读文件、搜索不起守卫;写前拦截确定在岗时写后不重复判那四类;收尾一轮里别的进程(别的会话、同一会话的后台子代理)中途追加的记录下一轮才看见;已完结的需求再说「不过」不追加记录;三查也认「刚完结的需求范围里的改动不算越界」。少墙对拍补列的四样(都归得到上面各条):一个零件坏了只拦用得到它的事件(此前所有事件都拦;答验收题时三查里的量仓零件坏了,此前守卫启动失败、退出码 2,现在退出码 0、不记完结);编辑放行时不读台账,台账目录坏掉时放行的那几种编辑不再跟着拦;已下线的downloadRemoteFile按认不出的工具写前拦、写后记一笔,不再记写证据(认不出的云端工具在策略那一步先拦下、不再走到量仓,也就不顺手建台账的存量基线,下一次任何事件会建);没签字时pythonw、带多段版本号的 python 跑受治树里的脚本与 python 同放。 - 守不到之处(写进架构详图):直接起程序的写法在某一版平台上起不来时,写前不拦、写后也不补判 —— 换上后与每次换平台版本都要在真实会话里逐个时刻核;PowerShell 工具与笔记本编辑工具守卫不处理;云端工具调用失败不走写后;脚本直接写射程缓存文件拦不住;powershell 的编码命令(
-EncodedCommand)写前照拦,写后看不出编码里包的是不是发布(此前同);取 shell 包着的命令只照 bash、cmd、Windows PowerShell 5.1 的文法实测过,pwsh、zsh、ksh 没装、没验证;命令行里几种真执行而认不出的写法此前同样认不出、这一版没动:cmd 的开关写成/\c(反斜杠)、bash 的ifwhileuntil后面直接跟的命令与case … in 模式) 命令、cmd 的if … 命令、powershell 位置上的.ps1后面用反斜杠转义的括号(没有执行开关时)、管道或输入重定向把命令喂给不带执行开关词的 cmd / powershell(echo "<命令>" | cmd)、here-doc 起始行后面的管道(cat <<EOF | bash)、|&后面的 bash;rm / rmdir / git mv 删挪保护目录本身(在 .claude 里的另有「rm 删 .claude」拦着)、没签字时把受治文件 mv 出仓,此前同样不拦、这一版没动。
- 挂载范围与起法:写前、写后只挂守卫按工具名分支处理的工具(名单带
- v4.5.x
两次签字改成需求方的话、验收单、看板与机器镜像一致才让签;执行体每层有主、名册扩到六层配齐
设计指纹fe6ddc83内容指纹895421ce测试指纹0f1cc6e5d8bec59f改动设计 21 个(CLAUDE.md、_registry.md、x-admin-engineer.md、x-adversarial-reviewer.md、x-architect.md、x-client-engineer.md、x-data-engineer.md、x-harness-auditor.md 等);代码 7 个(guard.js、command-policy.js、requirements.js、verify-harness.js、PLAN-TEMPLATE.html、scope.template.json、requirement-check.js)
需求需求闭环已发布
为了:需求闭环的需求 10、11(需求方 2026-10-01:「两个签字,一个签需求确认,一个签实施交付」「验收就应该是一个验收清单,而不是选择」「宪法的 L0 到 L5 就要有自身的 agent 来负责」),并补上洞三十五(题里打字被记成不过)、洞四十二(签字作废期间合法改动被记成越界、记进别的会话的账本)与换上之前两轮独立审查指出的问题(ADR-75)。
- 签字题:签字一的选项改成「需求」「范围」「要你亲手验的清单」(动钱多一项);签字二的选项就是机器镜像里没有自动测试的那几条用例,一条一项。一道题最多四个选项,放不下分几道同一句开头的题一起弹,守卫合起来核;要亲手验的用例超过十五条签字一就拦。
- 弹题前置:验收题弹出之前先查,三查有一样不绿、选项不是那张清单、落盘的结果单不是最新的,题弹不出来;两种签字题带着答案弹出都拦。
- 题里打的字只记成用户的话,不算签字也不算不过;勾「有一项不对」才记不过。答案照平台的分隔切开,整段等于某个选项才算勾了它(此前按子串找:问一句提到选项名的话就算勾了)。
- 看板与机器镜像一致才让签:每条「怎样算做完」、每条用例的「拿什么作证」、落点表每个目录要在看板看得见的地方逐字出现;用例一条不多一条不少。看得见按标签逐个走(认引号里的大于号、行内四种隐藏写法、收起的折叠块、注释与脚本样式模板)。
- 验收单:结果单末尾加一节,逐条需求列出对着哪几条标准、自动用例过没过、要亲手验的是清单第几项;下半张就是要亲手验的清单。验收单进结果单编号。
- 收尾与三查认范围:签字作废的需求只算本会话签的、只按签字那一刻记下的目录;越界只记进本会话那份账本或没签字那份。
- 基线:签字那一笔带上基线指纹与签字时的目录;基线没了拒绝重记;只在仓外镜像里有的账本只点名、不拷回。
- 命令白名单:没签字时受治名单之外的目录里的脚本也拦(受治且文件存在才放)。
- 执行体:新增框架架构师、体系工程师、测试工程师三份;原有十二份各补写域、输出经谁核、结论记在哪;对抗审查官、体检官、元治理专家、框架架构师用 fable;规范裁判官接测试床;下线专家的线上删除移交部署专家;官网归后台前端专家、治理站点归体系工程师、服务端内核母本归云函数专家。名册同步,「官方只能派一层」的旧说法删掉。
- 测试:新建签字床(十条)与验收单床(四条);守卫回归重写 RQ29 组、新增 RQ37–RQ47 与 WL2b–d;造计划的六个测试文件加一层夹具包装(看板自动带机器镜像原文);会话台账床把仓外镜像指进沙箱。换上之前把七处关键判定逐个改坏,对应的床都红。
- 说明与模板:计划模板与机器镜像模板写明标准对着需求几、用例对着标准几、要亲手验的用例写在哪看怎么验;三份工作流说明与架构详图的需求对账、执行体两节同批回看;宪法里执行体那一句改成按六层配齐。
- v4.4.x
订正:复盘者转录里平台注入的说明(isMeta)不算续跑
设计指纹ffb20978内容指纹94aa0466测试指纹60acecde2d517649改动设计 1 个(harness-engineering.md);代码 2 个(guard.js、verify-harness.js)
为了:让第七次独立复盘那样的可信结论不被误标不可信(平台给复盘者塞了一条「上一段回答被安全分类器截断」的说明,v4.4.7 按用户消息条数判续跑,把它当成了第二条提示词)。
- 守卫:复盘者收尾判「被续跑」改按提示词的 promptId 数(同一条提示词的消息共用一个),带 isMeta / turnCompanion 的平台注入消息跳过;回归加 RV3q(isMeta 不算续跑)、RV3s(两个 promptId 才算)。
需求闭环换成闭集:没签字时命令行只放白名单、需求账本链式指纹加仓外镜像;并收第六次独立复盘的修补
设计指纹8ce23801内容指纹21cd79cf测试指纹dfe575f0e00211c8改动设计 3 个(harness-engineering.md、SKILL.md、SKILL.md);代码 6 个(guard.js、command-policy.js、requirements.js、verify-harness.js、requirement-check.js、seal.js)
为了:让需求闭环的「没签字不能改」成为闭集意义上的真墙(六轮复盘证明黑名单枚举写法是开集、追不完,用户拍板换方案),并让直接改账本不管什么写法都必被识破。
- 白名单(没有任何在办需求时):命令行只放只读命令、shell 关键字与内建、git 只读子命令、受治树(.claude / x-harness / x-core / x-test)里已有的脚本(node / python);重定向与带路径参数的写命令(cp / mv / rm / mkdir / touch / tee / dd …)只在全部落点都在仓外或免检目录(计划、账本)的字面路径时放;仓外脚本、带变量的重定向、git 写子命令、find -exec、curl 落盘、npm run、tar 等一律拦。有在办需求时不走这里(那时守的是范围与留痕)。此前那张黑名单(直写形态)保留给硬保护面。
- 账本:每一笔带上一笔原文的指纹、同时追加到用户目录下的镜像(测试沙箱经环境变量指进沙箱);链断、与镜像不符、镜像不见、账本文件不见都判「被直接改过」:写前一律拦、签字不记、计划删不掉、复盘者派不了、收尾每轮点名、封版拒封、结果单第一查红;迁移前没链没镜像的旧账本按原样认,第一次经守卫记账后镜像从旧段起头。
- 守卫:sed 原地写认短选项簇里带 i(-ri / -Ei)与 --in-place=后缀(此前只认 -i 与裸 --in-place,一行
sed -ri就能改需求账本伪造「已完结」);cp / mv 的 -t 与 --target-directory= 形态按「目录 + 源文件名」算真实落点过保护面与需求闸(此前只比目标目录本身);路径归一把 Git Bash 的 /e/… 与 e:/… 归成一种(此前 /e/… 被当成仓外);挪走或删掉整个仓库根(绝对、Git Bash、../x 三种写法)与硬保护同判。别的会话发来的消息之外,复盘者收尾多核三样:结论里的结果单编号必须是任务说明里那一张、转录里不止一条提示词(被续跑)不可信、同一份任务说明只记一笔可信结论;不可信的不计入连败。 - 需求对账:计划看板被删或被清空与目录没了同判、收尾点名(计划目录是免检面,
: > PLAN.html写时拦不住);刚完结的需求范围里、完结前本会话写的文件,完结后的第一次收尾不再误拦;没有任何在办需求时写后也说「不在任何范围里」;受治名单加.claude/settings.local.json、.mcp.json、.claude/docs/admin/antd-6-full.txt(改它们等于改钩子权限、MCP 定义、x-antd 行号闸的比对基准)。 - 核对命令:第三查加「落点表里每一格都变过、且不全是别的会话改的」(设计图四写明机器查这一半,此前只列不判)。
- 测试:守卫回归加 RQ7i–n、RQ8d、RQ33l–o、RQ35b/c、RQ36b、RV3i–p、RV6e;单元床 C2 加看板清空、C5 加完结后不误拦、A1 加无在办需求的写后提醒、V2 加不可信不归零;核对命令床 R1 改口、新增 R12(每格变过);会话台账床新增 L15(真 git 仓:没签字 + 命令写 + 时间窗 → 收尾点名)。
- 口径:设计图四「第一查不过封版发布完结都过不去」改成实际(封版前只查越界与第二查,发布出口没接);两份技能说明与架构详图里「和账本目录里最新那张单子比」改成「弹题那一刻记下的那张」;开发流说明里验收题的选项名改成守卫要的三样。
需求闭环第五次独立复盘后的修补:直写路径的命令过需求闸、删挪上一级目录同判、验收只认弹题那一刻的单子、老测试只认床本身变过
设计指纹3c57b4f2内容指纹f362c7f0测试指纹4fff662e740a85d7改动设计 2 个(CLAUDE.md、harness-engineering.md);代码 7 个(guard.js、command-policy.js、requirements.js、verify-harness.js、PLAN-TEMPLATE.html、requirement-check.js、seal.js)
为了:让需求闭环这套机制经得起第五次独立复盘(ADR-74 的延续),并让标准 1「直写路径的命令改不了受治文件」成为机器真能保证的话。
- 守卫:直写路径的命令(重定向 / cp 与 mv 的落点 / tee / sed -i / dd of=)写受治文件,与编辑工具走同一道需求闸(没有签过字的需求就拦;变量、通配、仓外、计划与账本目录不管);删与挪按「有没有保护目标住在它下面」判上一级目录(
mv .claude/hooks、mv .claude/tmp、mv .claude、mv .claude/plan此前全放:正则要求斜杠后有内容,目录本身匹配不上;账本目录挪出去改一笔再挪回来能伪造「已完结」);unlink与 rm 同判;别的会话发来的消息(cross-session-message)不进原话记录(此前被记成用户发话,放空了连续三次不过那道闸)。 - 签字二:弹「验收完结」那道多选题那一刻守卫记下账本目录里那张单子的编号、颜色与题目指纹,签字二只认这一笔 —— 打字说的、或写前拦截停着时弹的都算「没给他看过」(此前认磁盘上最后写的那张,给用户看过绿单之后再重算一张也算他看过);签字题的必选项按动词分(签字一三样、动钱的需求多「动不动钱」;签字二是三查结果单 / 复盘结论 / 要你点的用例);看板正文还留着方括号占位签不了;
.stylelintrc.json进受治名单;签字作废期间放过的写也说在不在范围里。 - 核对命令:第二查只认床文件本身变过(只改被测代码、床一字没动仍算老测试充数,宪法 §六.7 两边同批改);同一张结果单上先「不过」后「过」不算清掉。计划恢复之后再删再点名(此前「点过名」永远算数)。范围按并集(与收尾对账同口径):不在本需求范围里、却在别的在办需求范围里的改动不算本需求越界,单列一栏。
- 封版前置:每条触及本单元的需求按它自己的会话(签字那笔记的)算,不按跑封版的会话;它的会话还没在本单元动过手的不拿它的用例闭环拦别人封版(真仓出现第二份触及同一单元的计划时抓出:用跑封版的会话算别人的需求,本会话范围里的改动全成了别人的越界,别人刚签字零改动也把封版卡死)。
- 测试:守卫回归加 RQ1e/f、RQ7c–h、RQ12d、RQ29a–g、RQ33b–k、RQ43c/d;单元床 C1 改成经弹题记单子那条路、C2 加恢复后再删、C5 同步;核对命令床 R7 加同单子过不盖不过、R9 加只改被测代码、新增 R10(小仓造没封版的单元 ⇒ 第三查红点名它);会话台账床新增 L14(真 git 仓里命令行改范围外文件 → 时间窗归属 → 收尾点名越界);封版床 R6 标题改成只走「不存在」一支、另两支归 R9。
- 口径:宪法 §六.8「固化封版前与完结前查同一件事」改成「封版前先查其中此刻判得了的两项」;计划模板与看板里 section 的 id 不再与页签容器重名;计划目录里多放的模板副本删掉、scope.json 的 trial 字段去掉。
- 守卫:直写路径的命令(重定向 / cp 与 mv 的落点 / tee / sed -i / dd of=)写受治文件,与编辑工具走同一道需求闸(没有签过字的需求就拦;变量、通配、仓外、计划与账本目录不管);删与挪按「有没有保护目标住在它下面」判上一级目录(
需求闭环第四次独立复盘后的修补:stash -u 与 mv -t 的暗道、路径大小写、全局忽略文件、复盘者身份与模型、量仓出错不降级、claude -p 冒充签字
设计指纹f9ad869b内容指纹1a619cae测试指纹2a1d8b2eb868f66c改动设计 1 个(harness-engineering.md);代码 6 个(guard.js、command-policy.js、requirements.js、verify-harness.js、PLAN-TEMPLATE.html、requirement-check.js)
为了:让需求闭环这套机制经得起第四次独立复盘(ADR-74 的延续),并把「怎样算做完」写成机器真能保证的说法。
- 守卫:
git stash带上未跟踪文件(-u / -a / 长写法 / 短选项簇)一律拦(不带路径的 stash -u 会把签过字的计划连同需求账本整个挪出工作区,收尾连「计划不见了」都点不了名);mv -t <目录> <来源…>与--target-directory=形态按来源判硬保护与计划目录;claude -p / --print拦(洞三:命令行起无界面会话喂话能冒充签字);受治判定大小写不敏感(Windows 上写成 X-SERVER/… 曾绕过写前拦截与写后提醒);列受治文件时关掉用户级全局忽略文件(-c core.excludesFile=/dev/null)。 - 复盘:派发时复盘者只能是 x-adversarial-reviewer、模型不许降级(haiku / sonnet);收尾时不是对抗审查执行体的结论标不可信。量仓(git)出错时三查不再静默退回只看写证据,按「判不了」红。
- 测试:守卫回归加 RQ7b、RQ31e–i、RV6c/d、RV3g/h、CL16/17;单元床加 W0,V2 加执行体与模型两项;核对命令床 R2 加看板正文与范围外文件进编号两项;守卫回归套件那张薄壳床改动一行以触发空壳对照(此前冻结基线等于它自己的指纹、从没对照过)。
- 口径:计划的「怎样算做完」标准 1 与 10 改成机器真能保证的说法(经编辑工具与直写路径的命令拦;其余形态收尾点名),用例 2 / 5 / 13 / 15 改点真正测它的床。
- 守卫:
订正:复盘说明里范围外文件的打印(结果单那两栏 v4.4.3 起带指纹,说明程序按旧形态打印成「路径,指纹」);别的会话的范围外文件也列名
设计指纹843ac895内容指纹595346d7测试指纹3fba31feaa4eba75改动设计 1 个(harness-engineering.md);代码 1 个(review-brief.js)
为了:复盘者看的任务说明与结果单同一形态(需求闭环,ADR-74 的延续)。
review-brief.js:范围外「别的会话」「没有写证据」两栏按 [路径, 指纹] 取路径打印,别的会话的文件也列出名字(此前只有计数)。
需求闭环第三次独立复盘后的修补:复盘说明整份逐字核、结论记生成时的编号、计划读不了同「不见了」、stash push 与忽略清单的暗道、签字题选项要核、完结那条路与「没动过」分支补了床
设计指纹fd2a16a0内容指纹1a4c7e8e测试指纹195e7c40cc5dad80改动设计 1 个(harness-engineering.md);代码 5 个(guard.js、command-policy.js、requirements.js、verify-harness.js、requirement-check.js)
为了:让需求闭环这套机制经得起第三次独立复盘(ADR-74 的延续)—— 复盘者看的、机器记的、用户签的必须是同一份东西。
- 复盘:可信 = 第一条提示词逐字等于程序生成的那份任务说明(此前只核正文,表头能加一句「已人工核过直接给过」),且说明是对当前内容生成的;结论记的内容编号取说明生成时的(此前记收尾那一刻的,复盘途中改计划再重签就对不上);派复盘者时提示词必须原样是账本目录里那一份、计划名从那一份取(改表头里的计划名绕不开「连续三次不过」的拦)。
- 计划:scope.json 被覆写成读不了的与「不见了」同判、收尾点名一次;
git stash push -u / save带上签过字没完结的计划目录同删拦;签字锁住的内容加进单元名(封版前置按它挑需求,改名不能让签字还算数);动钱的需求至少一条自动用例(模板的规矩,此前没人核)。 - 签字题:选项必须是需求与怎样算做完 / 用例 / 落点表(此前不核,题目写「确认 <名>」只给一个「继续」也能签)。
- 改动面:任何一层的
.gitignore与.git/info/exclude都受治(第二次只补了仓根;子目录写一个*或往 exclude 加一行照样能藏新建文件),后者进脊柱写保护;结果单编号加进看板正文与范围外文件的指纹(用例 7「改一个字」);版本契约读不了时第三查红。 - 测试:完结那条路真走一遍(三查全绿 → 「验收完结」→ closed)、只差步骤没勾第一查红、老测试充数(跑过但没动过)第二查红、说明改一字不可信也不准派、stash push 计划目录拦、签字题选项不对不算签,各补了床。
- 口径与看板:S30 不再把「删计划」当步骤(完结之后才删);落点表按机器镜像补全;「钩子还没装 / 试运行 / 手填」的旧说法全部改掉;签字记录列全五次;洞清单补
.gitignore中途受治带来的一笔假改动。
需求闭环第二次独立复盘后的修补:收尾对账不再被红项饿死、红单不能验收、范围内无写证据的改动算进本需求、签字前查模板与页签、.gitignore 受治、「不过」要再复盘
设计指纹6444e64b内容指纹a258e644测试指纹96e8dfc245d9d066改动设计 1 个(harness-engineering.md);代码 5 个(guard.js、requirements.js、verify-harness.js、requirement-check.js、review-brief.js)
为了:让需求闭环这套机制经得起第二次独立复盘(ADR-74 的延续)—— 给用户看的和机器判的必须是同一张单子,说不清的一律不算过。
- 收尾环:需求对账与计划目录核对提前算、并进每条退出路径的报文(此前本会话有任何检测 / 测试红项时整段不跑,用例 2 / 9 的收尾点名从来跑不到);红项没减少放行那条路也照拦一次需求对账。
- 验收:给用户看的那张结果单必须是绿的才记「已完结」(编号用的事实此前不含「没指定会话 / 台账读不了」这些判不了的状态,红单与绿单同号),结果单编号的事实里加进这些状态;「不过」之后必须有新的复盘,第一查才绿。
- 第三查:范围里没有写证据的改动(后台命令、手工编辑)算进本需求的单元,只有明确归别的会话的才单列(此前被当成别人的放过未封版的域,单子上「别的会话 0、没有写证据 1」自相矛盾)。
- 签字前:模板原样拷进来没填(字段里还有「【」)不算填了;看板缺需求 / 设计 / 步骤 / 用例任一页签签字不算数(标准 8 此前只看步骤勾选框);签字时范围与别的正在办需求重叠就报出来(洞二十六兑现)。
- 改动面:
.gitignore进受治名单(往里加一行就能把新建的受治文件从改动面藏掉)。复盘结论绑复盘者看的那张单子的范围指纹(任务说明生成时记下),复盘途中执行者重跑核对命令换不掉。「没有用例的标准」那一行改写成「机器判不了」(此前有用例时写死 0 条)。 - 口径改正:命令删计划只挡直写路径的 rm / rimraf / git rm / mv / git mv,换目录、变量、find -exec 等形态拦不住、靠收尾点名兜底(此前写「一律拦」说大了)。
- 守卫回归加 RQ12b/12c;需求对账单元床加 S5、H2 加两项、C1 加「你看的是红单」;核对命令床 R7 加「不过」与「机器判不了」两项;六张床的看板夹具补四个页签。
需求闭环第一次独立复盘后的修补:签字成官方选项里的一道多选题、编号不进用户看的话、没签字时收尾也对账、没通过的验收不冻住需求、复盘可信且绑代码指纹、核对命令与复盘说明进脊柱、说不清一律红
设计指纹022cb20d内容指纹04cb0eb8测试指纹a403ab22e8a54bb5改动设计 2 个(harness-engineering.md、ADR.md);代码 8 个(guard.js、command-policy.js、requirements.js、verify-harness.js、PLAN-TEMPLATE.html、requirement-check.js、harness.js、seal.js)
为了:让需求闭环这套机制经得起独立复盘(ADR-74)—— 用户不懂技术,签字要他点得明白;机器判不了的一律不算过。
- 签字改成一道多选题(用户 09-30 四次纠正后定稿,ADR-74):题目以「确认 <名>」或「验收完结 <名>」开头并带计划的完整路径,选项就是签的内容(需求与怎样算做完 / 用例 / 落点表,业务需求多一样「动不动钱」),全勾 = 签字、没勾全不算、输入框打字 = 「不过 <名> <他打的字>」;三句话去掉编号,内容编号由守卫在勾全那一刻记,结果单编号只进
.sheet.json;写后钩子只认答案,平台返回的优先于调用方传的;平台送进来的后台任务通知不算用户说话。 - 独立复盘者第一次抓出 15 条,真缺陷同批修:没签字时收尾按归属(含命令行写的)拦本会话改过的受治文件,记
_unsigned账本、同内容只拦一次(用例 2);没通过的「验收完结」只记账、不改状态(此前一笔红的验收把需求冻住、签字作废那道闸失效);验收与封版的三查重算不落盘(账本目录里那张永远是执行者给用户看的那张);复盘要可信 —— 第一条提示词正文的指纹对得上程序生成的那一份 —— 且绑定范围内文件指纹,代码一变旧结论作废、第一查要求可信;复盘者只按第一条提示词认、不按执行体类型、不扫整份转录;三查核对命令与复盘说明程序进脊柱写保护(洞七);第三查只按本会话改到的单元判、别的会话在途改到的单列、一个单元都没改到也能完结;归属与收尾对账同一口径(借守卫的量仓与台账归属);没有基线 / 台账读不了 / 没指定会话 / 空壳对照判不了一律红;挪走计划目录(mv / git mv)同删;开工注入改读计划根目录的scope.json(旧路径从来打印不出);「用户发话」按会话分;签字作废期间之外没有「本会话写过就放」的豁免;随代码附带的补签命令删除;带编号的旧写法从守卫报文、模板、帮助文字里清掉。 - 守卫回归加 RQ8b/8c、RQ25b–d、RQ31b/c、RQ42、RV3c/d、RV5d/e、SS1b;需求对账单元床 T2 翻转、加 C4;核对命令床加 R6/R7;封版命令床加 R6。
- 签字改成一道多选题(用户 09-30 四次纠正后定稿,ADR-74):题目以「确认 <名>」或「验收完结 <名>」开头并带计划的完整路径,选项就是签的内容(需求与怎样算做完 / 用例 / 落点表,业务需求多一样「动不动钱」),全勾 = 签字、没勾全不算、输入框打字 = 「不过 <名> <他打的字>」;三句话去掉编号,内容编号由守卫在勾全那一刻记,结果单编号只进
守卫补洞(D-04)与需求对账第一批:保护面扩面、命令暗道、数据库写分级、启动 fail-closed、收尾继续拦、开工注入与接线留痕;需求账本与三句签字、写前无签字不让写、写后对范围、收尾对账
设计指纹09f23229内容指纹b99457d8测试指纹bdffe1776be58114改动设计 7 个(CLAUDE.md、x-adversarial-reviewer.md、harness-engineering.md、ADR.md、SKILL.md、SKILL.md、SKILL.md);代码 15 个(guard.js、command-policy.js、mcp-policy.js、session-ledger.js、stop-handler.js、verify-harness.js、bed-runner.js、harness.js 等)
为了:补上守卫在顶层复盘里被实测打穿的那批洞,并让每条需求先有计划、先有用户的确认,再由钩子在写前、写后、收尾三处对照执行(复盘看板 D-04、D-11、D-12)。
新增几道闸与三个钩子事件,升第二位。 顶层复盘第一站(2026-09-29)用真守卫的只读判定复现出守卫命令行通道与云端工具通道的一批洞(复盘看板 G-10 ~ G-19),本版一次补齐;同一版接着装「以计划为入口、钩子硬控流程」那条需求(它自己的计划住计划目录里,完结后删)的钩子第一批 —— 补洞是它的前提:
- 保护面扩面:整个
.claude/hooks/(含回归床与测试,此前只锁分发器与策略模块,守卫的回归床能随手改就能随手弱化)、两条封版命令(x-meta-devcore/seal.js、x-feature-devarch/seal.js)、两个发布出口(deployer.js、publish-tests.js)、x-core/tools/manifest.js(内核核验与出包)、.claude/agents/*.md(复盘者与执行体定义)、装配面新鲜度戳,都进脊柱写保护;编辑工具直写一律拦,改它们只能先在副本上改好跑完回归再请用户开闸换回。只锁判决依据本身、不锁整棵目录 —— 分发脚本、脚手架、部署门登记表照旧归日常开发改(既有床 SP2 的原则,本版第一稿把体检工具整棵锁进去被它当场拦下)。 - 命令暗道:
cp/mv按「目录 + 源文件名」算真实落点再判(此前目的地写成目录就放);mv把硬保护目标挪走拦;rm/rimraf/del-cli删硬保护目标拦(本地发布档案除外:作废的档案本来就该清);git apply、git stash pop|apply、git update-index --assume-unchanged|--skip-worktree、git rm|mv脊柱文件拦;生产构建(npm / pnpm / yarn / bun / max / umi 的 build 脚本、node --run build)拦 —— 构建只经发布脚本在用户单次授权下跑(宪法 §六.3);python 只拦-(标准输入读脚本)、-m(跑模块)与 pip 装包,落了盘的 .py 与 node 脚本同待遇;NODE_OPTIONS只拦预加载类开关(-r/--require/--import/--loader),内存上限照放。 - 数据库写分级:经云端工具(
manageMysqlDatabase、queryMysqlDatabase的 runQuery)执行的语句先看内容 ——DROP TABLE|DATABASE|INDEX|VIEW、TRUNCATE、ALTER TABLE … DROP、无条件DELETE/UPDATE一律拦(表与字段的删除走五步破坏性迁移、由用户在控制台做);带条件的写照旧过部署门。此前只看仓库有没有未复核改动、不看语句。 - 守卫自身:分发器启动壳 —— 任一零件加载失败退出码 2(fail-closed)并写明恢复办法,此前退出码 1 等于全部放行;部署门总预算 26 秒(床、忽略规则核对、内核核验三段各自扣时,剩不到 1.5 秒即拦),此前三段各自超时能叠到外壳 30 秒之外。
- 收尾继续拦:被拦过之后那一次收尾(
stop_hook_active)不再无条件放 —— 红项比上一轮少但没清零继续拦,没减少放行并说明;台账新事件sr记每轮红数。此前每轮只拦一次。 - 需求对账(需求闭环计划的钩子第一批,
guard/requirements.js):一条需求 = 计划目录(.claude/plan/下的一个目录),人读PLAN.html、机器读scope.json(签字锁住的四样:需求、动不动钱、怎样算做完、用例,加落点表里的目录;内容编号 = 四样的指纹前四位)。新挂UserPromptSubmit:用户每句原话逐字进需求账本.claude/tmp/requirements/(脊柱写保护),认三句固定的话 —— 「确认 <名>」记签字一(钩子记下此刻的内容编号)并记全部受治文件的指纹(只记第一次),「验收完结 <名>」记签字二,「不过 <名> <说明>」记验收不过;整句完全相同才算,计划缺需求 / 设计 / 步骤 / 用例任一部分都不记。编号不进用户看的话(10-01 用户原话「这个 fb8e 我根本看不懂……这是你的工作」):内容编号在他点「确认」那一刻由钩子记,内容一改签字作废;结果单编号只进.sheet.json,他点「验收完结」时钩子拿他看过的那张(账本目录里最新生成的)与当场重算的比,不同就要他看新单子。签之前让他知道签的是什么(10-01 用户原话「你至少要让我知道签的内容」):计划看板的完整地址写在题目里(界面只给用户看题目与选项,正文会折成一句摘要,10-01 用户看到的就是「已生成在 PLAN.html」);选项就是签的内容 —— 需求与怎样算做完、用例、落点表,业务需求多一样「动不动钱」,框架与系统规范的需求不显示它(那是业务侧的标记,用户原话「框架升级为什么会牵扯到钱」);每样的要点写在选项说明里。这三句打字算,经官方选项也算,而官方选项里的签字只有一种形态(10-01 用户四次纠正后定稿):一道多选题,题目以「确认 <名>」或「验收完结 <名>」开头,选项就是签的内容(需求与怎样算做完、用例、落点表、动不动钱)—— 全勾 = 签字(钩子替他说出那句固定的话),没勾全不算(只记勾了的、说缺哪样),在输入框打的字 = 意见、记成「不过 <名> <他打的字>」(打了字就不算签);不是这种形态的题只记原话、不推断;写后钩子只认答案,不把选项标签当用户说的。执行者该用选项让用户点,不该让他手打固定句,也不该勾完内容再问一遍「签不签」(自相矛盾),不设「先不签」选项(不勾就是不签)。平台当成用户输入送进来的后台任务完成通知(整段是 task-notification 标签)不记、不算用户说过话(否则「连续三次不过要用户发话才能再派」这道闸被它放空)。写前:没有正在办(签过字且内容没改)的需求,不让写受治文件(不拦计划与看板、.claude/tmp、仓外、本会话已写过的文件)。写后:一句「在哪条需求的哪一格 / 不在范围里」放在工具结果旁。收尾:对签字那一刻的基线算改动面,范围取全部正在办需求的并集(一份计划盖住的改动不算另一份的范围外),范围外的按收尾环已算好的会话归属(内容指纹 → 命令时间窗,命令行写的也认得出)—— 本会话写的与分不清的拦一次并记oos、内容变了再拦,别的会话与没有写证据的只列并点名。 - 三查接关口(需求闭环计划的第 3 批):体检工具新加核对命令
harness.js --action=reconcile,对签过字、正在办的需求出三查结果单(第一查实施复盘:对签字基线算改动面、范围内外、按写证据归属、数步骤的勾、复盘结论;第二查用例闭环:每条用例点名的测试对当前内容过没过、是不是这条需求期间新建或改过的、咬没咬住,要用户点的看账本;第三查固化核对:改到的单元封没封、封后动没动、落点表每一格变过没有、有没有「为了」),带编号 = 判定事实的指纹前四位,结果单写进需求账本目录。版本契约多一行:每一版标题下一行> 为了:一句话,三层同一种写法,统一封版命令没有这一行拒封。封版命令封之前先跑三查里与固化有关、此刻判得了的两项(本会话零越界、用例的自动测试闭环),触及本单元的在办需求任一红即拒封;步骤与复盘归完结那一关。签字二「验收完结 <名> <结果单编号>」:钩子当场跑三查,编号对得上最新一张单子且三查全绿才记「已完结」,否则记下这一笔并说清哪一查红。删计划:签过字还没完结的计划目录rm/rimraf/git rm一律拦并说明,完结了的放(.claude树里唯一准 rm 的地方);被脚本删掉的收尾点名一次。 - 复盘进关口(需求闭环计划的第 4 批):复盘者的任务说明由程序生成(
harness.js --action=review-brief --plan=<名>:需求、标准、用例、落点表、签字后的改动清单、最新结果单编号、结论行格式,第一行带任务编号,写进需求账本目录),不由执行者手写。新挂SubagentStop:复盘者(只按它收到的第一条提示词里有没有程序生成的任务说明标记认 —— 不按执行体类型,按类型认会把拿对抗审查官做普通挑刺的也逼着编计划名与结果单编号、往账本记假复盘;也不扫整份转录,扫整份会把干活时读过守卫源码、回归床的子代理认成复盘者;两处都是守卫盘点会话抓出的)最后一行必须是固定格式「复盘结论:过 / 不过 <计划名> <结果单编号>」,格式不对不让它收尾;认出结论就进需求账本(不过也记),并核转录里的任务编号是不是程序生成的那一份(对不上照记、标不可信)。派复盘者之前(Agent 工具、提示词带任务说明标记):连续三次不过、用户还没发话 ⇒ 不让再派。三查的第一查读这些结论:最新一次是「过」且对着当前内容才算复盘过。治理站点新鲜度传感器按会话归属(守卫盘点会话活体抓出的跨会话误拦):对不上的源落在本会话改动里的才拦,全是别人改的只提示一行。 - 两个新钩子事件:
SessionStart开工注入(标准输出写明写前拦截在不在岗、正在办的需求与计划位置,取自计划目录的scope.json;记一笔闸的状态);ConfigChange与编辑工具写settings.json都记一笔cfg(来源、文件、此刻闸的状态)—— 开闸关闸各留一痕。两者都不拦。 - 唯一运行器:起床的子进程剥掉
NODE_OPTIONS里的预加载开关(stripPreload,落在判定口径区,全部床的旧记录随之作废、须重跑)—— 那条注入口只归换空壳检查自己在进程内用。 - 回归:守卫回归套件新增 CT(收尾继续拦)、BD(构建)、PY、NO、CM / RM(复制搬走删除)、GD(git 暗道)、PP(保护面)、BT(启动 fail-closed)、DBW(数据库分级)、SS / CC(开工注入与接线留痕)各组;RF8、SV9、SV10 三条旧断言按新立场翻转;收尾环那张床的副本工作区补上架构资产目录(x-arch v2.0.5 起锁着它,副本不带它基线就红);运行器床加 G27。
- 保护面扩面:整个
- v4.3.x
版本契约第三轮堵漏:锚单元不许消失、业务目录里的测试按登记认、静态站点打包前再比一次版本
设计指纹3357c3d8内容指纹a7823a4b测试指纹e1a9cce05bc5c0be改动设计 3 个(harness-engineering.md、ADR.md、x-meta-rule.md);代码 8 个(guard.js、framework-lock.js、stop-handler.js、test-faces.js、publish-tests.js、bed-runner.js、check.js、version-contract.js)
新增几道核对,升第二位(ADR-72)。 v4.2.0 封版后第三轮独立对抗审查:此前复现的 12 条绕过逐条重跑,全部确认已堵;另复现出一条严重的新漏洞与几处小缺口,本版堵上:
- 单元能整个消失:版本契约每次按磁盘现算单元名册,没有地方记「这个单元本应存在」—— 删掉关系图文件、把
.claude/harness改名、删掉 x-arch 的文件,那个单元连同它管的名册一起从所有检查里消失,守卫的框架锁极简比对在框架目录没了时也自己关掉,收尾与发布都报没问题。现在三个锚单元(整个 HARNESS、业务总览、x-arch)在本机台账封过就不许从磁盘上消失,收尾每轮都核(不再「本会话没改变更历史就不管」)、发布前核;框架锁极简比对遇到「目录没了而台账封过」直接报。其余单元由两本名册管,锚在名册就在。 - **业务目录里叫 tests 的目录、*.test.js 被当成测试跳过**,而它们会随包上传 —— 现在只认测试根名册与部署门登记过的床,别处的照样算业务代码,新出现的当场红并说清该放进测试根还是登记部署门。
- 删掉判据文件,收尾看不出系统规范域少了一个(发布兜得住)—— 删判据文件也让 x-arch 当轮整单元核。
- 静态站点先比版本、再测试与构建,这期间改的受治文件不再比一次 —— 准备档案之前再比一次。
- 收尾封版复核只收变更历史(删掉锁清单要等发布才看见)—— 也收锁清单的改动。
- 站点「版本」页把统一之前的记录标成「已封版」,与变更历史页打架 —— 同一个判法,只标按契约封过的版本。
- 治理站点构建器不在任何单元(它的发布验收结果被发布档案信任)—— 归属不清,收进框架会让改站点样式也升总版本,写进诚实边界③。
- 文档:对照审查挑出的文字项逐条订正 —— 十个业务域测试设计页的「重算时」(上一版漏掉的句式)、客户域目录说明、账户注销域视图页、x-arch 条款与判据补上业务域名册与整段历史、x-arch 架构页「按需登记」、架构详图 §八 §十六 的封版复核口径与两条旧的问题登记、运行器与判定模块里几处旧说法。
新的床:版本契约 N1(改写)、H14;判定模块 K12(补收尾环入口)、K13;框架锁 F8;收尾环 S17;发布出口 D11;站点 G9(补一条)。8 个新判定臂在副本上逐一撤回,对应用例都变红。
- 单元能整个消失:版本契约每次按磁盘现算单元名册,没有地方记「这个单元本应存在」—— 删掉关系图文件、把
- v4.2.x
版本契约第二轮堵漏:锁清单钉整段历史、业务总览记业务域名册、业务代码原文比、每条发布通道同一套比对
设计指纹28b77ebd内容指纹2ba8d853测试指纹6197011c1b04c9b6改动设计 6 个(harness-engineering.md、ADR.md、x-dev-rule.md、x-meta-rule.md、SKILL.md、SKILL.md);代码 12 个(command-policy.js、release-versions.js、stop-handler.js、test-faces.js、publish-tests.js、orchestrator.js、layer-auditor.js、seal.js 等)
新增几道核对,升第二位(ADR-71)。 v4.1.0 封版后再做一轮独立对抗审查(两个执行体:一个在沙箱里逐条复现绕过,一个逐条对照文档与代码),复现出的漏洞本版逐条堵上:
- 已封的历史只钉了第一节:删掉旧版的记录行就能改它、没闭合的代码块能吞掉已封版、最旧的契约期版本删了没人报 —— 锁清单另记封过的那一版到文件末尾的整段历史指纹,旧版一个字都不能改(施工中也一样);锁清单缺这一样就是按旧契约封的,第一节已封就报,全部 57 个单元本版升版重封(业务代码先用 v4.1.0 的口径核过:封版之后一行没改)。
- 删掉锁清单、再删掉变更历史的「改动」行,就能重新首封、重冻无主基线 —— 「这个单元封过没有」另看本机台账;收尾与发布对「锁清单不在或坏了、台账却有记录」报红,封版拒绝首封。
- 删掉整个业务域不用升任何版本 —— 业务总览的锁清单记业务域名册(与 x-arch 记系统规范域同一个做法);名册成员新增、删掉时,增量检测让持名册的单元整单元核。
- 按语法去注释仍骗得过(JSX 文本里的
//与/*、挪动 require、改字符串里的空白)—— 业务代码改为原文比,注释与空白也算改。 - 静态站点四个出口的发布准备不比版本(只靠 MCP 那一道,开闸时整条不比)—— 发布准备先调同一个发布前比对
guard/release-versions.js。 - 部署门入口与空壳对照不在任何单元 —— 归框架(内容);部署门注册表与钩子接线仍不锁(前者业务开发天天改、后者开闸关闸由用户定),写进诚实边界。
- build、coverage 这类目录名里新写的代码逃过「无主只减不增」 —— 业务代码只跳过依赖、构建与装配产物、测试目录。
- 只改文件名大小写看不见 —— 算改动(云端认大小写)。
- 会话身份用 printf -v、read、借变量名间接改写拦不住 —— 命令里出现这个名字(除读取外)一律拦;把名字拆开再拼接仍拦不住,写进诚实边界。
- 文档:对照审查挑出的 21 处与代码不符的说法逐条订正 —— 报文里的升版规则、x-arch 条款与判据的一步一升与施工中开关、《系统架构标准》「不受版本锁步管」、21 个业务域视图页的旧叫法(保鲜、重算指纹、修改历史)、账户注销域「零保护」、站点入口页的框架范围与「只有收尾放过施工中」、封版命令文件头描述的已否决设计;ADR-71 记下施工中开关的执行点是收尾、开发流 VERIFY 与封版的检测前置(取代 ADR-69「只有收尾」)。
新的床:版本契约 H1(改写)、H7(扩)、H8–H13;判定模块 K12;收尾环 S16;工作区探针 SID1(扩);发布出口 D10。17 个新判定臂在副本上逐一撤回,对应用例都变红。
- v4.1.x
版本契约堵漏:比对口径按语法、封过的一版全锁、一次只升一步、两条发布通道同一套比对
设计指纹36ba5ab4内容指纹69568659测试指纹9aa7e2badf73d311改动设计 19 个(harness-engineering.md、ADR.md、x-dev-rule.md、x-meta-rule.md、x-standard-rule.md、SKILL.md、_registry.md、x-admin-engineer.md 等);代码 55 个(guard.js、command-policy.js、test-faces.js、worktree-probe.js、deployer.js、seal.js、verify-feature.js、seal.js 等)
新增几道核对,升第二位(ADR-70)。 用户 09-28 问「版本的架构设计完全统一了吗、牙都确认真实的硬控了吗」。对 v4.0.0 做了一轮独立对抗审查(五个角度、每条发现再对抗核实),确认下面这些漏洞,本版逐条堵上:
- 比对口径:业务代码此前按行尾
//一刀切去注释,字符串里的网址、glob、调用目标改了都看不见 —— 现在按语法认注释(字符串、模板、正则字面量里的不算),.wxml认<!-- -->与内联<wxs>;数据表由只取字段集改为比完整结构(必填、唯一、选项集、长度都算)。口径一变,20 个业务域的锁清单全部作废,各补丁升版重封(先用旧口径核过:全部只因口径变了,没有人改了代码没封)。 - 一次只升一步:此前只要变大,跳号、低位不归零都放行;现在相邻两版只能某一位加一、后面的位归零,封版与整单元核对都判。
- 封过的一版一个字不能改:锁清单另记这一版的日期、标题与说明、测试行与改动清单,改了就红;此前只锁文件。
- 锁清单不能靠删来重来:变更历史里有按契约封过的版本、锁清单却不在或坏了 —— 收尾与发布红,封版拒绝当成首次封版(此前删掉业务总览的锁清单,下次封版就把无主基线从头冻结)。
- 改了变更历史就整单元核:三层都核(此前只核整个 HARNESS,且路径大小写没统一,只改框架变更历史时这一段根本没跑)。
- 两条发布通道同一套比对:新增
guard/release-versions.js,MCP 部署门与脚本出口(deployer.gateFunctions)都调它 —— 整体比对、框架锁极简比对、全部单元契约生效之后每一个封过的版本逐版对台账(此前脚本出口不比版本,封版记录只核本会话改过的第一节)。 - 封版日期只能是今天:两个封版入口都不再收
--date。 - 框架认领执行工件与技能资源:
.claude/agents/*.md归设计、技能assets/归内容(此前不在任何单元里);x-arch 锁清单记系统规范域名册,删掉一个系统规范域不再不留痕迹。 - 归属不能冒充、记录不能失效放行:台账读不了按判不了处理(此前当成没有记录,「删了记录行重封」那一臂因此失效);工作区探针认改名的两个名字;写前拦截拦设会话身份环境变量的命令;封版记录的床数是真实的(此前恒 0)。
- 施工中开关只有真假两态:收尾、开发流 VERIFY(此前 VERIFY 不带它,改了业务代码开发中必红)与封版的检测前置带它,全量检测与发布不认。本版试过让封版只放过被封的那一个单元,随即发现 82 个业务文件同时归两个域(登录与移动端底座共用 56 个),两边都施工中时谁都封不了,当场收回。
- 站点:版本号一律经版本契约读,大小版本的叫法只一份,「已封版」只标按契约封过的版本,框架变更历史也按同一种台账出一页。
- 文档:架构详图 §十三 按本版改写(比对视图、四道关口、诚实边界十条),升哪一位的说法各处统一成一份,旧流程(
sync --seal、重算指纹、srcHash 保鲜)的说法清掉。
新的床:版本契约 H1–H7、封版命令 X2、判定模块 K4 / K11、收尾环 S15、工作区探针 RN1 / SID1、发布出口 B8 / B9。
- 比对口径:业务代码此前按行尾
- v4.0.x
版本契约:三层同一种写法、同一份判定代码、同一个封版命令(MAJOR:版本锁步从三套各管各的改写成一份契约)
设计指纹bf2af23e内容指纹483dcef1测试指纹492e3a2e712caa49改动迁入统一版本契约,此前的版本没有锁清单(首次钉下 设计 31 个、代码 222 个)
改写既有契约,升第一位。 用户 2026-09-28 发现系统架构的「变更史」与业务架构的「修改历史」写法与页面都不一样 —— 同一件事三种标题写法、五套解析、三种页面,而整个 HARNESS 的版本锁还借用一份系统规范的闸。本版把三层(整个 HARNESS 1 个单元、系统规范域 34 个、业务域 21 个,另加业务总览 1 个)统一成一份版本契约,条文住架构详图 §十三:
- 唯一实现:检测引擎
check/version-contract.js—— 单元名册、统一写法的解析、比对视图(派生区与自动生成的文件不算;业务代码去注释去空白)、逐文件与整单元判定、封版的核心计算。别处禁止另写标题正则、指纹算法或单元名册;x-arch 的四颗闸(0003 / 0009 / 0014 / 0015)改成调用它的薄壳。 - 四道关口:写入时锁清单受守卫写保护;收尾(增量检测内置一段)改了锁住的原件却没加新的一版当场红,已加新的一版还没封叫施工中、只提示;封版(
meta.js --action=seal与开发流arch/seal.js转调同一份core/seal.js)检测零红、测试全过、有标题有说明才按会话归属写三行指纹、改动清单与锁清单;发布(部署门)整体比对全部单元,施工中也拦。 - 锁自己:契约代码是框架代码;守卫另留一段不经契约代码的框架锁极简比对,防「把契约改坏、再用改坏的契约判自己」。
- 退役:x-governance NS-COMMON-0007(框架判自己不借系统规范的闸)、业务域的 srcHash 与
arch/rehash.js、框架封版命令--action=framework、sync --seal、业务域版本锁步名册。 - 无主业务代码:不归任何业务域的业务代码冻结在业务总览的锁清单里、只减不增。
- 页面:三层的变更历史统一渲染成同一个版本台账(标题、三行指纹、改动清单、封版态),叫法统一为「变更历史」;治理站点所有页签与说明同批改叫「变更历史」,业务详情页的版本格不再写死;行内渲染修正「加粗包住代码」露出字面星号,随之变成真链接的文档互指(业务文档 .md 互指、治理真相源互指)在产物里改写到对应页面。
- 只按路径判归属:一个文件归哪个单元由各单元自己的
owns判(只看路径,业务代码另读一次判是不是自动生成的),列一个单元的全部文件只是把候选目录走一遍再过owns—— 判几个文件不再先把 57 个单元的文件全列一遍、全读一遍(冷启动逐文件判定约 2 秒降到 0.1 秒,增量检测与收尾每次都付这笔)。两条路算出同一个集合由床对拍。 - 引擎按调用方自己的位置取:守卫部署门与站点版本生成器取检测引擎时按自己住在哪取,不按被判的仓取 —— 被判的仓可以是沙箱或夹具,里面没有引擎(此前在沙箱里判不了、按拦处理)。
- 唯一实现:检测引擎
- v3.20.x
- 旧·设计指纹9dc6de54旧·内容指纹36cceb22
改动统一之前的版本没有改动清单
封版命令拒绝封一节没写改动说明的版本(patch)。用户 09-28 问「不管改大版本还是小版本,都会强制刷新版本号并记录变更吗」—— 核下来版本号是硬控的(改了框架不升版这一轮收不了尾、部署门拦发布),变更历史最上面也必须加一节,但那一节只写一个标题、正文空着照样能封:「记录变更」这一半仍靠自觉。封版命令现在要求第一节除两行指纹外至少写有一行说明,否则预演与真封都拒绝、一个字不写;封版命令是写出合法指纹的唯一途径(手写的指纹没有封版记录,收尾复核拦),所以这里拦住就是硬控。机器只判写没写,判不了写得对不对。封版床补一发(S10),在封版命令的副本上撤回这一拒绝,S10 变红。本版也是版本锁在真仓的第三次实战:改了封版命令,增量检测当场报「框架代码在 v3.20.2 封版之后改过,还没升版」。
- 旧·设计指纹e0b4a462旧·内容指纹3447f86f
改动统一之前的版本没有改动清单
框架变更历史真正接进收尾复核 · 删框架文件逃不过收尾 · 删掉指纹行不能重封 · 坏床不再拖垮整轮判定(patch)。对 v3.20.1 的守卫改动做了一轮独立对抗审查(三个角度、每条发现再对抗核实),确认三处、另有一处在核实期间已修。① v3.20.1 ① 那一臂在真实收尾里从没走到:收尾环调用封版复核之前按路径过滤,只收系统架构与业务架构的变更历史,框架变更历史被筛掉 —— 守卫床当时直接调判定函数、绕过了这层过滤,所以全过也没发现。过滤改为同样收框架变更历史,守卫床补一发经收尾环入口验(K7b),v3.20.1「版本锁的防手改从此闭合」那句此前不成立,到本版才成立。② 删掉第一节两行指纹、再跑封版命令,能拿改过的框架内容把同一版重封一遍:封版命令在第一节没指纹时,若封版清单或台账里已有这一版就拒绝;收尾复核对「台账有这一版、第一节却没指纹」同样报出。③ 只删封版清单里的框架文件、不碰变更历史,收尾与部署门都看不见(增量检测对不存在的文件只打一行「跳过」,查删除的那一臂住在变更历史上):收尾环把框架变更历史一并送进增量检测,它那一批没过就不把被删文件记干净。④ v3.20.1 让床头点名写错的床进了反查表,判定时算它的指纹会抛,整轮判定就成了「判定不可用」—— 别的会话写错一张床,碰到它点名文件的每个会话都被整轮拦死:这种床现在只判它自己「坏了」,按床文件与缺失路径归属(别的会话的只报、本会话的硬拦),封版与业务域前置给理由而不是抛。守卫床补四发(J14 / K6c / K7b / K7c)、封版床补两发(S8 / S9);在守卫副本与封版命令副本上把七处修复逐一撤回,对应用例都变红。审查另提两条判为设计本意、不改:旧版本各节不在复核面里(与系统规范域、业务域同一口径,已写进架构详图的版本锁一段);x-surface 封版要逼真度床真跑过(v3.20.1 ㉕ 的本意)。
- 旧·设计指纹a6b5c304旧·内容指纹08680626
改动统一之前的版本没有改动清单
守卫接上框架封版记录 · 床头点名写错不再整张床漏推 · 封版前置看得见经床头点名连来的床(patch)。用户 09-28 开闸,做 v3.20.0 留下的那一步。① 收尾复核认框架变更历史(诚实边界㉖):第一节两行指纹必须等于守卫台账里的封版记录,手写或手改都拦 —— 版本锁的防手改从此闭合。② 床头 @covers 写错一条(㉔):反查表与业务域找面改用宽松读取,只剔写错的那一条,发布推导仍推得到这张床;算指纹仍严格,真跑时当场报错;运行器卫生检查新增一项点名写错的床。③ 规范封版前置(㉕):另收经床头 @covers 点名本规范判据或同前缀注册表的床,同样要全过。④ 运行器登记豁免那一句原因跟上现状:「本机没装微信开发者工具,或没下载各端调试用的那个版本的基础库」(它在判定口径区段里,全部床的旧记录因此作废,守卫面与技能面同批重跑)。⑤ 守卫判定模块的床补三发(C4 / K2b / K6b),在守卫副本上把三处修复逐一撤回,对应用例都变红。本版是版本锁第一次实战:改守卫即改框架代码,不升版这一轮收不了尾。
- 旧·设计指纹1dea5055旧·内容指纹e9c7ae15
改动统一之前的版本没有改动清单
整个 HARNESS 的版本由机器锁住 · 顶部新增「版本」页签 · 框架变更历史改成每版一节(minor · ADR-68)。〇 用户 09-28 定:版本设计按建议来 —— 整个 HARNESS 的版本单独一个顶部页签「版本」、和理念同一级;框架页里的「版本设计」只讲规则;各业务域、各系统规范域的版本不带动总版本;而且必须硬控,不能靠人记得去改。① 框架变更历史由一张表改成每版一节「## v主.次.补 · 日期」、按版本从新到旧排:此前 v1.0.0–v1.50.0 一段是旧的在上,文件开头却写着「追加到末尾」,表里还夹着两行空行把表格截成三截,都没有闸发现;各版内容逐字不改,只去掉两处竖线转义。② 治理规范 x-governance V1.5.0 新增 NS-COMMON-0007「框架版本锁步」:框架 = 设计(架构详图、宪法、决策记录)+ 代码(守卫、检测引擎、测试运行器、元治理与开发流脚本;测试不算);闸判历史从新到旧不重号、文首等于第一节、第一节已封版、封版清单自洽且与第一节一致、框架每个文件与清单一致 —— 改过、新增的红在那个文件上,删掉的红在变更历史上;报文不印实算指纹。条款 ARCH-E01 认领它;床
x-governance/framework-version-lock.test.js(15 发)。③ 封版命令meta.js --action=framework(x-meta-dev/scripts/core/framework.js):从判据取检测器算实算值,给第一节写两行指纹、写封版清单harness/version-lock.json、记守卫台账;封过的一版内容一变就拒绝、一个字不写;床x-meta-dev/tests/framework-seal.test.js(7 发)。④ 治理站点 x-harness V1.1.0:入口页由四个变五个,新增version.html(左侧按大版本分组、组里小版本;首屏当前版本与封版状态;大版本卡片、升版规则、全部版本台账、带版本号的外部件);构建器新增builder/version-registry.js现读版本数据写进产物assets/version-data.js,封版状态照封版命令的做法取检测器实算值比对;框架页首屏与侧栏加版本入口、新增「版本设计」一节;另外三个入口页顶部加「版本」;site-build补 G9 / G10 / R7。⑤ 本文 §十三 改写:版本号只写文首、变更历史新的在最上面、版本锁怎么锁;「改了框架有没有升版」归机器,「要不要改本文描述」仍归触发清单。⑥ 还差一步(诚实边界㉖):收尾复核核对守卫台账里的框架封版记录,要改守卫模块,关着写前拦截改不了 —— 与 ㉔㉕ 同批在开闸那一步做。本版自己就是第一个被这把锁锁住的版本。 - v3.19.x
改动统一之前的版本没有改动清单
关闸后实机验收 · 站点入口页跟上统一模型 · 更新触发补「同批回看站点入口页」· 网页版逼真度床进发布(patch)。〇 用户要求关闸后真实验证两个裁判:写前拦截挂回,真实会话里写入、收尾、定版三个关口逐项实测都拦得住、撤回后放得行,把真实代码改坏测试会红;顺带修定版拒绝原因的前缀 —— 检测的原因此前也挂着「封版前置(测试闭环)」,统一改为「封版前置」(
tetrad.js,x-meta-dev 床同批改,48/48、空壳对照通过)。① 治理阅读站点的框架页原先停在 v3.19.0 之前:侧栏与执行一节写「x-spec-checker 统一裁判」、首屏写「开发与治理共用裁判」、治理拓扑的框架一半缺判据且系统一半叫「系统制品链」、两个闭环中间只挂一个裁判,整页没有统一模型。现补「统一模型」一节(四件套、两个裁判与同构、执法的四个关口、裁判也被裁判、证明不了的)并逐处改齐;理念页的「绕过流程,不等于绕过检测」改为「……检测与测试」,L2 生命周期补 ARCH-SYNC,L4 改为收尾时把检测与测试一起叫来、发布前当场真跑测试。② §十三 触发清单之后补「同批回看站点入口页」:四个入口页是原件、不从本文派生,构建器新鲜度看不出说法过时;说法对齐没有可抓形态,不造假闸,由触发清单承担。③ 网页版逼真度床进发布(用户 09-27 定):床头补@covers(注册表、复刻件源码、两端的基础库声明),网页版发布推导的测试面由 7 个变 8 个(多出spec:x-backend),当场对拍、发布不认豁免;改注册表或端的基础库声明,旧记录即作废。同批修两处:床此前拿最外层 WeappVendor 目录里恰好有的包(3.16.1)去比,而两端开发者工具的调试基础库版本是 3.17.2 —— 改为以调试版本为准(私有配置覆盖公共配置、各端必须一致;它是线上版本的代理,线上版本不在仓库里),按版本在开发者工具各配置目录里精确找包、下载中断留下的半截包不认;「照哪个版本仿」此前只写在一段说明文字里,x-surface 注册表_replicaValuesBasis补机读字段libVersion(x-surface V1.11.4),说明文字改成不带版本号(V1.11.5),当前基准从此只在这一处。换基准前对 3.17.2 逐值复核,平台值全部相同,复刻件一字未动。§十六 诚实边界⑥按此改写。④ 本批交付后的独立对抗审查(三路审查,逐条照代码核实后改):框架页把「定版两个都过」说成对业务域也成立 —— 业务域重算指纹只有测试前置、本域没有测试覆盖时写 none 放行,本文 §一 与 §十六 执行点对照表同样说过头,三处一起改准;框架页另补「还没到的地方」(后台、端业务模块、官网、数据表文档只有检测),把治理拓扑的框架三件套改回三个节点、测试床不再挂在执法下,执法卡不再说四个关口都由守卫叫,L1 按宪法写成「管生命周期」而不是组织角色,发布关口注明小程序包不经这里,删掉一条让手机端挤成四列的样式;理念页 L3、系统页证据链补上测试,理念页与框架页各链到宪法与本文。逼真度床补一段选包自检(临时目录造夹具,三种改坏都红),x-backend 条款 ARCH-C01 / ARCH-E05 与架构页改成「调试版本是代理」「装了但没下载那个版本也会跳过」。另查出两处框架层缺口,记为诚实边界㉔㉕:@covers点名了不存在的文件时整行被吞、发布推导静默漏床;规范封版前置看不见经@covers连过来的床 —— 两处都在守卫模块里,关着写前拦截改不了,归回归清单首项。改动统一之前的版本没有改动清单
四件套 + 两个裁判成为统一模型 · 两个裁判同构 · 空壳对照成机制 · 收尾测试新鲜度切硬拦 · 宪法与理念同步(minor · ADR-67)。本轮只动顶层机制,业务、老测试与各域底层瑕疵列入回归清单。① 理念:§一 写入统一模型(设计 · 条款 · 判据 · 执法 + 检测读代码 · 测试跑代码;执法在开发中、收尾、定版、发布四处把两个裁判叫来;两个裁判同构;裁判也被裁判);§三 控制哲学改为「绕过工作流 ≠ 绕过检测与测试」;宪法 §二 / §三 / §七 同步(用户授权修改)。② 检测裁判补齐:会话台账的干净结论带判据组指纹,判据或检测引擎一变即作废;四个编译检查器工具没装、缺配置不算通过(没有文件要查仍是通过);oxlint 读懂 1.x 对象形报告,读不懂或退出码非零却无错误按错报;
check.js --changed带上语言层(本轮 js/ts 过 oxlint,语法解析失败即红);封版加检测前置(-t/-v零红,与测试前置合成一个结论)。③ 收尾环:两栏分报、分开记账(只被测试拦下时检测结论照记,逐批干净的照记);本会话一段 100 秒总时限,到点没跑的按基础设施异常拦;测试新鲜度切block(干跑全部会话台账零误拦为证),账本不存在等于没跑过,无主改动与已离开工作区的改动只报不拦,别的会话新建的床不拦本会话,规范面不因「重」降级,经上游牵动的框架面照拦;封版起算改按冻结版本号(guard/seal-baseline.json)。④ 空壳对照:唯一运行器对新建或改过的床在记账前自动做(新模块x-harness-dev/scripts/core/bite/),函数床经部署门入口--bite;计划只在test-faces.bitePlan定义(fn / spec 连同@covers的代码 / guard / module);没咬住的床收尾、定版、发布都不认;不做对照只认运行器判定口径区的BITE_OFF登记,床头@bite off不再算数;老床按guard/bite-baseline.json不追溯。⑤ 写保护:唯一运行器、空壳桩与对照、部署门入口进脊柱。⑥ 发布侧守卫收口(部署会话第五轮在前):上传档案闸对四种档案同一要求(推导出的每张床PASS、测试面、输入源码指纹;治理站点另要产物验收);云函数测试记账另锁内核母本指纹kernelPrint;治理站点构建器的床补@covers,发布推导得到它。⑦ 床:守卫床 test-faces 59 条(新增 J10–J13、U4、B1–B6)、stop-ring 15 条(新增 S12–S14)、session-ledger 16 条(新增 L11–L12)、worktree-probe SP2、verify-harness 372 条(新形态档案与内核一半)、x-harness-dev 53 条(G26)+ 新床 bite 14 条、x-meta-dev 48 条(封版检测前置)、引擎新床 compile-checkers 9 条;全部新增断言逐条做了突变对拍(改坏被测逻辑,期望用例必红)。⑧ §十六 两张表加「检测裁判」「空壳对照」两列与没有测试的对象一行,宪法对照表补四句;诚实边界订正⑥⑧⑨⑩⑪⑫⑮⑱⑲、新增⑳–㉓。- v3.18.x
改动统一之前的版本没有改动清单
业务架构加第七个视图「测试设计」· 问题留在各设计底部 · 视图清单单一来源(minor · ADR-66)。① x-arch V1.20.0:名册
x-arch-design-template.json加视图test(测试全景 / 逐个服务的测试 / 测不到的地方 / 异常必填,资金与状态不变量 / 人工验收可选);NS-COMMON-0012 报文里写死的视图数目改为从名册派生;条款书 ARCH-B06 改写为七个视图,ARCH-A06 的「只许这五页」改为名册里的那几页;判据床 design-template 的 G8 由手抄五个视图 id 改为取自名册、新增 R1f(缺测试设计必咬、报文数目取自名册)。② 21 个业务域同日补齐parts/test.html:事实从文档头 describes × 测试面判定 × 部署门注册表派生;讲测试的四条异常(order-P-09、coupon-P-06、dispatch-P-03、mobile-P-01)从服务设计底部挪到测试设计底部;各域ARCH.md索引加测试设计一行、升补丁版、修改历史记一条并重算指纹(代码未变)。③ 治理站点:构建器的视图页签改为读同一份名册(不再手抄五项),名册进源清单(改了站点判过期),输出形态版本 2 → 3;站点床 G8 改为取自名册。④ 模板散文《架构设计模板》v2.1:加「测试设计怎么写」一节、蓝图第七格、交付链第六环、骨架第六页;首屏一律上下排(七个视图并排放不进半幅)。⑤ 本文:§七「测试守不到之处的登记位置」② 业务域改写;§十四 NS-COMMON-0012 条目改为七个视图;§十六 对照表「测试守不到的地方必须在设计里写明」一行的执行强度与缺口订正。x-arch 架构页异常 x-arch-P-01 前半已处理、后半(资金写函数要么有测试要么写明不测)仍只登记。- v3.17.x
改动统一之前的版本没有改动清单
测试闭环进宪法 · 宪法句到 L0–L5 执行点对照 · 登记豁免第三态 · 编排器补 ARCH-SYNC · 各设计底部登记异常(minor · ADR-65)。① 宪法落字(用户在架构会话点头):落字包 16 处 —— §一 x-test 定义、§二「测试闭环(存在性声明)」、§三 L4 / L5 行与「测试的执行点(定性)」段与护城河、§四生命周期(VERIFY〈检测 + 测试〉→ ARCH-SYNC〈回看设计 · 升版 · 测试前置〉)与
/x-harness-dev一行、§五两环两裁判与闭环图、§六第 7 条测试闭环铁律、§七禁区补四项、相关文档两行;第 7 处(控制哲学「≠ 绕过检测与测试」)按约定暂缓。② 落字后独立核实(对照表 30 行逐行回代码 + 三视角对抗审查),据此订正宪法措辞到属实:x-test 标签改「代码测试(业务端与内核母本)」、「只按一份口径记账」改「按内容记账」、执行点那句改用 L4 行已有的词并写明守不到之处写进架构层的设计、§五与 §六.7 里属于记账规则与执法强度的写法收回下层。③ 机制向宪法对齐:登记豁免(SKIP-EXEMPT)从「收尾算通过」改为第三态「豁免」—— 不算通过、收尾只提示不追讨(硬拦档也不拦)、定版与发布拒、VERIFY 单独列出不说「全过」,体检「测试闭环」行单数「只差登记豁免」(test-faces 床 48/48,新用例突变对拍红);编排器阶段序列补 ARCH-SYNC 成五段(feature-dev 自测 18/18,新增两条);命令行发布识别补包管理器两词前缀(npm exec/npm x/pnpm exec/pnpm dlx/yarn exec/yarn dlx/bun x、bunx)与-p/--package带值选项(verify-harness 新增 CL10–CL15、PU12;守卫面 6 张床全过)。④ 本文:§三全景图 L3 / L4 / L5 三格对齐宪法(环2 按实际写、部署门与出包门、x-test);§四「只定义」补测试闭环;§五业务域那半句移到 §六;§六补「ARCH-SYNC 与发布出口的测试执行点」、两个裁判改为引用宪法定义;§七补「测试守不到之处的登记位置」;§九顶层物表补 x-test 行;§十六 订正运行器第一条取舍(旧的「跳过不算未过」已作废)、x-test 口径、登记豁免,补「出包门」「改过的测试怎么证明仍咬得住」「面族 → 闭环点」「定版」定义与宪法测试条文 → L0–L5 执行点对照表(21 行,执行强度只写结构、会变的值由体检派生),诚实边界订正⑥并补⑪–⑲。⑤ x-arch V1.19.1(测试指纹 f9f40258ac58c444):订正 V1.19.0 写坏的转义函数(替换串里的$&被展开成邻行代码,编号文法没有正则元字符所以行为未变);条款 ARCH-A03 的重算条件由三件改为四件(与脚本一致)。⑥ 异常登记(只登记不修业务):各设计的底部新增「已登记异常(待复盘 · 只登记不修)」,统一字段(编号 / 会出什么事 / 动不动钱 / 依据 / 状态 / 由什么测试守着)—— 业务域 10 个共 36 条(订单 11、代金券 7、派单 6、成员权限 3、角色分配 2、登录 2、客户 2、服务标准 1、企业信息 1、移动端平台 1;各域升补丁版本,重算时记下代码未变与测试指纹,服务标准、客户、企业信息三域测试指纹为 none),系统规范 8 份共 23 条(x-arch 4、x-deploy 6、x-styles 6、x-governance 2、x-file 2、x-auth 1、x-harness 1、x-surface 1),本文各节 7 条(harness-P-01 至 harness-P-07)。编号是过渡用的「域-P-nn」,第七视图「测试设计」与问题清单方案定下后统一换成全局编号迁入。⑦ 同批订正的旧说法:x-dev-rule「丢后台会被环1 拦下」不属实(只有管道过滤与重定向被拦,丢后台没有机器闸)、两个裁判改为引用宪法定义、报告模板补测试一栏、新增 NS-DEV-0044(测试同批增改删);x-feature-dev、x-meta-dev、x-harness-dev 三份技能说明对齐五阶段与登记豁免口径,技能说明与真相源里不再用「测试闭环 L1 / L2」这类施工阶段号(与六层撞名)。验到什么程度:宪法与规则书增量检测零违规;x-arch 守护床 10 张、守卫面 6 张、三个技能面 4 张全过;8 个系统架构页与 30 个业务域文件增量检测零违规;全量检测、体检与闭环验证见同批收尾。没验的:真机与真后台(本批一行业务代码没改)。- v3.16.x
改动统一之前的版本没有改动清单
测试闭环 L2 与 L4 补口:VERIFY 按改动跑测试床 · 命令行直接发布的写前识别与写后复判 · 重面按实测判、框架面不降级 · 体检与闭环验证带测试维度 · 第五条审计链路(minor · ADR-63)。① VERIFY 接测试:
x-feature-dev/scripts/verify-feature.js --changed <改动文件…>一条命令跑增量检测 + 按改动跑测试床(先用判定模块算命中哪些面:命中交唯一运行器,一个都没命中如实说「没有测试覆盖」、不判失败 —— 运行器按改动选床一张都没选中按失败处理,防路径写错当通过);编排器 VERIFY 那行说明订正(原写「全量 check.js -m + 编译(npx build)」,与检测铁律和宪法 §六.3 都不符),每端多一行「测试」;x-dev-rule 在检测铁律下加「测试另走一条」(不是第三条检测命令)、各端增量那一步同时跑床、阶段 4 的「端到端测试」换成能做到的事,新增 NS-DEV-0043;自测新增一条(只验命中哪些面与参数契约,真跑床会递归跑到自己)。② 命令行直接发布:command-policy.cloudPublishOf一份识别(tcb / cloudbase 的 fn deploy / create / delete / code update、hosting deploy / delete、run / cloudrun / framework / app deploy 与冒号写法;剥 npx 等包裹词,node 直接跑 CLI 脚本、npx @cloudbase/cli 也算;bash -c / cmd /c / powershell -Command 向内再判一层;只读子命令与网关路由不在射程),写前整条拦(挂回写前拦截后生效),写后复判记一笔、收尾报红一次(此刻就生效)。探针 16 条应识别、13 条不该识别全对;verify-harness 新增 CL1–CL9、PU8–PU11,对旧守卫跑新用例恰好 8 条正向用例全红,落地后 359/359。③ 收尾分级:重面只按实测整面耗时判(检测引擎面原按面族一律算重,实测单张约 1 秒);守卫、检测引擎、自研技能三类框架面被本会话直接碰过时不因重降级(它们唯一的闭环点就是收尾)。test-faces 床 47/47(J6 改新语义、新增 J9),两个突变均红。④ 体检与闭环验证:六层体检多一行「测试闭环」(横切:执法模式、账本、无归属床、各面新鲜度计数、拒绝名单、封版起算日;判不正常只看账本缺失与无归属床);闭环验证加 ⑤「收尾 → 封版 测试链」(只读核三处前置与复核都接在真仓上);体检床 50/50(C7、C7b 沙箱反证、D1 改 5 步、D4)。本批当刻实测:71 个测试面、314 张床、无归属 0。⑤ §十二 审计链路改为五条,新增「测试闭环」(要四样活体证据);§三 全景图 L1 / L2 / L4 盒、§六 工作流表与 VERIFY 段、§十 递归自治同步;§十六 诚实边界订正⑤(拒绝名单由 Claude Code 权限系统执行、与写前钩子无关、按前缀可被绕开只作软兜底)并补齐⑥–⑩;x-harness-auditor 改「五链路」。⑥ 真仓实证:合包会话对 ecommerce/order 做 ARCH-SYNC —— 真仓第一次带测试前置的rehash --execute:重跑 11 个 fn 面 9 张床全过后写回,代码指纹与测试指纹 5e51affc319701b0 两行在账,封版记录与代码指纹行逐字一致,收尾复核零问题。⑦ 运行器上游收窄(同批,ADR-64):运行器组只算bed-runner.js里VERDICT-CORE-BEGIN/END框出的判定口径区段(合包会话框了 7 段,运行器床 G24 守「关键符号都在框内」),框外改动、harness.js、test-faces.js的改动都不再作废任何记录;标记缺失或不成对退回整文件。test-faces 床新增 P7,三个突变全红。⑧ x-arch V1.19.0(同批,测试闭环 L3):NS-COMMON-0010 堵三处「点名在、床却不算数」—— 被 HTML 注释包住的点名不算、床里的「规范名:编号」按完整编号认、点名的床不许住在唯一运行器不收床的目录(只看测试根里面的目录段;引擎工具包多注入isTestSkipDir,只加不改);原计划的「待补床只减不增棘轮」被封版前置吸收、不再单立。判据床新增 R10h,四个突变全红(其中一个是「连测试根前缀.claude一起判」的错误写法,由原有 R10b 抓住);全仓 34 张架构页、306 条点名零违规。本批不含:宪法测试条文(部署会话已定稿落字包;改宪法文件须用户在本会话点头,未落)、§十六 宪法句到 L0–L5 执行点对照表(随宪法同批)、§三控制哲学「≠ 绕过检测与测试」(等命令行发布这一路有拒绝、收尾切硬拦之后)。- v3.15.x
改动统一之前的版本没有改动清单
测试闭环 L1:封版与业务域重算指纹的测试前置 · 测试指纹 · 封版记录 · 收尾测试指纹复核(minor · ADR-62)。①
/x-meta-dev sync --seal钉死一版之前核该规范的测试面、连同住在别处却写明「规范名:编号」覆盖它某颗闸的床,对当前内容全过;逐闸有床(specCoverage一份匹配,运行器--coverage与封版缺口同源);架构页零「待补床」;登记豁免的跳过(SKIP-EXEMPT)钉版不算通过;钉死时在「判据指纹」下一行写> 测试指纹:<16位>;已封版再跑--seal即重新认证、刷新这一行。②x-feature-dev arch/rehash.js --execute加第四个条件:本域describes目录被哪些测试面测着(被测文件或@covers落在目录下),这些面全过;过了在「代码指纹」下一行写测试指纹,没有任何测试覆盖如实写none;「代码未变」那一支同样核。③ 判定只在guard/test-faces.js(testPrintOf/specCoverageGaps/sealGate/facesUnder/domainGate/recordSeal/sealProblems),两个脚本只调用;封版记录住本机账本seals一节,先记账再写盘,记不下就一个字不写。④ 收尾环新增「测试指纹复核」(stop-handlersealRecheck):本会话改过的变更历史,测试指纹没有记录 / 与记录不符 / 代码指纹那一行被手改 / 自上岗日 2026-09-25 起封版却没有测试指纹,都拦;不分试运行,判定模块坏了记基础设施异常。⑤ 「真仓」按脚本自己所在的仓认 —— 首版按「树根 = 仓根/.claude」认,当场把 x-arch 两张四件套床在临时目录里搭的仓形状固件当成真仓、全部拒封(唯一运行器跑床抓到);固件树照旧封版、不写测试指纹,测试床验这一条时显式注入(testGate/--test-gate);rehash 在真仓不理会GUARD_HOOKS_DIR。⑥ 验证:test-faces 床 46/46(K 组 10 条)、meta-dev 床 47/47、x-arch 锁步床 30/30(G 组 6 条)、x-arch 四件套两床与框架独立性床全绿、verify-harness 346/346;突变对拍 36 个全部变红(判定 14、收尾接线 4、封版脚本 8、rehash 10);真仓实证:x-arch V1.18.0 经sync --seal首封测试指纹 dc2d992aec50d2bd(规范目录 8 张床),纳入覆盖床后重新认证为 53c55808b738f044(8 张 + 住在别处覆盖它的 2 张,同一行原地刷新),封版记录在账、收尾复核零问题、增量检测 exit 0。同批:x-meta-dev/scripts/spec-gate.js退役(全仓零调用、无说明入口,它的「spec 能否上线」三道门已被封版前置取代,四维核实后删除);x-arch 两张跑重算命令的床补@covers rehash.js(改命令即作废它们的记录)。改动文件:.claude/hooks/guard/test-faces.js·.claude/hooks/guard/stop-handler.js·.claude/hooks/tests/test-faces.test.js·.claude/skills/x-meta-dev/scripts/core/{tetrad,lifecycle}.js·.claude/skills/x-meta-dev/tests/meta-dev.test.js·.claude/skills/x-feature-dev/scripts/arch/rehash.js·.claude/skills/x-spec-checker/tests/x-arch/business-lockstep.test.js· 本文 §五 / §八 / §十六。- v3.14.x
改动统一之前的版本没有改动清单
测试闭环阶段 1 的守卫一半:测试面判据 · 按张记录 · 收尾测试新鲜度(试运行只提示)· 上传内容闸 · 上传档案闸 · 写后复判 · 开闸感知(minor · ADR-61)。新模块
guard/test-faces.js是测试面与按张记录的唯一定义(十个面族按位置推、@covers补跨读、sha256 指纹带上游四组),唯一运行器(合包接--face/--changed/ 按张记账)与部署门入口(部署接跑绿记账)都调它,收尾环按它判;判据床hooks/tests/test-faces.test.js36 条、十处换桩注入全部咬住。收尾环新增「测试新鲜度」一段,MODE=advise试运行期只提示。写前:床门与内核装配闸之后加「上传内容闸」(实际上传目录的上传指纹必须等于床门跑绿时记下的那一份);静态托管上新内容的档案必须带checks且过(网页版测试、治理站点产物验收;回滚不要求)。写后:cloudbase 工具执行完用写前策略复判,本该拦的记账、收尾报红一次 —— 开闸期间这是云端写操作唯一在岗的检查。收尾每轮提示写前拦截是否停着;体检 L4 改为核对三个钩子键真挂着(旧判据只看有没有hooks对象,开闸时照样报健康)。守卫主自测经薄壳床进唯一运行器,新增 20 条用例(346 条),六处拆闸各自被对应用例咬住;守卫面 6 张床真仓全过并已记账。没做的:挂回写前拦截与拒绝名单(tcb fn deploy/tcb fn code update/tcb hosting deploy及 cloudbase 同义写法)等用户当面点头;MODE切block与装配戳并入按张记录等试运行数据。- v3.13.x
改动统一之前的版本没有改动清单
唯一运行器两处加固:改真仓的床自己拿锁 · 死链射程补上床目录与床通配(patch)。① 09-23 一份 105 条用例的夹具被两个进程同时直接跑同一张「备份→改真仓→写回」的床写成了
{}:仓库级跑床锁只锁运行器,直接node <床>的人不拿锁。运行器新增holdBedLock(),这类床在 ROOT 之后调一行,经运行器 / 部署门入口跑时什么都不做,直接跑时先排队拿锁(最多 60 秒,等不到即说明原因退出);8 张改真仓的床全部接上(合包 5 张、arch 3 张),回归测试 harness-dev G19;原样重演事故(两进程错开 2 秒直接跑)第二个排队到第一个结束才开始,夹具逐字节一致。② 死链检查(卫生检查 ⑤)此前只认完整的.test.js路径,目录形态与通配形态结构性看不见,测试迁移后派单、x-api 等文档里留下的目录形态死链因此一直没报(arch 已手工改掉);现认床文件、床目录、以.test.js结尾的通配三种,占位、片段、命名约定、非床文件不在射程,回归测试 G20,突变实测三种形态各自按实况判。改动统一之前的版本没有改动清单
§十六 测试放置补一条:临时的业务产品测试放仓根
x-temp/、测完即删(patch)。用户在部署会话审测试清理清单时定调:x-test/保持原样,只放业务代码的长期回归测试与部署门入口(与宪法现行定义一致,不改宪法);临时的业务产品测试放x-temp/。核过属实:唯一运行器bed-runner.js的HISTORY_RES早已把x-temp/列为不收床、不查死链的区。误会的来源是.gitignore一句过时注释(说x-test放「方案原型资产」),部署会话已订正;本版把这条放置规则写进真相源,免得同一个误会下次从别处再长出来。同批订正三处指向旧测试路径的死链(x-api 判据 V6.6.2 与架构页、x-curd 架构页)—— 唯一运行器的死链检查只认.test.js结尾的完整路径,目录形态与通配形态它看不见,这几处因此一直没报。改动统一之前的版本没有改动清单
收尾环无主结论三处根治:红每轮再查 · 批次报红先定位再记账 · 没跑成不记结论(minor · ADR-60)。病根是同一句设计被推得太远——「查过没有按 (文件键, 内容指纹) 记,同一内容只查一次」对干净结论成立(省掉重复检查),对红结论不成立:一个文件合规与否不只取决于它自己的内容(注册表在别处补上、上游域改好,它一字没动也该转干净),而
guard.js的!x.clean && !x.red让红结论永不复查,于是翻案只剩「改自己的内容」这一条路 —— 正是为骗过机制去改代码。第二处:stop-handler.js的redFilesOf在报文认不出文件名时整批算红(宁多不漏),而连坐来的红同样按内容指纹永久存档,干净的邻居被连坐一次就再也洗不掉。第三处:recordOwnerless的入参是 guard.js 侧的全量side而不是真跑过的result.side.ran,于是批次基础设施异常(side.infra,注释明写「没跑成 → 不记结论」)的文件被记成干净 —— 假绿。活体:2026-09-21 业务架构搬家中途,三份ARCH.md(marketing/coupon · service/dispatch · service/supplier)被记红,搬完后逐文件与全树扫描皆零违规,而部署门(仓库级、挡全部静态托管发布)一直挡着,人工核实干净也没有合法的清除路径;部署会话拒绝手改台账(「台账是执法记录,去改它就是为了让红变绿而动记录」)并定位到这两行代码。三处根治:①side选取改为!x.clean,与同一函数里mine的「逼修:未过关的每轮再查」对齐;② 批次报红而报文一个文件名都认不出来时逐个复跑定位,只把真报红的记红,预算 8 次跑用尽或逐个跑仍全绿(跨文件不变量)才退回整批算红并经新增的side.blind在报文里说清是「定位不到」;③ 只对result.side.ran记结论。为什么以前没抓到:sideFiles这条路在三张 hooks 床里零覆盖(每处调用都传sideFiles: [])。本轮补 4 个端到端用例(桩引擎加两种注入:报红但不点名 / 不打印完成标志就退 1,另以仓内registry.txt模拟「合规与否取决于别处」),反向验证:未打补丁时四例全红且连坐的邻居赫然出现在部署门待检列表里,打补丁后 14/14。- v3.12.x
改动统一之前的版本没有改动清单
围栏判断收归引擎唯一实现 + 元规范十颗闸补床修缺陷(minor:L3 新增一处引擎注入与一条检测器纪律,治理拓扑不变)。代码围栏(``` / ~~~)的识别此前在元规范判据里被各闸各写一份:翻转式(奇偶开关)的写法在「4 反引号外层套 3 反引号内层」时第二个开围栏就把状态关掉,按长度配对的写法则整类看不见
~~~。现收进检测引擎单一实现buildFenceLineMask,经tools.fenceLines注入检测器(逐行视图,按「围栏字符 + 长度」配对),字符偏移版由同一份逐行核心派生(重构前后对 35 份判据逐字符判定完全一致);判据内禁止再手写围栏跟踪,消费处缺席即抛。x-standard V1.2.1 → V1.3.0 同批修十颗闸:0007(嵌套围栏跳过分支是死代码)、0010 / 0012 / 0014 / 0015 / 0029(手写围栏的六处副本)、0013(hasSlot认两花括号、真插槽反被判缺)、0019(路径过滤判定改括号配平,取消三条整行豁免近似:一假阳两假阴)、0023(路径字符集不含点号 ⇒*.ts这类不存在的建议路径整类提取不到)、0031(锚一断整颗闸静默:整条 STD 被删 / 判据零插槽 / SLOT-VALIDATION 落在 MULTILINE 块外),并放开规范名段数字([a-z0-9-]+,带数字的规范名此前整片不可见)。五处条款与实判不符一并收掉(ARCH-B09 对 STD-COMMON-0005 的 presence 描述、D01 散文示例口径、D02 排除字段名与引擎白名单、E01 标识符形态两半、E02 行内注释剥离只作用于两臂中的一臂)。补床:文档结构组 97 → 127、标记插槽组 → 102、检测器纪律组 78 → 135,每颗缺陷留带 ★ 的回归锚,三张床均做空跑复验(桩化后「必报」用例无一存活)。35 份真实判据改前改后逐条对拍:十颗闸射程一个没变,新暴露两条真违规(x-antd NS-ADMIN-0005 与 x-styles NS-COMMON-0033 的排除行被说明文字截断,引擎实际装了一条死 glob,由 arch 会话同日改掉并各升 PATCH)。- v3.11.x
改动统一之前的版本没有改动清单
业务架构按四大中心分「中心/域」两层(minor · ADR-59)。
arch/business/从「按 x-data 归类层任意深度」改成恰好两层中心/域,中心就是后台菜单的四大中心:营销marketing(客户流)/ 电商ecommerce(订单流)/ 服务service(工单流)/ 研发randd(系统,不对外)。搬家:客户、优惠券进营销;供应商、工单进服务;原system/八个域进研发(改名同时消掉与arch/system/的撞名);商品、商品流转、订单留电商。代码目录一行不搬,域经 describes 认领代码。注册表加「四大中心」一节作中心名册的唯一来源;x-arch V1.17.0 把 NS-COMMON-0001 从一臂扩成四臂(登记的域有文档 · 中心名册自洽 · 门牌两段且中心已登记、文档路径即门牌 · 磁盘上的域目录必须登记),registry opt-in 就此收口;两本冻结名册(设计模板、版本锁步)按新门牌改名、上限不变。治理阅读站点导航按中心分组,旧深链接改道。- v3.10.x
改动统一之前的版本没有改动清单
x-test 按被测对象分桶(minor · ADR-58)。
x-test从扁平一层改成按被测对象分桶:13 张云函数床进functions/<函数名>/(目录名 = 部署门注册表键),三键共用的归并床与两张注册表金丝雀进consistency/,内核级床进kernel/,x-core 构建期工具床进tools/,移动端床进mobile/{core, biz/goods, backends/web}/;床文件名一律不改;部署门注册表路径同批改,部署门入口--verify增床放置核对(部署会话)。移动端网页 backend 行为床里三条拿检测引擎常量对账的臂拆成 x-backend 判据床ns-common-0002-0005-engine-parity(每条另带反向注入);部署闸 C9 组拆进 x-deploy-dev 自测(部署会话);两份报告脚本归所属技能scripts/。x-module-del 修三处早就存在的静默失效:服务端扫描只找「中心 / 模块」两层,x-server 重组成「侧 / 中心 / 模块」后一个函数都扫不到(删函数同批删床从未真生效);跨模块引用检查拼 shell 交给 cmd.exe、/dev/null不认,结果恒空;床点名只认data-bed属性。另收紧删除闸:x-test 下只准整目录删functions/<函数名>。判据床路径订正:x-backend V1.11.3 / x-jwt V1.6.1 / x-structure V2.1.2 / x-surface V1.11.2。- v3.9.x
改动统一之前的版本没有改动清单
测试放置加固(minor · ADR-57)。测试根唯一真相源收进检测引擎常量
check/constants/test-roots.js(只收自研技能),引擎索引器跳过测试根(夹具永不被判);唯一运行器:自报跳过记 ⏭ 不算通过、输出走临时文件且标准输入给空(修掉收尾环床挂两小时)、仓库级锁、@suite只认独占一行、--guards=<规范>按守护选床、选中整个 assembly 套件写装配面戳;卫生检查五项(游离测试按 git 视角、墓碑、运行头、文件名规则编号、死床路径)只在全量计失败;移动端名册里 43 张床打齐套件标签并与旧名册逐张对拍相等,随后名册x-test/run-mobile-beds.js退役(发布床阶段与收尾环装配面命令都改按套件取床):名册里 25 张治理床与复刻保真对拍床迁入各自规范的判据床目录、3 张 L4 床迁入.claude/hooks/tests/并去掉施工期前缀,23 个引用文件同批订正;guard 业务目录判定按仓根相对路径排除测试根(演练实测不锚仓根时,业务树里建一个同名子目录即可绕过写保护);运行器收床之后床被并发挪走时单列报告,不再整条崩;x-meta-dev 骨架带跑床命令与床位置、自检核对验证命令目标存在;x-module-del 删云函数同批删床、部署门键与点名;第一批残留的旧床名 125 处订正(x-styles V2.1.2),三份判据「测试只在 x-test」的理由订正(x-antd V1.1.1 / x-api V6.6.1 / x-file V4.3.1);第二批判据里的床路径与「登记在移动端名册」说法订正(x-backend V1.11.2 / x-icon V2.2.1 / x-mirror V3.1.1 / x-structure V2.1.1 / x-surface V1.11.1)。- v3.8.x
改动统一之前的版本没有改动清单
业务架构改成「一个域六个视图」(minor:L3 一颗闸换判据,L5 站点随之出页签 · ADR-56)。x-arch V1.15.0:NS-COMMON-0012 从「业务模块页遵循业务架构标准(十节)」改判「业务域遵循架构设计模板」—— 五个视图页住域目录
parts/、修改历史就是CHANGELOG.md,旧形态(modules/、ARCH.html、CHANGELOG.html)退场;流程设计每个场景先流程图、后分步操作;名册x-arch-design-template.json取代x-arch-business-standard.json,另外 14 个域登记为只减不增的 pending。《业务架构标准》改名《架构设计模板》(.claude/arch/standards/architecture-design-template.html)。菜单域是第一个样板(v0.2.0,旧模块页删除)。治理站点:业务导航不再列数据表,六视图的域一行一个节点、点开六个页签。开发流重算命令补一支:代码没变而升版时也记代码指纹并注明「代码未变」。床:新判据床x-spec-checker/tests/x-arch/design-template.test.js(36 发含反向验真),旧床退役,真实仓闭环床与站点床同批改。- v3.7.x
改动统一之前的版本没有改动清单
测试放置(minor · ADR-55)。测试跟着被测对象放:规范判据床迁入
.claude/skills/x-spec-checker/tests/<规范名>/,检测引擎原子迁入其tests/engine/,四件套引擎与 guard 的床迁入各自的tests/,业务代码的测试留在x-test/;新增唯一运行器x-harness-dev --action=beds(按位置收床、游离测试报红、--coverage推广到每份规范),退役样式 / 判据 / 四件套三本名单与床归属对拍金丝雀;x-arch V1.14.0 放宽床位置判据;/x-meta-dev delete同删判据床目录;§九「测试只在 x-test」一句改写,新增 §十六。- v3.6.x
改动统一之前的版本没有改动清单
业务域版本锁步立闸 + 重算指纹命令 + 已闭环域真实仓闭环床(minor:L3 新增一颗闸,L2 开发流收尾补一条命令;治理拓扑不变)。x-arch V1.12.0 → V1.13.0 增 NS-COMMON-0014:业务域
ARCH.md的 version 必须等于CHANGELOG.md最新一条,条目标题只认「## v主.次.补 — YYYY-MM-DD」、按版本严格从新到旧、日期不倒挂;两个锚都报,最新一条写法不对时文档侧报「判不了」不静默;同前缀名册x-arch-business-lockstep.json登记立闸当日 10 个不锁步的域,只减不增(判据冻结清单)。客户域当轮理顺(39 条标题统一写法、按版本重排,正文一字不动;域内变更史构建器跟着改并删掉重复记当前版本的currentVersion)。开发流收尾补重算指纹的唯一入口x-feature-dev/scripts/arch/rehash.js:写回前核三件事 —— 版本等于最新一条、这一条是今天写的、这一条还没记过指纹 —— 都成立才写,并在条目里留一行「代码指纹」;实算值按规则名从判据取真检测器,不复刻算法。床:x-arch-business-lockstep(23 发,闸逐臂造红 + 命令三种拒绝一次写回)、business-arch-closure(24 发,真实仓:客户 / 企业信息 / 菜单零违规零豁免,每一端放探针真收尾环拦下只点名本域、重算命令同刻拒绝零写入、删掉即放行)。- v3.5.x
改动统一之前的版本没有改动清单
业务结构放置闸立闸当日加固(patch:同一颗闸收紧判据,治理拓扑与强制层不变)。x-arch V1.11.0 → V1.11.1。立闸后三路对抗检查(绕过 / 误报 / 流程接线)用真检测器实测打穿一串写法,两条致命:关系表把「两端」改写成「上级」逃关系域;同名诱饵表文档让真文档怎么违规都变绿。逐条堵上:「关联」只认字段表格行且字段必须真实存在、声明与关联先剥注释与代码块、关系表两端必须恰好是字段里关联的全部表、同名多份表文档即红、忽略目录里的表文档即红、上级链成环即红、上级未归域直接报红(豁免不外溢)、判据冻结立闸当日清单(名册只减不增由机器管)、改好当轮表文档锚逼划掉;合法写法的误报同批修。域文档锚收窄为只报重叠与放错层(不替别的表转报,免得拦住只改域文档的并行会话);原想按 git 上一版判「新认领」,实测检测器沙箱只给 fs / path,且那版写法拿不到时静默退回「全算新认领」本身是假绿,已删,边界写进条款。同批 NS-COMMON-0002 增别名臂(describes 路径必须是唯一规范写法、大小写与磁盘一致)、NS-COMMON-0003 声明 null 分支报文不再印实算指纹。脚手架:外键可写「字段名:表名」各自写清指向,合规验证同时跑 x-data 与 x-arch。床:放置床 44 → 67、业务架构闸床补别名五写法。
改动统一之前的版本没有改动清单
业务结构放置立闸(minor:L3 新增一颗闸,取代 ADR-53 的一条否决 · ADR-54)。x-arch V1.11.0 增 NS-COMMON-0013:每张表恰好归一个域、子表与关系表在表文档里写明上级、按放置规则放对一层(子与上级同域;跨域关系归
kind: relation的关系域)。锚在每张表文档上,改表当场由增量门看见、自动按会话归属,收尾环零改动。立闸当日存量由真判据跑出、登记为两份只减不增的豁免名单;客户域为首个完全合规域。同批 NS-COMMON-0002 增写法臂:describes 只接受「目录/**」(单文件、中段通配、无/**目录会让保鲜闸静默算成没有代码)。L2 同批:开发流程加「新表先定归属与上级」一步,数据端检测加 x-arch。- v3.4.x
改动统一之前的版本没有改动清单
业务架构保鲜传感器接进收尾环(minor · ADR-53;本行 09-22 补记 —— 当时只升了文首版本号、漏写这一行)。收尾环新增一段:本轮改过的文件与各业务域
describes求交,命中就跑一次-m x-arch,只报本会话碰过的域。同批 x-arch V1.10.x:describes 加值域约束(路径必须存在)、保鲜报文不印实算指纹。- v3.3.x
改动统一之前的版本没有改动清单
治理站点收口:产物验收闸 + 构建末尾清残留 + 收尾环传感器接线(patch:强制闸门新增一处传感器,治理拓扑不变)。① L4 环3 新增治理站点新鲜度传感器:本轮碰过受治树或站点源码 ⇒ spawn 构建器
--check(源清单逐文件比指纹 + 产物存在性),对不上报一行、只验不建(向导侧执行、传感器侧只检测);站点不存在整段跳过(框架不依赖材料)。它与装配面两条判据同属「改了 A 忘了跑 B」类,单文件 detector 结构性看不见。接线曾静默失效:构建器目录改名build/→builder/之后传感器路径没跟,existsSync为假 ⇒ 整段跳过、永远不报;床上 S2「改了没重建必须报」命中 0 条而 S1/S3/S4(都是「不该报」的用例)照常绿 —— 活体的「闸报绿≠闸看见了你」,修后 22/22。② 构建器新增--verify-dist发布验收(四臂:新鲜 / 无残留 / 零降级 / 生成页零断链,复制进来的受治文档断链只报告不判死),发布链 POST-VALIDATE 调它;同批给构建末尾加主动清残留 —— 两次改名各在dist里留下整个旧目录而源清单比对全程报新鲜(残留不在任何一份源的对面),后缀白名单挡不住,只有「⊆ 本次 outputs」挡得住。③ x-harness 判据 V1.0.1→V1.0.3:白名单templates/→pages/(templates是引擎 L1.5 独占目录,非 owner 写了包含也会在聚合阶段被整体剔除 —— 两份站点页坐在射程里却一颗闸都扫不到,而本域扫描报零违规;抓到它的是守卫自己的业务树真空金丝雀 verify-harness C1),补回并归位STD-COMMON-0005闭合标记(漏标记只有-v看见、补错位置只有-t看见)。④ 判据床x-harness-site-build加 V1–V4 四发逐臂验产物闸红得起来绿得回去。验真:verify-harness 326/326(C1 真空 41=41)、两张床 17/17 + 22/22、x-harness -t/-v/-m/validate 全绿、x-arch 四件套 11/11。遗留给部署会话:x-deploy-sites.json尚未登记 x-harness,deploy-release-pipeline的 C3 真注册表金丝雀按设计报红,登记后自绿(x-deploy 四件套与发布床本会话一字未动)。改动统一之前的版本没有改动清单
治理阅读站点 x-harness 升为顶层物(minor:站点类第二个成员,L5 新增一个受治顶层目录)。原住受治树的
.claude/arch/harness/站点拆成三处:阅读外壳与构建器升为顶层物x-harness/(四个入口页 +assets/+builder/+ 只被链接的二级页 +design/),被受治件加载的共用样式表留.claude/arch/assets/,被判据或条款引用的《系统架构标准》留.claude/arch/standards/—— 判准是方向:站点读受治树可以,受治件依赖站点不行(真把共用样式表搬进站点,删掉x-harness/会让 33 份设计件一起掉样式)。引擎terminals.js的站点常量登记 x-harness(实测:登记前索引命中 0 份、登记后 29 份);新建 x-harness 系统四件套(3 颗 NS:目录闭集 / 站点源码不许跑出站点根 / 构建器只准往产物目录写)与判据床x-harness-gates。为什么必须构建:条款 / 判据 / 变更史 / 业务架构全是 markdown,浏览器把.md当纯文本,而本地直开时又被禁止读本地文件 —— 渲染只能在构建时做。为什么产物不设闸:闸是「派生件进仓」的代价;本轮先把变更史做成 33 个进仓 HTML、不得不为它造保鲜闸,撤销时连版本锁步一起返工(x-arch V1.8.0→V1.8.2)——病根在落点,不在渲染。宪法顶层物表与 L5 同批更新。- v3.2.x
改动统一之前的版本没有改动清单
阶段三收尾复盘:收口 ADR-51 登记的两处守卫边界 + 金丝雀清单收缩(patch:既有闸补射程,不增闸门、不改拓扑)。① 环1 命令判定(
guard/command-policy.js)改前逐条复现全部放行,改后全拦:win32 执行开关补/k/r与 Git Bash 双斜杠//c;PowerShell 位置参数即命令(powershell Remove-Item …、powershell -NoProfile git reset …),只放-File/-f与直接跑.ps1;dev server 判定由「出现 dev 这个词」改为起服务器的脚本名dev/start/preview及:变体(依据 x-admin/package.json 实测:start 与 start:* 全是max dev,preview 构建后起max preview),命令名补umibun,并认node --run <脚本>;包裹词表补cross-env—— 它缺席时任何命令名判据前加它即失明(实测cross-env X=1 node -e …与后台 start 脚本原文都放行)。构建命令本闸不管:宪法允许经用户单次授权后由 AI 执行,守卫判断不了授权;发布链的构建在发布脚本子进程里跑,本就不经环1。第三处(复制类工具改写发布档案)维持登记不补,理由写在 §八。② 金丝雀 C1 转红的根因是本会话 09-18 给wechatpay目录补登 x-exception / x-marker 共管,支付演示目录 10 个脚本不再是检测真空,coverage-inventory.json按双向棘轮缩 10 条(51 → 41)。验真:verify-harness 326/326(新增 W 组 10 例、SV 组 12 例,每组「该拦 / 该放」成对);同批恢复 PreToolUse 写前拦截。改动统一之前的版本没有改动清单
决策一执行轮 + MULTILINE 失明修复轮(patch:L3 视图契约定型、一颗新闸、孤儿身份加名字;治理拓扑与强制层不变)。① 引擎三处:
parseImports只在剥注释与字符串的视图上认import起点(字符串 / 模板串里的伪导入不再计入,床 tetrad-ts-imports-mixed +5);目录模式喂料金丝雀x-structure-gates-dirmode-feed(按引擎真实喂法调检测器,不往目录里看即红);L1.5 独占目录按正交治理轴登记共管。② 元规范 x-standard V1.2.1:ARCH-E02 / NS-COMMON-0024 选视图口径改正 —— 找业务写法默认读保块视图codeKeepMultiline,codeOnly/multilineStripped只在有意排除块时用并写明理由;旧口径的「决策表」照它写出的闸对 MULTILINE 业务块整片失明。③ 失明普查与修复:读抹块视图的闸逐颗审,确认失明 20 颗 + 候选 6 颗分七组改到保块视图(x-api V6.5.0、x-file V4.3.0、x-surface V1.11.0、x-styles V2.1.0、x-type V1.2.0、x-exception V1.3.0、x-auth V4.4.0、x-preload V1.2.0、x-address V1.3.0、x-map V1.3.0),每组床补「块内必咬」并反向验真;x-i18n V1.4.0 顺带把导入闸找@ts-ignore改在原文上逐行判(检测器注释原引旧决策表)。块里藏着的现役违规 0 处。④ x-marker V1.2.0 → V1.3.0:新闸 NS-COMMON-0003 收回 MULTILINE 抹块资格(插槽须判据声明、NS 族段须登记,识别器与引擎视图逐行对拍,床 x-marker-multiline-block 42 发);立闸当日咬出两处,查下去是规则号被复用的旧标记 → 孤儿闸补名字臂(孤儿身份 = 规范 + 规则号 + 名字,全仓 10348 个标记同口径普查只这一组 4 处),x-meta-dev 清理脚本orphan-marker-cleaner.js同批改:孤儿认定与闸同口径(被名字对不上的容器包住的同号 MULTILINE 随容器一起清),扫描根与跳过表改取引擎名册、缺失即报错(原手抄一份扫不到内核母本与母本包源);清掉两个导入服务的 8 行旧标记,代码原样,增量检测零违规。⑤ 零床闸清零:782 颗闸全部有真床,判据床名册 155 → 166(床归属金丝雀下界同批抬到 166)。验真:validate --all 34/34;判据床 166/166、四件套床除业务架构锚点一发外全过、移动端 1288 例、样式名册全过;全量check.js -d101 项 100 过,唯一红为 x-arch 业务架构customer/目录(他会话在途,按并行隔离铁律跳过);编译 4394 文件全过。同日收口:两个导入服务清掉旧标记后一度不受任何标准写法管(x-api 服务写法闭环排除*-import/service.js的理由「由 x-file 接管」已过期),用户拍板由 x-api 接管 —— x-api V6.6.0(bcde8e9e)去掉那条排除,两个服务按写类服务写法打标记(运行行为不变),床 x-api-gates-server-std 射程那一发翻正并反向验真,发布交部署会话。改动统一之前的版本没有改动清单
补床全量轮(patch:判据零改动,只补测试床;闸总数与治理拓扑不变)。33 份系统规范的 578 颗零床闸全部配上承重床 —— 架构页「测试床」一节不再有「待补床」,由 x-arch NS-COMMON-0010 强制(少点名一颗即红)。判据床名册
x-test/run-spec-beds.js32 → 155 张(5400 余例全过),床归属金丝雀下界同批抬到 155。床的形状定型为两条臂:形态问引擎真检测器(extractNsRuleDetector+buildDetectorTools),射程问引擎真选文件器(extractRulesFromSpec+scanFilesByRule)—— 立第一张床当场踩出来的:多数闸的路径过滤不在检测器体内,拿检测器验路径永远问错对象。另三个立床须知:STD 段匹配从磁盘重读文件(样本必须落盘,只喂内存串恒返回零违规);buildDetectorTools按文件名做进程级缓存(每例换名,序号插在第一个点前以免破坏后缀自锚);部分检测器闭包缓存不按工作区分键(一张床只用一棵假工作区)。补床挖出约 150 条判据问题,本轮一条未改(改判据要升版 + 条款回看 + 封版,且会曝新存量,须成轮做),全部钉成床里的「现状登记」断言 —— 判据修好那天那一发会红、逼人回来改床。其中 4 处在引擎(X-RULE 只写 BEGIN 不写 END 两闸同盲;插槽写成={{{{名}}}}时引擎取错槽名致约 30 个插槽的取值校验从未执行;JSX 标签解析吞「引号收尾自闭合标签」与「属性里嵌 JSX 的标签」;床验真令牌表不认checkStandardFormat而注释里写一句check.js反倒能过)、1 类是闭环兜底只查到文件级、14 颗单闸可被换写法绕过(最重的是 x-jwt 验签次序按字面ok: true定位,少一个空格即绕过)。修不修交用户拍板。三批 25 个子 agent,批 2 有 3 个撞额度中断、批 3 续上收尾;批 2 提示词模板替换残留致 47 张床命名成x-x-*,已统一改名。改动统一之前的版本没有改动清单
存量违规清零轮(patch:判据整改两处 + 业务码零兜底整改,闸的总数与治理拓扑不变)。v3.2.0 收紧后登记的 37 处存量,由用户拍板后逐处重新核验(8 组分析 + 8 组对抗复核,全部用引擎真检测器复现报点)并分三类处理:真违规改代码 29 处(删死兜底 / 按条款写显式守卫 / 分组表按父 ID 全集预建空值 / 死参数与死分支一并删)、真渲染面显示兜底打条款标记 5 处(注释里写明为什么是渲染面,ARCH-D02 自证)、判据误判改判据 2 处。判据侧两项:① x-curd V8.3.0 —— 树形两颗闸豁免「绑定关系树」,但只按正向证据(顶层 create 恰一个
mode:'custom'与一个customModal,且同标签permissions.create指向本文件 AUTH_META 中 id 以-bind结尾的功能权限),只读树 / 展开传参 / 权限非 -bind 一律 fail-closed;对抗复核造的「实体树改用自定义弹窗想溜掉」样本仍被咬,CHANGELOG 显式写明推翻 V8.2.0「只登记不修」的在案结论。② x-tools V3.2.0 —— 堵计算属性名方法(['name'](a = 1) {})的绕闸通道:回溯取不到标识符时旧判据默认放行,方法名加一对方括号即免检;一般化教训「凡『先提取特征、再比排除名单』的判据,提取失败那条路不能默认放行」记入架构页取舍。三处根因外挂:SOP 聚合读补@aggregate-read(假列权限致非超管看到空步骤,待用户构建 + 重发)、file-url-read 改为「验证通过却无链接即抛 SYS_500」不再报假成功、登录合并候选昵称改数据透传(响应字节变、显示不变)。验真:全量check.js -d101 项全过零红(本轮首次)、判据床 32/32、四件套床 12/12、金丝雀 8/8、validate --all 34/34、arch 层 156 目标 0、编译 4393 文件全过。两处新发现的运行时崩溃缺陷(未定义变量)只登记、交用户拍板。改动统一之前的版本没有改动清单
发布档案根改名
.deploy-releases→x-release+ 本地留存 3 份 + 进版本库的发布台账(patch:强制闸门集合一颗不增不减,只改闸读的数据位置,并把台账纳入既有的发布档案只读面)。守卫三文件与回归床同批换锚;新增 RR2b/RR2c(Edit / Write 手改发布台账必拦)。落地文件与指纹(sha256 前 16 位):guard.js dbebe5ba79b80cb5 · guard/mcp-policy.js f10d4ce4f8fea1d8 · guard/command-policy.js 4855c430aaf4da31 · verify-harness.js 79091d7266083a1f(落地前基线与 v3.1.0 记录逐字相符才覆盖)。验真:verify-harness 304/304(2 条 H1 红为 arch 会话在途改判据的瞬态,签名-v x-zzh1t… exit=1,不在本改动面),反向验证同一套新用例指向未打补丁的守卫副本时发布档案族整片转红;发布库床 19/19、技能自测 92/92、x-deploy validate 10/10、装配面床 521/521。决策见 ADR-52。改动统一之前的版本没有改动清单
阶段三复盘整改轮(minor:测试床验真加臂 + 条款书派生区语义变更 + 三处引擎原语)。① 条款书「标准写法」派生区改为判据行号索引(x-standard V1.1.1):模板本体只住判据,33 本条款书自动加载体量 1448 KB → 1312 KB;引擎生成器与 4 张床、x-meta-dev 自测同批改。② x-arch V1.4.0 封版 884b78b5:NS-COMMON-0010 加两臂——床种类写实(不标
data-bed-kind必真调用引擎extractNsRuleDetector/check.js,只守不变量写data-bed-kind="invariant")、点名兼收「规范名:ARCH-条款号」;引擎原子parseBedCitations多带clauses/kind;首扫抓出 12 份架构页 32 处未标的不变量床(整改轮内逐份标齐)。③ 引擎:普查 glob 认花括号且不配对抛错(engine.js)、tools.ignoredDirs原语、两处 STANDARD 标签正则的大写 X 截断修复(tetrad-doc.js / x-meta-dev parser.js,x-exception 两段模板曾被丢块),新床 tetrad-census-glob 11 例。④ 判据整改轮:按 9.5 / 9.6 复审清单逐份升版(x-exception V1.1.0、x-i18n V1.1.0、x-curd V8.2.0、x-detail V2.1.0、x-data V3.2.0、x-tools V3.1.0、x-api V6.2.2、x-file V4.1.0 等),每颗改逻辑的闸配一张跑真检测器的床,新曝存量违规只登记不修业务码;全部条款书逐条对检测器校准并把「为什么」压到三句内(迁移去向判据:操作性内容留条款、理由与历史去架构页)。⑤ 死链:x-dev-rule / x-feature-dev 参考三处 / 后台注释两处 / 测试说明一处改指条款号;业务架构 member、spu 由 x-architect 改(login / mobile 属他会话在途,未动)。⑥ 收口:整改轮四批 32 个子 agent 全部完成,17 份规范升版封版、30 张判据床落地并有了电源 —— 新立第五本 runner 名册x-test/run-spec-beds.js(床归属金丝雀接入下界与互斥断言);x-arch 再升 V1.5.0(fdda35c0):引擎令牌扩到四种(buildDetectorTools/X-RULE-BEGIN-SLOT,手抠 SLOT 块喂引擎 tools 的床不再被误判为不变量床);引擎parseImports补第七变体(默认 + 具名混写,后台 50 处此前对五份判据隐身,床 tetrad-ts-imports-mixed);x-standard V1.2.0(546c5f31,NS-COMMON-0021 名册改取tools.ignoredDirs)。收紧后新增存量业务违规 37 处只登记、交用户拍板(REVIEW.html)——该批已于 v3.2.2 清零,本句留作当时事实,现状以 v3.2.2 为准。- v3.1.x
改动统一之前的版本没有改动清单
阶段三收口:全部系统规范迁为四件套、迁移名册清零(patch:结构不变,成套闸进入严格态)。① 名册终态:
x-arch-system.jsonpending 为空、ceiling 0,注册表文件保留作成套闸与版本锁步闸的全局锚点;x-arch V1.3.0 封版 99622a72。references 下除元规范外每份规范都有arch/system/<规范>/(ARCH.html + CHANGELOG.md + assets 泳道图原件)与条款书,新建规范只能经/x-meta-dev tetrad一次建整套;迁移全程判据零字节改动、版本沿用,每份迁入前后 -t / -v / validate / -m 各端全绿,三注入(删认领 / 手改派生区 / 改判据不升版)各红一次并复原。② 元规范 x-standard 的规则书改为条款书(36 颗闸各有认领、2 条无机器闸),设计仍留本文档;工具补三处元规范分支(引擎解析器clauseBookHead设计行指向本文档 / x-meta-devtetrad.refresh免变更历史与架构页 /checkRegeneration免架构页),其余规范行为不变,由 tetrad-doc-parser 39、tetrad-clause-gate 19、tetrad-fixture-set 21、x-meta-dev 自测 44、tetrad-framework-independence 5 张床验证;注入删认领 → -v 报 NS-COMMON-0027 并复原。③ 迁移期登记的判据缺口、引擎口径问题(普查 glob 不认花括号、普查不套 IGNORED_DIRS、无机器闸条款进不了床点名)与零床闸补床策略,均不改判据,统一记在施工看板问题清单等拍板。改动统一之前的版本没有改动清单
静态托管发布面物理闸落地(minor:强制闸门新增,由部署会话在副本上完成、用户开闸后落地)。环1 MCP 路径新增三组判定并叠在部署门之上:静态托管上传 / 删除(含扁平形态)、tcb 静态托管路由 Create / Modify、网关工具与托管域名写动作;守卫按需读注册表
x-deploy-sites.json与.deploy-releases发布档案作数据(读不到、记录坏、缺字段一律 fail-closed 并写明原因),不 require 任何 part2 代码;同批修正 dev server 判定按参数路径字面匹配的误拦(只看被执行脚本位置)。落地文件与指纹(sha256 前 16 位):guard.js c4fcf7b5dd20b9ff · guard/mcp-policy.js 082a832be0b04048 · guard/command-policy.js 81cf6aa3d32a8f2e · verify-harness.js 8ee949ec7695048b。验真:verify-harness 302/302(新增 116:HS1–42 上传删除、RR1–19 发布档案只读、RT1–26 路由闸、GW1–17 网关与托管域名、PV1–12 预览判定),同一套用例跑落地前守卫 77 例转红;四件套床与 session-ledger 11/11 全过。决策见 ADR-51;对抗审查登记的三处未修边界写在 §八 与 ADR-51。- v3.0.x
改动统一之前的版本没有改动清单
阶段二收口:两份生成式架构页与旧生成器退役(patch)。x-styles、x-structure 于同日迁为系统四件套(各自 V2.0.0 变更历史记逐节去向)之后,删除
.claude/rules/x-styles-arch.html、.claude/rules/x-structure-arch.html与x-meta-dev/scripts/sysarch/(35 个文件:两套生成器、索引、自检、断言反向注入,以及牙覆盖矩阵 / NS-COMMON-0034 覆盖率探针 / 全档位普查 / arch↔spec 缺口审计四类测量脚本与数据快照)。测量的常驻归宿:牙覆盖矩阵 =x-test/x-styles-axis-matrix.test.js(推理表换成逐格测量),全档位普查 = 架构页普查面板(声明式查询),其余两类为一次性测量、结论已归条款书与架构页诚实边界;旧页六条生成期硬断言由 x-arch NS-COMMON-0007~0010 与 x-standard NS-COMMON-0027 的常驻闸接替。x-plan-doc V1.1.1 收回rules/**/*.html射程(rules 目录自此只有 .md);x-backend-rule、x-core/README 与 harness §拆包复盘段的旧页指针改指条款书与arch/system/。删前四维核实:引用零残留(ADR / 本表历史记录与 bak 存档不改写)、无规范强制其存在、生成器无任何 skill / 床 / 工作流入口、git 史为 09-09 与 09-13 建、09-15 被四件套整体替换。验真:x-plan-doc -t / -v / -m 绿,全量检测零新增红。同批订正 §工作流表「/x-deploy-dev」一行的过时说法(sys 同步早已退役):改为「云函数 / 静态站点无空窗发布 / 回滚;预检→发布→核对」,纯描述订正。改动统一之前的版本没有改动清单
收尾环按会话分账(MAJOR:L4 收尾与部署门的契约由「仓库级」改写为「按写证据归属到会话」)。环2 改记写证据台账(每会话一份、只追加:Write/Edit/MultiEdit/MCP 下载记文件键与写后内容指纹,Bash 记结束时刻与 duration_ms),环3 用 git 测全仓、按台账归属,只检查只拦本会话的改动,分不清两边都拦并注明,无主的不拦人只出结论(每轮至多 40 个);「查过没有」按(文件键,内容指纹)记,全仓快照与全仓队列退役(
guard/queue-store.js删除,guard/session-ledger.js新建,worktree-probe.js只剩测量);部署门改为「全仓任一脏文件既非存量又无干净结论即拦」;台账目录进脊柱写保护(原快照那条退役);规范与规则书派生加住址判据(只认 references 与 rules);退役的.claude/tmp/worktree-snap.json与orphan-report-ack.json删除(用户提交时取消跟踪)。新床 tetrad-session-ledger(11 例,两会话身份真跑 guard.js);verify-harness、tetrad-stop-ring、guard-worktree-probe、guard-assembly-face 改到新接口(探针床顺带修掉「父目录折叠」误报;tetrad-stop-ring 副本改为带入全部 arch/system)。三处归属判据措辞统一(x-arch-rule ARCH-A03、x-dev-rule 5c、harness §二)。同批 L1:架构页派生区引擎新增第七种面板 swimlane 泳道图(原件 assets/*.json,每跳点名的闸与条款由引擎校验、守护链到认领条款;新增视图不升 outputVersion)。决策见 ADR-50;看板 e11–e15 销账。- v2.2.x
改动统一之前的版本没有改动清单
官网 x-website 登记为顶层物(站点类 · minor)。① L5 新增顶层物
x-website/(纯静态页面 +xStatic/{images,icons,fonts},无构建),宪法 §一 表与 §三 L5 行同步;② L3 引擎constants/terminals.js新增站点类常量SITE_DIRS,ALL_TOP_DIRS= 端 ∪ 框架内核 ∪ 站点(覆盖闸 C1 金丝雀随之把 x-website 纳入受治面);x-harness-dev 体检 L5 名册改读ALL_TOP_DIRS(原手写四项已漏 x-technician 与 x-core);③ 新系统四件套 x-website V1.0.0(架构页 + 条款书 + 判据四颗闸:目录闭集 / 站内引用完整 / 零外部资源 / 首页备案号 + 反向注入床x-test/x-website-gates.test.js+ 标题字体子集只读报告脚本);④ x-deploy V3.3.0 新增 NS-COMMON-0001/0002(官网托管目录 = 顶层目录名 / 无空窗发布,反向注入床x-test/ns-deploy-website-tooth.test.js);x-deploy-dev 流程5--target=website,共用发布库补「指向目录的引用落到该目录首页」一处(deploy-release-pipeline+B2b);⑤ x-dev-rule 适用范围注明官网不属四端开发流。⑥ 同日对抗审查实跑后收紧(3 高 2 中 2 低,真实官网现状均不受影响):x-deploy V3.4.0 两颗官网发布闸改为函数体按花括号配对、指令行原样输出、声明唯一、顺序与中止锚在 main 与失败分支体内(8 种原先报绿的构造转红,床 27 例);x-website V1.1.0 补 base 元素、object data、imagesrcset、表单 action、页面自动跳转、字符串 @import 与 image-set(床 42 例);官网产物闸按发布库真实发布清单逐个过目录闭集闸(引擎索引看不见点开头文件与 dist / build / node_modules,发布库却会原样发布);共用发布库回滚语义改变:本次新增、不带内容指纹的文件纳入回滚删除清单(此前回滚后新页面仍 HTTP 200,检查点照报完成;后台与网页版同受益,带指纹的新增文件照旧留给下一次清理,D1 端到端用例补执行删除并核对);访问映射表主域名行改为可解析形态并入金丝雀 C3(此前主域名在所有发布核对里缺席)。决策见 ADR-49。- v2.1.x
改动统一之前的版本没有改动清单
收尾环加固(用户开闸后落地 · minor)。① 规范与规则书也进增量检测(补派不改派):原先两者只跑 -v、被整个排除在 --changed 之外,以它们为靶的文件级闸在收尾环结构性不跑 —— 规则书上的 x-governance NS-COMMON-0004(真相源禁引施工计划)、规范上的 x-marker NS-COMMON-0001(业务码孤儿 X-RULE 标记,其规则书写着「改 spec 时 --changed 触发」)、x-styles 规范自检闸;改前实测全部规范与规则书同轮改动一次 --changed 5.9 秒、零违规。② 规则书三分类收敛为一个函数:唯一判据住检测引擎
check/constants/rule-books.js(有配套规范 / 无规范名册 / 孤儿),收尾环、x-meta-dev validate --all、x-harness-dev 体检 L3 三处同源;孤儿规则书每轮报违规(此前收尾环不看名册,把一切无规范规则书说成「设计使然」报备一次就静默,validate --all 一律跳过);名册去掉两个从不参与配对的死条目,体检 L3 增报名册死条目。③ 拦下报文带原因:收尾环检测命令一律加 -d,摘要按规范报告逐块摘违规详情(此前从第一处违规详情截到末尾,下一份规范的统计表占满名额)。④ 两处脊柱注释的旧 arch 路径改为 arch/business。回归:verify-harness H1-3 组改为孤儿每轮拦、名册内报备一次(186 例全过);tetrad-stop-ring 床扩到规则书进增量检测与三分类;x-harness-dev、x-meta-dev 自测各补用例。决策见 ADR-48。- v2.0.x
改动统一之前的版本没有改动清单
系统四件套定型(MAJOR:part2 契约由三件套改写为系统四件套)。① 架构层拆两目录:业务架构整体迁入
arch/business/(注册表与跨域图随迁、全部路径引用改写),arch/system/为系统架构(每份规范一个目录:ARCH.html + CHANGELOG.md + assets/);② L3 引擎新增原子parsers/tetrad-doc(条款书形态、规则书派生区生成、架构页派生区戳记、变更历史解析;检测端经 tools.tetradParser、写入端直接 require;单元床含真实规范库锚点);③ x-standard V1.1.0 规范指纹闸 NS-COMMON-0027 加条款格式分支(认领 / 引用 / 无闸理由 / 标准写法与速查逐字等于重新生成 / 版本锁步 / 形态,反向注入床);④ x-arch V1.2.0 系统组 NS-COMMON-0007~0010(成套与只减不增迁移名册 / 派生区戳记保鲜 / 版本锁步 / 原件完整与测试床验真)+ 业务组 0002 约束臂,系统组注册表x-arch-system.json(反向注入床的固件树由真引擎产出);⑤ x-governance V1.1.0:禁引 plan 射程扩到架构页 .html、新增 ADR 编号唯一闸(在案重号 ADR-16 冻结);⑥ L1 x-meta-dev:tetrad 动作(新建一整套 / 迁入已有判据)、sync 四件套分支(版本锁步拒绝即零写入、--seal 封版、--census 普查快照)、generate 拒绝覆盖条款书、delete 整套删、audit 四件套总表、validate 第 10 项逐字重新生成;架构页派生区引擎scripts/arch/engine.js与骨架资产assets/arch-skeleton/;⑦ 常驻床第三本名册x-test/run-tetrad-beds.js;⑧ 文首变更摘要外迁本文件末节,文首只留当前版本;同批订正存量瑕疵(元规则书 sys-sync 自相矛盾、两份 SKILL 引用不存在的施工计划、开发流端序表漏客户端、harness 仍教写 version-log、「宪法原则书全域自动加载」不属实、宪法点名具体规范、体检名册死条目与写死的规范数下限、子代理嵌套层数的过时记载)。详 ADR-47。- v1.53.x
改动统一之前的版本没有改动清单
拆包复盘收口(R25–R39)+ x-structure arch 面。L4 Stop 环新增「包源物化同步」判据(
guard/assembly-face.js新增isPackageSource/checkMaterialized,stop-handler.js新块:改动集命中母本包源 ⇒ spawnmobile.js --verify --end all,不一致即拦;床guard-assembly-face+M 组 5 例;两条装配判据的引擎名册改懒加载,verify-harness 184/184 含新增 GA7 嵌套落点用例)· 孵化器lib/manifest.js新增landingSubpackagesFrom/landingSubpackages,deriveAppJson按本端消费的落分包的包自动写subpackages(mobile-dev.test +R27)· x-feature-devorchestrator.jsIMPLEMENT 提示改铁律两条命令、verify-feature.js全量补-d· 师傅端app.json开lazyCodeLoading+ 两 tab 页 json 声明custom-tab-bar(x-route 0005 通过)·.gitignore四行逐包落点收敛为miniprogram_npm/一行(x-mirror 0005 通过)· mobile ARCH v0.15.0 describes 补x-core/mobile/kits/**+ 四处「kits 是业务域包」措辞订正 · x-styles-spec 两处 detector 报文与 x-styles-rule 一处开发者动作不再指路已退役的 sync-mobile · x-antd / x-i18n / x-tools / x-structure / x-mirror 五本 spec 与三本 rule、两篇业务 ARCH、两处包源注释共 13 处旧名旧路径订正(六本 spec 指纹重派生,validate 33/33)·x-core/README.md目录表补mobile/删shared/·pnpm-workspace.yaml删死 glob 与过时自述 · x-dev-rule 客户端章节改终态 · coverage-inventory 删 34 条已被 sys 四本 co-owner spec 收编的幻影(C1 金丝雀恢复绿)。新文件:.claude/rules/x-structure-arch.html(生成物)与x-meta-dev/scripts/sysarch/st-*.js十个生成器脚本;x-structure-rule.md 加架构总图指针 + 三处 DEST_RE 单段旧说法订正。验真:46 张常驻床 1148 例全绿 · verify-harness 184/184 · meta validate 33/33 · 生成期六断言 + 自检九组 + 断言反向注入 10/10- v1.52.x
改动统一之前的版本没有改动清单
N9 收尾:剩余 10 条全部闭环(R13 / R15~R18 / R20~R24)。新增闸臂 3 条 ——
x-backend NS-COMMON-0002同锚加 backend 包名命名法(@wowoway/mobile-backend-<目录名>,把现役既成形态固定成法则,零新增编号)·x-route NS-MOBILE-0011臂2「落点形态却不属于任何现役包」(堵住臂1 的假绿:前缀不匹配时它退回端内存在性判定,而本地旧落点还在 ⇒ 判通过,要到 fresh clone 才红)·x-structure NS-MOBILE-0016容器分支报文改说实话(正文早已订正「改本闸不生效」,报文仍谎报 —— 报文是人唯一会读到的那一句)。新增床 1 张 + 断言 5 组 ——ns-mobile-dest-depth-anchor(13 例,dest段数真仓锚:x-icon 0003 的落点映射与 x-route 0009 的宿主推导都是「由 dest 拼前缀」,段数四天变过两次却零断言;复刻历史前科「字符类漏@⇒ 0 咬」作反向注入)·0016-0019床 +H 组(固件 dest ⇔ 装配器真DEST_RE)+H5~H7(terminals.js首次进对拍 + 偏序方向锚)+A13(报文防谎报)·0024床 +I 组(GENERATED ⊆ IGNORED_DIRS+ 反向必须保持不成立的方向锚)·0011床 +H 组(H2 把旧落点目录真的造出来再判)·mobile-web-backend+5 例(rewriteAppJsonForWeb首次有直接断言)。每条都做反向注入(共 21 例注入,注入面覆盖 spec / 装配器 / 引擎常量 / 床自身四类),其中一例当场抓出我自己判据的洞(rewriteAppJsonForWeb② 只判「同页不重复」看不见双斜杠)。ADR-45 第三条补记:一批 10 条里 3 条的补法照抄会恒红(R16 样本前提错 / R24 方向反 / R17 等价应为偏序),另 4 条核实后收窄或改向 —— 补法本身是假设不是结论,实施前必须重量判据方向、样本前提与射程- v1.51.x
改动统一之前的版本没有改动清单
N9 拆包架构整体复查(用户提出「看下哪里存在没有强控的」):两轮多 agent 复查六维(每维配独立证伪 agent)产出 24 条幸存缺口,本轮闭 15 条。新增闸 4 条 ——
NS-MOBILE-0025(包源顶层目录闭集,0024 在包源侧的对称物 + 棘轮豁免只减不增)·NS-MOBILE-0026(包源根绝对落点引用必须与x-materialize.dest一致)·x-mirror NS-COMMON-0007(端侧落点残留两臂)· 三条既有闸各补一臂(0017 目录名 ≡ 短名 / 0024 空骨骼 / 0006 反向)。装配链接闸 ——--materialize --backend weapp收尾自动跑closure()(此前 closure 零自动触发点,weapp 腿一条机器闸都没有)· H5 部署 PRE-VALIDATE 由三本扩到五本(补 x-structure / x-mirror)· 床名册加assembly分组并接进verify-mobile第 ⑤ 臂。孵化器两处根治 ——transformAppJs剥块改锚契约标记 + 判据移出软条件(原实现静默漏剥 ⇒ 新端带悬空require.async出生)·deriveAppJson剔除指向端内的别名(原样继承 ⇒ 新端出生即悬空)。修掉 6 处真实缺陷(含两端各漏 2 条packOptions.ignore导致纯 JSDoc 文件随主包上线)。诚实交代:用户命题「一键编译多端 APP 和 H5 都无障碍」只成立一半 —— H5 腿有实测,APP(Donut)腿零实现零闸零床零编译记录。收录 ADR-45(正向不蕴含反向)。L4(用户当日开闸后落地):新建guard/assembly-face.js(装配面判据 + 新鲜度戳,端名从 terminals 派生)+stop-handler对拍。原方案「Stop 环里直接跑床」被实测否掉 —— Stop hooktimeout=120s而该组床要 90~206s,必然撞超时;改为「跑」(verify-mobile ⑤臂 / 部署链)与「验」(Stop 环对拍指纹,毫秒级)分离,强制力等价且不必改checker-invoker。判据床guard-assembly-face10/10 全喂真runStop;活体自证:补判据注释后它当场抓到自己的改动。ADR-45 同批补记「一条强制的落点必须先量它的执行预算」- v1.50.x
改动统一之前的版本没有改动清单
规范能力(架构法则·新闸):端根一级目录闭集 + 外来包落点归
xPackages/(ADR-44)。病根:DEST_RE只收单段小写 root、比它自己上一行的注释窄一整档,而NS-MOBILE-0018又拿这条正则当立论根基 —— 循环论证;「落点只能在端根」因此被写进 arch(「实测约束,非偏好」)与包 description。微信侧从无此限制(官方示例即两段 root,npm 寻址逐层上溯,本仓现役 7 个多段 root)。后果:goods-lazy(09-07)与geo-lazy(09-11)四天内在端根堆出两个目录,而端根一级零闸。由非技术用户一眼指出。新闸 NS-MOBILE-0024:端根一级 = x* 骨骼白名单 ∪ 微信原生必需 ∪ 生成物,文件不判;六骨骼分界判据只有一条 —— 真相源在端内还是端外(xPackages/是外来包产物:gitignore · L4 只读 · 改它没用)。NS-MOBILE-0018落点改xPackages/<包短名>/miniprogram_npm;DEST_RE直接编码新法则;packageDest的 root 解析 indexOf→lastIndexOf。落点法则不按消费者数量分类:否决「geo 落进唯一消费者 address 分包」(ADR-43 把事实当设计意图);否决「放 xComponents/xModules」(实测被 0014 孤儿闸当场判红)。改动:端内 21 路径 + 2 root + project.config 2 + .gitignore 2 + 包源 4 处硬编码 + 镜像面排除项归位容器名(顺带修 geo-lazy 从未登记的不对称)。验证:--verify 逐字节一致 · --closure 868/悬空 0 · 0016-0019 床 47/47(新增 C7 防改回) · 新床 30/30 · 金丝雀 8/8 · mobile ARCH 0.12.1→0.13.0(srcHash 8a249723)。诚实边界:多段+大写 root 下手工放置 miniprogram_npm 微信认不认,仓内零实测、官方无原文,待用户编译验证- v1.49.x
改动统一之前的版本没有改动清单
强制层(床接电·债务闭环):本会话新建的 6 张拆包治理判据床漏登记 runner 名册,由另一会话的
bed-ownership-canaryS1 臂(盘上每张床都要有归属)报红发现,连带把 H5 装配的 BEDS 闸拦死。病根不是「忘了」而是没有物理闸:run-mobile-beds的 selfCheck 只双向对拍mobile-前缀,而这 6 张叫ns-mobile-*/ns-common-*,结构性不在其射程(runner 自述「这一条靠人」的诚实边界);于是它们存在、写着 178 条断言、从没被任何 runner 跑过,而任何一份「全部床通过」的报告都不含它们 —— 这正是bed-ownership-canary存在的理由。处置三条:① 登记进BEDS+NON_PREFIX两表(名册 34→40 张,selfCheck 零告警);② 汇总行统一成parseCases形态①结果:N 通过,M 失败,共 K 个测试—— 按 runner 自己写的纪律(「正解是让床统一成形态①,而不是让 parseCases 无限长」,它认得越多越像第二真相源);③ 验证用抠出来的真parseCases而非自写等价正则(复刻判据=第二真相源)。实测 6 张全部 exit 0 + 被认出 + 零失败(31/36/20/38/32/21=178 例),bed-ownership-canary复跑 8/8、S1 转绿。诚实边界:本轮只验到「各床 exit 0 且被认得出」+「金丝雀 8 臂绿」+「--list 自检零告警」,未跑完整 40 张一轮(含 webpack 真构建);对方会话本轮独立跑过 33 张全过 790 例,两边合起来覆盖到,但「40 张一轮全绿」本轮无人有资格说。同批记最终全量 97/98:唯一红arch/system/mobileclient srcHash 陈旧,经三条取证归他会话在途(describes 含x-core/mobile/backends/**∧ 对方自述改了 image 复刻件与 event-seal ∧ 实查 diff 与自述逐条吻合),按隔离铁律不代修改动统一之前的版本没有改动清单
规范能力(勘误·射程):拆包收口——全 33 本 spec 适用面逐条扫端名字面量,补最后一处真漏。x-api NS-MOBILE-0111(消费必带加载开关)正文自称「载体 B 消费侧全端强制」,适用面却写死
x-client/x-technician四条 glob —— 自相矛盾;拆包后页面与组件大量住进母本包源,75 个包源文件从未进过该闸射程(结构性看不见,非漏报),新增第三个端时同样整端失明。改{mobile}令牌后实测包源 75 文件零违规(补射程零存量工作),spec 与 rule 两处写明禁改回字面端名;paths 派生 128→131。另两处判定不改:x-auth NS-MOBILE-0005(x-client/pages/my/index.js单文件)是有意单端(xCore/dev 权限锚点,师傅端无该域);x-standard:2462 是元规范正文的反面示例不是适用面。同批完成三端验收对账:用户实测微信开发者工具编译 / 真机预览 / H5 全部正常,主包 1.34 MB < 1.5 MB 质量线、工具总结论「未发现代码质量问题」⇒ D-48 主包超标闭环(AI 侧交叉复核:本地逐目录体积与工具排序完全一致、比值 0.55–0.75 编译压缩,两组数据自洽)改动统一之前的版本没有改动清单
规范能力:「什么该成包」从人脑子里搬进规范(N7),同批立 ADR-43。缺口怎么发现的:N5(把 xModules/address 等升格为包)复核时发现原计划结构上做不到——权限靠页面路径前缀推(
access-check.js的/^\/xModules\/([^/]+)\//→/pages/{域}/index的 menu),而包落点只收单段 root(DEST_RE),升格后权限推断落空;且两者本来就已经是分包、不跨端 ⇒ 三类成包理由一条不占,用户裁定取消 N5。顺手跑全端引用图(843 节点)撞见8 个住主包的组件只被单独一个分包用——与 geo 当初被拆出去的病因完全相同,geo 拆了这 8 个没拆,不是情况不同,是规则只在人脑子里。N7 三件:① x-structure-rule 新增「何时该成包」判断守则(三类该成/三类不该成 + 「谁来判」分工表);② x-structure NS-MOBILE-0023(同域包对的单元归属:主包侧包 A 的某 js 若全部消费者都是 B ⇒ 整目录搬进 B,零新增包),床 21 例,建闸即咬到 2 处;③ 只读报告x-test/mobile-package-affinity-report.js(判不了的不做成牙,出事实供人裁定)。判据被实测推翻一次:草案「只被单个下游包消费」命中 5 处、3 处误伤(core 的公共能力 + 会造成反向依赖的 goods-jd),收窄为「只在同域包对内 + 消费者须含包内自引用」后零误伤,详 ADR-43。搬迁实测:product-favorite / product-labels 共 13 文件 goods → goods-lazy,物化 goods 落点清 13、goods-lazy 写 20(主包真瘦身),--verify逐字节一致 ·--closure悬空 0(859/868 持平) · 0023 由红转绿;要改的只有 9 处 usingComponents(根绝对→包内相对)与 x-styles mirrorDomains 的 2 行 client 对位路径。剩 6 处(core 的单元被端内分包独占)明确不建闸:拆它们要自建独立分包,是「多一个分包下载 ⇄ 主包少几十 KB」的人工权衡;收录 ADR-43- v1.48.x
改动统一之前的版本没有改动清单
规范能力:拆包治理面补齐五条闸(N6-2~N6-5),同批立 ADR-42 两条建闸纪律。x-route NS-MOBILE-0010(跨分包同步 require 禁令:解析到别的分包必须 require.async,宿主口径与 0009 同源——端文件按本端 app.json、包源按 x-materialize.dest 并逐消费端校验;说明符解析端内相对/端根绝对/resolveAlias 别名/bare 包名四形态。此前零闸:真机 MODULE_NOT_FOUND 是唯一反馈,而真机验证是用户主权动作;装配器 --closure 在虚拟树上解析,虚拟树没有分包概念)、NS-MOBILE-0011(resolveAlias 目标必须可解析);x-mirror NS-COMMON-0005(每个 (包,端) 落点必须被 .gitignore 覆盖——0004 明写"gitignore 只管 git 不管打包器",反过来它也不管 git,这条缝此前零牙)、NS-COMMON-0006(packOptions.ignore 的 file 型条目必须有对应源,补 0004 诚实边界①"只判 folder、file 型看不见"的缺口);x-structure NS-MOBILE-0022(母本包 package.json 字段闭集 + private 必须严格 true + version semver)。建闸即咬到 1 处真实存量违规(0006 抓出 x-technician 那条 N3 拆包后的 geo 死条目,已修),其余真仓本就合规——故每条闸都配反向注入床并带射程断言(引擎目标集含预期锚点),五张新床合计 157 例全绿,0016~0019 床 46 例、端类金丝雀 12 项回归全绿。三条原计划被复核否决:「main 判禁字段」(「H5/webpack 也不读它」无证据)、「死别名臂」(孵化端 8 条预置别名会集体假红)、「packOptions 条目存在性」(产物侧判据必假红,改判源码侧);收录 ADR-42
- v1.47.x
改动统一之前的版本没有改动清单
规范能力:母本包源的模块寻址长出通用牙(NS-MOBILE-0021),同批立「适用面必须与 scanMode 同构」建闸纪律(ADR-41)。闸:包源
.js的require/require.async只许「包内相对」或「bare 到本包dependencies已声明的包」,端别名/端根绝对/未声明 bare 一律报红——此前 302 个包源 js 只有 4 个在 require 形态射程内(x-preload NS-MOBILE-0005 臂B,且只管顶层),其余 298 个写端别名一路绿灯:NS-MOBILE-0019 只读声明依赖不读源码、x-mirror 逐字节等值对错写法一视同仁、装配器--closure的toTarget()主动拿端resolveAlias参与解析且只查本端消费集不查本包 dependencies(两种写法都主动放行),同批订正 NS-MOBILE-0019 诚实边界②那句「归 --closure 报」的误导声明。纪律:首版适用面写{mobile-src}/**/*.js,而 x-structure 是目录模式 ⇒ 引擎filterFilesByDirModeRoots剔除目录根下全部文件目标 ⇒ 射程恒空而-t/-v/判据床全绿,-m只显示一行「不适用」;改锚包根package.json由 detector 自 walk 整棵src,并把「引擎目标集含四个包根」与「detector 覆盖 ≡ 包源 js 全集」两条写进床(H1/H2)。床 38 例全绿(含 tmpdir 合成两个尚不存在的包 address-lazy / invoice-lazy 作反向注入),0016~0019 床 46 例、端类金丝雀 12 项回归全绿;收录 ADR-41- v1.46.x
改动统一之前的版本没有改动清单
代码层/强制层:母本包容器分层(
domains/*→kits/*+biz/*,过渡容器退役,容器与层严格一一对应) + 射程原语根治(容器名五处硬编码收敛为各处单一常量表,两个射程形态由它派生,闭集外藏包 fail-loud——原对未知容器静默跳过,搬目录即整体掉出{mobile}射程);NS-MOBILE-0016 补容器闭集判红,x-backend NS-COMMON-0001 形态闸改走闭集(原硬编码core|domains会误伤新容器);四闸床 38→46 例(A7 判据翻转);收录 ADR-40- v1.45.x
改动统一之前的版本没有改动清单
闸射程回归根治(拆包 + 零副本双重致盲 · minor):三条承重闸在各自的「搬家」之后对新家结构性失明,且全链路零告警——① x-api NS-SERVER-0143 臂2(zod 顶层禁传输/控制保留字)可达性判据硬编码
const roots = [x-client, x-technician]并显式跳 miniprogram_npm,而拆包把系统层*.api.js迁入x-core/mobile/{core,domains/*}/src后端树只剩 8 个业务 api.js(x-technician 归零)、包源 24 个云函数名不可见 ⇒ 臂2 恒判「不可达」、整条臂死(床「臂2·可达域」样本 file-upload 正是包源独有,实测 expected 1 / actual 0,而该床自己也在 UNRUN 台账里没人跑 —— 闸死了、验闸的床也没人跑)。② x-marker NS-COMMON-0001(孤儿 X-RULE 标记)索引根同款硬编码 ⇒ 包源 83 文件 / 17 条规则 ID 不入索引,规则被删也无人喊,而那正是本闸唯一的存在理由;其 SKIP 含sys的排除又建立在「x-server 86% 是 sys 分发副本」的旧世界上,2026-08-20 零副本终态后前提失效。③ x-marker NS-COMMON-0002(无法归属的标记)适用面不含x-core/server/**,而内核sys/base/controller.js:26/:180正躺着X-RULE-…-x-api-call-STD-SERVER-0002-…—— 形态畸形(缺 TYPE 段)且所指 specx-api-call从不存在;讽刺点:该闸的规则正文恰好拿 x-api-call 当反面例子举,却咬不到自己写的范例。根治:三处判据全部改经引擎原语(tools.mobileEnds/tools.mobileSrcRoots),原语缺席一律 fail-loud,禁静默退回硬编码口径;L1.5 治理拓扑变更:DOMAIN_SCOPED_DIRS.sys加 co-ownerx-marker-spec(持标记可归属性轴,与 x-deploy 部署面 / x-exception 异常架构 / x-jwt 令牌三轴正交)—— 加 owner 是必要条件,非 owner 时 glob 在聚合阶段被整体剔除 = 死规则(defaults.js 内 x-order / x-deploy 两个同款先例各有 4/4 探针实证)。畸形标记按「二选一」的②成对删除(它包住的是controllerSystem内核工厂,四个 sys owner 里无「系统层模板」STD 覆盖它,不存在「改成标准形态」的选项),内核 bump 0.3.2 + --stamp(零行为变更,脚本内置三重断言:标记须独占整行 / 非标记行逐行等值 / 行数差恰为 2)。同批 x-deploy NS-MOBILE-0002 扩第七阶段 BEDS:新加的stageBeds是 fail-closed 放行条件而闸只认六阶段,删它或把 skip 分支改恒真照样全绿;三条判据 —— 定义在场且被调用 / 失败分支体内 exit(1) /--skip-beds分支体内响亮打印。★判据锚在分支体内、禁用字节窗口★(立闸当天反向注入实证:窗口式判据被邻近构造喂饱 —— ② 的 600 字符窗口里有后续阶段的另一个 exit(1)、③ 的 400 字符窗口里有隔壁 else-if 的 console.error,三条里两条不咬;改花括号配对取分支体后 6/6 全咬)。验真:0143 床 12→14 项(可达域拆两侧各证一次 + 原语缺席 fail-loud 臂)· 真引擎反向注入三发(file-upload:23 臂2 / 包源假规则 ID 孤儿 / 内核畸形标记)逐字节还原 · 内核工具床 49/49 · mobile-web-backend 43/43(含「禁名表 ⊇ IGNORED_DIRS ∪ DOMAIN_SCOPED_DIRS 键」金丝雀,证明动引擎常量未打破它)·-vx-api 7112e5f7 / x-marker 3ebbaecb / x-deploy 9c60fffc / x-governance 2a40e2b1 各 36/36。新增两张常驻床(一次性探针 = 闸没有回归保护):ns-mobile-0002-beds-stage-tooth(7/7,零写盘,抽 detector 喂变异内容、不碰并行会话的 deploy.js)与verify-mobile-canary(15/15,给 x-mirror spec 两处引为强制力来源、ARCH 称「物理保证」却零自动化通路的 verify-mobile ② 接电)。同批治理面订正:x-constitution-rule paths 补x-technician/**(16 死命令在师傅端目录不自动加载,它在 NON_SPEC_RULES 里、meta sync --paths派生不到);x-governance 规范简介与规则书正文补arch(detector 适用面含.claude/arch/**/*.md27 目标,而规则书正是 paths-scoped 自动加载那一份,它把射程说小一整类受治工件)。诚实边界:style 会话 09-08 立的 5 颗闸(x-backend NS-COMMON-0010~0013 / x-surface NS-MOBILE-0006)未记入本条——并行会话隔离,且其注册表当日仍在动(v1.10.0→v1.12.0),代记即固化在途快照,归该会话收口时补。- v1.44.x
改动统一之前的版本没有改动清单
拆包收官(S10-pre lockstep + Wave 4 主会话收尾 · patch):x-auth NS-MOBILE-0010 扩锚
{mobile-end}/app.js,声明面 = 端树 ∪tools.mobilePackages(ends∋端).srcRoot,与 adminauth-scanner.ts插件内唯一枚举口resolveMobilePackages(读各包x-materialize.ends)同表同批(specHash 5f7b1fef)——0010 由「盲报陈旧」变为点名差集的真判定(两端各差signup-web-create,用户 admin build 后归零);x-feature-dev 自测两处陈旧断言修正(client 自 2026-07-25 起是已定义端;scripts 内规则号注释改措辞);customer 域 ARCH 0.8.8(customer-last-login-update/ clientmy-profile-update对cloudbaseUserId显式z.never());x-styles specHash 随 axes.json 12 行 pair 改包源同步(26c32662)。拆包看板 23 行全部 done(S17a 壳固化 / S17b 镜像退役见 v1.44.0 + ADR-38);剩用户主权:admin build、内核 0.3.0 全量重发 + signup-web-create 新建 + 四函数重发、两表 datasource 重导入 + 唯一索引、H5 浏览器实测、两端真机、commit;裁定⑪ 待拍板;x-technician package*.json"name":"x-client"复制残留按用户裁定清除——端壳模板新增占位__END_NAME__(端目录名派生,manifest / x-mirror 0002 detector 同表,specHash fb2b86c2),x-technician 两文件各改 1 处、x-client 零变化;admin build 已跑,两端 grantable 各 +signup-web-create,0010 归零、liveness 17/17。收官后首测三修:① 裁定⑪ 作废(零代码引用;x-route NS-MOBILE-0005 保留并写入作废依据,3d28d648)② H5 匿名直开落 403 根因 =auth-permission-read公开接口对 guest 放行返回空权限 → service 身份门(AUTH_401 / USER_NOT_FOUND)+ 重发 ③ 异常页按钮左右 20rpx 标准缝(端壳模板)+ web backend button 宿主去 width:100%(与微信块级同形)改动统一之前的版本没有改动清单
拆包 S17b 镜像体系退役(minor · 治理拓扑变更):x-mirror V3.0.0——删旧 NS-COMMON-0001 端↔端镜像牙(删前实证
-m x-mirror x-client/x-technician该规则「不适用」= 适用面 0 文件、verify-mobile ②listFramework(端) = 0),renumber 0002→0001 母本包物化内容指纹 / 0003→0002 端壳模板指纹(specHash c1e28324;/x-meta-dev 场景 D:cleaner dry-run 0 处、-m x-marker0 红);引擎terminals.js删CANONICAL_CLIENT_END,x-structure / x-i18n CLIENT scanConfig root 改{mobile-end}令牌、extractScanConfigByTerminal按名册逐端展开同构块(零端名字面量、零 swap;x-structure c956ad75 / x-i18n 8f56b66b);[canonical-baseline]豁免取消,端类金丝雀④ 出现即违规;x-mobile-dev 2.0.0:sync-mobile 退役桩 →render-mobile.js(manifestrenderEnds),create-mobile --from=<种子端>显式参数取代指针,ends()只剩{ all },verify-mobile ② 收敛为 0002 双向等价 + 未登记 = 0,③ 加母本包根x-core/mobile(mobile-dev 44/44、canary 10/10);x-feature-dev roadmap 增MOBILE_PKG_RULES=[x-mirror] × MOBILE_PKG_ROOT母本包检查组(+1 断言);co-owner 保留(撤销实测未登记探针 3/3 → 1/3、目标 77 → 65,理由改「端锚射程完整性」,defaults.js / x-standard-rule / x-mirror-rule 同批改注);床:x-motion M4.2 由TECH_DEFS === CLIENT_DEFS恒真式改「def 住包源 + 端零残留副本 + 已装配落点逐档等值」,border-axis-gap-ledger SPEC_FILES 去 x-mirror、N15 改记母本包物化牙(UNTESTABLE 保留,理由:锚在 package.json 不在 token 文件);宪法 §一 :24/:25/:30、harness §三/§九/§十、ADR-38、arch/system/mobile v0.9.0(§二模型换代、§四/§五/§六重写、srcHash 22639a2a 不变)、agents/x-client-engineer、x-dev-rule Client 章 + NS-DEV-0032、x-preload-rule、x-styles-spec 两处注释(specHash 同步)措辞同批。未做:各业务域 ARCH(login / agreement / order)散文里的旧号x-mirror NS-COMMON-0002归各域下次升版;client 阶段 VERIFY 对包源只加 x-mirror 一组(其余 {mobile} 规则书归全量);全量 -d / commit 归主会话- v1.43.x
改动统一之前的版本没有改动清单
拆包 Wave 3(S14 / S15 / S16)+ H5 阶段 S 身份 + 治理面射程闭合(minor):S14 custom-tab-bar 逻辑 + back-arrow + xStatic/icons/index.js 入母本包(包内 15,两端各删 12),端 custom-tab-bar/index.js 一条 require 薄壳、json/wxml/wxss + config/tabbar.config.js 留端,IoC⑥
initMobile({ tabbar })(七键全部挂上),别名升宽@custom-tab-bar/*,x-structure 0013 源根优先 + 双源漂移臂,x-auth 0013 第五注入行;S15 首个业务域包@wowoway/goods-domain(domains/goods,ends ["x-client"],端 json 41 处根绝对,x-antd 0003 只扫 admin 侧故 prose 改包,x-backend 首评绿);S16 分包域包@wowoway/goods-sub(destgoods-sub/miniprogram_npm,装配器早已支持,x-file STD-MOBILE-0002 P1 路径插槽化,x-preload 0003 改所属包声明消费端);三包物化两端逐字节一致、闭包悬空 0/0,x-client 525 → 404 文件。射程闭合:引擎原语resolveMobilePackages/tools.mobilePackages/tools.mobileEndsOf(取代split('/')[0]与「非端根 ⇒ 名册全集」两病根)+{mobile-src}令牌 + 目录模式基根自检;x-i18n 0003 / x-api 0108 / x-icon 0003 / x-route 0009 / x-tools 0024 五条改经包级消费面派生,x-structure 端根壳 + 域包三族首次进射程,全部反向注入实证。H5 阶段 S:内核 0.3.0(resolveChannelByWebSource/ token 策略 web 分支 / handler 第 5 步身份透出)+ 公开函数 signup-web-create + customer_base v2.8 / technician_base v0.5 加 cloudbaseUserId + x-jwt V1.2.0 臂④ + x-surface V1.3.0 + x-deploy 白名单;登录页 web 分支 OTP(isWebBackend());床 mobile-web-identity 19/19、web 36/36。arch:mobile 0.8.11(describes 收窄为 core/backends,domains 归各业务域)、login 0.4.4、spu 0.3.17、goods-flow 0.1.4、customer 0.8.7(H5 连带)。登记未修:x-auth 0010 与 admin auth-scanner lockstep(S10-pre);closure 对未命中别名的@…形态判 npm external 不报(归 S17b);login describes.data 未锚 technician(registry 真空,待 technician 域固化)。用户主权待办:admin build、内核 0.3.0 全量重发 + signup-web-create 新建 + customer/technician-{create,update} 重发、两张表 datasource 重导入 + 唯一索引、H5 浏览器实测、真机、commit;裁定⑪ 待拍板- v1.42.x
改动统一之前的版本没有改动清单
拆包 Wave 2(S10 身份簇 / S11 half-sheet + x-dialog 并行入包 · patch):S10 把 xCore/auth + xCore/login + custom-tab-bar/tools 搬进母本包(包内 53 = 搬 44 + 新建 9,两端各删 44),auth / login 两页留壳(S8 壳形态),四个 AUTO-GEN 留端件(route-helpers / menu-parent-registry / menu-func-registry / grantable-apis.json)经
initMobile({ env, routes, menus })注入——routes.js按后缀锚把端 SYSTEM_PATHS 归成 H11 具名routes.system(命中数≠1 fail-loud),session.js接管 globalData 四键(全库零散写),L1 路由守卫由 routes 接管者在注入那一刻安装;app.js 改薄:属主端 / 资源复用端两种云实例形态的分派 + source-injector 安装整体住包内app-bootstrap.js,端只this.cloud = bootstrapCloud(),两端该段逐字相同 ⇒ manifesttransformAppJs的云 bootstrap 变换退役(签名去 resourceAppid),收尾断言改「bootstrapCloud 必在场 / 云实例形态字面量必不在场」。口径定稿:留端件一律相对 require,包内件一律别名长键(别名整键指包,端里写别名会静默指进包里不存在的路径);别名窄键先例@custom-tab-bar/tools/*。规范面:x-auth NS-MOBILE-0004 扩面到四系统页壳(关闭 Wave 1 登记的「壳形态无机器闸」)+ 新建 NS-MOBILE-0013(身份簇存在性 + IoC 注入行 + 改薄断言);x-route 九条移动端闸令牌化(0001-0005/0008{mobile-end}/app.json端自留地判据;0006/0007/0009{mobile}且端根派生改端集派生——包源文件逐消费端判、包源宿主恒主包),母本包源首次进入 x-route 射程;x-jwt NS-COMMON-0001 令牌化;x-preload STD-MOBILE-0001 包含面跟到包内auth-page.js。S11 half-sheet + x-dialog 入包零 spec 改动(三牙 detector S4/S5 已源根就绪,反向注入 13 发全咬),共享面只改 x-styles-axes.json half-sheet pair 指包源 + NS-COMMON-0034 混合形态臂源根优先。登记未修:x-auth NS-MOBILE-0010 walk 端树找*.api.js,auth / login 原子入包后声明面对它不可见——扩 walk 会与 admin auth-scanner 只走端树的 emit 口径永久打架,正解是 scanner 与本闸 lockstep 同批改(S10-pre 收窄为此一项);x-structure NS-MOBILE-0014 适用面{mobile}/app.js语义应为{mobile-end}(当前 no-op)。架构结论见 arch/system/mobile v0.8.10(describes 保留留端件 + 壳锚)、system/login v0.4.3、system/agreement v0.4.4。物化 231 文件两端逐字节一致、闭包 0 悬空;全量 -d 唯一预期红仍是 grantable 清单陈旧(用户 admin build 主权)改动统一之前的版本没有改动清单
拆包 Wave 1(S7 / S8 / S9 / S12 / S13 五单元并行入包 · patch):并行范式 = 每个执行者只动「本单元子树 + 端消费点 + 本单元规范三件套 + 本单元床」,共享面(app.json 别名 / app.js 契约键 / manifest / x-mirror 等共享 spec / ARCH / CHANGELOG / 看板 / 物化 / 全量)由主会话集成——共享 spec 只报告不编辑,避免并发写同一 spec 与 sync 竞争。规范面:x-feedback 4 条规则字面端名→
{mobile}令牌(detector 零改,--paths3→5);x-exception NS-COMMON-0001 2b/3b 与 NS-MOBILE-0012 改 mobileLocate + 去重 + 「消费端集合」;x-preload 19 行令牌化 + NS-0003 交集 / NS-0005 双臂 / NS-0010 四事(含 IoC② 静态注入行闸);x-file 仅 STD-MOBILE-0006 组成要素 1 行 + STD-MOBILE-0001 模板行插槽化(端别名 / 包内相对两形态;验证串竖线分隔故不能用正则或运算);x-map / x-address 各 2 处 prose。同批修掉的既有假绿:x-tools NS-COMMON-0023 用^[^/]+/xTools/…推端根 ⇒ 包内 xTools 模块结构性不评估(S13 差分实证,反向注入包内探针现必咬;已入包 5 个 xTools 单元正控全绿);x-api NS-COMMON-0001isClientApi只认端根前缀 ⇒ 包源*.api.js不进前后端交叉闸。登记的既有射程缺口(未修,归后续步):系统页壳形态无机器闸(**/xCore/exception/**被 x-api 三处 / x-auth 十处排除,归 S10-pre NS-MOBILE-0004 扩面);x-route 移动端闸字面端根、包源不在射程(归 S10);x-tools NS-COMMON-0024 只认别名形态、包内相对反向依赖不可见。架构结论见 arch/system/mobile v0.8.9(系统页壳形态 / 端→包别名统一 / 包内相对铁律 / IoC 落地形态)。物化 154 文件两端逐字节一致、闭包 0 悬空;x-auth NS-MOBILE-0010 报 grantable 清单陈旧属用户 admin build 主权,全量 -d 里保留为唯一预期红改动统一之前的版本没有改动清单
拆包 S6 xCore/i18n 入包 · IoC① 落地 + x-i18n 母本包 locales 根(patch):① 契约注入首次带电:包出口
registerInit(\x27locales\x27, initI18n),端 app.js 顶层require(\x27@wowoway/mobile-core\x27).initMobile({ locales });locale-loader不再 require 端聚合入口(包→端依赖铁律),未注入即 fail-loud(x-test/mobile-i18n-ioc.test.js 五例)。② 词典分层:包内另立包级框架聚合config/locales/{zh-CN,en-US}.js(9 框架叶),端根聚合只留一条require(\x27@xCore/i18n/config/locales/<lang>.js\x27)+ 端业务叶 —— 新增框架词典叶端零改;别名@xCore/i18n/*整键指包(auth / exception / feedback 六处消费零改)。③ x-i18n 14 条 locales 根规则:移动端模板提升为__mobileTpl,母本包源 locales 根按同模板生成pkg:<包>条目(root / 消费面 / unitDir 全落包源);0001 端可用键 = 端 ∪ 包、0003 包条目消费面 = 包 ∪ 全部移动端、0006 新增端↔包影子键臂、0009 新增「端根聚合必须接入包级聚合」臂、NS-MOBILE-0002 包源文件逐消费端查 app.js、0015 单位叶经 mobileLocate;x-exception 0012 / 0001-4b 两处读源改 mobileLocate(原排 S8 提前)。④ 顺手堵掉的既有射程缺口:x-i18n 目录模式根原写scanConfig.COMMON.root: x-client/…字面 —— 引擎只对 CLIENT 块按端类名册 swap,镜像端 x-technician 的 locales 根从未进过 root 类规则射程;改立 CLIENT 块(+{mobile-src}MOBILE_SRC 块),本轮起三根(client / technician / pkg:core)逐根独立判。反向注入 5 例全咬(影子键 / 端未接入 / 包废弃键 / 端与包消费不存在键)。教训:String.replace 替换串含$\x27把 0009 段残片插进正则(记忆库老坑再犯一次,已用函数替换器修)。arch/system/mobile 0.8.7 → 0.8.8(srcHash d8150dea)改动统一之前的版本没有改动清单
拆包 S5 xStyles 入包 · L3 引擎立「母本路径定位器」(minor 语义 · 记 patch 号):
buildDetectorTools新注入tools.mobileLocate(workspaceRoot, rel, endRoots)—— detector 把「框架相对路径」解析成实存绝对路径的唯一合法口,语义 = 源根优先(resolveMobileSrcRoots()逐根)+ 端根回落(过渡态 / 端自留地 / 测试床沙盒),调用方禁再自拼path.join(workspaceRoot, 端根, 框架路径)(S1–S4 逐个逼改的「端根派生」病根就此收口)。x-styles 十三处解析点改经它:注册表client.def值零改、语义改「相对母本包源根」;0001 引用面 = 全部消费端 ∪ 包源根 + 物化落点路径映射(…/miniprogram_npm/<包>/<包内相对路径>结尾即算引用);0003 落点 @import 改判「包内相对路径在包源实存」、与是否已装配无关(干净检出不假红);0015 / 0011 / 0013 三条跨文件闸的端定义面 = 端根树 ∪ 包源,包源文件借第一个移动端实例判。入包当天抓到两条假绿并闭环:0013 死档闸对包源定义文件早退(axis-matrix / border D4 / brand-ladder C2 / axes S16 四床同时翻红);0011 端内影子定义因包源根x-core字典序恒在端根之后、按「非最小者报」永不自报(反向注入实证,补「端文件与包源同名即无条件自报」臂)。指纹提醒:x-styles specHash 把 x-styles-axes.json 一并算进去,改注册表注记也要重新 sync(本批当场撞到一次)。床:13 张改指包源、run-style-beds 登记 brand-ladder / gradient 两床(25 张串行全绿)、common-nonN 新增 3 例落点 @import 正反例、def-teeth 期望 2→1(单一定义面)、border 台账 N15 探针路径改包源(基线不变、未 bake)。arch/system/mobile 0.8.6 → 0.8.7改动统一之前的版本没有改动清单
拆包 S1–S4 四个单元入包逼出的治理面判据改造(patch,均已闭环):L3 x-i18n NS-COMMON-0015 单位真相源由字面端路径改「母本包源根下同路径,找不到 fail-loud、禁回落端根」;x-type NS-MOBILE-0102 报错指路改包路径;x-styles 四闸对包源根生效——NS-COMMON-0017 禁副本 canonical 根 +=
tools.mobileSrcRoots、NS-COMMON-0039 canonical 逐根实存改「命中包源根即以该根为唯一根」、NS-COMMON-0018 包源 wxss 档位解析借第一个移动端实例的 def(S5 后改包源根)、NS-COMMON-0013 死档反向臂消费面 += 包源根(活体:tab 指示区档入包当天被判死档);x-motion-axis-closure 床扫描面 += 包源根;x-data选项集清单两条 constMap 锚改指包源(NS-DATA-0215 当场抓到——看板曾把它当散文);x-dev-rule「拆包过渡态」段;x-icon NS-MOBILE-0003 png 死链的端根派生改「包源文件按全部消费端逐端实存 + 名册空 fail-loud」(S2–S4 收尾全量 -d 抓到:包内 star-rating 引 /xStatic/icons/star-*.png 被按 x-core 根判死链——原排 S14,实际 S2 即触发;教训:端根派生 detector 的触发面看「包源文件会不会被它扫到」而非「它治的目录何时入包」,23 处已全部按此复核)。arch/system/mobile 0.8.5 → 0.8.6。教训入记忆:spec Edit 与 meta sync 禁同一批并行(指纹算在半改状态,x-styles 活体);单元搬迁前先 grep x-data 登记册改动统一之前的版本没有改动清单
拆包 S0.3 探针落盘揭出的三处治理面缺口(patch,均已闭环):① L3 引擎目录模式 scanConfig root 新增
{mobile-src}令牌(scanners/spec.jsextractScanConfigByTerminal 末段展开为每个实存母本包源根 resolveMobileSrcRoots() 的子树)——x-structure MOBILE_SRC 块原写死 core/src 六子树,domains/* 下的组件文件不在 dirModeRoots 内、被当普通文件喂给目录模式 detector ⇒ NS-MOBILE-0002/0003 ENOTDIR 崩溃(--changed活体);canary ② 加断言;② x-styles NS-MOBILE-0009 registry 消费闭环端根派生改「先匹配 tools.mobileSrcRoots → 类定义面 = 全部消费端 registries 之并」(包内组件被哪个端消费都得穿透;S5 xStyles 入包后再并入包源);③ x-styles NS-COMMON-0039 弃权表nonPrimitiveComponents.dir实存判定扩到母本包源根(组件入包后端根下只剩物化产物 IGNORED)。另.gitignore+=x-client/goods-sub/miniprogram_npm/(分包落点,S16 前置)。三处都是 S0.2b「18 处端根派生移交各单元步」之外被探针当场逼出的同型缺口——证明「先落探针再搬」的顺序对改动统一之前的版本没有改动清单
拆包 S0.2b 治理面前置·规范半边(裁定④ 的另一半,ADR-37):L3 x-backend V1.2.0——NS-COMMON-0001 闭合形态收进母本包骨架
(core | domains/<kebab>)/{package.json, src/**}(src 内容归 {mobile} 各规范,x-backend 只认领骨架),NS-COMMON-0002 锚扩core/package.json+domains/*/package.json但用独立 HIDDEN_PKG 表(IGNORED_DIRS ∪ {sys,templates},显式不含 locales/xType/xStyles)+ miniprogram 字段实存校验;x-mirror V2.1.0 新增 NS-COMMON-0002 内容指纹牙(锚 package.json → x-materialize → 各消费端<dest>/<包名>逐字节 equals,缺失/不同步/多余三臂按 (包,端) 聚合 + 端未装配独立错误 + 名册外端 fail-loud)——「IGNORED_DIRS ≠ 免疫」首个活体;x-surface NS-MOBILE-0002 端根派生改「先匹配源根 → 全部消费端 app.json」;x-marker NS-COMMON-0002 射程改{mobile}令牌形态;x-standard 有效键快照 += mobileSrcRoots;x-constitution rule paths 收x-core/**;x-client-engineer 写域切分(core/src 与 domains 归它,backends 与装配器不归);x-exception / x-structure 规则书补齐 STD-ADMIN-0006/0008、STD-MOBILE-0006、NS-SERVER-0003、NS-ADMIN-0001/0002/0005/0009/0010 引用(validate 33/33);arch/system/mobile 0.8.3 describes 装配器条目放宽x-core/tools/**。验真:x-backend 四向反向注入 + 指纹牙三臂注入 + canary ⑤ 双表断言 + 行为床全绿。收录 ADR-37- v1.41.x
改动统一之前的版本没有改动清单
拆包 S0.2a 治理面前置(裁定④ 引擎半边):L3
terminals.js双形态导出母本源根(MOBILE_SRC_ROOT_GLOBScore/src ∪ domains/*/src 供{mobile}展开 ·resolveMobileSrcRoots()实存列表供 fs 消费者与tools.mobileSrcRoots,显式不含 backends/,miniprogram≠srcfail-loud);{mobile}令牌第二半射程 + 新增{mobile-end}端根限定令牌(x-structure NS-MOBILE-0013 改用,S0.2a 当日活体:detector split(/)[0] 推端根落包源推出 x-core 误咬);x-standard NS-COMMON-0018 白名单 +=mobile-end;x-structure 头部加scanConfig.MOBILE_SRC块;x-arch NS-COMMON-0003 walk 排除 node_modules/dist/.cache/miniprogram_npm;compile-checker x-core 补 wxss/wxml(+14/+14 文件);formatter-helpers 文件失败端无关 + report-formatter 后缀走 getTerminalRuleSuffix;L4isGeneratedArtifact三处产物四通道只读 +isBizSource+= html/css/wxs(verify-harness +6 例 GA1–GA6,183/183);L1 x-meta-devderiveRulePaths(聚合 + 引擎同一展开 + 目录形态补 /)、sync --paths只重写 paths 块、validate1b 集合相等阻断、ENDPOINTS 改 ALL_TOP_DIRS 派生、无 paths 块 = 全局规则书豁免,26 本规则书当日归一(x-api 15→120 条等);x-mobile-dev startup-closure 退化为mobile.js closure()薄壳(H8b)、verify-mobile 加--skip-arch与 ④ 闭包臂、mobile-dev.test 硬阈值改现算、transformAppJs 剥 goods-sub 预热块(闭包升级当日抓获:孵化端 app.js 残留 require.async 悬空,旧 BFS 从未报过);deploy.js PRE-VALIDATE 对每个实存源根逐一 -m x-surface;两床(geometry / zoom)改复用引擎 buildDetectorTools;金丝雀 +⑥⑦⑧(9/9)。验真:verify-harness 183/183 · 行为床 30/30 · 全量 check.js -d 除他会话 customer/ARCH srcHash 外零新红 · meta validate --all 31/33(余 2 项为存量 STD/NS 引用债,git diff 证与 paths 无关)· verify-mobile ④ 两端悬空 0。诚实边界:19 处 detector 端根派生归 S0.2b;x-backend 对 core/ 仍裸早退(S0.2b)。§三 / §十- v1.40.x
改动统一之前的版本没有改动清单
L5 移动端系统层母本取得包身份 + 装配器 weapp 腿(拆包 S0.1,ADR-36):
x-core/mobile/core/package.json=@wowoway/mobile-core(miniprogram:"src"+x-materialize {dest:"miniprogram_npm", ends:"all"},四方共读的唯一一张表)+src/index.js契约出口占位(initMobile({ env, locales, routes, menus, preload, tabbar, cloudAsset }),键无接管者即 fail-loud);pnpm-workspace 写全五项(+mobile/core+mobile/domains/*);x-core/tools/mobile.js长出 weapp 腿——--materialize --backend weapp(每端 × 每包按 x-materialize 落点,复用 manifest.js sha256 / atomicWrite / pruneEmptyDirs 原语,同内容跳过、多余清掉)/--verify --end all(ok / missing / differing / extra / 未装配)/--closure --end all(端 + 消费包虚拟树上四类引用零悬空,包→包 bare@wowoway/<pkg>/…、别名最长匹配、剥注释后扫);web 腿包源直拷进 staging 同一落点 +aliasesFrom键长降序 + webpackresolve.roots/resolve.modules;缺--backend必 fail-loud。实证:行为床 30/30(探针包x-test/fixtures/x-fixture-mobile-core三面——别名 require / 根绝对 usingComponents / app.wxss @import——全部打进 bundle;verify 三态反向注入改 1 字节 / 缺 1 文件 / 多 1 文件全咬;closure 注入坏 require / 坏 usingComponents / 消费集外包三种必报;注释里的 @import 首跑即被当引用 → 补剥注释器再绿);真端--closure --end allx-client 831 文件 781 引用 / x-technician 300 文件 231 引用零悬空;--materialize --backend weapp两端各落miniprogram_npm/@wowoway/mobile-core/index.js,--verify全 ok;-m x-backend x-core73 文件 8 闸绿;名册金丝雀 5/5。§三 L5 框 + §十 消费边界按 backend 分档- v1.39.x
改动统一之前的版本没有改动清单
L3 母本闭集扩五维 + L5 web backend 三兑现点 + H5 传输定型(ADR-35):x-surface V1.2.0 注册表加
schemes(协议 → kind / resolver / 接收入口)与componentApis(methods / lifecycle / options)两表,母本侧 NS-MOBILE-0004 值形态闭集闸 / NS-MOBILE-0005 组件实例 API 闭集闸 + 元闸 ⑫⑬;x-backend V1.1.0 加 NS-COMMON-0007 值形态 resolver 接入闸(唯一换算点 + 每个接收入口必经)/ NS-COMMON-0008 组件实例 API 覆盖声明闸(adapter / runtime / degraded 键集 ≡ 注册表);web backend 新增runtime/{resolver,transport,capabilities}.js与 bundler 虚拟模块__X_RESOLVER__/__X_ENV_CONFIG__,animate / clearAnimation 运行时补齐;H5 云函数调用走 admin 同一条 HTTP 网关(Bearer +X-Source-Platform: web-{端}),server 内核策略表名册派生web-{端} → ['token']、handler 对已认证 web 来源不令牌化、file-url-read 分支 W,内核 0.2.0 + manifest --stamp,x-jwt V1.1.0;装配器--gateway。根因病历:真 x-client H5 登录页 11 图全碎 = 闭集少两维(不是身份)。实证:0004 反向注入精确行号、0007/0008 三处同批注入 2+3 处、行为床 22/22、浏览器 11 图全载、全量 -d 96/98(余两红为文档保鲜已同批清)。诚实边界:backend 两闸判接入 / 声明不判结果;web 来源→端身份表映射归阶段 S;内核母本受 guard 保护区只读,改动经 node 脚本通道(锚不命中 exit 1)。- v1.38.x
改动统一之前的版本没有改动清单
L5 移动端 backend 层立(ADR-34):四件套母本 × 三 backend(微信 / Donut / H5),H5 backend 基于 glass-easel 自建住
x-core/mobile/backends/web(globals 双槽 / 页面栈 + eventChannel + history / wx shim 43 令牌三态 / 4 内置组件 / bundler / shell),装配器x-core/tools/mobile.js(端自发现、生成物<端>/dist/web+.cache/web-src);L3 新增两本纯 NS 规范:x-surface V1.1.0(母本语言面闭集 + 伴生注册表x-surface-whitelist.json,4 条)与 x-backend V1.0.0(backend 契约,5 条),均反向注入实证;x-test 行为床mobile-web-backend.test.js17 例(shim 逐令牌 / 双槽 × 真适配器 / 名册金丝雀 / 固件端真 webpack 端到端);x-mobile-dev COPY_EXCLUDE_DIRS 与 verify-mobile 补 dist / .cache;roadmap END_RULES.client 19 本。真 x-client 副本装配 + 浏览器实测通过。详 §九。- v1.37.x
改动统一之前的版本没有改动清单
全面复盘闭环 WP-04 批A/B(detector 判据补强 34 条 · 红床先行 70 例)+ 引擎 L3 视图分流补齐:
ts-source-context.stripCssComments新增(CSS 家族专用单趟剥注释:块注释 + LESS 行注释,:/// url( / 字符串内不剥,无正则态无模板态),non-standard-checkerCSS 分支改用之 —— JS 词法器把calc(100% / 3)的/当正则起点、把url(//cdn)当注释起手,是样式面假红 / 假绿的共同病根(G06-F7 / G02-F10 / G03-F08);stripNonCode单/双引号态换行退出(JSX 文本撇号曾把后续多行抹白)。床x-test/ts-source-context-lexer.test.js7 例;全量 92 项改前后零变化。同批 A0005 收回 app.tsx 排除(活体已无 @ant-design/colors)、0011 单点报告反转(--changed增量门下新影子定义自曝红)、0007/0039 注册表形态与 schema 双向闸。教训:M0004 抹绑定过头致 38+4 假红当场修回(绑定折成{{}}占位而非空);REG10 定义识别块锚点从 7 翻到 8(M0007 declRe7 入族) —— 锚点按设计翻红即登记决策。改动统一之前的版本没有改动清单
全面复盘闭环 WP-03(detector 判据修 30 条 · 红床先行):x-styles 60 闸中 0010(JS 成员赋值 / setProperty / 字符串内 kebab 声明 / 函数实参 / 百分比按 valueGrammar / WXML 单引号)· 0026 孪生同口径 · 0001 路径解析等值 · 0003
~@/别名 · 0007 形态校验 · 0011/0014 定义位文法 · 0015 扩 .ts/.js · 0017/0036 CSS 视图 · 0021 四形态 · 0022 gray-13 · 0024 块栈归族 · 0025 档化写法 · 0033 margin 简写 · 0034 calc + 多 token · 0038 端归属派生 · 0039 KNOWN↔schema · A0002 加 i · A0006/A0007/A0008 · M0002 穿透态三形态 · M0004/M0005/M0006/M0007/M0008 · M0010 三臂;0010/0026 排除面同深收窄到 token 定义目录;引擎ts-source-context.stripNonCode补 url( 免疫 + REGEX 态(与 stripComments 同源,等长契约不变,全量 92 项零回归)。新常驻床x-test/x-styles-effectiveness.test.js(50 例 ·X_STYLES_SPEC=<快照>复现红)+x-test/ts-source-context-lexer.test.js(5 例);活体抓出并修 2 处(colors.wxss rgb(0,0,0) · user-card.js 字符串 margin-top: 88px)。底稿见当时 x-styles 复盘的归档目录(CLOSURE-PLAN / CLOSURE-LEDGER;★2026-09-09 去路径化:原写反引号包裹的 plan 路径,而 plan 闭环即删、引之必死链 —— 结论已固化在本行,指针不必留★)。教训:适用文件行括号说明内禁反引号(引擎整行取反引号为 glob,x-standard 0018/0030 会曝红;勿用脚本批量改别人的排除行)改动统一之前的版本没有改动清单
style 全面复盘订正(patch · 零机制变更):§七 档位体系口径「16 轴」→「11 轴 + 四类目不建档只守镜像折半(0034 臂3)+ 字族纯禁令」登记入架构真相源;伴生原语表双向一致的诚实边界补写。复盘本体见看板 ㉑(47 份只读审计 + 三视角反驳,存活 418 条)
改动统一之前的版本没有改动清单
L3:视觉原语治理归属定案 —— 留在 x-styles(治理版图第二半张图),数据独立成伴生注册表
x-styles-primitives.json(D-34 结案,ADR-33)。①三路独立方案 + 六份对抗反驳综合裁定否决「迁 x-tools」与「新建 x-primitive spec」:逼用闸是档位表消费者(搬出即半把锁 + 引擎禁依赖业务注册表)、三条元闸看守随迁丢失只能克隆、gapless 重编 25 号让床静默换靶,效力增量为零;②伴生文件靠同目录同前缀自动入 specHash 与 Stop 环扇出,detector 内preg/reg分名隔离 0019,0007 ⑧ 留墓碑;③补牙:NS-COMMON-0039注册表自洽(声明或弃权 / canonical 逐根实存 / requireAttrs↔本体对拍 / 前缀正交 / 弃权表)·NS-MOBILE-0012配方类根认领(一原语一前缀,.x-submit-btn→.x-submit-bar-btn双端归位)·NS-MOBILE-0013组件目录归类(新建组件第一个 json 就红)·0017端锚定 + 词边界 + 镜像域 pairs 豁免(解 0017×0034 catch-22)·NS-MOBILE-0005增 requireAttrs + 事件名归一 + 标签边界;NS-MOBILE-0003 删与 L2 排除重复的路径早退;④验真:-t/-v x-styles绿,三端-m x-styles0 红,新床x-styles-primitives-teeth24/24(含临时注册表反向注入),描边八床全绿;消费 STD 模板经论证为形式主义,登记为带触发条件的待办- v1.36.x
改动统一之前的版本没有改动清单
L3:引擎新增 CSS 声明解析原子
parsers/css-decl.js+ detector 工具包契约单一真相源(描边轴 57 缺口根治,用户令「修到严控」)。①病根:x-styles 各闸自写「属性: 值 / 定义位 / 长度文法」正则 12+ 份副本各自演化,105 用例台账 57 个口子多数同源;②原子经tools.cssParser注入(整文声明迭代 · 行内 style · 定义表 · 长度文法全单位 · border 四边展开 · 旋转判定),0010/0026/0013/0023/NS-MOBILE-0008/0018 改用;③buildDetectorTools抽为引擎导出、_getPreprocessed补内容同一性校验、x-standard NS-COMMON-0024 有效键改Object.keys(tools);④闸侧:0010 自建变量/LESS 变量代入判 + JS 表达式感知 + WXML 绑定内字面量,0026 判全 var + 私有变量穿透 + calc 运算数按任一轴,0018 由正则签名改语义几何(注册表enforce.shape),NS-MOBILE-0011 扩四臂含 wxss content,0007 增三臂(closedSets 禁 biz / valueGrammar 单位全集对拍 / enforce 只认 shape),0030 增大小写碰撞臂,0015 JS 视图,0006/0011/0015 stripStr 转义文法;⑤注册表:border 补 12 逻辑属性位 + 单位全集 + 放弃面归零形态,颜色轴认领 box-shadow/text-shadow 色段,transform 轴单位段机械同步;⑥床:原子单元床 40 · 判据床 84 · 射程床 21(真引擎)· 台账 105 OPEN 0 · 棘轮 11;活体三端 Δ=0(两处真裸值顺手改档)。ADR-32。- v1.35.x
改动统一之前的版本没有改动清单
L3:假绿根治(v1.34.0)的两个【论证支点】补上机器锚(D-51 销账)。①证伪立案的旧描述:D-51 立案写「detector 编译期抛错仍返回 0 违规,同文件真违规随之消失(活体 3→0)」。真引擎双注入实测(在真 spec 内同时注入「一条 detector 语法错」+「另一条必报违规」,跑完立即撤销、与备份逐字节比对零残留):坏 detector 报 🚨
LOAD_FAILED、同文件另一条规则的真违规照常报出、退出码 0→1 ⇒ 前半句已被 v1.34.0 修掉,后半句不成立(该场景为 per-rule 调用,结构上不存在跨规则污染)。②发现并补上真缺口:§八原文的论证支点之一是「extractNsRuleDetector全库只有一个调用点 ⇒ 修一处即全通道覆盖」——这是会漂移的前提;而「消费点真的调用了getNsDetectorLoadFailure」不被任何既有断言覆盖(回归床 L1–L4 查的是违规类型/状态枚举/查询函数/状态机优先级在不在,没有一条查有人用它)。实测:抽掉消费点那句 failure 查询,L1/L2/L3/L4 全部照常绿,假绿原样复活。③处置:新增回归床用例 L5(x-test/x-styles-axes-teeth.test.js),双重锚定——(a) 消费点必须同时在场三样(查 failure / 产DETECTOR_LOAD_FAILED/ 记LOAD_FAILED状态)且顺序正确(查询在if (!detector)分支内、在 detector 执行之前);(b) 反向枚举全scripts/树的extractNsRuleDetector真调用点(剥注释后按「后跟左括号」判真调用),多出一个即 fail-loud 逼人确认它也查了 failure。承重验真:抽掉查询 → L5 精确翻红而 L1–L4 全绿(这正是缺口存在的铁证)→ 还原后与备份逐字节相同、探针零残留、床回到基线。引擎属 L4 只读面,注入与还原全程走脚本(非 Edit 工具)。残余(如实登记):catch 本身仍只 log + 写_detectorFailure而不直接 push violation —— 这是关注点分离的设计不是缺陷(违规由消费方按 per-rule 上下文产出),且唯一消费点已被 L5 焊死改动统一之前的版本没有改动清单
L4:环2.5 worktree-probe 四条记账缺口同批补齐(D-30 销账,用户开脊柱闸)。①G1 路径解码:git 对非 ASCII 路径【默认】C-quote(
\ooo八进制),原实现用JSON.parse解——JSON 不认八进制,遇\346必抛 ⇒ 落 catch ⇒ 带引号原串被当路径 ⇒ statSync 失败(mtime 记 -1)、入队一条不存在的路径 ⇒check.js --changed无事可做 ⇒ 该文件静默逃出复核而报告全绿。改为按【字节】解码再整体 UTF-8 还原(一个汉字 3 个\ooo,逐字符解会得 3 个坏码点)。射程实测:全仓 542 个 tracked 路径会被 quote(含受治的plan/multi-item-order/流程图解.html)——立案原文「样式面活体实例=0」只统计了样式面。②G2 忽略面:原诚实边界③「实测三端样本无一被 ignore」是假的——.gitignore里一条从 Node 通用模板抄来的裸logs/吞掉 6 个真实业务源(x-admin/src/xModules/logs/{index.ts,pages/logs.tsx}且config/routes.ts已注册/logs/base路由 + zh-CN/en-US 两份语言包),它们既不在版本库(新克隆构建失败)也对本环全盲。实测仓库内 4 个 logs 目录中 3 个是业务源、第 4 个在已整体忽略的x-demo/内 ⇒ 该规则零正当用途,已删除;边界订正为「被 ignore 的文件测不到是 git 视角固有天花板,现存反例已清零,复发由回归床对拍拦截」。③G3 基线写保护:快照.claude/tmp/worktree-snap.json升入isSpineTarget——把它改写成【等于当前状态】⇒ 差集恒空 ⇒ 本轮全部改动从队列凭空消失,Stop 逼修与部署门 isPending 同时失明且都报绿,危害与runtime-registry.js同级(判据逐字同构);补前它逐条过不了任一既有谓词(非 settings/.mcp.json/guard 树 · 不含 check-spec/ ·.claude/tmp≠ sys|templates|.umi ·.claude不在 ALL_TOP_DIRS)⇒ 三通道全放行。不影响探针自身(进程内 fs 写不经 PreToolUse)。④G4 降级语义归一:reconcile一直返回degraded/noRepo/baseline,部署门也一直逐条 fail-closed,唯独 Stop 环三个标志一个都不读——降级时changed恒为[],「git 测量失败」与「工作树真干净」在本环里不可区分,整轮 Bash 写静默逃逸;现 Stop 环与部署门同语义拦截(禁同一字段两套失效语义,与 D-25endRoots同款病理)。新建常驻回归床x-test/guard-worktree-probe.test.js(CQ/IG/SP/DG 四组 7 用例),其中 CQ1 与外部真相源全仓逐条对拍(git 默认 quote 输出 ↔core.quotePath=false真名,542 条全等)。承重验真 4/4:四条缺口各自反向注入 → 床精确曝红(CQ 注入回JSON.parse时 542 条全部不符,即修前真实状态)→ 撤销后复绿,零残留。verify-harness177/0,全量 92/92- v1.33.x
改动统一之前的版本没有改动清单
L4+L2:新建云函数通道翻转为 MCP 优先(用户拍板)+ vendor 双形态归一。①背景:双探针真云对比(自省指纹法,env 只回传名+sha256 前 8 位)证实 MCP createFunction 已支持 envVariables+timeout(与 tcb 注入逐字节等效指纹),平台侧 detail 除密钥外逐字段零差异(Memory 默认 256=标准档,CodeSize 差 5 字节=包名长度),createFunctionHTTPAccess 与 tcb service create 等价(双 200);官方最优实践核证=「禁止硬编码,统一环境变量」(docs.cloudbase.net secure-secrets 专页)。密钥经 MCP 参数下发由用户裁定放开(env-registry 本在仓库+detail 本会回显,边际暴露≈0;卫生建议=定期轮换)。②闸演化:runtimeConfigBypass 增 ctx.expectedTimeout(guard 从 runtime-registry 注入)——携带 timeout==真值放行/不一致或取不到拦/memorySize 恒拦(全兼容旧语义:MG15-17 沙箱无 registry 仍拦)。③★vendor 双形态归一★:实测 MCP 服务端重连后切为扁平工具集(createFunction/updateFunctionCode/...),旧判据只认聚合名 ⇒ 扁平面将被未知快照整体拦死或绕闸;mcp-policy 增 normalizeFlat(扁平→聚合语义,含 name→functionName/funcParam→func 参数归一)+扁平读/变更/凭证面分类登记(login/logout/interactiveDialog 硬拦),四判定面单真相源。回归 MG26-31(扁平读放行/timeout 匹配放行/不匹配拦/funcParam 归一不误伤/login 拦/registry 不可读 fail-closed),verify-harness 146→152/0。④流程落地:SKILL「新建·MCP 六步」(5a 预检→bundle→print-fn-config 取真值→createFunction→建路由→后验;--validate-only 实测不吃 --path 走全量,预检明示用 5a)+新脚本 print-fn-config.js(本地打印 {timeout,envVariables} 真值)+流程1 降为 tcb 兜底(MCP 故障/非 256 memorySize/批量);x-dev-rule 第6步+NS-DEV-0024 同步翻转
- v1.32.x
改动统一之前的版本没有改动清单
L5:真大一统 v3 · P1 交付 + S2 乙案裁定(用户确认)。①P1:x-core monorepo 化(pnpm-workspace.yaml,packages=['server','packages/*']),内核获包身份
@wowoway/server-kernel@0.1.0(包目录=server/ 而非 packages/server-kernel/ —— 内容零动铁律:挪 sys 即断全部牙锚;40 内核文件零移动,验收 harness 146/0·原语床 49/0·sys-check 0·C1 棘轮咬住 4 新文件登记复绿)。②S2 真云 PoC(探针 zz-npm-poc-read,验后即删):MCP 通道对第一方包四路全死——打包器硬剥 node_modules(下载云端存储 zip 铁证:@wowoway 零条目)/显式 ignore 覆盖不了(合并非替换)/NODE_PATH 平台明禁「不支持修改系统环境变量」/zipFile 参数 MCP 实现坏(paths[0] undefined);云端 node_modules=上传包∪registry 云装合成(mtime 实证每次 update 重装)⇒ 非 registry 包经 MCP 更新必丢⇒ 内核入 node_modules=杀死 MCP 一分钟快路径,不可行。③乙案裁定:包身份在源头(workspace/版本/跨端共核/未来 registry 全成立),server 发布面保持 sys/ 装配(三道牙+运行时锚+MCP 快路径零改);原路径B 的 16 入口 codemod+handler IoC 2 行反转作废(sys/ 物理位下上溯天然成立);丙案(vendor/+Module._initPaths 私有 API)违零兜底被否。④版本纪律落地:x-meta-rule 场景C 增 2.5 步(改内核→semver bump→--stamp)+禁令一条;deploy SKILL 流程2 增第 0 步;manifest.js --stamp 输出提醒。npm 侧事实:仅占 scope 名(@wowoway 归用户账号),包 private:true,本机 CLI 未登录(网站登录≠CLI 登录),零发布——发布是 P6 运输升档的一条命令(需用户 npm login+显式授权,登录/发布须指官方 registry,本机默认源=npmmirror 镜像)- v1.31.x
改动统一之前的版本没有改动清单
L4+L5:v1.31.0 交付物的对抗审查回扫(4 镜头找缺陷 × 逐条怀疑者反驳,12 候选 → 7 确证/5 驳回),确证项全部当批修复:①P0 批量部署假绿(活体复现):deploy() 四处 early return(坏路径/staging 清理失败/内核装配·verifyBundle 失败)不走进度计数 ⇒ batchDeploy 汇总恒「成功 0/失败 0」、消费端 exit 0 报全成功——最危形态=改内核忘 --stamp 时 --all 208 个全部静默跳过仍报成功。修:早退统一 failEarly(必计数必留痕)+ 汇总从 results 单真相源导出 + undefined 槽位按失败计;回归=skill 自测新增批量计数用例(82/0)。②P1 sys-sync 分发通道绕过锚新鲜度闸:原自带 readdir+copy 树(违反 manifest.js「禁第二处 walk/copy」铁律),不经 manifest() ⇒ assertStampFresh 在【分发主通道】上从不触发=「新文件+旧锚」可被铺到 208 副本。修:整改为逐副本 manifest.materialize()/delta()(闸+delta+prune+原子写全继承);活体反向注入=篡改母本不盖章 → sys-sync dry-run 每份 fail-loud「锚清单过期」(改前静默分发)。③P1 运行时锚 extra 全盲:verifyKernel 只查清单内文件,而 Node LOAD_AS_FILE 先于 LOAD_AS_DIRECTORY ⇒ 残留旧版
strategies.js可遮蔽现役strategies/index.js(内核今天就有 3 个无后缀目录模块引用),40 文件字节全对、认证链跑旧代码、锚全绿。修:verifyKernel 增 sysRoot 全量枚举,清单外文件即红(R5 反向注入验证)。④P2 stamp tmp 残留收编:atomicWrite 崩溃残留.x.tmp-pid-seq会被下次 --stamp 烙进清单并全网分发且运行时反而【要求】它存在。修:TMP_RESIDUE_RE 三点联防——walkFiles 不见它(不入清单)/materialize 顺手清扫/integrity 运行时豁免(S5/R6 验证)。⑤P2 guard 四臂串行超时合计 60s 超 PreToolUse 30s 预算(双挂并发时 hook 被杀=fail-open):床 20s→12s(44 倍余量)·check-ignore 10s→3s·--verify 20s→8s,合计 26s+开销<30s,过期算术注释同步改写。驳回的 5 条(路径别名绕过/BOM 砖死/冷启动语义/closure 循环依赖/deployer X 形误拦)均经实码反驳留档。附确认:--all 全量 verifyBundle 增量耗时 ≈50s(~2%,可接受)。回归:原语床 49/0 · skill 82/0 · harness 146/0 · sys-sync(新通道)208 → sys-check 0 · 冒烟 ✅ · 资损域床 12 床全绿改动统一之前的版本没有改动清单
L4+L5:运行时锚(D7)兑现 + 牙B 接线 + 内核装配闸补记。①运行时锚:母本增
base/integrity.js+kernel-manifest.json(manifest.js --stamp生成,确定性序列化保证副本逐字节等值);manifest()对 canonical 母本强制锚新鲜度(改内核忘 --stamp ⇒ 装配/校验/打包全线 fail-loud);handler.js冷启动第一行校验,缺失/漂移抛KERNEL_INTEGRITY——手工 tcb/开发者工具/cwd 不在根/Bash 直跑四类本地闸全部够不着的通道的唯一防线。真云 E2E:一次性探针函数走脚本通道全链路(VALIDATE+装配+牙B+发布),冷启动 1596ms 返回业务错=内核加载成功,验后删除零残留;本地反向注入三形态(漂移/缺文件/删锚清单)全部抛错。②牙B 接线:verifyBundle三合一(内核字节等值+require 闭合[断边/逃逸/禁动态 require,sys 虚拟解析到母本]+bare 依赖对账[externals ⊆ deps ∪ busboy 白名单]),CLI--verify与脚本通道 deployer 同点消费——guard MCP 闸 spawn、deployer require,红即 fail 部署。上线前全仓普查 209/209:0 断边 0 动态,externals 恰为模板 5 锁定 deps ∪ busboy,零存量曝红。v2p6-6「装配后 deps 对账」由此同批兑现(canonical EXACT 等值已锁存量,闭包对账锁增量)。③§八补记 v1.30.0 批内落地却漏记的内核装配闸(kernelAssemblySurface 双臂:内容臂+打包器剥离臂)——当批漏记属宪法 §六·4 违规,如实认。④诚实边界声明:arch srcHash 保鲜牙对 x-core 结构性不可达(describes=四端 glob),内核变更真相由 sys-check 三臂+本 CHANGELOG 承载。自测:x-core 原语床 33→46(S1-S4 锚/R1-R4 运行时/V1-V5 verifyBundle),verify-harness 146/0(C1 双向棘轮当场咬住 2 个新真空文件,登记后复绿),skill 81/0,模板冒烟 ✅,资损域床 --all 全绿,sys-sync 208 后 sys-check 0 违规。线上生效边界(诚实):锚只随下一次发布进入线上函数,当前线上 208 函数尚无锚,属渐进生效- v1.30.x
改动统一之前的版本没有改动清单
L5 代码层:server 内核母本归位 x-core。
x-server/templates/cloud-function-template/sys38 文件迁至x-core/server/sys(逐文件 sha256 等值,树指纹b214117d迁前迁后逐字相同);模板降为 6 个业务骨架文件,sys/改由x-core/tools/manifest.js从母本装配(delta + prune + 原子写三语义,缺 prune 即「陈旧内核静默上生产」)。同批新建两原语:manifest.js(内核根由__dirname派生,无可漂常量) +closure.js(内置最小 JS 词法器,虚拟解析:sys/**一律解析到母本、无视盘上物化状态),自测床x-test/x-core-tools.test.js33 用例经三轮反向注入。改址面 20 处:4 spec(x-deploy 母本根 + x-exception STD/闭环 NS + x-jwt + x-auth,各自 specHash 重算 + rule 同步)· 6 rule 正文 · admin 插件 2 处 · 3 个 x-test 金丝雀 · sync-sys-directory · scaffold.js 与 template-smoke-check.js 改「复制骨架 + 装配内核」· 7 份文档。编译验证面同批扩到 x-core(COMPILE_DIRS = BUSINESS_DIRS ∪ FRAMEWORK_DIRS)——不扩则 38 个内核文件随母本迁出静默退出 OxLint 面,且只表现为文件数变小、不报错。coverage-inventory 45→82(母本 38 文件中仅base/exception-codes.js有 spec 认领,其余 37 为检测真空——迁移前它们的「被认领」是 include-before-exclude 的副产物,并非真被检测,本次把这一真空显式化)。诚实边界:母本内容级检测仍缺,待 P6 牙B(引用闭合)与禁动态 require 补齐- v1.29.x
改动统一之前的版本没有改动清单
L5 代码层:x-core 内核母本立项(收录 ADR-30)。§三 六层全景图 L5 行、§九 L5 代码层表、§十 治理拓扑三处同步——x-core 定性为 L5 被治材料(非新工件类、非端、不改治理拓扑),铁律「框架【操作】它、绝不【依赖】它」对其同样成立,判据=「若 x-core 消失,part1 能否独立自洽自测」(答案:能)。§九 表头由「端」改「顶层物」并补录长期漏登的 x-technician(真实师傅端小程序,217 文件受治),同批标注 x-client=canonical / x-technician=镜像端。§八 刻意未动——x-core 现阶段不涉及 guard 变更,盲改即无中生有。宪法侧同步 §一 表(追加内核行 + 补录 x-technician + 表头改「顶层物」)、§三 L5 行、§二 存在性声明,全部只写定性、机制细节按 §七 留 L3/L5
- v1.28.x
改动统一之前的版本没有改动清单
L4 强制层:新增强制闸门「运行时配置绕过闸」(
guard/mcp-policy.js出runtimeConfigBypass纯函数,guard.js在代码推送闸【之前】消费)。病根=云函数timeout/memorySize是平台侧参数(函数运行时改不了自己),唯一真相源在runtime-registry.js;但存在多条「绕过仓库直改线上」通道(manageFunctions.updateFunctionConfig/createFunction.func.timeout/callCloudApi scf.UpdateFunctionConfiguration),且都不推代码⇒ 既有codePushSurface恒 miss、静态检测扫文件也看不见线上态 ⇒ 线上被改而仓库不知情,下次脚本发布又覆盖回去,值反复横跳。只拦显式携带该两字段者,不携带一律放行(纯改代码的updateFunctionCode快路径完全不受影响)。必须挂在 codePushSurface 判据之前——配置绕过不推代码,挂后面等于永不触发。回归 MG15–MG18(三拦一不误伤),verify-harness 135→139。同批修正:tcb fn deploy --all假绿根治(其收尾只logger.error=console.log、无 throw 无 exit ⇒ 部署失败退出码仍为 0,已改命名式)- v1.27.x
改动统一之前的版本没有改动清单
规范能力层:新增强制闸门 NS-COMMON-0031「脚手架模板↔STD插槽契约保鲜」(x-standard-spec,detector 锚
*-spec.md内 fs 反读.claude/skills/*/assets/templates/**,解析模板自带 X-RULE 标记取 STD 归属,归属本 spec 则按其 SLOT-VALIDATION 逐行比对,三向 fail-loud)。病根=模板处于检测真空:templates/在聚合阶段被判独占域剔除,业务 spec 永远看不见它;skill 自测 T6 又只断字符串包含,违规行藏在插槽内部照样穿过。活体事故:x-data-spec 于 2026-07-01 给「字段设计内容」槽加 linelist 校验,而 x-data-dev 6 个模板停在 2026-06-13 形态 ⇒ 产物必违规(base 12/node 7/relation 7/leaf 5/log 5/dict 5),潜伏 43 天无人踩中(期间 7 张新表全部手工/复制建成绕过脚手架)。设计要点=零新增执行点(寄生-v,已被 Stop 环与全量面双点无条件调用;且自身受 NS-COMMON-0027 管,想悄悄退化即被现有牙咬)。同批修 6 模板(说明性小节移入## 附注,对齐存量 12 张表惯例),曝红 26→0。反向注入揪出 detector 自身 BUG:正则硬编码-->结尾 ⇒ 对全部 JS 注释形态 spec(x-api/x-type/x-curd/x-auth)提取不到规则而静默恒绿,已改(?:-->)?双形兼容。诚实边界:证形不证意;射程止于 skills 内模板(x-server/templates/**由 template-smoke-check.js 另线,当前零调用);占位符行交 skill 自测 T6 兜底(4/7 skill 的 T6 仍假绿,独立工单)- v1.26.x
改动统一之前的版本没有改动清单
本文档自身日志载体分离:§十一 ADR 全表(30 条 64,517 B)+ §变更历史全表(25 条 22,884 B)外迁
harness/{ADR.md,CHANGELOG.md},正文 123,286 → 36,362 B(降 70.5%)。病根:本文档 70.9% 是历史,而它是 L0–L5 架构真相源、宪法 §六·4 强制每次架构性变更必读必更——读一次架构详图被迫吞两倍于正文的决策记录与版本流水。载体形态:正文保留两处薄指针(存在性声明 + 链接),ADR 标注「不可变追加,既有条目只能被 supersede」,CHANGELOG 标注「新条目追加本表,禁写回正文」。为何不整体目录化(harness-engineering.md→harness/ARCH.md):该路径被x-governance-spec包含面与x-governance-rulepaths 字面写死、被宪法 §六·4/§六·5/相关文档表引用、被x-arch-spec两处 detector message 提及——改路径须动 2 个 spec 的 specHash,而本批用户约束为「rule+spec+hook 不动」。故取正文原位 + 旁挂harness/目录:零 spec 改动、零 specHash 变动、零宪法改动、零引用破坏(实测全部 spec 包含面无一捕获.claude/harness/**)。验证闭环:原文 344 非空行逐字比对全部命中对应产物、ADR 30→30 与版本 25→25 条数守恒、x-governance 四闸全绿。诚实边界:①外迁产物不受任何 detector 保护(与 arch 的 NS-COMMON-0004/0005/0006 三闸不同),回流与失同步靠人工;②本文档与 arch 现为两种载体形态(arch=域目录内成对,harness=正文原位旁挂),统一需待 spec 解封;③rule/spec/hook 经三路取证 + 双轮对抗审查判定不做——其内嵌日期绝大多数是立法判例与验证留痕(护城河本体),真流水仅 0.36%,且x-standard NS-COMMON-0009硬编码 5 章节白名单使 spec 物理上无处安放「变更历史」节- v1.25.x
改动统一之前的版本没有改动清单
业务架构治理层:arch 日志载体分离(P2,承 v1.24.0 域目录化)。261 条
version-log自 9 域ARCH.mdfrontmatter 迁出为同级CHANGELOG.md(分节## v{版本} — {YYYY-MM-DD}),ARCH 总量 1,061,883 → 571,221 字节(降 46.2%),order 域 434KB→189KB(降 56.3%)、coupon 降 65.6%。病根:日志躺在 frontmatter 文件头部,任何 Read 都必然先吞完历史流水才够到正文标题(order 域 99 条占全文 56.5%,sourceOfTruth被挤到第 116 行),使「只读设计面」物理上不可能。新增三闸(NS-COMMON-0004/0005/0006):成套闸(有 ARCH.md 必有同级 CHANGELOG.md——日志无处可去必然回流文档头)/ 日志载体分离双臂(臂A ARCH.md 禁version-log键、臂B CHANGELOG.md 禁describes/srcHash/sourceOfTruth)/ 域目录白名单(只允许两文件 +parts/adr/assets三子目录,穷举零豁免)。包含面收窄.claude/arch/**/*.md→.claude/arch/**/ARCH.md,顺带消灭 NS-COMMON-0002/0003 各一条字面路径排除(改名即失效的脆弱点,现由身份锚点天然隔离)。防回流三处 prose 同步(x-feature-dev SKILL ARCH-SYNC 硬步 / x-architect agent 身份定义 / 本文档 §十四),否则下次 ARCH-SYNC 照旧写回 frontmatter。验证闭环:从 git HEAD 原文重演 P1+P2 逐字节比对 9/9 域全过(frontmatter/正文/261 条日志三重校验)+ 三条新闸反向注入逐条实证咬合(野文件→0006、移走 CHANGELOG→0004、写回 version-log→0005 臂A、日志加 srcHash→0005 臂B)+ 还原后零残渣 +-t6 规则自测全过 +-v元规范 30 条全过 + specHash 同步 33f91f60。顺带根治:coupon/mobile 两文件混合行尾(P2 重组时字面\n混入 CRLF 文件产生 7 行 LF),arch 树行尾统一为 LF(与 git 存储态一致)。诚实边界:分离闸适用面 = 域文档,_index.md/_context-map.md元文件非域不受管辖(体量 10KB 级,动机不成立);order/dispatch正文存在时点快照陈旧标记,其当前设计结论仍可能只记载在 CHANGELOG 条目里,已在各域 CHANGELOG 头部按实测标记数逐域显式警示,正文回填是独立欠债- v1.24.x
改动统一之前的版本没有改动清单
业务架构治理层:arch/ 域目录化(
{域}.md→{归类层…}/{域}/ARCH.md,9 域全量)。动机=一个 bounded context 会产出多份异质文档(设计正文/版本日志/分支架构/ADR/可视化产物),单文件承载不下;身份锚点=含ARCH.md的目录为域目录、不含者为归类层(同构 x-clientpages/↔index.js范式)。本次为纯位移:文档内容逐字节零变更(10/10 md5 与迁移前一致),检测器包含面.claude/arch/**/*.md天然兼容子目录故零 spec 改动、零新增闸;全仓 98 处路径引用同步(含 arch 域间互引 42 处、plan 看板 13 处、x-data/x-test/hook/skill 注释 20 余处),_index.md注册表 9 行改指{域}/ARCH.md,_index.md/_context-map.md留 arch 根不动。因两处散文指针落在 spec 文件内(x-mirror/x-order),经/x-meta-dev sync重算 specHash(33384080→1f1934ad / 97af270a→fa344057)。验证闭环:x-arch 三条与迁移前基线逐条一致(0001/0002 通过、0003 仍 4 处同域存量债)+ 反向注入双测(伪造注册表路径→0001 咬;删sourceOfTruth→0002 在新路径咬,证非扫不到的假绿)+ 还原后逐字节复原可证 + 全量 92 项 90 通过(2 失败=x-arch 存量 srcHash + x-styles 6 处 token,均零交集本次改动)+ 编译 11587 文件全过 + 两 canary 全绿- v1.23.x
改动统一之前的版本没有改动清单
规范能力层:「按声明方驱动」的闸补上归属完备性(ADR-29)。病根=
x-marker NS-COMMON-0001遍历 spec 文档反查标记,隐含前提「标记能被归属」——形态不可解析 / 所指 spec 不存在这两类标记连检测目标都没有,比漏报更深一层;注入x-ghostspec实证两条规则同时放行的双绿假象。机制=新增NS-COMMON-0002双臂归属闸(臂1 形态可解析 / 臂2 spec 真实存在),扫描面从 spec 文档翻转到业务代码(归属不了就没有声明方,责任落代码侧)。同批清三处系统性错误因果:①x-marker 三件套 prose「只认四种、MULTILINE 一律不判」方向相反(实为六种且 MULTILINE 在判,照它删标记会解除豁免)+ 假声明「本规范自身不入扫描面」(实测在面内),6 处漂移全订正 ②x-apiNS-ADMIN-0002把codeOnly 抹 MULTILINE当豁免机制写进三处 prose,实测 51/51 零处依赖(豁免全来自外层 depth>=1),而该视图制造双重不可见盲区(五 spec 之外 STANDARD + MULTILINE),改用codeKeepMultiline③orphan-marker-cleaner全文 0 处process.exit,未尽事项仍退 0(实测它报"待删 0/EXIT=0"而同批文件里有 4 处它看不见的畸形标记),改为非零退出。否决 sys/ 404 行同形态标记清理(危害不成立:sys 是 NS-DEV-0007 禁改 + L4 isProtectedArea 拦截区,"虚假安全感"三条件全不成立;代价 202 云函数重部署;且 L1.5 领域独占已使其天然在射程外)。验证:深度测试 28/28(含 8 项不适用路径零误伤)、建牙即红双臂、视图订正硬实证(同代码 codeOnly 判 0 / codeKeepMultiline 判 1)、L4 环1 活体拦截、cleaner 退出码双向。收录 ADR-29- v1.22.x
改动统一之前的版本没有改动清单
强制层:环2.5 事后测量记账落地(ADR-28)。病根=Bash 通道写业务源三环全盲(环1 词法判据实测 38 条逃 27、13 个写工具全逃;环2 无 file_path 进不了白名单;环3 队列空即 pass;部署门 isPending 恒 false)。机制=
guard/worktree-probe.js用git status --porcelain -uall与上轮快照取 mtime 差集入队,Stop(refresh:true)+ MCP 部署门(refresh:false)双消费,自指产物区排除。环1 同步诚实降级为「防手滑」(不再补写工具名单)。同批 part2 侧:x-stylesNS-ADMIN-0008className 类契约双臂(存在性 + 禁动态拼全局类名)+NS-ADMIN-0001硬编码白名单改真相源现场派生。验证:探针 8/8、guard 端到端 12/12、双臂反向注入精确 FIRE。收录 ADR-28- v1.21.x
改动统一之前的版本没有改动清单
强制层:L4 部署门增设资损域回归床臂(D-aa/D-ac 收口)。病根=资损域行为不变量的验证是一次性事件(先「跑完即删」后「建完不跑」——实测三既有床 140 用例全部无自动执行点)。机制=runner 原子(
x-test/run-deploy-gate.js,fail-closed)+ sidecar 注册表(x-test/deploy-gate.json,函数名→床映射)+ 双消费点(x-deploy-dev VALIDATE 门3 + guard.js MCP 门,用户开闸后同日双通道齐,活体三形态验证)。同批:新床 refund-order-update 32 用例(锁配对/业务终态/设计钉三类断言)+ reconcile T6 补 5 用例齐 16 锁出口 + x-api NS-SERVER-0146 锁出口配对静态臂(双层验拦实证:同一注入牙与床同时抓住)。机制归框架、数据归业务,守「框架不依赖业务」铁律。收录 ADR-27- v1.20.x
改动统一之前的版本没有改动清单
规范能力层:L3 引入第二种规范形态——注册表驱动的矩阵框架 + 元闸族。病根=三位一体默认形态「一条规则一个内嵌 detector」在多维度重复表达时产生同构缺陷(维度↔判据被二次硬编码进 detector),实测同一缺陷连犯 5 次、五次修法相同(放宽正则)、五次都没碰病根。决策=把维度抽出为 sidecar 注册表(第四类真相源),闸只认 schema ⇒ 加一维度 = 加一行声明、闸零改动;配套元闸族三条(注册表自洽 / 闸实现纯净 / schema↔闸双向一致)。同批根治两处结构缺口:①某轴无关闸漏登记名册 ⇒ 逃出纯净闸射程且该方向零检测(反向臂以名册为迭代源)——已补登;②两条定义面闸行首锚定 ⇒ 单行规则块内声明不可见(实测 18 个定义位),改为声明起始位置锚定 + 字符串等长抹除,反向探针 8/8。两个被实测否决的方案留档:❶为根外 token 单独建纳管闸(增量模式下机检收益 0,只制造返工不产生不变量,正解=随各维度回填逐个收编)❷按字面为闸间共享副本建对拍闸(同语料复刻实跑 84.3% 假红且对真实漂移全部漏报,已立案待判据改写)。收录 ADR-26
- v1.19.x
改动统一之前的版本没有改动清单
规范能力/强制层:三位一体在「删除方向」上的缺口闭合。病根:治理流程只有「新增/修改」没有「删除」——x-styles 重构删 59 条规则时只改 spec、未清业务码 X-RULE 标记,遗留 116 处孤儿标记/29 文件/2 spec(x-styles 3 组 + x-file 1 组),而
-m/-v全绿(既有机制无一读业务码比对 spec:x-standard NS-COMMON-0025 只做 spec 内部汇总行↔正文双向、reverse-coverage 只查 rule 引用)。三处根治:①新建 x-marker 三件套(NS-COMMON-0001 业务码禁留孤儿标记;扫描面=spec 文档、业务码为数据源,与 x-arch srcHash 同构,责任落声明方;索引经 context 全局 var 跨调用复用实测 29 目标只建 1 次;排除 sys//templates/ 实测提速 7.9x;诚实边界三条:只认六种可靠形态(2026-08-12 ADR-29 订正原"四种"表述)、规则 ID 跨 spec 重号 137/271 故宁漏勿误、元规范自身走 -v 自检)②orphan-marker-cleaner(x-meta-dev core;五条安全设计:实时校验规则确不存在/只删标记独占整行/BEGIN-END 必须成对/默认 dry-run/--skip 跳并行会话;覆盖宪法原则9 四种注释格式含 JSX{/* */})③x-meta-rule 补场景D 删除规则(七步含「清理业务码标记」核心步 + 验零)。为何不挂 x-standard:-v用的就是它的全部规则而 Stop 每次改 rule 都跑-v,实测挂上后 560ms→1.5-2.8s 慢 2.6-5 倍;独立 spec 只在-m全量与改 spec 时触发=恰好孤儿产生时机。为何不改 guard 开例外(否决「选项A」):违反宪法§二 part1 绝不依赖 part2 铁律(guard 放行判决将首次依赖业务 spec 内容)+ 规则 ID 跨 spec 重号致判据 100%失效 + 攻击面从封闭集变开放集。清理实测 100 处/26 文件(16 处他会话在途按§6.6 保留),tsc 全量 exit=0、x-mirror 字节等值未破、x-styles/x-file 回归 0 违规;深度测试 18/18 + 反向注入验拦;收录 ADR-25- v1.17.x
改动统一之前的版本没有改动清单
规范能力:「updatedAt 被当业务时钟」backlog 闭合,结论=不需改。追加核实推翻两个候选方案:
order_item_node全库 12 处写入(ORM 0)逐条核 WHERE → 无一处在 refunding 态改行而保持该态(命中 refunding 的 5 处全是转出;order-settle 改四费的 IN 不含 refunding),故「无关操作重置计时」物理不存在,updatedAt语义本就正确。加专用列=重复造轮子(order_status_log 已记录);改查台账 MAX(createdAt)=引入更坏失败模式(CAS 与台账无跨表事务,崩溃即永久漏扫,探针 P2-C 实证)。正解=保留 updatedAt + 新增 x-order NS-SERVER-0007「refunding 态原子性锁」(WHERE 命中 refunding 则 SET 必须含 itemStatus=,只许转出),把巧合焊成物理闸。该牙正向恒 0,有效性只能靠反向注入:四发全中(IN 混入→FIRE / ='refunding'→FIRE / 确实转出→放行 / 子查询内 refunding 顶层不含→放行,括号深度感知防误判)。方法论:正向扫不出违规的不变量守卫牙,必须同时注入「应 FIRE」与「应放行」两类才能证明不是恒绿。x-order specHash → 9ef7237c;pay-common 亦已部署(线上 sha256 byte-identical,14 环境变量保留,0139 三胞胎分歧收敛);ADR-23 诚实边界③改写改动统一之前的版本没有改动清单
规范能力/治理拓扑:平台写路径能力边界必须实证;L1 全局排除禁用于含业务写入的目录。活体=退款链 10 分钟宽限窗物理塌成 0(生产实证 dispatch_base 6/6 行 updatedAt==createdAt 而 3 行 supersededAt 非空);根因=平台 7 系统字段只在 ORM 写路径维护、裸 $runSQL 完全不介入,而状态机域 63 条裸 UPDATE 无一自补。否决迁 ORM(25 轮并发 CAS 对照:ORM 11/25 守卫穿透 vs 裸 SQL 0/25,两跳非原子;涉及 6 表全被 5 分钟定时器+会重推的支付回调并发写,无自动进程对手的裸写=0 条)。按动词拆清真相:增 94:1、删 40:0、改 53:63 → 真实边界是主数据 CRUD vs 状态机跃迁,非 read/write。canonical 修法
updatedAt = ROUND(UNIX_TIMESTAMP(NOW(3))*1000)(参数绑定形态表间行为不一致故统一禁用,7 表实证)。治理拓扑变更:wechatpay 从 L1 迁 L1.5(原全局排除致 7 条钱域裸 UPDATE 物理隐身 + NS-SERVER-0139 声明其路径却成死规则),代价=17 文件登记真空清单 + 六处结构类规范显式排除。新增 x-api NS-SERVER-0142 三臂(反向注入 3/3 FIRE);-m 首扫 56/63 揪出 glob 死角(驼峰 orderService.js)。63→0 violations,全量 84/86(余 2 为他会话在途),verify-harness 128/128,编译 11274 文件全过;收录 ADR-23- v1.13.x
改动统一之前的版本没有改动清单
规范能力:移动端类(client 类:x-client+x-technician+未来端)检测统一根治——18 spec 中 12 只扫 x-client 致师傅端 258 文件裸奔(5 假绿 + x-structure 假阳),census 分类不可靠经 opus 重审修正。三引擎机制(CLIENT_CLASS_ENDS 名册单源,加端一行自动覆盖):①opt-in
{mobile}/令牌(spec.js expandMobileClassCoverage,显式非 blanket——裸 x-client/ 保持单端=安全,杜绝 blanket 的假阳(x-structure ENOTDIR)与假绿(Class B 静默放行))②scanConfig 目录模式按端类展开(extractScanConfigByTerminal 把 CLIENT directory config 派生 TECHNICIAN,root 端根 swap;x-structure 类目录枚举覆盖)③tools.mobileEnds 注入(non-standard-checker,detector 端分治去硬编码,禁 vm 沙盒 require 名册)。6 Class A 令牌化 + 6 Class B detector 端根派生/tools.mobileEnds 去硬编码(x-exception 跨端键集比对循环重构 + x-i18n 16 处异构 LOCALES map 派生 + x-api 修 tools-not-defined 签名坑),canonical 基准端(x-mirror BASELINE/MIRRORS + x-exception REGISTRY_CJS)显式// [canonical-baseline]标记豁免(禁隐式兜底)。抓获 3 真架构 bug(tools 签名/跨端参照非端根/scanConfig 目录模式)。防复发金丝雀x-test/mobile-endclass-canary.test.js5/5(扫全 spec detector 体零 load-bearing 端硬编码 + 三引擎机制 + 名册覆盖)。全量 85/86(唯他会话 x-arch §6.6),6 Class B 师傅端 100%(tools20/api106/styles160/exception112/i18n174目录/structure52目录);真文件探针 + 全量逐步闭环,throwaway 探针零残留。经用户开闸实施(引擎脊柱),完成须关闸;收录 ADR-20- v1.12.x
改动统一之前的版本没有改动清单
强制层:L4 端类写保护单一真相源根治——guard 两处硬编码正则(guard.js:90 isBiz + command-policy.js:130 isBizSource)漏 x-technician 致活生产端 X-RULE 标记写时裸奔,改派生自 terminals.TERMINAL_DIRS(command-policy 唯一派生点 require + escRe + BIZ_DIR_RE + isBizDir 内部 normPath;guard.js 消费 isBizDir),hooks 端类硬编码归零,新增端登记一处即自动保护。opus 对抗自审真探针实证(../../ require 成功 2.8ms/派生等价/x-merchant 模拟)+ 自揪瑕疵B(fpl vs normPath 不一致→内部归一)。补 D3 金丝雀
x-test/terminal-registry-canary.test.js(terminals⟺channel-config 两根真相源 + isBizDir 覆盖全终端)。spawn 真实 guard.js 10 活体+3 反向验真全闭环,临时探针零残留。经用户开闸实施(脊柱),完成须关闸;收录 ADR-19- v1.11.x
改动统一之前的版本没有改动清单
威胁模型:云端配置盲区 = 第三类真相源(引擎射程外),立「云端真相不受治」边界声明。活体:admin 迁子路径删根目录 → wowoway.cn 404,根因 HTTP 网关反代路由(StaticStorePrefix)只在云端、代码库零记录、引擎不可见。opus4.8 五路审计+对抗官逼假绿裁决 deploy 四件套不能宣布闭环:①本会话真假牙 NS-ADMIN-0004/0005 改名旁路(对抗官注入实测 0 违规)已修(缺函数即违规,反向验真咬合)②spec「精确断言/禁弱代理」与 no-op 恒真闸矛盾 = 原则1 谎言已诚实降级(检测边界章:保证 canonical 结构在场,不验控制流/运行时 MCP 调用)③SKILL.md 四处附属表漂移已同步;L4 运行时零牙实证(mcp-policy.js:129 只 gate 不读 cloudPath / command-policy 无 tcb)。治理方案(backlog·需授权):云端配置金丝雀(MCP 拉线上网关/托管配置 ⟺ 代码库期望值机器比对)。诚实裁决:结构骨架诚实但「运行时防错误部署+云端配置漂移」两类实质保护是架构固有天花板,写死边界不得粉饰;收录 ADR-18
- v1.10.x
改动统一之前的版本没有改动清单
规范能力/强制层:检测器↔分发器极性错配 = 一类系统性假绿,立「极性同构 + 分区完备性金丝雀」通用范式。活体:x-mobile-dev(黑名单极性)与 x-mirror-spec(白名单枚举)错配 → 基包 54% 文件零牙、5 个真漂移只咬 1 个而牙报"0 violations"。三处根治:①L1.5 co-owner 语义扩展(DOMAIN_SCOPED_DIRS owner 单值→数组,locales/xType/xStyles 各 +x-mirror-spec;判据=轴正交性,横向端轴 ⊥ 纵向内容轴)②x-mirror-spec V2.0.0 极性反转(端根全包 − 56 条封闭排除集;specHash da8219eb)③分区完备性金丝雀(verify-mobile:manifest 五类分区 ⟺ spec 排除表,模式集+逐文件双向等价,漏登记 fail-loud)+ 新增 END_DIVERGENT 端自留地分区(xStatic:目录架构一致、图片各端自换,sync 永不覆写)。反向实测全咬(co-owner 三片 3/3 + 幽灵抓获 + 排除面零误报 + 金丝雀双重炸响);mobile.md v0.4.0;收录 ADR-17
- v1.9.x
改动统一之前的版本没有改动清单
工作流/治理拓扑:arch 收尾执行器终裁——x-feature-dev v1.1.0 生命周期四→五阶段(PLAN 读 arch 域文档 + ARCH-SYNC 收尾硬步 spawn x-architect,跳过禁入 DEPLOY);Stop per-turn 锚注入否决(对抗审查 F1 闸位错/F2 咬错会话/F3 橡皮图章/F4 通道投毒,机制可行性 P1b exit1 已实证但架构三重错);§十四 srcHash 牙 Stage2→已落地修正(活体抓获 customer/dispatch/coupon 真漂移)+ x-arch 三件套三处真相源矛盾修复(specHash e205b972)+ customer.md v0.2.0 示范闭环;deploy VALIDATE arch 反查注入预注册 backlog;收录 ADR-16
- v1.8.x
改动统一之前的版本没有改动清单
勘误(route-surgery.js as-built 硬化):v3 as-built 对抗揪 3🔴(R1 定位 fail-open 前缀扇出/R2 嵌套组名漏报致孤儿键/R3 scan deleteScope 契约假声明——真值域无 leaf)+6🟠,v4 修法验证后 v-final 全实施——R1 ABORT_PREFIX_HIT+逐行 component 精确提取/R2 嵌套组名并入 deletedGroups/R3 映射诚实化(SKILL 映射表+advisory 声明)/F15 空占位子组拒删/S1-S4/F11 verify timeout/F13 TOCTOU 拒覆盖他会话/S5 --delete-empty-group;32/32 测试;+订正 plugins/menu-sync.ts:9 第三处 header 谎言。修法不改威胁模型/闸门/工作流(纯实现勘误),故 PATCH 非 MINOR;ADR 行序未重排(11/12/13 属他会话行,§6.6 不碰)
改动统一之前的版本没有改动清单
工作流/威胁模型:ADR-14 两 FUTURE 项终裁落地——①建 route-surgery.js + verify-route.js(闭"删除动词在 admin 物理不能闭环"断裂:Edit 删 routes.ts 标记块被环1 拦、原 SKILL「routes 走 Edit」死文档;四牙链自检含 vm 装载牙抓 tsc 假绿形态/三态 fail-closed/组塌缩镜像 NS-ADMIN-0011/原子写;即时自检剔除 -m x-auth 防中间态误报;x-module-del 流程2 步序反转=手术最先 rmSync 最后;38/38 沙箱测试+真 detector 验证)+订正两处 header 半谎言 ②blob-OID 从 DEFERRED 降 WONT-DO 三段式(同信任域自证循环=任何威胁模型下都错;升级条款预注册=服务端 branch protection+CODEOWNERS,防错误锚);§八 更新 + 收录 ADR-15
- v1.7.x
改动统一之前的版本没有改动清单
强制层/威胁模型:乙++ node-fs 写洞根治层——撤回方案甲(git-Stop 破 §6.6 实证:131 脏含 ~124 他会话)/否决方案丙,选"分治+每洞有 owner":①
execute-delete.jsfail-closed 部分删除态报告 ②部署 VALIDATE 从-m x-deploy扩--changed内容门(排除 sys/,补 node 写绕部署门真洞)③删 guard.js/command-policy.js/verify-harness.js/check.js 共 7 处退役层谎言(.githooks/git pre-commit/manifest 谎称活闸,含用户可见 BLOCK 文案;保留诚实"已退役"声明)④诚实声明唯一权威=用户审 commit(避撞死命令原则6);三不可消解残余(win32 无 LSM/删除原子性/自检脚本 AI 可改),blob-OID DEFERRED;§二/§八 更新 + 收录 ADR-14- v1.6.x
改动统一之前的版本没有改动清单
强制层:L4 guard 环1 X-RULE 标记防篡改精化——marker 正则
[A-Z0-9-]→\S+捕获完整标记堵 swap/改名盲区(防篡改只增不减)+ x-logging 整块删窄口例外(日志纯诊断可删,Stop-cycle 兜底);12/12 活体测试;收录 ADR-13- v1.5.x
改动统一之前的版本没有改动清单
治理拓扑:澄清跨域 REFERENCE 探针合法性(ApiResult 信封 = 三 spec 按字段分治共享契约,探他 spec 契约域语义是合法 REFERENCE 非越界,物理 EMBED 仅单文件共址),否决 ServerSystemError 新类(红队四路证伪),落地 NS-SERVER-0006(server 禁裸 throw new Error·区域感知豁免·零内容排除表)+ Seam E(admin dev 消息泄露 tier-gate);收录 ADR-12
- v1.4.x
改动统一之前的版本没有改动清单
勘误/coherence:调和 §六(skill-bridge)↔§十五(agent 执行者)声明四端两条正交编排路径并存;配合宪法 §四消解"内部机制留到 L2 决定"过时占位(agent 已建)+ §二补受治工件类存在性声明;agent 成熟度复盘 punch-list 修复(terminator execute-delete.js/architect Bash/client searchKnowledgeBase/deploy manageHosting)
改动统一之前的版本没有改动清单
治理拓扑:新增 agent 执行工件类(第四类受治文件)+ x-agent 三件套设计(NS-1 薄 agent 承重 + NS-2 死指针/NS-3 第三方登记/NS-4 覆盖认领/NS-5 model 白名单;否决逐依赖指纹/coordinator/--domain=agent;供应链非实时诚实边界);§十五 + ADR-11
- v1.3.x
改动统一之前的版本没有改动清单
威胁模型:新增「并发会话」隔离铁律(多 AI 会话并行,非本会话引入的 rule/spec/hook/arch 变更属他会话在途,禁互相干涉/代修复,非本会话域保鲜牙告警静默跳过);宪法 §六.6 + §二威胁模型「并发会话」行 + ADR-10
- v1.2.x
改动统一之前的版本没有改动清单
治理拓扑:新增业务架构层 arch/ + x-arch 三件套(存在性闸 + 文档头完整性闸,含 I2 specRefs 句法代理),三层文档分类补全(§十四),NS-COMMON-0004 扩域覆盖 arch/;收录 ADR-09;srcHash 四端保鲜牙 + 框架禁依赖业务闸 defer Stage 2
- v1.1.x
改动统一之前的版本没有改动清单
治理拓扑:新增真相源引用完整性闸(x-governance NS-COMMON-0004 禁引 plan 方向闸),根治宪法/rule→plan 死链(全量唯一残留失败清除);收录 ADR-08
- v1.0.x
改动统一之前的版本没有改动清单
初版:基于乙案(hook-only)定型态,收录 ADR-01~07,确立文档定位/更新纪律/四链路审计基线
文首变更摘要存档(v2.0.0 外迁 · 2026-09-14)
以下为
harness-engineering.md文首第 4 行在 v1.53.0 时的原文,逐字原样搬运、零改写。v2.0.0 起文首只写当前版本号,变更史只住本文件的版本表。定稿日期:2026-07-03(乙案 hook-only 定型态);末次架构性变更 2026-09-13(拆包复盘收口 R25–R39:L4 Stop 环新增「包源物化同步」判据——改动集命中母本包源即 spawn 装配器
--verify --end all(1.2s),不一致即拦;病根是 x-mirror 指纹牙锚在包 package.json、--changed <包源文件>结构性带不出它,忘物化=开发者工具跑旧代码而闸全绿;两条装配判据的引擎名册改懒加载(无引擎工作区不再每轮 infra-failure)。x-structure 取得 arch 面:.claude/rules/x-structure-arch.html(第二个生成式架构文档,生成器x-meta-dev/scripts/sysarch/st-*.js,55 条 ARCH 条款逐条指名 45 条闸 + 12 条外域闸,六条生成期硬断言——零床规则数改为棘轮而非拒生成)。孵化器按包声明自动派生分包subpackages;师傅端按需注入与客户端对称;.gitignore落点收敛为裸目录行;mobile ARCH 保鲜面补kits/**;详 §十 v1.53.0 + ADR-46;前次 2026-09-12(「什么该成包」成规范(N7):x-structure-rule 新增「何时该成包」判断守则(三类该成/三类不该成 + 「谁来判」分工表)、新增 NS-MOBILE-0023(同域包对的单元归属,零新增包的内聚修复)、只读报告x-test/mobile-package-affinity-report.js;同批立 ADR-43——「当下只有一个消费者」是事实不是设计意图,内聚判据必须锚在【声明的结构关系】上而非【当下的引用统计】(草案按统计判命中 5 处、3 处误伤,含把内核公共能力判成应搬进业务包,而 x-layer 层序判据挡不住);N5(端内业务模块升格为包)因与权限路径前缀推断结构性冲突且无收益,由用户裁定取消;详 §十 v1.49.0 + ADR-43;前次 2026-09-12(拆包治理面补齐五条闸:x-route NS-MOBILE-0010(跨分包同步 require 禁令)/0011(resolveAlias 目标可解析)、x-mirror NS-COMMON-0005(落点必须被 .gitignore 覆盖)/0006(packOptions file 条目必须有对应源)、x-structure NS-MOBILE-0022(包声明字段闭集 + private 严格 true);同批立ADR-42两条建闸纪律——面向「产物」的判据一律反查到它的源(产物在 fresh clone / 未装配机器上必不存在,产物侧判据 = 假红制造机),「零引用」不得判成「死声明」(孵化端预置声明会集体假红,假阳性直接废牙);详 §十 v1.48.0 + ADR-42;前次 2026-09-12(母本包源模块寻址长出通用牙 NS-MOBILE-0021(包源require只许包内相对或 bare 到本包已声明依赖),同批立建闸纪律 ADR-41:规则的「适用文件」必须与所在 spec 的scanMode同构——目录模式 spec 里的文件级 glob 因filterFilesByDirModeRoots剔除而射程恒空,且-t/-v/判据床可以全绿,-m只留一行「不适用」;故新闸锚到该模式扫得到的目标(此处为包根package.json)由 detector 自 walk,并强制每条新闸的床带射程断言(引擎目标集含预期锚点 + detector 覆盖 ≡ 应覆盖全集);详 §十 v1.47.0 + ADR-41;前次 2026-09-12(母本包容器分层与射程原语根治:L5x-core/mobile/domains/*按各包已声明的x-layer拆为kits/(系统工具包)与biz/(业务包),domains/过渡容器退役,容器与层自此严格一一对应;前置 N4c——容器名原在五处各自硬编码(检测引擎MOBILE_PKG_CONTAINERS/ 装配器 / admin 包读取器 / x-structure NS-MOBILE-0016 / x-backend NS-COMMON-0001),先收敛成各自唯一常量表并加「闭集外藏包即 fail-loud」(原对未知容器静默跳过),两个射程形态(静态 glob + fs 自发现)改由常量派生,再搬目录;NS-MOBILE-0016 同批补容器闭集判红(N4a)、四闸床 38→46 例;详 §十 v1.46.0 + ADR-40);前次 2026-09-09(闸射程回归根治:拆包与零副本终态双重致盲下三条闸对新家结构性失明,x-api NS-SERVER-0143 臂2 可达域 / x-marker NS-COMMON-0001 索引根 / NS-COMMON-0002 适用面 全部改经引擎原语,L1.5 DOMAIN_SCOPED_DIRS.sys 加 co-owner x-marker-spec;x-deploy NS-MOBILE-0002 扩第七阶段 BEDS 三条判据;内核 0.3.2 + --stamp,详 §十 v1.45.0 + ADR-39;前次 2026-09-07(拆包 S17b 镜像体系退役:x-mirror 旧端↔端镜像牙删除、CANONICAL_CLIENT_END指针与 sync-mobile 退役、目录模式 scanConfig 改{mobile-end}令牌逐端展开、x-client 与 x-technician 对称为「消费母本包的端实例」,详 §九 / §十 v1.44.0 + ADR-38;前次 2026-09-07(拆包 Wave 3 收尾·治理面射程闭合:引擎「包 ⇒ 消费端集」原语resolveMobilePackages/tools.mobileEndsOf+{mobile-src}令牌 + 目录模式基根自检,详 §十 v1.43.0);前次 2026-09-06(拆包 S0.2b 治理面前置·规范半边:L3 x-backend 闭合形态收进母本包骨架(core | domains/<kebab>)/{package.json, src/**}+ 0002 锚扩母本包(独立 HIDDEN_PKG 表 + miniprogram 实存校验);x-mirror 新增 NS-COMMON-0002 内容指纹牙(包源 ⇔ 各端 miniprogram_npm 落点逐字节,「IGNORED_DIRS ≠ 免疫」首个活体);x-surface 0002 端根派生改源根优先;x-marker 0002 射程改令牌形态;宪法 rule paths 收 x-core/**;agent 写域切分,详 §九 / §十 + ADR-37;同日稍早 拆包 S0.2a 治理面前置:L3 引擎{mobile}令牌射程扩到母本包源根(第二半)+ 新增{mobile-end}端根限定令牌 +tools.mobileSrcRoots注入 + 编译面 x-core 补 wxss/wxml;L4 guard 新谓词 isGeneratedArtifact(miniprogram_npm / dist/web / .cache/web-src 三通道只读);L1 rule paths 改由 spec 机械派生(meta sync --paths + validate 1b 集合相等),26 本规则书当日归一;闭包解析唯一实现收口 x-core/tools/mobile.js,详 §三 / §十;同日稍早 L5 移动端系统层母本取得包身份@wowoway/core(x-core/mobile/core,路径保形逐单元迁入),装配器 x-core/tools/mobile.js 长出 weapp 腿(物化 / 校验 / 引用闭包)与 web 腿包源直入 staging,消费边界按 backend 分档定案(server 与 mobile-weapp 物化消费、admin 与 mobile-web 本机构建器解析),详 §三 / §十 + ADR-36;同日稍早 L3 母本闭集扩五维:x-surface +值形态 schemes / 组件实例 API 两表两闸,x-backend +resolver 接入闸 / capabilities 覆盖声明闸;L5 web backend 补 resolver / transport / capabilities 三兑现点,H5 云函数调用定型走 admin 同一条 HTTP 网关,server 内核策略表名册派生 web-{端} 来源,详 §九 + ADR-35;前次 2026-09-05 L5 移动端 backend 层立:四件套母本 × 三 backend,H5 = glass-easel 自建 backend 住 x-core/mobile + 装配器 x-core/tools/mobile.js;L3 新增 x-surface 与 x-backend 两本纯 NS 规范锁母本侧与 backend 侧,详 §九 + ADR-34;前次 2026-09-03 L3 视觉原语治理归属定案:留在 x-styles + 伴生注册表 + 三颗新闸,详 §七;再前次 2026-09-02 L3 引擎新增 CSS 声明解析原子 + detector 工具包契约单一真相源;再前次 2026-08-21 L3 引擎「规则没跑成」由静默改 fail-loud;前次 2026-08-13 本文档自身日志载体分离:§十一 ADR 全表 + §变更历史全表外迁harness/,正文降 70.5%——「正文只存最新态、历史外置」原则自本文档起对 part1 生效)
改过本单元的需求
- agent架构立层已发布把四类架构升成五类:新增 agent 架构(设计页、版本单元、治理站点第五栏),主控改由「X大脑」执行体启动,执行体名册与文件一一对应
- agent架构二期已发布把 agent 架构从「立了层」做到「真能派活」:名册对表、新增项目经理、派工硬化、设计页与五处真相源按真实机制改口
- 清理归档已发布清理归档:流水线在部署之后多一个「清理归档」环节 —— 已完结的计划不再删,由一条命令整份搬进计划目录下按日期分的归档目录;同一条命令清掉这条需求留下的过程文件…
- 测试卫生在办让测试床只能经运行器跑、只在自己的副本和临时目录里读写:直接 node 跑一张床会自动转经运行器跑(进度、记账、领名额照旧;此刻业务端那 43 张床在名单里免检…
- 床隔离已发布测试少跑重复的第一条「床隔离」:把真往仓里种探针、写夹具的 14 张测试床和起 PowerShell 的 1 张,改成在沙箱(系统临时目录或床自己的假仓)里做;…
- 床并行与床账已发布让测试同时跑起来、重复的不再跑:运行器缺省按本机的 CPU 与内存开池同时跑,副本里跑过的结果能带回真仓,守卫那张最大的测试拆开同时跑,改坏对照按点跑、按指纹记…
- 测试调度一在办跑测试只有一个入口,它把要跑的床拆成小片、分到常驻的副本里同时跑,看着机器余量放行,一片跑完就记账、打进度,没过的下次只跑没过的;超时只抓卡死、被掐的记没判出不…
- 规矩固化一已发布把你定的做事规矩一次写进说明书(宪法、架构详图、技能说明、每份执行体定义),压缩上下文或重开会话都不会丢,再加一张核这些字在场的测试床;顺手改正项目经理定义与 …
- 规矩固化二在办让会话能自己清主控线目录里没人用的旧文件(不再叫你删),把「记忆里的规矩有没有落点」「被拦过的会话不再叫醒」「放行被拒时别自己绕」做成机器闸,再加一个只读的「列…
- 检测提速·并发已发布检测提速第二步,也是最后一步:测试床在安全的前提下分道并发跑(缺省照旧一张接一张,开 --jobs 才并发;会动真仓的床照旧独占;红绝不改绿)、选床认法对拍纠偏…
- 检测提速·减负已发布检测提速的第一步:去掉每轮收尾检查与开发、发布、体系守护三条流水线里的重复劳动,给两张最慢的测试床减负,顺手修两处框架小毛病(收尾单认遗留与清理归档、架构详图讲…
- 完结不误报已发布完结不误报:一条需求验收完结之后,它交付的那些文件只要内容没再变,就不再被任何会话的收尾检查与三查算成「范围外的改动」—— 现在封版命令写出的文件(变更历史、锁…
- Codex分担已完结型号配置可以按会话角色单独设一行(走哪条路、哪个型号、哪个推理档、快速型号、上下文宽度),型号是 gpt 的经本机代理走 Codex,代理地址一句话能改:会话命…
- 发布只查原料已发布发布只查原料:关着闸发静态站点时,部署门的待检清单只数这次要发的那个站点的原料目录,不再被仓里与它无关的改动拦住;回滚与清理旧文件不看仓库状态;治理站点发布准备…
- 少重签已发布签字只锁五样:需求那一句话、要你亲手验的清单(哪几条、每条验什么)、动钱与动权限与身份与改已发布表字段类型或删功能三个自报、流程(业务、Harness、规范认成…
- 流程立法已发布按落点分五条流程立法:宪法第三节「两把尺子」改成自上而下五层,第四节「五类需求,一条流水线」改成五条流程(Harness、规范、业务三条主流程,运维、分析两条辅…
- 守卫判错与补闸已发布把 10-13 到 10-14 真撞过的守卫判错与缺口一次收掉:履历不剥落点里的计划路径、开闸期间的删除没人认领、发布登记不认 agent 架构、派发闸靠名册里…
- 守卫读地图已发布让守卫读工作区地图:守卫与检测引擎余下的按路径判断、五份名册和元规范里一处,从各自抄的名单与正则改成读同一张地图,只换读法、答案逐条不变;地图读不到时要用它的判…
- 守卫提速已发布回填守卫提速与补洞:照守卫盘点定下的方案改守卫与检测引擎,让守卫只在该起时起、同一件事只留一份判法、补上查出的洞,每一处改前改后用测试对拍 动不动钱:不动 内容编号…
- 需求闭环已发布回填harness 需求闭环 动不动钱:不动 内容编号 6df0(签字一签的是 6df0)
- 需求闭环收尾已发布回填需求闭环收尾:把需求闭环计划洞清单里还没写进架构详图的四条洞固化进去 动不动钱:不动 内容编号 ec93(签字一签的是 ec93)
- 托管限流已发布托管限流:静态站点发布的备份改由发布脚本自己完成,仍经 MCP 的托管调用写明不撞限流的做法,根因记进部署的架构页与条款书
- 车道上机已发布车道上机:签「确认」那一刻守卫按落点认出流程、按七个风险标记算出最低档,写低了签不上,认出的车道记进签字;改判定代码的需求同一时刻只办一条;签字题与立项命令照车…
- 账本加锁在办让几个会话共用的账本不再互相盖掉、不再写断:跑床账、需求账、原话账各加一把锁,整份重写的先写临时文件再改名(遇文件被占就退让重试),判开工条件和记那一笔放进同一…
- 主控立规已发布主控立规:把「一个主控会话守顶层、每条需求线交给一个工作会话、具体的活交给 agent」这套运作方式写进宪法、架构详图与项目架构设计页。这是这条线的第一条,只立…
- 型号配置已发布各角色的型号与推理档改由一份配置文件决定(主控类、执行类各一对),只有你对 X大脑 说固定话才能改,改完新起的会话与新派的执行体即生效、不立需求不升版不封版;并…
- 新运作已发布让除了你开的 X大脑(首席产品官)窗口之外的会话都由系统自己发起、你只在 agent view 里看,项目经理、运维经理、产品架构师和 Harness架构师做成…
- 入口路标已发布入口路标:让全新的会话只凭体系里写着的东西,就知道一条需求怎么开 —— 项目架构设计页加一节「怎么开一条需求」(计划怎么建、按改的是什么找谁干、只做分析的事怎么…
- 流水线提速已发布流水线提速:把一条需求从签字到归档之间的机器节点串成一条命令,删掉重复的重建、重跑、重签,收尾单由机器起草,签字能合并,登记行指向整棵草稿目录的一律拒绝,项目架…
- 流程减负在办审查类的活(签字前的减法审与预审、独立复盘、过程复盘、体系体检)交给复盘经理改名的「审查经理」(用时起、用完关,走 Codex),审查按需求的档与波及面由机器分…
- 项目架构已发布项目架构:把「需求 → 实现 → 部署」这条流水线立成第四类架构 —— 一页设计(流水线状态机、五道硬门与各门的射程边界,版本单元,升版封版)、三道门补硬控(签…
- 发布查全站已发布发布查全站:把「发布后把整站查一遍」做进发布工具现成的两步 —— 发布准备时在本机把每张页面写死的引用逐条核一遍,新文件传完、换首页之前把每个文件在每个访问入口…
- 发布提速已发布让发布不再白等:发布前测试开池同时跑(用「床并行与床账」量定的整机预算,部署门入口的函数床照旧一张接一张);备份之后发布档案的 assets 目录只留这一次新增…
- 登记册锁已发布让会话登记册的锁,拿锁撞到「文件被系统暂时占着」这类暂时错误时,像写登记册改名那一步一样等一等再试,到时限仍不行才失败并如实说原因;并让守这把锁的测试每次都咬得…
- 发布修补已发布回填发布修补:治理站点首次全量发布暴露的三处 —— 守卫误拦发布档案里的备份落点、部署门永远拦着已结束会话的改动、六个业务域页面链到目录成了死链 动不动钱:不动 内…
- 复盘经理已发布每个专项验收完结之后,由新设的「复盘经理」把这一程的过程复盘一遍(补上 PDCA 的 A):机器先出耗时表和红旗,复盘经理按这条专项的档写结论与发现,发现先过一…
- 复盘提速已发布复盘提速:把一轮独立复盘从一个多小时压到十来分钟,而且收得住 —— 复盘任务说明改成只对着签过字的标准逐条判过不过(标准之外的发现记成遗留)、只看上一次复盘之后…
- 脚本去重已发布脚本去重:把流水线里重复执行、重叠执行的几处去掉(第一批,不碰守卫与检测引擎)—— 测试运行器能只补跑不新鲜的床、带筛选时不再全仓扫卫生;体系守护自测那张床同一…
- 脚本读地图在办让技能脚本改问工作区地图:运行器、计划与三查脚本、元治理、统一开发、数据端、模块下线、发布与移动端装配的脚本,把各自抄的「这个路径是什么」的名单和判断,凡地图能…
- 项目自带已发布项目自带,不往项目外放:一,每条需求在项目里有自己的施工区文件夹 x-test/zz-work/<需求名>/,工作会话的副本、对照、探针、备份、过程记录只放这里…
- 会话型号已发布会话命令按角色给型号 —— Harness架构师、产品架构师起成 Opus 5.5,项目经理、运维经理、产品经理起成 Sonnet 5.5,推理档一律最高,起完…
- 签字区标改动已发布签字区标改动:需求看板的签字区在内容改过、要重签时,只把改过的条目标出来(底色、竖条、标签、改动片段高亮、一键只看改动),没改的原样,顶部一条横幅写清改了几条;…
- 签字带高保真已发布改界面的需求,你点过头的高保真进签字档 —— 签字页签最上面直接嵌着、一屏看完,附单独打开的链接与内容指纹,由对着它的标准锁住;每份计划「设计」页签最顶上写场景…
- 签字题带地址已发布签字题带地址:弹签字题或验收题之前,守卫先核题目正文里写着这条需求看板的完整路径与「签字」页签、看板签字区是最新的,缺一样这道题就弹不出来;用户在对话框里自己打…
- 代签到底已发布代签到底 —— 签字一之后,验收(照代签设置亲签或代签)、发布、归档、按项目名提交(打项目标签、推到 GitHub)、结案报告全程不再等你;验收一签同时授权这条…
- 入口页模板已发布入口页模板:治理站点的四个架构入口页(业务、系统、框架、项目)长成同一个模板 —— 把入口页立成模板(侧栏、标语 hero、概念插图、全景卡片、内容节,共用一份…
- 日志拆分已发布把记录分成「状态」(机器要读、只写现在)与「日志」(只供将来复查)两类,在工作区地图里给每个记录路径标明;日志不进判定代码的判断、不进说明书、平时不加载进上下文…
- 定档排队主控签已发布定档、排队、只在主控签字:每条需求签字时按它定的档(小事、成条的事、难事)核条数上限,超了签不上;同一个版本单元上已有别的需求占着就签不上,谁占着、谁排着一条命…
- 顶层收尾小修已发布顶层最后一条收尾:履历与复盘说明的时刻按本机时间写并标时区;探针误删真仓时收尾先提示并给出核对放回的办法;立项命令给项目架构与 agent 架构单元自动带设计页…
- 联调与发布门已发布给开发期联调上线一个机器认得的口径,让正式发布核「已验收完结」,让发布登记对得上完结时的那一版
- 真相源拉通已发布真相源拉通:把 10-11 六路审计查出的 22 处真相源矛盾、15 处执行体与技能说明过期、4 块无人认领的写域、业务工作流与需求闭环没接上的几处一次改口拉通…
- 看得见记得住已发布看得见、记得住:守卫每拦一次留一笔账;用户每说一句话,守卫列出每条在办的需求谁在办、走到哪、被拦几次、欠下几条;完结那一刻把用时与返工、欠下的事与复盘者的遗留写…
- 工作树一在办让每条需求在自己的官方工作树里施工、主干永远只收验收过的:会话在主仓起、握手后进自己的树,计划跟着分支走;守卫认树根,改动落在哪棵树就归哪条需求,控制面命令一律…
- 清理归档硬控已发布清理归档硬控:仓库外面建的临时目录由守卫自动记进在办需求的登记文件,不靠办理会话自己记;清理归档对登记的每一行逐项核,有一行没着落就不搬;仓里有已完结还没清理归…
- 收尾与站点格已发布收尾与历史发布:一条需求验收完结之后有一份固定五栏的收尾单(做成了什么、没做什么、遗留与去向、要发的格与此刻状态、链接),放在计划目录里随计划归档,清理归档的命…
- 收尾不挡下一条已发布让一条专项验收完结、该发的格发完之后当场归档、提交,下一条随即开工:接力命令归档之前只问机器当场答得出的事(没人拿着跑床和建站的锁),复盘经理的复盘、复杂化审查…
- 地图立起来已发布工作区地基的第 1 步「地图立起来(引擎这一侧)」:在新目录 .claude/hooks/workspace/ 立起全仓「这个路径是什么、归谁、能不能动、算不算…