这一页是什么
- 它是什么
- 这套体系自上而下五层架构里的一层(宪法第三节):业务架构答「做什么、为什么做」,系统架构答「按什么规范写」,项目架构答「怎么一步步做成」,agent 架构答「谁来做」,Harness架构答「凭什么保证做对」。本页写把一条需求从提出做到上线的那条流水线本身:有哪几个阶段、每道关口谁守、证据在哪、守不到什么。
- 版本单元
project:overview:锚是本页,版本写在页头的 version 标记里,变更历史与锁清单在同目录。需求履历住同目录的requirements/下,是封存记录,不进锁清单。- 分工
- 本页只写当前这一版:这条线是什么、关口在哪、证据在哪、守不到什么。每道关口的机制(判法、时限、字段、命令的细节)只写在架构详图,本页一句指向;改过什么、为什么改,只写在变更历史与决策记录。
一、流水线:
一条需求的状态机
一条需求从提出走到上线、收拾干净、提交进库,再接回下一条,是一个环:签字一可以提前签好几份,开得了工就当场开工、开不了就排队,开了工才动受治文件;实施之后到开出验收区之间的机器节点由一条接力命令串起来,只在派复盘那一处停一次。已完结是验收签过字(用户本人签,或照代签设置由 X大脑 代签;这一签同时授权这条需求的发布与提交),已发布(终点)是该发的格都由运维经理发了 —— 两段分开,都要走完。
图 1 宏观闭环:实线是每条需求都走的内环,虚线是只在流程本身要改时走的外圈;琥珀色的两格里各有一步要你点头(签字一只能你本人签;签字二你本人签,或照代签设置由 X大脑 代签,这一签同时授权发布与提交)。版本更新在第 ⑤ 格。第 ① 格里 X大脑 定流程与档、项目经理起产品经理会话,架构师出设计、产品经理写计划。内环是九格:排队、开工并在第 ③ 格,提交、结案报告并在第 ⑧ 格。
五条流程与十五条车道
走哪条流程由落点(落点表里的版本单元)定、不由人选(宪法第四节)。Harness、规范、业务三条主流程走本页这一条线(本节的环、第二节的六个阶段),差别只在落点、入口、谁动手、往哪发;运维、分析两条辅助流程不立需求、不进这条线,一改仓里的文件就回到主流程。每条流程分三档,流程 × 档是一条车道,共十五条;每条车道是什么、走哪几步、跑哪些床、复盘几轮、谁来做,见架构详图 §十五「先分级、再选路」的车道表。
- Harness 流程
- 管什么:宪法、框架的机制(检测、守卫、工作流)、项目架构、agent 架构,以及五层怎么写、怎么管
三档:小事(只改文字)、成条的事(改机制,落点里有写保护文件)、难事(改判定口径与流程本身)
走不走这条线:走 —— 每一档都要签字一、封版、独立复盘、三查、验收签字 - 规范流程
- 管什么:一份系统规范(设计、条款、判据与守着它的床);动到检测引擎的并进 Harness 流程
三档:小事(只改条款文字)、成条的事(改判据)、难事(新建、删除、扩射程)
走不走这条线:走 - 业务流程
- 管什么:一个业务域的需求:数据表、云函数、后台、两个小程序端;官网也随这条(小事那一档)
三档:小事(只改展示)、成条的事(一个功能)、难事(动钱、权限、数据结构,含删功能、母本与内核)
走不走这条线:走 - 运维流程
- 管什么:不改仓、只动线上的部署与版本
三档:例行(发已验收完结的东西)、常规(线上数据修正、控制台配置、路由与证书)、紧急(回滚)
走不走这条线:不走 —— 不立需求;往线上放东西照旧要授权、只在运维经理的会话里做,部署门照旧核(阶段五) - 分析流程
- 管什么:只分析、不改任何东西;所有流程的入口,业务的新需求先在这里整理成需求清单
三档:快问、分析与体检、需求整理
走不走这条线:不走 —— 不签字、不封版,产出只落计划目录里的看板
今天靠什么:三条主流程签「确认」那一刻,机器按落点认流程、按七个风险标记算最低档,并按档核条数上限(阶段一);改判定代码的同一时刻只开工一条(阶段二);X大脑 定流程与档时先认车道,运维与分析两条认流程,靠纪律(架构详图 §十五)。
环的启动与收尾
启动:开工的那一刻(当场开工的就是签字一那一刻;需求履历仍在签字一那一刻建出)。收尾:已发布与已归档两样都成立的那一刻;提交排在收尾之后,账本记了「提交」那一笔,这一条占着的单元才放开。会话清空机器看不见,不入态。
十态表
一条需求此刻在哪一态、下一步该谁做,体系守护的 loop 动作一条命令查得到(只读;命令见第十节「一圈最少跑哪几条命令」)。下面只列十个态名;每一态怎样算到了、下一步该谁做什么,只写在架构详图 §十四 的十态表。
- 未立项
- 已立项
- 在办实施
- 已封版
- 复盘过
- 待验收
- 已完结
- 已发布
- 已归档
- 环收尾
已发布与已归档没有固定的先后(机器只要求已完结,先发还是先清由主控排),环收尾只在两样都成立之后出现。签了字一还在排队的需求算「已立项」,开了工才进「在办实施」,态名不增不减。两个终点别混:已发布是发布状态的终点,环收尾比它多要一样已归档。判每一态只读现成的账、不当场重算;签字作废、账本被直接改过不另立态,在打印里注明(判法见架构详图 §八「环的十态」)。
状态机
一条需求按次序走过八个环节、六个阶段,每个阶段结束处一道关口。状态机图讲关口与证据;此刻走到哪一态看上面的十态表,每一态下一步该谁做见架构详图 §十四。
状态机图:一条需求从提需求到清理归档依次经过的八个环节,与六个阶段的关口 —— 阶段一、三、四、五的关口夹在环节之间,阶段二的关口挂在「实现」那一格下面(实现中),阶段六的关口在「清理归档」之后、接到下一条需求的开工(虚线框);下半部分列每一步留下什么证据、三个「不」与开闸(签字一授权、实施中机器放行,手动开闸只在急救时用)。三个「不」里前两个有机器拦,「没有授权不许发布」里随验收的发布以验收那一签为授权:亲签的机器不核、是纪律,代签的机器核(阶段五)。
二、六个阶段与关口
每个阶段写六样:关口卡在哪、守卫在哪拦、证据记在哪、守不到之处、急救开闸期间在不在岗、守着它的床。每个阶段的小标题下先有一句「这一阶段做什么」,再有一张图(在闭环的哪一格、谁办、机器拦在哪、留下什么),六个阶段之前另有一张泳道图。判法与时限一律在架构详图 §八(需求对账、收尾环、部署门)与 §十三(版本契约)。
图 2 泳道:青色是机器接力的节点,琥珀色是要你点头的,蓝色是 X大脑 与常驻的几位(项目经理、两位架构师)。签字一只能你来;签字二按代签设置由你或 X大脑 来,这一签同时授权发布与提交,设成代签时你只出现一次。图上设计一格:业务的需求归产品架构师,Harness 与规范的需求归 Harness架构师。
阶段一 需求与设计:签「确认」
这一阶段做什么:需求探讨、立项,由架构师出设计、产品经理写成计划。签字一可以提前签好几份,开得了工当场开工,开不了排队。
图 3 阶段一 需求与设计:这一阶段管闭环的第 1、2 两格;X大脑 定流程与档、项目经理起产品经理会话、架构师出设计、产品经理写计划、X大脑 弹题、你签字一、守卫记签字;机器拦在签字之前的整段、弹题之前与记签字那一刻;留下需求账本里签字那一笔与建出的在办履历。设计一格业务的需求归产品架构师,Harness 与规范的需求归 Harness架构师。
- 卡在哪:用户对需求、范围与要他亲手验的清单签字之前,不许写受治文件,命令行只放只读闭集;签了字、开了工,才按办理会话放行(阶段二)。签「确认」那一刻有三样让这一笔签不上:业务混着 Harness 或规范流程;写的档低于七个风险标记算出的最低档;条数超了这一档的上限。另有三样不拒签、改记成排队,见下「开得了工就开,开不了就排队」。
- 签字锁什么、不锁什么:你签「确认」签的是需求,不是整份计划。签字只锁五样:需求那一句话;要你亲手验的清单(哪几条、每条验什么、一共几条);动不动钱、动不动权限与身份、改不改已发布表的字段类型或删不删功能这三个自报;档;流程(业务、Harness、规范,机器按落点表认,签字那一笔记下、之后每次都拿此刻认出的去比)。这五样里任何一样改了,签字作废,请你重签;「验收谁签」这一栏也随签字一锁住,放宽要你重签、收紧走核准(第十节「验收谁签与代签」)。其余的细化 —— 标准的措辞与条数、自动用例的一切、亲手验用例的「在哪看、怎么验」、同一流程之内加或换的版本单元、落点表里的目录与格 —— 叫过程,签字之后改了不再让你重签,叫「待核准」。
谁核准:X大脑 跑核准命令记一笔,机器核三件事:它是会话登记册里此刻登记的主控(认不出时,是你最近一笔签字所在的会话);它不是当时办这条需求的会话(含改派接手的);它不是自那一刻以来写过这份机器镜像的任何会话,而且镜像此刻的内容查得到写证据。核准那一刻机器重判,碰到五样就拒绝,另有四道拦悄悄改松(哪条需求没有标准对着了、用例对着的标准不存在、自动用例或点名的测试变少、加业务域单元;后两样要显式带开关,并在清单里标红、独立复盘必须作答)。核准不是签字 —— 它不替你签任何一次,签字一仍只有你本人签。
范围:签字时的目录和单元,加核准过的;没核准的目录里的改动算范围外。
验收时你看得到:三查结果单、复盘说明和验收区各有一节「签字之后的过程改动」,每一笔核准写着谁核准(标明是不是你签字时说话的会话,接任的主控也标「不是」)、几点、改了什么(旧到新)、新增覆盖多少个受治文件,节顶上写累计;有核准记录的需求,验收清单最后多一个必勾项「签字之后的过程改动我看过、认可」,没勾就是不过;核准一笔,已有的复盘作废、要再复盘。
仍请你重签的三种情形:一是没有核准路的需求(办理会话就是签字会话,或核准者自己写过机器镜像、写者查不到 —— 没有「另一个会话」可以核准),签字之后的过程改动当作实质,签字作废,重签时一并带进;二是核准时发现新增了风险标记、档的下限升高,账本记一笔「需重签」标记,签字随即作废,重签之后同一份清单照常核准;三是把「验收谁签」从亲签放宽成代签。流程变了(落点表认成另一条、混成一条)同样是签字作废,不走核准。判法见架构详图 §八「需求对账」里的「签字只锁五样、过程由主控核准」,取舍在决策记录 ADR-111、ADR-129。 - 守卫在哪拦:用户说话那一刻认签字、记账(机器送进会话的固定句不记、不认作签字,句子后面多一个字就照常记;登记了主控之后,签字只认 X大脑 的窗口里说的,见第十节「验收谁签与代签」);写前拦截查本会话是不是某条在办需求的办理会话。记签字那一刻另核:看板与机器镜像一字不差、落点单元是版本契约认得的单元或 none、短名不与已有的履历重名。
认车道:先核两道 —— 按落点表认流程(不归任何版本单元的看目录),业务混着 Harness 或规范的签不上,回话说怎么拆;看签字那一刻落点表里的目录(加用例点名的测试)按七个风险标记算最低档,写低了签不上,回话点名中了哪几个。认出的车道记进签字那一笔、不进内容编号;「动权限与身份」「改已发布字段或删功能」两栏为真时进签字锁住的内容。写保护、判决依据、判定代码三份名单只写在守卫一处常量里。
定档与上限:机器镜像里写着档(没写按小事),守卫核四个数(数字见图 4 与第十节「先分级」)。超了不记签字,回话点名超的是哪一项,出路是拆,或换成放得下的最小一档;签过字之后改档,签字作废。
开得了工就开,开不了就排队:签字那一刻判三样开工条件 —— 它要占的单元(签字时的目录加核准过的)上没有开了工没完结的需求,也没有完结了记着要提交、还没提交的;它碰到判定代码时没有别的开了工没完结的需求也碰着;仓里没有已完结、计划还留在计划目录的需求(阶段六)。都成立,当场开工,账本里就是一笔确认;有一样不成立,这一笔带「排队」的标,回话写明在等谁。
办理会话:签上的那一笔记下按哪一档核的,与办理会话 —— 机器镜像最后是哪个会话用编辑工具写成此刻这样的就认它;立项命令由产品经理在自己的会话里跑,所以从写第一笔计划起它就是办理会话,认不出就记成签字的会话,认错了跑改派命令(阶段二),不用重签。办理会话和签字的会话是同一个时,这条需求没有核准路(见上「签字锁什么、不锁什么」)。此后三查、封版前的对账、越界都按办理会话算,所以签字都在 X大脑 的窗口里签得成。
怎么签:看板签字区勾选、复制结论贴回;对话框里点固定写法的「全选执行:确认 〈名〉」;或在「其他」里自己打固定那句,后面跟的话记成他的意见。可以提前签好几份,几份(同一块的也行)确认可以一题多选,各记一笔、各核各的;验收题必须单选。需求确认区里摆着这条的「验收谁签」(代签的,验收、发布、提交都不再问你);落点里有受保护文件的,题里另写一句「签了就等于同意到时放行这些文件,不用你手动开闸」(第十节「开闸跟着签字走」)。签字一只能你本人签、从不代签。看起来是签字却没记上的,选项与说话两条路都当场回一句原因,收尾时再补说一次。
弹题之前:守卫先核 —— 只能由领队弹、单选(多选的确认题除外)、名字对得上恰好一份没完结的计划、正文写着看板的完整路径与「签字」页签、签字区是最新的那一道;任何选项题正文写了不带盘符的仓内相对路径也拦。判法见架构详图 §八「签字题带地址」「带话的签字」「认车道」「定档与上限」「同一块排队」「办理会话」「一题签几条、每道题都核地址」,取舍在决策记录 ADR-92、ADR-94、ADR-98、ADR-106、ADR-111、ADR-119。 - 证据记在哪:需求账本(本机,链式指纹、仓外镜像)里签字那一笔:内容编号、签字时整份计划的原文快照与过程的底(重签时逐条比对、核准时算旧到新用)、按哪一档核的、认出的车道与流程、办理会话是谁;带话的签字另记一栏意见。排队的这一笔带「排队」的标;开工另记一笔,带着开工基线。之后每一笔核准、每一笔「需重签」标记也记在这本账里。签字一那一刻建出在办的需求履历,每核准一笔履历跟着刷新。
- 守不到之处:「动权限与身份」「改已发布字段或删功能」两栏是写计划的人自报,机器不对着代码核(与「动钱」那一栏同一种边界);账本与仓外镜像一起删掉,机器只能当成从没签过;签字锁的是机器镜像,看板正文改字不作废签字;一键签不证明他打开过看板;弹题前只比现成的编号、不重算三查;名字加了引号、紧跟别的字的认不出是签字题,就不核地址。见第八节「认车道守不到的」「定档与上限守不到的」「排队与开工守不到的」「在主控签字守不到的」「签字之后的过程改动核准守不到的」「签字没记上守不到的」。
- 急救开闸期间:认签字、记账、认车道、定档、排队照常(记签字那一刻判,不靠写前拦截);「没签字不许写」与弹题之前那道核对挂在写前拦截上,不在岗。
- 守着它的床:
.claude/hooks/tests/requirements-signing.test.js、.claude/hooks/tests/requirements.test.js、.claude/hooks/tests/project-gates.test.js、.claude/hooks/tests/verify-harness.test.js、.claude/skills/x-harness-dev/tests/harness-dev.test.js(排队动作说的与签字那一刻的结论一致)、.claude/hooks/tests/stop-ring.test.js(签字没记上,收尾补说一次)、.claude/hooks/tests/session-phrases.test.js(固定句不记、不认作签字)、.claude/hooks/tests/delegated-signoff.test.js(签字记录只认两条路)、.claude/skills/x-harness-dev/tests/plan-new-ask.test.js(立项命令与签字题的打印)
阶段一的关口核的四个数与办的过程中只点名的两条线,三档各是多少:
图 4 三档对照:数字就是阶段一核的四个数加两条只点名的线(第十节「先分级」);三档各是什么样的事,见架构详图 §十五。
阶段二 实施与落地:只改签过的范围
这一阶段做什么:开了工的需求,由产品经理带执行体照签过的计划动手干活。
图 5 阶段二 实施与落地:这一阶段管闭环的第 3 格;产品经理派执行体写受治文件;机器拦在写前(两样)与这一轮收尾;留下会话台账里每次写入的写证据与每拦一次的留痕。守卫、检测引擎这类受保护文件另由写保护拦着,只对这条需求的办理会话放它签过的那几个(第十节「开闸跟着签字走」)。
- 卡在哪:仓里有在办(开了工)的需求,而写的会话不是任何一条在办或签字作废需求的办理会话(排队的不算在办);写的是顶层文件,而写的会话没办着那个顶层单元;写入落在范围之外(范围 = 签字时的目录加核准过的目录);写的是受保护文件(守卫、检测引擎等),而不是这条需求的办理会话在写它签过的受保护格。
- 守卫在哪拦:开工:开得了工的需求签字那一刻已经开了工(阶段一);排队的由项目经理(或主控)排到它时跑开工命令(见第十节),判的是签字那一刻同一组开工条件,都过才记开工那一笔、叫醒这条需求的产品经理。排队的需求不占单元、不放行写、不算在办;单元从开工占到提交完。判法见架构详图 §八「同一块排队」,取舍在决策记录 ADR-119。
写前按办理会话判:有在办需求时,写受治文件(编辑工具与命令行直写)与跑闭集之外的命令,只放某条在办或签字作废需求的办理会话;不是的拦下,回话点名正在办的几条各归哪个会话,出路是交给那个会话、跑改派命令接手,或另立一条需求。计划目录、账本目录、仓外文件不受此限;执行体按派它的会话算。
顶层围栏:要写的文件归整个框架、某个系统规范域、项目架构或 agent 架构这四类单元时(归不归只问版本契约的名册),写的会话必须办着落点表列有该单元的需求,否则写前拦下,点名这个单元此刻被谁占着。
改派:node .claude/skills/x-harness-dev/scripts/harness.js --action=handoff --plan=需求名 --take—— 跑它的会话成为办理会话,账本追加一笔,不重存机器镜像、不重签;改派作数到下一次签字为止;改派不改历史,范围里由办过这条需求的会话写的改动照旧算这条需求的。X大脑 或项目经理还可以用--to=完整会话号指名改派(账本记成指名);谁都能跑的--take账本里记成自助,照旧能把三查和写前拦截接过去,但不带走签字放行。
签字放行:守卫、检测引擎承牙这两类受保护文件对谁都拦,只有四样同时满足才放这条需求的办理会话写它签过的那几个,完结、归档、签字作废当场收回;写文件工具、命令行、换入帮手同一份。四样是什么、永不放行的是哪些,见第十节「开闸跟着签字走」。
范围:范围是签字时的目录加核准过的目录,签字之后新加、还没核准的目录里的改动算范围外;写后提示这一笔落在哪一格;收尾对账把本会话写的、不在本会话办理的需求范围里的改动拦一次,写进别的会话在办范围的点名一次、记账;无主的与别的会话的只列不拦。判法见架构详图 §八「写前按办理会话判」「顶层围栏」「办理会话改派」与写前拦截一节里的保护与放行,取舍在决策记录 ADR-94、ADR-98、ADR-101、ADR-116。 - 证据记在哪:会话台账:每次写入一笔写证据(归属按内容指纹、命令时间窗、无主三级判),三查第一查按它算范围里与范围外;守卫每拦一次也留一笔(几点、在哪一刻、拦在哪、为什么)。改派在需求账本里记一笔(指名与自助分开记);签字放行放过哪些受保护文件、实际写了哪些(从写证据取),记进需求履历。
- 守不到之处:没有写证据的改动(命令跑得久、丢后台、脚本末尾才写出)只列不挡;写前不判落点格 —— 办理会话写别的需求范围里的文件写前照放,只在写后提醒、收尾拦一次;改派不经用户,防的是认错人、不是防人;改派之后前任的范围外改动只靠前任自己收尾时点名。顶层围栏的缺口见第八节「顶层围栏守不到的」,签字放行的缺口见「签字放行与急救开闸守不到的」。
- 急救开闸期间:写前那一半不在岗(按办理会话判、顶层围栏与签字放行都在这一半里);写后记账与收尾照常,改派命令是脚本、照常。
- 守着它的床:
.claude/hooks/tests/requirements.test.js、.claude/hooks/tests/session-ledger.test.js、.claude/hooks/tests/stop-ring.test.js、.claude/hooks/tests/verify-harness.test.js(经守卫入口换一个会话号写顶层文件)、.claude/skills/x-harness-dev/tests/plan-handoff.test.js(改派前后围栏与三查按谁算)、.claude/hooks/tests/signed-gate.test.js(签字放行与各种拦)
阶段三 测试与验证:两个裁判都过
这一阶段做什么:检测和测试两个裁判把关。
图 6 阶段三 测试与验证:这一阶段管闭环的第 4 格;检测与测试两个裁判由机器跑,一起经过改完一批、一轮收尾、封版之前、发布当场四个点;机器拦在一轮收尾、执行体停下、封版之前与发布当场;留下按内容记账的测试记录与检测的干净结论。
- 卡在哪:两个裁判没过:检测读代码判「写得合不合规」,测试跑代码判「行为对不对」;改了判据或被测对象,旧结论作废。
- 守卫在哪拦:收尾硬拦(本会话改过的面,床要对当前内容全过);执行体停下那道关(它写过的文件检测有红就不让停,只查检测);封版的检测前置与测试前置;发布当场(阶段五)。接力命令的头两步就是「改完一批」那一处(阶段四)。机制在架构详图 §八「组队与执行体」与 §十六。
- 证据记在哪:按内容记账的测试记录(本机台账);检测的干净结论按文件、内容、判据指纹缓存。
- 守不到之处:判据与测试的射程之外(写进各域的测试设计与系统架构页);登记豁免的跳过不算通过、单独列出;收尾硬拦对四类面只提示不拦 —— 整面实测超过五分钟的重面业务面、只经上游牵动的规范面与业务面、一张床都没有的面、已经提交出工作区的改动。
- 急救开闸期间:写前不在岗;写后复判与收尾硬拦照常。
- 守着它的床:
.claude/hooks/tests/stop-ring.test.js、.claude/hooks/tests/test-faces.test.js、.claude/hooks/tests/team-gates.test.js
阶段四 复盘与验收:复盘过、签「验收完结」
这一阶段做什么:独立复盘,再验收 —— 你亲手验,或照代签设置由 X大脑 代验代签。
图 7 阶段四 复盘与验收:这一阶段管闭环的第 5、6 两格;产品经理跑接力命令、派复盘官,X大脑 弹验收题,你签字二或由 X大脑 代签;机器拦在封版、派复盘、开验收区、记完结与之后的删挪(上排两步用编号小牌对到下面的牌);留下变更历史记录行与锁清单、账本的复盘笔与完结笔、三查结果单与封死的履历。
- 卡在哪:封版、三查、独立复盘、验收签字四处;都过了才封存履历,之后才清理归档(第五节)。
- 守卫在哪拦:接力命令(体系守护的 run 动作)把实施之后到开出验收区的机器节点串起来:复盘结论入账之前七步 —— 增量检测、按改动跑床、规范同步、封版、固定检查、三查、生成复盘说明,停下等派复盘;入账之后再跑同一条,三步 —— 三查、开验收区、起草收尾单,末尾打印「可以弹验收题」;验收完结之后再跑同一条,也是三步 —— 刷新收尾单、预览清理归档、清理归档(第五节)。它只接力、不判:每一步调那一步自己的程序,红在哪一步就停在哪一步;不经它一条一条手跑,结果相同。
封版命令:检测零红、测试全过、日期是今天、一次只升一步;触及本单元的在办需求零越界、用例闭环、签字没作废;最上面那一版的「为了:〈短名〉」恰好解析到一条开了工、落点表列有本单元的需求。
三查(实施复盘 · 用例闭环 · 固化核对)由核对命令按办理会话算。复盘派发闸:只能派对抗审查官、提示词恰好是程序生成的派发表头(说明全文由审查官自己读)、连着三次不过要用户发话(产品经理停下手,由 X大脑 请用户到这个会话里说)。收尾时守卫再核表头并核它读全了说明。复盘结论绑签字锁住的内容、范围里的受治文件与签字之后的过程改动(核准记录和待核准清单,核准一笔复盘就作废);复盘只对着签过字的标准逐条判,标准之外的记成遗留 —— 例外是经主控核准的标准与用例的改动,逐条拿旧和新对着需求看,放松了的按没达标算,带红标的必须逐项作答。三查的第一查多认一样:签字之后的过程改动没经主控核准的,第一查红。登记了的固定检查没全过,第二查红。
验收签字:守卫当场重算三查(另起进程、有时限,赶不及就不记、回「机器忙,过一会儿再点」),全绿才记完结。签字记录只认两条路:用户的原话,或 X大脑 的代签命令(关口与用户签时同一套,验收区没有证据不签,见第十节「验收谁签与代签」),别的写法不算;履历里写明「X大脑 代签」。这一签同时授权这条需求的发布与提交。封存履历:记完结之前写全履历、产出指纹进账本。计划目录下的文件用命令删或挪一律拦,已完结的回话给出清理归档的命令。判法见架构详图 §八「接力命令」「复盘之后看板的状态列可以动」「项目架构与封存履历」与 §十三,取舍在决策记录 ADR-98。 - 证据记在哪:变更历史记录行与锁清单(含为了哪条需求);账本里的复盘笔(带复盘者写的遗留)与完结笔(带履历指纹;代签的那一笔另记签字人「X大脑 代签」、设置的指纹与验收区证据的指纹);落盘的三查结果单;封死的履历(含用时与返工、遗留两栏)。接力命令每一步的产物由各自的程序写出。
- 守不到之处:第二查不判改动实质,用户真没真验机器判不了,代签时 X大脑 验得对不对也判不了;复盘的预算没有闸;复盘者的遗留只认任务说明里写死的写法,写成别的样子记成没有;落点表列有本单元而签字作废的在办需求,会让任何会话都封不了这个单元,签字之后有没经主控核准的过程改动、办理会话又在本单元动过手的同样封不了;共享文件一变,已经过了的复盘作废,靠排次序;接力命令不排窗口、中途被打断不会自己续。见第八节「发现的留存」「计划删不了、挪不走只挡命令行」。
- 急救开闸期间:封版命令、三查、签字认定在岗(不靠写前拦截);复盘派发那一拦、计划目录下删与挪的那颗闸、验收题弹出之前那道核对挂在写前拦截上,不在岗 —— 复盘这一道只剩复盘者收尾时标可信不可信那一步。
- 守着它的床:
.claude/skills/x-meta-dev/tests/seal-command.test.js、.claude/skills/x-spec-checker/tests/engine/version-contract.test.js、.claude/hooks/tests/project-archive.test.js、.claude/hooks/tests/requirements.test.js、.claude/hooks/tests/team-gates.test.js、.claude/skills/x-harness-dev/tests/review-brief.test.js(任务说明)、.claude/skills/x-harness-dev/tests/plan-checks.test.js(固定检查)、.claude/skills/x-harness-dev/tests/requirement-check.test.js(三查)、.claude/skills/x-harness-dev/tests/plan-run.test.js(接力命令)、.claude/skills/x-harness-dev/tests/sign-delegate.test.js(代签命令)、.claude/hooks/tests/delegated-signoff.test.js(签字记录只认两条路)
阶段五 部署与上线:发布前的核对都过
这一阶段做什么:运维经理把改好的发上线。
图 8 阶段五 部署与上线:这一阶段管闭环的第 7 格;运维经理凭验收那一签的授权发布(你签的凭 X大脑 转来的验收原话,代签的凭代签记录),只读查、检查、构建、上传、登记;机器拦在只读查、发布前检查与上传三处,亲签的授权有没有、是哪个会话在发靠纪律、机器不核,代签那条路机器核;留下入库的发布台账(站点类发布一行)、履历的发布段与本机发布档案。图里「授权」那一行是授权的两条路,口径见第十节「谁来发布、授权怎么算」;BOSS 就是用户,X大脑 就是主控。
- 卡在哪:把东西推上线的那一下:云端写入(部署门)与发布脚本出口。
- 守卫在哪拦:部署门核待检改动、发布前版本比对、发布前测试(按被发布物推导测试床、当场真跑)与上传档案。先只读查:各发布入口正式跑的第一步,列出要发的原料目录里还没经收尾环复核的改动,有就当场停;站点发布里别的会话名下、内容没变、以前查过干净也没记过红的,先查时当场重查,过了就放行;上传那一刻守卫同样当场重查(跑不完按拦);发布命令的只读开关
--sources单查这一样。待检改动的射程:治理站点、官网、手机网页版只数原料目录,其余云端写入数全仓;回滚与清理旧文件只由上传档案闸把关。发布前版本比对是三条发布通道共用的一个函数:全部单元封着且一致,基线之后封的每一版带着为了哪条需求。联调:实现到一半要先往线上放东西才能接着联调的(建空表、导入并发布数据模型、部署云函数),叫开发期联调上线 —— 由运维经理在授权下做(用户本人的授权,或照代签设置由 X大脑 代授权),带着需求名;放行面是这条需求签过字的落点表(签字时的目录加主控核准过的目录,签字之后新加、还没核准的不算):要上线的函数与表落在落点表里才放,版本比对只放过这条需求签字时与核准过的单元的施工中;它记进这条需求履历发布段的「联调」一格,不算正式发布。没开联调的一律按正式发布判:要发的云函数或站点源码被某条在办需求的落点表盖住就拦(读整张落点表,还没核准的目录照拦),正式发布排在验收完结之后。代授权:代签的需求,发布授权由 X大脑 代给(开发中途的联调授权也可以),命令里显式带需求名和「代授权」标记,部署门和各条发布出口只核带标记的这条路:验收是代签、设置此刻仍允许、要发的内容指纹等于验收那一刻的,才放行;治理站点这一格按这条需求的履历里有没有「治理站点」一格认,别的站点按落点够不够得着原料目录认,判不了的按拦;联调另看这条需求在办、落点对得上;设置改回亲签之后同一笔被拦。判法见架构详图 §八「部署门认联调」与 §九「发布之前先只读查部署门」。 - 证据记在哪:入库的发布台账(站点类:时间、站点、发布号、提交);履历的发布段(只由发布登记追加);本机发布档案(不入库)。联调上线成功之后由机器自动记进「联调」一格,记不上的只说一次并给补记命令。
- 守不到之处:亲签的验收原话与用户的单次授权机器不核,也不核是哪个会话在发、转来的是不是验收原话、验收题正文写没写会发哪几格:这几样是纪律,别的会话跑发布脚本,拦它的只有发布前的检测、测试与版本比对;设置改成亲签关掉的只是代授权这条路,门并不强制用户在场。代授权那条路机器核的是代签记录、设置与内容指纹,核不了 X大脑 判得对不对;它发治理站点,上站的是此刻封过版的整棵受治树,别的需求封了版、还没验收的文档也会一起上站(亲签那条路一样)。急救开闸期间部署门写前不拦,写后补判、收尾报红,事后拦不回来。联调守不到的三样:① 用户有没有为这一次联调授权,机器不核 —— 与正式发布一样是纪律(代授权那条路核的是设置与代签记录);② 是哪个会话在发,机器不核 ——「只在运维经理的会话里做」是纪律,联调标记谁都开得了,兜着的只有收尾时点名一次;③ 机器认的联调只有云函数上传、建表、改数据模型三样,控制台里用户亲手做的导入与发布机器看不见、不自动记。
- 急救开闸期间:部署门写前那一半不在岗(发布脚本出口的比对在脚本里,开闸照样比);写后补判与收尾报红照常。
- 守着它的床:
.claude/hooks/tests/project-gates.test.js、.claude/hooks/tests/release-versions.test.js、.claude/hooks/tests/framework-lock.test.js、.claude/hooks/tests/assembly-face.test.js、.claude/hooks/tests/verify-harness-blk3.test.js(守卫主自测拆成的三块,blk3 到 blk5)、.claude/skills/x-deploy-dev/tests/deploy-gate-wiring.test.js、.claude/hooks/tests/hosting-scope.test.js(待检改动的射程)、.claude/hooks/tests/session-ledger.test.js、.claude/hooks/tests/gate-measure.test.js(先只读查与当场重查)、.claude/skills/x-deploy-dev/tests/deploy-release-pipeline.test.js、.claude/hooks/tests/trial-gate.test.js(联调)、.claude/hooks/tests/delegated-signoff.test.js(代授权那一支)、.claude/skills/x-harness-dev/tests/harness-dev.test.js(读本页阶段五「联调」那两段)
阶段六 收尾与归档:归档、提交之后下一条才能开工
这一阶段做什么:计划归档,过程文件清掉,按项目名提交进版本库,这位产品经理的会话关掉。
图 9 阶段六 收尾与归档:这一阶段管闭环的第 8、9 两格,并接回下一条的第 1 格;产品经理跑接力命令收尾归档,主控跑提交命令,项目经理转结案报告、关会话,下一条由 X大脑 定、项目经理排开工;机器拦在清理归档命令与下一条的开工;留下归档目录里的整份计划、账本里「提交」那一笔与版本库里的一个提交、一个项目标签。复盘、遗留与发现的去向在后台办,不挡归档、提交和下一条。
- 卡在哪:一条新的需求开工的那一下:仓里只要还有已完结、计划还留在计划目录的需求(不论哪个会话办的),它开不了工 —— 签字照记,这一笔记成排队;同一个单元上,前一条完结了记着要提交、还没提交的,下一条同样开不了工。
- 守卫在哪拦:用户说话那一刻,与阶段一的定档、开工条件同一处判:计划目录里有已完结的计划,新的需求就开不了工,回话点名是哪一条、带清理归档的命令;封版、发布、在办需求的写都不拦。
清理归档:验收完结之后产品经理再跑一次接力命令就接着做,做法见第五节。
提交:环收尾之后,项目经理请主控跑提交命令:验收与环收尾对得上、交付还是验收那一刻的内容,才把这一条验收过的那一份按项目名提交,打项目标签req/需求名,只推主干与这个标签、只许正常推,再记「提交」那一笔,单元到这一笔才放开。钥匙石与代签设置从不提交,有改动时点名,由你亲手提交;命令行里的 git 一律只读。推送被拒或断网,提交与标签留在本地,重跑补推。提交完项目经理拿结案报告转 X大脑再关会话,X大脑 原样转你。判法见架构详图 §八「清理归档硬控」「项目自带」「接力命令」「提交命令」,取舍在决策记录 ADR-97、ADR-106、ADR-112、ADR-118。 - 证据记在哪:账本里「提交」那一笔(提交号、标签、推没推成)与进库的提交、项目标签;结案报告从履历、发布段、收尾单与账本现拼,不另存。
- 守不到之处:只拦开工、不拦签字;一条已完结的需求没人做收尾与归档,会卡住后面所有新需求开工,出路是任何会话都可以替它起草收尾单、跑清理归档。提交与点名守不到的见第八节「环收尾到提交守不到的」,关会话的时点与清理归档的守不到见「什么时候关会话」「清理归档靠施工区与人跑」。
- 急救开闸期间:阶段六的关口是记签字与开工那一刻判的,照常在岗;副本提醒挂在写后,照常;施工区的隔离挂在写前拦截,不在岗;清理归档与提交的命令、运行器是脚本,照常。
- 守着它的床:
.claude/hooks/tests/requirements-signing.test.js(阶段六的关口)、.claude/hooks/tests/requirements.test.js、.claude/hooks/tests/project-gates.test.js、.claude/hooks/tests/verify-harness.test.js、.claude/skills/x-harness-dev/tests/plan-wrapup.test.js(逐行核、整份删施工区、运行器收尾自清、骨架、两把锁)、.claude/skills/x-harness-dev/tests/plan-run.test.js(完结之后接力命令收尾归档)、.claude/skills/x-harness-dev/tests/harness-dev.test.js(排队动作「卡在收尾与归档」一节)、.claude/skills/x-harness-dev/tests/plan-loop.test.js(十态的提交那一行、结案报告与后台收尾)
三、与四类架构怎么串
下面按架构一行一行列,右边依次是落点(阶段一、阶段二)、定版(阶段三、阶段四)、站点上怎么链。
- agent 架构
- 落点:单元
agent:overview,锁 agent 架构设计页与执行体文件;写它们要办着列有这个单元的需求,执行体目录另有写保护(落点里列着它的格由计划工具标「受保护」,签字一授权、到时放行);改到 x-agent 规范的判据或条款时另列spec:x-agent。
定版:这个单元升版封版、锁清单记需求;改一份执行体不带动整个 HARNESS。
站点上怎么链:需求页与 agent 架构的变更历史页互链。 - 业务架构
- 落点:落点表认领的格就是业务域的视图格,单元是
domain:中心/域。
定版:碰到的域升版封版,锁清单记下为了哪条需求。
站点上怎么链:需求页与域页互链;域的变更历史页尾列改过本域的需求。 - 系统架构
- 落点:单元
spec:规范名;判据是阶段三跑的东西。
定版:规范升版封版(经元治理流程刷派生区)、锁清单记需求。
站点上怎么链:需求页与规范页互链。 - Harness架构
- 落点:六道关口都是守卫与引擎在拦;单元
framework:harness。
定版:改了守卫、引擎、工作流的需求,整个 HARNESS 升版封版。
站点上怎么链:需求页与版本页互链。 - 项目架构(本页)
- 落点:本页自成单元
project:overview,履历不进锁。
定版:改了流水线或某一道关口,本页升版封版。
站点上怎么链:站点「项目架构」一栏先本页,再「待立项目」与「历史项目」两组(第四节)。
一条需求在各类架构上留下的痕迹由两样东西串起来:履历记它碰过的格与产生的版本,锁清单记每一版为了哪条需求。站点从这两样互相链回。
四、历史项目与待立项目
(封存记录与暂放清单)
流水线办完一条需求留下两样东西:一份需求履历,是它的封存记录,站点上列在「历史项目」那一组;一张待立项目清单,记已完结的项目留下、经主控决定放到后面的,或用户当场拍板放进来的事与理由。一件事任何时候只在一处:没处理的在待立项目里,处理掉了就跟着办它的那条需求进历史项目。
历史项目:需求履历
- 住哪:
.claude/arch/project/requirements/<需求名>/:RECORD.md(给人读)、record.json(机器读,封死后只核不改)、releases.json(发布段,只由发布登记追加)。 - 谁写:钩子一次写成:签字一那一刻建出「在办」(需求、范围、标准、用例、签字原话);验收完结三查全绿时写全并封死(复盘记录、结果单、碰到的格与产生的版本、签字一与验收完结的签字记录(用户的原话;代签的写明「X大脑 代签」),另有用时与返工、遗留两栏、签字放行一栏(放行过哪些受保护文件、实际写了哪些,有放行才有),和签字之后的过程改动一栏 —— 有核准才有,逐笔写核准者、时刻、改了什么旧到新)。生成时剥掉指向计划目录的路径。
- 怎样算封死:履历里有完结段,并且账本里有带同一产出指纹的完结笔或归档笔;缺那一笔按在办算,钩子可以重写。
- 谁守:目录进守卫脊柱保护(只有钩子进程内写);检测核封死履历的产出指纹;履历不进任何锁清单;签字建履历不算越界。
- 回填:有一批履历从账本、结果单、复盘简报与用户原话回填,缺的段标「回填」;它们变更历史里「为了」的写法不同,靠一张按单元与版本建键的别名表对回需求。
待立项目:暂放清单
- 它是什么:一张扁平清单,五栏:遗留与问题、来源、为什么现在不处理、打算什么时候处理、随哪次验收上来(用户当场拍板的写拍板那天);每条带序号,新加的默认排前面、用户改了排序的照用户的;不分组,还在办的需求欠下的不列。
- 三条规矩(用户定的):① 两种时候更新 —— 甲、项目验收完结那一次:加这条项目新留下、决定放到后面的,拿走它处理掉的;乙、用户当场拍板要加、要删、要改排序的:主控当场让项目经理照改,来源一栏写用户的原话与日期;② 甲那种要加、要拿走的几条,由主控在弹验收题之前定下、写进题目正文(代签的需求写进验收区),用户签了验收完结(或照代签设置由 X大脑 代签)才算数;乙那种以用户的原话为准;两种都随治理站点下一次发布上站;③ 立项、派工、排期在会话与总账里做,不上站。
- 谁写、住哪:项目经理写,写之前先拿到复杂化审查官的判断(立、并、不立、问你,只砍不必要的),住计划目录里主控总账的旁边;它不是受治文件、不是真相源,不归任何版本单元,改它不升版;甲那种放哪几条由主控定,乙那种照用户的原话。
- 站点上怎么出:构建器读它出「待立项目」那一页,只核形状(表头、序号连续、格不空、日期写法),不对就构建报错;它随站点公开,写的时候把真实的手机号、密钥遮掉。构建器怎么读、怎么核见治理站点规范。
五、终点与发布状态
一条需求碰到的「格」由它落点表里的单元推出,逐格记在履历的发布段里;该发的格全都翻了,才是已发布(终点)。
四条判法:① 数据表与微信原生包在体系之外发,固定记「在体系之外发」,不算进该发的格;② 发布当时的精确记法只给已完结的需求记「已发布」,在办的需求只把落在它签过字的落点表里的函数目录记进「联调」一格;③ 落点只有业务域、又没有哪一行业务域只改业务设计页的需求不带「治理站点」一格;只改业务设计页说的是业务域那一行的目录至少写了一条、而且条条都落在业务架构目录下(只改域的设计文档、变更历史与锁清单),这一行不按端推格,有一行这样的,需求就带上「治理站点」一格;一条目录都没写的业务域行照旧按端推;④ 一格该发的都没有的需求,验收完结就算已发布。十态判已发布与收尾单第四栏用的是同一份推法;每次跑发布登记都照履历里的落点表重推,已完结的需求不用重签。
- 业务域
- 推出哪些格:按它描述的端分格:后台、客户端网页版、师傅端网页版、微信原生包、云函数、数据表;只改业务设计页的那一行(目录至少写了一条、条条都落在业务架构目录下)不推端格,等「治理站点」那一格
怎么判:后台与两个网页版有入库台账,发布当时按锁清单精确记,事后按台账时间与封版日推;云函数没有入库台账,事后只能记「发布无记录」,发布当时由运维经理指明上传的函数目录才记得上;已完结的需求每次重算,把精确记下的版本与它完结时产的那一版比,不同就回「未发布」。 - 框架、规范、项目架构、agent 架构、业务总览
- 推出哪些格:一格「已生效」(版本契约的全部单元,业务域除外)
怎么判:落盘即生效,没有「发布」这一步;整条需求还要等「治理站点」那一格。 - 每一条需求,只有业务域落点、又没有哪一行只改业务设计页的除外
- 推出哪些格:一格「治理站点」
怎么判:它的履历与改到的受治文档要随治理站点重建、发布才上线。入库台账里最后一条治理站点上线记录的时刻晚于这条需求的完结时刻,才是已发布;两边换成同一个绝对时刻比。 - 官网源码(落点表碰到)
- 推出哪些格:一格「官网」
怎么判:官网不归任何单元,只能按台账时间推。
两种记法:发布当时 —— 运维经理发布之后立刻跑一次发布登记,按需求完结时产的那一版记(部署门已保证发的是封过版的那一份);事后 —— 发布登记按入库台账推。判法见架构详图 §八「收尾单与治理站点一格」,取舍在决策记录 ADR-100、ADR-108。
清理归档(验收完结之后的收拾)
清理归档是流水线末尾的一个环节:它不往账本记、不动封死的履历,只把这条需求用过的东西收拾掉,末尾重算一次发布段。阶段六的关口守着它:不做,新的需求开不了工。它与发布的先后由主控排:机器只要求已完结,业务各格先发再清,治理站点那一格可以攒着发,但发完才轮到提交,同一单元的下一条要等它提交完才能开工。
- 先有收尾单:计划目录里一份
WRAPUP.md,固定五栏 ——「一、做成了什么」「二、没做什么、为什么」「三、遗留与去向」「四、要发的格与此刻状态」「五、链接」。五栏都由机器起草:复盘结论入账之后接力命令起草一次,验收完结之后再跑同一条接力命令时刷新一次(只刷新机器管的几处,办理会话写了去向的照它的);第三栏每条遗留的去向默认写「后台办理中」:去向在归档之后办,不回头改收尾单;收尾单交主控把原文转给用户。认不到收尾单或缺栏,计划搬不走。 - 施工区与老计划的登记文件:副本、备份、探针只放这条需求自己的施工区(第十节「施工区放哪」),守卫不登记;搬之前先核施工区本身。老计划的登记文件
outside-dirs.txt(含归档里的)照旧:每一行要有着落 —— 已经不在、会清、或收尾单第二栏单独一行「- 保留:路径 —— 理由」,有一行没着落就不搬(阶段六)。 - 搬什么、清什么:计划整份搬进计划目录下的归档目录(按完结那天的日期、再按需求名),不删,归档进去的不再维护、也不是真相源;清掉账本目录里它的过程文件、施工区(整份删)、老计划登记过的仓外临时目录(写明保留的不删)与进程已经不在的测试临时目录。结果单的机器版、原话账本、仓外镜像与长期守着代码的测试不碰;账本本体与会话台账在提交之后挪进日志区、不删。
- 谁做、怎么做:验收完结之后产品经理在自己的会话里跑一次接力命令:它刷新收尾单、预览清理归档,没人在跑床或建站,就带执行开关真做;有人在跑的停在预览,等它跑完再跑;归档不了把原因原样说出来。复盘与遗留、发现的去向不挡归档,在归档之后的后台办,十态清单与结案报告里看得到。清理归档命令也可以手跑,谁跑结果都一样,手跑不看有没有人在跑床或建站:先核已完结、账本没被直接改过、履历已封死,再核收尾单、施工区与老计划的登记文件,缺一样就什么都不动;不带需求名只盘点,不带执行开关只预览;末尾重算这条需求的发布段并打印。
- 没做会怎样:阶段六的关口那一下是硬的(新的需求开不了工);另有提醒 —— 验收完结那句回话,用户每说一句话守卫对还没清理归档的已完结计划各说一行「【待清理归档】」,治理站点在完结之后还没发的合成一行「【待发布】」,已完结记着要提交、还没提交的点名「待提交」,提交没推成的点名「待补推」(从账本认,计划归档之后照样点名)。
守不到的见第八节「清理归档靠施工区与人跑」「收尾单与治理站点一格」两行;机制在架构详图 §八「清理归档」「清理归档硬控」「项目自带」「接力命令」,取舍在决策记录 ADR-95、ADR-97、ADR-106、ADR-112。
六、版本单元 project:overview
- 锚
- 本页
ARCH.html;缺变更历史或锁清单由契约报「缺」。 - 版本在哪
- 本页页头
<meta name="version">,与变更历史第一节同一个版本。 - 锁住什么
- 设计:本页;内容:无(设计页没有代码)。
requirements/**不进锁清单,否则每签一条需求单元就漂移。 - 基线
- 本单元的锁清单记着阶段五关口的基线:每个单元一个截止版本,每一版原样抄下去;阶段五的关口只核基线之后封的版本带没带「为了」(架构详图 §十三)。
- 封版命令
- 元治理的统一封版命令,与别的单元同一条;本页没有代码,守着六个阶段那几道关口的是框架的床(各阶段点名)。体系守护的自测读本页(样式形态、节名与阶段名、阶段五「联调」两段等),本页改了它要对改后的内容重跑。
- 升哪一位
- 流水线加减一个状态或环节、加减一个阶段或一道关口:升第一位;某一道关口新增硬控或射程变化,或新增一类东西:升第二位;只改说法:升第三位。
七、运营架构的入口
改 bug 也是一条需求,按落点走它的车道、从阶段一进来,流水线不用改;线上回滚走运维流程(第一节)。bug 怎么发现、怎么分级,不在本页。
八、诚实边界
下面每一条,冒号前面是守不到什么,后面是为什么、靠什么兜。各条的细目在架构详图 §八 同名几段的「守不到」。
- 本页与架构详图的分工:本页正文不写版本号与讲历史的话,体系守护的总自测核这一样;机制抄没抄、与详图一不一致,靠写的人与复盘者。
- 部署门核全仓,两臂口径不同:版本比对核仓里全部单元,不推这次的发布面;待检改动对治理站点、官网、手机网页版只数原料目录,原料目录之外的改动归版本比对守;三条发布通道里只有经 MCP 的那一条有待检清单。站点发布里别的会话名下的改动,只有内容没变、以前查过干净的才当场重查放行;从没查干净过的照旧要它的主人结束一轮或关窗口,重查跑不完一律按拦,后台与云函数照旧按全仓拦。机制在架构详图 §八「部署门」与 §九「发布准备的公开内容扫描」,取舍在 ADR-89、ADR-106。
- 官网、云函数、数据表与微信原生包:官网不归任何单元,发布状态只按台账时间推;云函数没有入库台账,事后只能记「发布无记录」;数据表与微信原生包在体系之外发,发没发机器不知道。
- 履历跨机器只剩自核与写保护:账本不进 git,随整个项目文件夹拷走;只靠 git 克隆的机器看不到它,只能核履历的产出指纹自洽;急救开闸期间在办的履历能被手改(完结时钩子重写);在办的履历是签字那一刻的快照,复盘次数要到完结、重签或核准一笔才刷新,用时与返工、遗留两栏只在完结那一刻写。
- 签过字、没完结、又不打算做的需求:开了工的,一直占着它列的版本单元,别的需求在这些单元上开不了工;没有「作废一条需求」这句话。靠什么兜:把它办到验收完结;主控排先后时先看排队动作里谁占着。
- 新建业务域的需求:签字时域还不存在,落点表写不了
domain:<新域>。做法:先用none认领那片目录签字,域建出来、封第一版之后把domain:<新域>加进落点表,由主控核准(加业务域单元要显式带单元名),不用重签;阶段一的关口不为此放松。 - 只做分析的事不能单独立成一条需求:落点表为空的计划签不了字;不是办理会话时,自己新写的脚本跑不了,新的怀疑要等修它的那条需求里先写测试复现。不为此放开命令白名单 —— 仓外的脚本能往仓里写任何东西。
- 顶层围栏守不到的:脚本进程内的写;急救开闸期间;不归任何单元的受治文件(钩子接线、守卫与技能目录下的测试、部署门登记表、治理站点源码、官网);还没出生的单元;删除;直写目标带变量、通配或反引号的命令行;办理会话认错时;围栏只问写的会话办着没办列有那个单元的需求 —— 谁起草的计划列了顶层单元、用户签了,谁就写得动(业务流程混着顶层单元的,签字那一刻的认流程会拦)。靠什么兜:用户签字时看见的范围;同一块排队;守卫、检测引擎、封版命令、执行体定义、锁清单与钩子接线另有写保护;三查结果单逐个列出改过的受治文件与谁写的。
- 暂停与恢复:没有「暂停」这个状态 —— 停线靠发现问题的会话自己停,它接着写,写前照放;谁叫的停、恢复没有,机器不认。靠什么兜:纪律;停下的需求没封版就发不出去,没验收就完结不了。
- 在主控签字守不到的:办理会话会认错 —— 用脚本写机器镜像的没有写证据,退回成签字的会话;别的会话后来改过机器镜像就认成它,认错了由该办的会话跑一次改派命令。连着三次复盘不过之后那一次发话,机器只认派复盘的那个会话里用户说过话:产品经理停下手,由 X大脑 请用户到那个会话里说一句,再接着派。X大脑 记签字的同一刻办理会话也往同一本账本落笔,会把链撞断。靠什么兜:签字回话里写着认成了谁,X大脑 拿它对产品经理握手时报的会话编号;X大脑 不写机器镜像;产品经理报完「请签字」就停手等回话。
- 签字之后的过程改动核准守不到的:机器认不出核准者是不是主控本人,只核三件事(是登记册里此刻登记的主控、不是当时办这条需求的会话、不是写过这份机器镜像的会话);办理会话就是签字会话的需求,或核准者自己写过机器镜像、写者查不到的,没有「另一个会话」可以核准,待核准的过程改动当作实质、要你重签 —— 主控自己写机器镜像再自己签,就是这一种;登记册认不出主控时,签字会话没了(会话清空重开)就没有核准路,要靠改一处锁住的内容逼出重签,机器不会自己发现;「需重签」标记只在有人跑核准命令时才落下,没人跑的话待核准让验收前的三查第一查报红,不会悄悄放过;等你重签期间别动待核准清单,动了的话标记会静默失效(标记绑的是清单);办理会话在自己的进程里冒用核准者的会话号去调记账口,读账本的一端看不出;写证据只在机器镜像此刻的内容查不到时才认得出脚本、拷贝、编辑器写的,夹在两笔有证据的写中间的认不出;新增的目录有多宽只列文件数、不判,还没建出来的目录机器认不出归哪个单元;老签字的底里有标准原文,但没有每条用例对着哪条标准,也没有落点表按格的行,这两样守不到;标准与用例的措辞放松了是不是把需求改松,机器判不了。靠什么兜:独立复盘的必查项(核准过的标准与用例的改动逐条看,放松了的按没达标算)、验收区逐条列旧到新和那个必勾项、你验收时看一眼有没有哪一笔不像过程而像在改需求;机器自己拦三道悄悄改松。
- 签字没记上守不到的:执行体弹的签字题,守卫说的原因只进那位执行体,领队靠它转述;三查要整读全部台账,台账越长,验收那一支越可能赶不上时限、回「机器忙,过一会儿再点」;收尾补说只往前看 24 小时。靠什么兜:签字题只由领队弹;收尾时补说一次。
- 认车道守不到的:「动权限与身份」「改已发布字段或删功能」两栏是自报,机器不对着代码核;签字时不核格里的目录归不归旁边那个单元,写计划的人能借单元名挑流程;落点写得太宽会多中标记(none 那一行写整棵 x-test 会盖住两个部署门入口,中「判决依据」、算碰到判定代码),要写到子目录那一级;三份名单只在守卫一处常量里,写漏了机器不知道;x-core 工具下的内核清单受写保护、碰它算难事,但不在判定代码名单里;X大脑 定车道、运维与分析两条认流程,与规范流程的影响面扫描、咬合证明、不留旧账三个环节,都靠纪律。靠什么兜:架构师审计划、X大脑 审落点表与两栏;业务域封版时版本契约照旧会挡。
- 定档与上限守不到的:条数挡不住单条标准写得宽;档由写计划的人填 —— 机器算出最低档、写低了签不上,写得比最低档高时该是哪一档机器不判,超了把档改大就签得上,难事前三样不封顶;用时与轮数只点名、不拦,办的时间是墙上时间,只扣等用户验收的那一段。上限的数字在守卫的常量表与图 4 两处,没有机器对拍,改数字要同批改。靠什么兜:X大脑 定档、架构师审计划。
- 排队与开工守不到的:开工的先后归项目经理排、主控拍板,机器只管同一单元同一时刻只开工一条、判定代码只办一条;开工命令按会话号认主控与项目经理,他们派出去的执行体同号也跑得了,最坏是先后排错;排队的计划排得越久越可能要重签,计划还合不合时宜机器不核;治理站点的项目页把排队的需求显示成「在办」。靠什么兜:先后由主控排;排队动作列占着的、排着的与此刻开得了工的。
- 单元占到提交完守不到的:前一条的发布卡住(比如后台要你亲手构建),同一单元的下一条就开不了工;不同单元的两条可以同时开工,但全仓发布要求全部单元都封着,先完结的要等另一条封了版才发得出去;开工、提交是账本的两个新写入者,判与记之间没有锁:同时追加可能断链(照拦),同时判同一个空着的单元可能同占(没有机器兜)。靠什么兜:主控排窗口时先看排队动作。
- 握手与节点回报:握手有没有回、派工带没带设计、到了节点报没报,没有机器核,第十节「八条规矩」里靠纪律的几条同样不核;消息发给停着的会话时发不出去、也不补发。机器看得见的只有账本里的签字、复盘、完结,落盘的三查结果单与会话台账里的拦截,用户每说一句话守卫把这些在「正在办」那一行列给当场的会话 —— 那一行读的是落盘的结果单,只在用户说话时出现,产品经理卡住了机器不提醒。靠什么兜:每个回报节点同时更新看板状态栏(看板才是落盘的状态),项目经理的巡检读各条需求看板的状态栏、超时没回报就叫人。
- 拦截留痕记不到的:只记经守卫出口的拦 —— 守卫启动失败、平台自己的禁止名单、钩子超时被掐掉的不记;封版拒封、签字没记成不在这本账里;台账写不进去时照拦、少一笔。被拦命令的开头原样留在本机会话台账里(不入库,保留三十天)。
- 环收尾到提交守不到的:机器只在每次回话里点名「待提交」「待补推」,不替人跑提交命令,靠主控与项目经理巡检;没有需求在办时,主控线与账本的改动不会自己进库,等下一条需求提交时随它带上;提交只认交付、履历与归档、台账三样进库,别的点名留在工作树里。靠什么兜:点名一直在,直到提交。
- 收尾环两处直接放行:被拦之后接着的那一次收尾,没有上一轮的红数可比时直接放行、连需求对账都不跑;继续的那一轮红项没减少也放行退出。
- 发布归谁与授权(亲签的授权是纪律,机器不核):往线上放东西只在运维经理的会话里做,每一次都要授权(口径见第十节「谁来发布、授权怎么算」);守卫不认哪个会话是运维经理,不核用户有没有授权、转来的是不是原话,发布脚本出口谁都跑得起来;代授权那条路另核代签记录、设置与内容指纹(阶段五)。靠什么兜:没封版、没测过、版本比对不过的发不出去;每一次站点发布在入库台账里留一行。
- 计划删不了、挪不走只挡命令行:拦的是命令行里直写路径的删与挪;换目录、变量展开、脚本进程内删拦不住,急救开闸期间不在岗;已完结的计划被脚本删掉,没有任何一处点名,清理归档的三处提醒也跟着消失。归档进去的文件命令行删不了,编辑工具与脚本仍改得了,也不在看板规范检查的范围里。靠什么兜:纪律 —— 已完结的计划只用清理归档的命令动,归档进去的只看不改。
- 清理归档靠施工区与人跑:只整份清施工区,以及老计划登记过的、确实在系统临时目录之下的目录;没放进施工区的东西(脚本自己建的、命令里带变量或通配的、平台的 PowerShell 工具建的等)守卫看不见或只提醒、清理归档清不到;老计划的登记文件被手改、保留的理由、施工区里要留的记录放没放错,机器不核;搬进归档的文件没有写证据,要等一轮收尾查过,这之前发布会被拦;验收完结之后那一次接力命令要人跑,它只问跑床、建站两把锁,只看判的那一刻,手跑清理归档不看;复盘与遗留、发现的去向在后台办、不挡归档,机器只显示、不催,忘了办靠项目经理巡检。靠什么兜:施工区的归属、副本提醒与阶段六的关口;点名一直在,直到搬走。
- 施工区的隔离靠词法:拦不到的见第十节「施工区放哪」最后一段,急救开闸期间也不在岗。写保护对施工区答「不保护」(副本里的跑床账与射程缓存除外)是有意的 —— 副本里得改得动守卫;换进真仓那一步由换入帮手与写前拦截把关,受保护文件按签字放行的口径放行(办理会话、签过的受保护格),不必用户手动开闸。靠什么兜:换入帮手先备份、逐字节核对、一条命令换回。
- 换电脑清单靠人做:装没装、设没设机器不核;记忆位置的设置对已开着的会话不保证生效,搬完要请它们重开。靠什么兜:清单第三块的体检,和新开会话问它记忆目录。
- 收尾单与治理站点一格:机器只核收尾单在不在、五栏下面有没有字,写得对不对、去向是不是主控定的、转没转给用户都不核;推格只看落点表里的目录,业务域那一行漏写了代码目录,机器照只改业务设计页推格(阶段二的关口照样拦范围外的写);收尾单随站点公开(动钱的需求不上站),写的时候把真实值遮掉。「治理站点」一格只按发布台账判:站点回滚、台账被直接改过它看不见;发布之后忘了跑发布登记这一格不翻;站点页面上这一格比登记慢一拍。靠什么兜:主控先看一遍收尾单再转;点名一直在,直到登记。
- 什么时候关会话(纪律):收尾单发出、清理归档跑完、治理站点那一格翻成已发布、提交完结案报告转出之后,项目经理才关这位产品经理的会话、删登记册那一行。机器不核这个时点(登记册里这条需求的行还在,会话命令的列表看得见),所以不入环的十态。
- 待立项目清单守不到的:第四节三条规矩都是纪律:构建器只核形状,不核理由、不核改动经没经过用户,也不核写之前有没有过复杂化审查官;清单与需求之间没有机器的账;清单不受治、不进锁清单。靠什么兜:验收那种写进验收题正文;用户当场拍板的以原话为准,原话账本可查;查敏感数据的那颗闸扫它。
- 发现的留存:做到一半记下的问题写在计划「欠下的」一栏,验收完结那一刻钩子把它与可信复盘写的遗留逐条写进履历;去向机器不记,写在别处的进不了履历,遗留一进履历就随站点公开、封死之后改不了。靠什么兜:主控逐条定去向,要放到后面的写进验收题正文、进待立项目清单。
- 接力命令与环的十态:接力命令串的是机器节点,派复盘、签字与验收完结之后跑它那一次仍要人;它不排窗口,中途被打断不会自己续,重跑从第一步核起。十态是只读的:出的是落盘的样子、不当场重算,判错只会误导看的人、不拦任何东西。靠什么兜:完结那一关仍是三查全绿加用户签字。
- 设计页的样式与图:本页只挂共用样式表,不写表格、样式块与标签上的样式(自测核形态),像不像一家、窄屏好不好读靠真浏览器与用户的眼睛;点名的床不夹折行标记(站点床按字面取床名)。图的张数没有床守着,图上的字与正文一不一致靠复盘;同一件事写在几处、没有机器对拍的 —— 上限的数字、十态的态名(本页第一节、架构详图 §十四、零件常量表)、八条规矩(第十节与架构详图 §十五),改一处要同批改。
- 写前拦截管不到脚本进程里的写:受写保护的文件,脚本在自己的进程里写,守卫看不见。靠什么兜:纪律 —— 落受治文件只用编辑工具。
- 会话命令与登记册守不到的:登记册被手改、会话号被冒用(Bash 命令里改写会话号守卫已拦,其余办法拦不全)、主控登记被冒用(会话名人能改,登记主控只防得住 AI 自己冒充);镜像只能发现单边改动。常驻会话不是任何需求的办理会话,也不写任何需求的机器镜像:它们只写计划目录,受治文件由产品经理派执行体写 —— 常驻会话跨多条需求,按会话号记账会串账,核准资格也要看谁写过机器镜像。官方升级后命令的输出可能变。命令行上给环境变量能换掉 claude 的位置和镜像的位置(X_CLAUDE_BIN、X_SESSIONS_MIRROR),体系守护的好几条命令还认环境变量 GUARD_HOOKS_DIR 把守卫零件指到别处,守卫都不拦 —— 与「自己写脚本再起 claude」同类,守卫本来看不见。靠什么兜:登记册只准受信脚本写;命令里留了字段自检,缺字段时报错、不硬做;定义里写明常驻不落笔。
- 说话钩子与首句守不到的:首句、续上的话、收到的消息都会触发说话钩子,固定句(含巡检句)只防「机器话被认成你的话」,防不了有人手打同一句;你亲口说的固定话是另一组,照常记、按签字的认法认。定时任务触发的话也走这个钩子,钩子分不出它和你敲的字(演练实测,被记成了你的原话)。已堵:签字只认主控窗口;环 1 拦含签字说法或固定话的定时任务,登记着的会话只许建巡检句。没堵的:定时任务送进来的普通话,在主控与没登记的会话里仍被记成原话;定时任务文件被脚本直接写,守卫看不见;说话只认主控要登记册读得出、登记了主控才启用,否则产品经理的会话里你说一句话也签得成。靠什么兜:固定句里不含任何签字说法,手打同一句也签不成什么。
- 代签守不到的:X大脑 逐条核验收清单、替你验得对不对,机器判不了,只核有没有证据、关口过没过。代签、改代签设置、改型号配置、重建登记册、换主控五条敏感命令,守卫按钩子输入里的 agent_id 拦执行体;但 X大脑 派出去的执行体和它同一个会话号,所以防得住执行体,防不住主控会话本身被冒用。在同一个进程里同时伪造一笔绿的验收和一笔完结的脚本,机器认不出;签字记录的来路严核只对进了新制度的计划(签字一带「验收谁签」栏的),老计划沿用老口径。代签命令认 X大脑 靠登记册,登记册被冒用的口子同样是代签的口子;运维经理只认发件名是 X大脑 的跨会话消息当授权或代签中转,发件名是平台给的,认得出叫 X大脑、认不出是不是主控本人。你用编辑器手改代签设置时账本里不留原话,编辑器手改和脚本直写在文件上分不开,只能在「最后改动」一栏与账本对不上时提示一句。靠什么兜:证据留在看板验收区,你随时抽查、随时能自己签;设置缺了或写错一律按亲签;改设置、换主控、重建登记册都要你亲口说那句固定话。
- 签字放行与急救开闸守不到的:能改守卫的人就能改放行的判定;放行把范围收窄到签过字的那几个文件、那一个会话,但办理会话往这几个文件里写了什么,机器挡不住。放行评估自己出错时受保护文件照拦、别的命令(含恢复命令)照放;守卫的零件装不上、整个起不来时一律拦,恢复命令也被拦(床里核过),只有急救开闸能救;别的地方出错时恢复命令跑不跑得了,没有保证 —— 那种情形同样是急救开闸的时候。自助改派(--take)之后,原办理会话(过了放行、但不再是办理会话)和接手者(是办理会话、但不在放行名单里)都写不了受保护文件,要主控或项目经理指名改派;执行体与派它的会话是同一个会话号,同享这份放行。换入帮手认这份放行,恢复帮手(restore)不认 —— 要恢复受保护的目标,仍只有急救开闸一条路。急救开闸是整关:设置会热加载,开闸那一刻所有在跑的会话(包括后台会话)同时失去守卫。靠什么兜:靠标准、测试床和独立复盘;永不放行名单只许加严;急救第一步先停常驻与产品经理会话,救完提醒关。
- 后台会话与恢复守不到的:恢复演过的是停掉后台会话再拉回;真重启电脑的恢复没有演过,用量上限把会话打断之后的拉回也没有测过。后台会话的环境(含代理)以后台服务起来那一刻为准,脚本直接起的会话不经你平时用的启动包装;权限确认不能代答,后台会话一律免确认模式,守卫的钩子才是真正的闸,免确认开关要用户设置里开着;在新目录或新克隆里起后台会话,得先由人信任一次。agent view 是官方的预览功能,界面和字段可能变,它头上写的默认型号与推理档是本机用户设置,发起时显式带齐、不受它影响;X大脑 这种交互窗口不出现在里面。项目经理与 X大脑 都不在时,消息发不出去也不补发。靠什么兜:命令里的字段自检;发起后核横幅里的型号与 @名字;换电脑清单;看板状态栏兜进度。
- 云端工具开机可能连不上:云端工具服务开机可能连接超时,后台会话没人点
/mcp,npx 起的进程启动失败官方也不自动重试。命令核连没连上读的是会话记录里平台自己追加的条目,格式官方没承诺,claude logs里有没有这类提示官方文档没写,读不出就说「核不出」;MCP_TIMEOUT在后台会话里生不生效,文档没写;本机六轮重启实测都连上了,没测出来。靠什么兜:开工自检、命令核对加重开一次、最后你发重连(见第十节同名小节)。 - 设计与审查的质量守不到的:两位架构师是不是真照逻辑链、数据链、功能链去想,复杂化审查官判得对不对,一个方案是不是最佳最合适、有没有人偷偷拿规模或成本当理由,机器都判不了。靠什么兜:独立复盘和用户抽查。
九、机制在哪
(指向,不抄)
下面每一条,冒号前面是机制,后面是住哪。
- 需求对账(签字、认车道、范围、三查、复盘派发、签字区、封存履历、定档、排队、开工、办理会话、顶层围栏):架构详图 §八「需求对账」;代码在
.claude/hooks/guard/下的 requirements.js、command-policy.js 与.claude/skills/x-harness-dev/scripts/core/下的 requirement-check.js;取舍在决策记录 ADR-94、ADR-106、ADR-119 - 收尾环、执行体停下那道关、拦截留痕:架构详图 §八;代码在
.claude/hooks/下的 guard.js 与 guard/session-ledger.js;取舍在决策记录 ADR-93 - 提交命令、结案报告、命令行 git 只读:架构详图 §八「提交命令」;代码在
.claude/skills/x-harness-dev/scripts/core/下的 plan-commit.js(结案报告出在 plan-loop.js),git 只读的判定在守卫的.claude/hooks/guard/command-policy.js;取舍在决策记录 ADR-118 - 版本契约(单元、写法、锁清单、「为了」、基线、封版命令):架构详图 §十三;代码
.claude/skills/x-spec-checker/scripts/check-spec/check/、version-contract.js .claude/skills/x-meta-dev/scripts/core/seal.js - 部署门、站点发布的当场重查、上传档案闸、发布前版本比对、联调:架构详图 §八「部署门认联调」、§九、§十三 第 4 关;代码在
.claude/hooks/guard/下的 mcp-policy.js、release-versions.js、trial.js、gate-measure.js;取舍在决策记录 ADR-100、ADR-106 - 发布状态重算:体系守护的 record-release 动作,代码
.claude/skills/x-harness-dev/scripts/core/;取舍在决策记录 ADR-100、ADR-108record-release.js - 清理归档、收尾单、「治理站点」一格、施工区与登记文件:架构详图 §八「清理归档」「收尾单与治理站点一格」「清理归档硬控」「接力命令」;代码在
.claude/skills/x-harness-dev/scripts/core/下的 plan-wrapup.js 与守卫的.claude/hooks/guard/requirements.js;取舍在决策记录 ADR-95、ADR-96、ADR-97、ADR-106、ADR-112 - 施工区(隔离、造副本与换入、记忆、换电脑清单):架构详图 §八「项目自带」;代码在守卫的
requirements.js、command-policy.js与体系守护的work-copy.js、swap-in.js;取舍在决策记录 ADR-112 - 接力命令、环的十态、办理会话改派、排队动作、开工命令:架构详图 §八「接力命令」「环的十态」「办理会话改派」与 §十四 的十态表;代码在
.claude/skills/x-harness-dev/scripts/core/下的 plan-run、plan-loop、plan-handoff、plan-queue、plan-start 五份,十态另有床.claude/skills/x-harness-dev/tests/plan-loop.test.js;取舍在决策记录 ADR-98、ADR-106、ADR-119 - 五条流程与十五条车道、谁在哪个会话做什么、八条规矩、怎么派工、交接:架构详图 §十五「先分级、再选路」「提速的八条规矩」「怎么派工」「主控怎么交接」与角色表,名词在 §十七;取舍在决策记录 ADR-90、ADR-93、ADR-102、ADR-105、ADR-106、ADR-116
- 会话命令(登记主控、发起、叫醒、停、删、恢复、列表、重建登记册、改名)、会话登记册、固定句、云端工具核对:体系守护技能说明里的会话命令一节与架构详图 §十五;代码在
.claude/skills/x-harness-dev/scripts/core/下的 session-ctl.js、session-registry.js,固定句与固定话的常量只在.claude/hooks/guard/session-phrases.js;取舍在决策记录 ADR-116 - 代签设置、验收谁签、代签命令、代授权、说话只认主控、定时任务通道:架构详图 §十五 的签字机制与发布授权,§八「签字记录只认两条路」与环 1「定时任务通道」;代码在
.claude/skills/x-harness-dev/scripts/core/下的 sign-settings.js、sign-delegate.js,守卫那一侧在.claude/hooks/guard/requirements.js;取舍在决策记录 ADR-116、ADR-118 - 签字放行(受保护格、放行、永不放行名单、急救开闸):架构详图 §八 写前拦截一节里的保护与放行;代码在守卫的
.claude/hooks/guard/下的 requirements.js、command-policy.js 与换入帮手.claude/skills/x-harness-dev/scripts/core/swap-in.js,受保护格的自动标记在立项、对账、签字题三条命令里;取舍在决策记录 ADR-116 - 受治文件类、设计只写当前这一版:架构详图 §十四
- 测试放置、唯一运行器与记账:架构详图 §十六
十、怎么开一条需求
三条主流程(Harness 流程、规范流程、业务流程)的需求走的都是上面这同一条线,运维与分析两条辅助流程不立需求(第一节)。新接手的会话先看「八条规矩」与其后几小节,认清自己是哪一种会话(X大脑、四位常驻之一、某个专项的产品经理)、手上的事走哪条车道、产品经理会话怎么起、签字在哪签、遇到顶层问题怎么办,再照下面的做;开新 X大脑 窗口看「开新 X大脑 窗口的例行三步」,死机之后看「死机之后怎么办」。每一样只指路,机制在架构详图。
八条规矩
节点之间怎么接力,见第二节的泳道图与阶段四「接力命令」;每条后面写今天靠什么,与架构详图 §十五「提速的八条规矩」同一口径。
① 设计由两位架构师出,X大脑 不出设计:业务的需求由产品架构师出设计,Harness 与规范的需求由 Harness架构师出设计,两位也审计划合不合设计;产品经理照设计写计划。X大脑 和常驻会话都不写机器镜像。纪律。
② 产品经理从写第一笔计划起就是办理会话:立项命令由它在自己的会话里跑,机器镜像由它写;签字回话里认成的办理会话不是它时,跑一次改派命令。一半机器:签「确认」那一刻守卫核看板与机器镜像对得上,并按机器镜像是谁写的认办理会话。
③ 产品经理会话由系统自动起:X大脑 定下流程、档、需求短名和类别,项目经理起会话,立项和起会话都在签字一之前;用户不用开窗口,在 agent view 里看。一半机器:会话命令只让登记册里的主控与项目经理跑,同名的会话、同一条需求已有活着的产品经理都拒绝再起;定什么流程什么档是纪律。
④ 一条需求一位产品经理:从立项到归档一个会话负责到底;改同一处的几件小事并成一条办,互不相干的各起各的。机器:同一条需求不会起两位产品经理,同一处同一时刻只开工一条(开工条件)。
⑤ 复盘与收尾单起草并行:复盘结论入账之后接力命令起草一次,验收完结之后再跑同一条接力命令时刷新并收尾归档(第五节「先有收尾单」)。两次起草都是机器;验收完结之后跑没跑那一次是纪律。
⑥ 治理站点谁改谁建:构建器有锁、不撞车;收尾环只提示不建,发布之前必建。不撞车是机器,建不建是纪律。
⑦ 几份确认可以一题签:只有确认题合并,每份各记一笔、各核各的,同一块的也行 —— 先记的开得了工就当场开工,后面的排队;验收题必须单选(阶段一)。机器。
⑧ 验收那一签同时授权这条需求的发布与提交:授权怎么算见「谁来发布、授权怎么算」,提交由主控跑提交命令。亲签的授权是纪律,代签那条路机器核。
谁在哪个会话做什么
用户平时只开两个窗口:X大脑,和 agent view(官方的后台会话视图,看得到全部后台会话,进去也能说话)。其余会话都由系统自动发起;它们与执行体的型号和推理档都照型号配置(见架构详图第十五节「型号与推理档」)。
X大脑(首席产品官,管产品;机器和各处说的主控就是它,只有一个,用户平时只和它说话)做这几样:和用户谈需求,拍板做不做、走哪条流程、定哪一档、排第几(要用户定的事一律给选项);统管各专项的产品经理;弹签字题给用户签(签字一可以提前弹,几份一题签);代签设置允许的,由它代用户验收(这一签同时授权发布与提交)、代用户授权联调;环收尾之后跑提交命令,把结案报告转给用户;改代签设置时跑受信命令,只在用户说了固定的话之后。它不出设计、不记会话号、不盯进度,从不写机器镜像;不动受治文件的小事(写计划目录、总账、待立项目清单、设计稿,只读分析)直接派一位执行体,动受治文件的事再小也交给一位产品经理。
- 项目经理
- 管项目(常驻,
x-project-manager):立项排期,排开工(排队的排到就跑开工命令、叫醒产品经理);起、关每个专项的会话(专项提交完、结案报告转出之后由它关会话、删登记册那一行);跟进度、催超时;管用量与静默时段(跑整面床、发布这类全仓共用的窗口怎么排,它出方案、X大脑 拍板);记总账与待立项目清单。自己二三十分钟一次的定时巡检保持在线:核登记册对会话列表、核各条需求看板的状态栏、超时叫人、遇到 blocked 状态的会话报 X大脑。不决策、不签字、不出设计。 - 运维经理
- 管部署(常驻,
x-ops-deployer):把东西部署上线,开发中途先上线联调也归它;每次上线都要授权(详见「谁来发布、授权怎么算」)。只认发件名是 X大脑 的跨会话消息当授权或代签中转,两样都没有不动手。开工先核云端工具在不在,连不上的办法见「运维经理的云端工具连不上怎么办」。 - 产品架构师
- 管业务(常驻,
x-architect):拥有整个业务架构;业务需求从逻辑链、数据链、功能链出产品设计,审计划合不合设计,实施后回看业务架构有没有同步。 - Harness架构师
- 管 Harness(常驻,
x-framework-architect):拥有整个 Harness(宪法、五类架构、L0–L5);框架与规范的需求出设计,各条线报上来的框架毛病由它分析、出方案。 - 产品经理
- 管专项(每个专项一位,
x-product-manager,只作会话用):从立项到归档一个人负责到底 —— 请架构师出设计、写计划(把 X大脑 判定的「验收谁签」写进计划)、签了字等开工(排队的只能写计划目录)、带执行体实施、请对抗审查官复盘、申请发布、收尾归档(提交由主控跑,它不提交);从写第一笔计划起就是办理会话;独立复盘连着三轮不过时它停下手,由 X大脑 请用户到这个会话里发话。
四位常驻会话不是任何需求的办理会话,也不写任何需求的机器镜像,受治文件由产品经理派执行体写;闲着的约一小时后被官方收掉进程、在 agent view 里显示「做完」,对话还在,叫一声就从原处接着干。agent(执行体)被 X大脑 或产品经理派去干具体的活,只在自己的写域里写,不和用户说话;X大脑 和产品经理在各自的会话里都是领队;各角色的细目在架构详图 §十五 的角色表。
控制复杂化:取舍只问最佳最合适,规模与成本不作为取舍的理由,只禁止复杂化。X大脑 在遗留定去向之前、成条与难事的签字题弹出之前、待立项目清单更新之前,派复杂化审查官(只读的执行体);它交回一张表,判断只有立、并、不立、问你四种,只砍「不必要」的,不碰用户当场拍板的事。项目经理写清单之前先拿到它的判断。
顶层指这套体系自己:宪法、架构详图、守卫、检测引擎、工作流、规范与条款、本页、agent 架构的设计页与执行体文件;各业务域自己的设计与业务代码随各自的业务需求线走。
转达的通则:用户平时只在 X大脑 的窗口说话。要别的会话办的事,由 X大脑 把用户的原话逐字转过去;产品经理与运维经理不凭转来的话就动手 —— 先到守卫的原话账本(.claude/tmp/requirements/says.jsonl,用户每说一句,守卫逐字记一笔)里只读核一遍,核到就办,核不到回 X大脑;代签的记录是另一条路(「验收谁签与代签」)。签字与急救开闸不走转达,只认用户当场说的、做的。被拦的动作不代做:一个会话被守卫拦下的动作,别的会话不替它做,先报 X大脑。这条通则是纪律,机器不核。还要用户去别的会话发话的只剩一样:独立复盘连着三次不过之后的那一次(第八节「在主控签字守不到的」)。
先分级
X大脑 接到一件事先认车道:由落点认出走哪条流程,再定这条流程的哪一档,手续的轻重跟着车道走;简单的事不许复杂化。机器规定必须走的只有五样 —— 用户确认、封版、一轮独立复盘、三查全绿、验收签字(用户本人,或照代签设置由 X大脑 代签;外加每轮收尾的检测与测试),三条主流程哪一档都不省,运维与分析不立需求、都不走。审查只留两层:成条与难事的计划在签字之前由架构师审合不合设计、再过一遍复杂化审查官的减法审,封版后的独立复盘。每条车道是什么样的事,定义只在架构详图 §十五 的车道表;下面写各流程三档各走哪几步。
- Harness 流程
- 小事:产品经理写一页计划、用户确认、开工、产品经理派一位执行体改、增量检测、变更历史加一版并封版、一轮复盘、验收;同一处正有一条在办时,搭进下一条当一条标准
成条的事:Harness架构师出设计、按文件列分工,产品经理写计划;产品经理带的几位执行体按文件并行(热点文件只给一个);落点里的受保护文件签字一授权、到时放行,真仓直改,不做仓库外面的副本;改到的那一面的床全跑;一到两轮复盘
难事:比成条的事多:签字之前多路只读设计一次,决策记录草稿随签字一一起签;按批落;封版前全量跑一次床;复盘至多三轮 - 规范流程
- 小事:只改条款书或系统架构页的文字;产品经理派元治理专家改;规范同步、封版、一轮复盘
成条的事:改判据;签字之前对全仓跑一遍这份规范、数清会红多少处,会红的当场改、登记成基线或列成整改清单转业务流程;每颗改过的闸有床证明真红真绿;一到两轮复盘
难事:新建、删除、扩射程;签字之前多路只读设计一次;五条检测命令全跑;复盘至多三轮;动到检测引擎就并进 Harness 流程 - 业务流程
- 小事:只改展示;产品经理派那一端的开发专家一位;改界面的,签字之前出那一屏的高保真,点过头的那一版存进本需求的 preview 目录、标准里锁指纹;封版前全量检测一次;一轮复盘;用户看那一屏验收
成条的事:一个功能跨几端;产品架构师出设计要点,产品经理起草计划、产品架构师审;数据先行,中途要上线联调的经运维经理(阶段五);本域的函数床;一到两轮复盘
难事:动钱、权限与身份、已发布表改字段类型、删功能、母本与内核;产品架构师先出域设计;床跑全部消费端;复盘至多三轮。各端怎么做在开发规则书 - 运维流程
- 例行:发已验收完结的东西,用户一句授权
常规:一张操作单(做什么、事前备份、怎么核对、出事怎么回滚)加用户一句授权
紧急:用户一句「回滚」,之后按对应的主流程立一条修复需求
三档都只在运维经理的会话里做(阶段五) - 分析流程
- 快问:主控自己答,花了力气的结论落看板
分析与体检:派一到四路只读执行体,挑刺一轮,产出计划目录里的一块看板
需求整理:几路并行出稿,产出方案页加一张需求清单,每条写明车道与依据,用户定了才立项
三档都不签字、不封版(「只做分析的事」)
每一档的上限(三条主流程用同一张表,数字见图 4):前四栏在签「确认」那一刻由机器按档核,超了签不上(阶段一);后两栏超了只点名、不拦 —— 「正在办」那一行与完结那句回话里写明超了哪一个,办的时间从开工算起(排队的时间不算)、不含等用户验收的那一段。认流程、最低档(七个风险标记)签「确认」那一刻由机器核(阶段一),改判定代码的同一时刻只开工一条由开工条件核(阶段二);X大脑 定车道时先认车道,靠纪律(架构详图 §十五)。
定了档再看落在哪:改同一处的几件事并成一条办,互不相干的并行办;同一处同一时刻只落一条 —— 下一条的计划、设计与预览可以先备好,签字一也可以先签,开工等上一条提交完。同一个版本单元上已有别的需求开了工、没提交完,后来的签字照记、记成排队;谁占着、谁排着、此刻谁开得了工:node .claude/skills/x-harness-dev/scripts/harness.js --action=queue(只读)。
起一个专项的产品经理会话
谁起、怎么起:X大脑 定下这条需求的流程、档、需求短名和类别(产品 / Harness / 规范),叫项目经理起它的产品经理会话 —— 经体系守护的会话命令(--action=session --do=start),用户不用开窗口。会话名是「需求短名-类别-档」(档写小事、成条、难事;例:地图立起来-Harness-难事),角色不进名字,名字只给人看、机器认完整会话号。会话名必须唯一:同一条需求已有活着的产品经理、任何一个活着的同名会话,命令都拒绝再起。型号、推理档、权限与设置在发起时一次带齐,写前拦截没接上线时命令一律拒绝。任何会话不经这条命令直接跑 claude,守卫一律拦,不分是不是办理会话。
立项和起会话都在签字一之前:起会话时计划目录还没有,短名、类别、档作为参数带进命令、不读机器镜像;产品经理在自己的会话里跑立项命令,所以从写第一笔计划起它就是办理会话。用户签「确认」时档要是变了,项目经理用会话命令的改名子动作照新档改名,会话号不变。
握手只有一个出处:发起命令往会话里只送一句固定句,握手的内容由发起命令打印、项目经理照原样经 SendMessage 送出 —— 先给项目经理回一句「已连通」并带上会话编号(命令已在握手内容开头写好),收到回执之前别动任何文件,再跑立项命令。立项命令打印的派工底稿只有回报节点、共用资源规矩和执行体名单,不含握手。没有回执,项目经理自己查那个会话的状态、报 X大脑。
派工带设计:产品经理先请架构师出设计(业务的需求找产品架构师,Harness 与规范的需求找 Harness架构师),拿到设计要点(动哪个文件的哪一处、口径是什么、按文件怎么分工)和要先读的文件,再带给执行体;一次只派眼下这一条。
按节点回报:派工里写明到哪些节点要回报,每条一两句 —— 读完(报预计多久送审)、计划送审、要请用户签字之前、已签字、接力命令每一次停下来(红在第几步、为什么;走到了复盘说明;末尾打印可以弹验收题)、复盘派出与结论、验收完结;任何时候的红灯与黄灯、等用户超过十分钟没动静、要偏离已定口径之前。只报要 X大脑 或用户接手的节点。每个回报节点同时把看板状态栏改成现状:收件的会话停着时消息发不出去、也不补发,看板才是落盘的状态,项目经理的巡检读各条需求看板的状态栏。
要用户动手的事先报主控:签字、授权,产品经理先报 X大脑、报完停手等回话;开闸跟着签字走,没有单独的开闸与关闸。签字题由 X大脑 弹:产品经理把题目正文报给 X大脑,X大脑 弹题、用户在 X大脑 的窗口签,签完 X大脑 把守卫回的那一行转给产品经理,产品经理核一眼「在办、办理会话是自己」再动手(不是自己,先跑改派命令)。
产品经理怎么对用户说话:平时它只向 X大脑 报、不自己找用户;用户进到它的会话里时(例如复盘三次不过要他发话),每次停下来,最后那段话的第一句只许是「现在不需要你做任何事。」或「请你现在做:……」。
等执行体交回时别开长的前台命令:一条命令在会话台账里是一个时间窗,别的会话这段时间用脚本写的文件会按时间窗归到本会话名下(阶段二),三查就会要求别人的单元先封版。等的时候结束这一轮等通知;别的会话正在同步、封版或建站的那一段,连几秒钟的只读命令也先停。
这几样都是纪律,会话之间的消息守卫不记;机器帮得上的只有「正在办」那一行(第八节「握手与节点回报」)和会话命令里的身份、重名、同一条需求重起三项拒绝。
签字在哪签
都在 X大脑 的窗口签:交给产品经理办的需求,签字的题都由 X大脑 弹,用户不用去别的窗口(签得成,靠签「确认」那一笔记下的办理会话,见阶段一)。怎么签、几份确认怎么一题签见阶段一;签字只认用户在当场那个会话里说的话,会话之间转发的话不算。
X大脑 要做的三件事:机器镜像它不写(谁最后写它就被认成办理会话);签完看守卫回的那一行写着认成了谁,拿它对产品经理握手时报的会话编号,对不上让产品经理先跑一次改派命令;把那一行转给产品经理。
要用户亲手验的项目不设计成触发仪式:验收清单上的每一项只许两种 —— 他本来就要做的事(打开站点看一页、打开一个文件看一处),或让他看一个结果;不许写成「请你做 X 来触发 Y」。要验「机器在他每条消息上点名」这类行为,拿他最近一条真实的消息当证据。纪律,机器不核。
验收谁签与代签
签字一永远由用户本人签。验收完结(这一签同时授权这条需求的发布与提交)、开发中途的联调授权,这两样本该用户点头的事,按用户的代签设置由用户本人或 X大脑 来。
- 两个开关
- 设置文件
.claude/sign-settings.json按专项类别分两个开关,互不影响:产品专项(类别写「产品」的需求,设计归产品架构师)和 Harness专项(类别写「Harness」或「规范」的需求,设计都归 Harness架构师);各取「代签」或「亲签」。设成代签的那一类,除了签字一,该用户点头的事都由 X大脑 代;设成亲签,都要用户本人来。运维、分析两条辅助流程没有验收签字,不在其内。立下时两个开关都是代签,现行的值只看文件里此刻写的。 - 设置文件
- 不归任何版本单元、不升版不封版;工作区地图声明它不受治、受保护(任何会话的写文件工具和命令行都写不了它)、入库(随仓走)。文件缺了、读不出或写得不对,一律按亲签。
- 每条计划的「验收谁签」
- 签字一时就定:计划的看板与机器镜像都有一栏,写亲签或代签,加一句理由。X大脑 定流程与档时一并判断,产品经理照着写进计划,签字题的需求确认区里摆给用户看。那一类设成亲签,只能亲签;设成代签,默认代签,验收清单里有只有用户能判的项(他的喜好、他要表达的意思、要他亲眼看过才算数的)就定亲签并写明理由。用户签「确认」时加一句「这条我自己验」,就改成亲签(X大脑 通知产品经理改看板和机器镜像、刷新签字区;它自己从不写机器镜像)。这一栏随签字一锁住:放宽(亲签改代签)要用户重签,收紧(代签改亲签)走核准、不用重签。设置是上限:签字一之后用户把某一类改成亲签,那一类在办的需求一律按亲签算,以读设置那一刻为准。
- 代签怎么签
- 关口一个不少,最后那一下由 X大脑 点。X大脑 先逐条核验收清单,每条的证据写进看板验收区(亲手验的清单照旧写成用户看得懂的话,代签时由它代验),验收区没有证据就签不了;再跑代签命令
node .claude/skills/x-harness-dev/scripts/harness.js --action=sign --plan=需求名 --kind=验收完结 --as=代签。命令核三件事:调用的会话是登记册里登记的主控;设置此刻允许这一类代签;这条计划的「验收谁签」是代签。三样都对,才照常记「验收完结」,签字人写「X大脑 代签」,带上设置的指纹和验收区证据的指纹;关口和用户自己签时是同一套、同一段代码(三查全绿、独立复盘过、看板与机器镜像对得上);之后的履历、发布段、归档和用户签的一样走,履历里写明「X大脑 代签」。签字记录只认两条路:用户的原话、代签命令,别的写法不算。 - 用户随时能自己签
- 就算定了代签,用户说「全选执行:验收完结 〈短名〉」照样算。代签之后 X大脑 向用户报一句:哪一条、凭什么签的、证据在哪,以及待立项目清单这次加了、拿走了哪几条 —— 代签的需求,清单的增减由这句报告告诉他。
- 代签设置怎么改(不立项)
- 两条路。一是用户在 X大脑 的窗口说四句固定话之一:「代签设置:产品 亲签」「代签设置:产品 代签」「代签设置:Harness 亲签」「代签设置:Harness 代签」,X大脑 跑受信命令
node .claude/skills/x-harness-dev/scripts/harness.js --action=sign-settings --do=set --class=产品 --value=亲签(类别与值照说的那句),命令在原话账本里核到这句话确实是用户说的(认法同签字)才改;这句话要新鲜、一次一用,改的时刻和那一笔原话的位置记在设置文件里。二是用户自己用编辑器改设置文件,下一次读设置就照新值。不经用户的原话,任何会话(包括 X大脑)都改不了。 - 签字只认主控窗口
- 会话登记册登记了主控之后,你的签字和你亲口说的「会话登记册:重建」「代签设置:…」「型号配置:…」只认在 X大脑 的窗口里说的;别的会话里出现这样的话,不记进原话账本、不认作签字,守卫只回一句原因,选项题弹在别的会话里也一样。「会话登记册:换主控」不受此限,新窗口登记之前它是唯一的出口。登记册读不出来、没有登记主控时这一条不启用。
- 永远只归用户的
- 签字一(需求确认,同时也是开闸的授权)、改代签设置、急救时的手动开闸,以及钥匙石与代签设置这两个文件的提交。
开闸跟着签字走
受保护的文件(守卫、检测引擎、执行体目录、项目设置等)平时对谁都拦。一条需求要改其中放行范围之内的几个时,不用用户手动开闸:签字一就是授权,实施时机器只对这条需求的办理会话放行它签过的那几个。
- 签字一就是授权
- 计划落点表里落在受保护文件上的格,由计划工具(立项、对账、签字题三条命令)自动标「受保护」,不靠人手标;路径里的通配符先展开成真实文件再逐个问保护名单。受保护格不另存标记,由签字那一刻的落点表和受保护名单现算(新旧签字一样)。签字一的题和看板里写一句人话:「这条要改受保护的文件(守卫 N 个、执行体目录……):签了就等于同意到时放行这些文件,不用你手动开闸。」签字一只能用户本人签、从不代签,所以开闸的授权不会被代签带走。
- 实施中机器放行
- 守卫照常在岗。写一个受保护文件,要同时满足四样才放行,否则照拦:① 写的是这条需求的办理会话 —— 签字时记下的会话、登记册里登记为这条需求产品经理的会话、X大脑 或项目经理指名改派的会话,三种;谁都能跑的自助改派不带走放行,常驻会话也不是;② 路径落在签字那一刻的落点表算出的受保护格里,并且核准之后的现行落点表里还有它;③ 这条需求在办(开了工、还没完结、签字没作废);④ 路径不在永不放行名单里。范围写死为守卫脊柱与检测引擎承牙两类受保护文件,保护区、生成物、发布档案、业务端源码不在放行之内。写文件工具、命令行、换入帮手同一份放行;别的文件、别的会话、别的需求一律照拦。
- 自动收回
- 验收完结、归档、签字作废,任何一样发生,这条需求的放行当场收回,不需要谁记着关。需求履历记下放行过哪些受保护文件、实际写了哪些。
- 永不放行名单
- 写在代码里、只许加严:各本账(需求账本、原话账本、会话台账)和需求履历;各单元的锁清单;装配标记;检测引擎的射程缓存;版本库自己的忽略清单;代签设置文件(只归用户);会话登记册(只归受信命令);定时任务文件;项目设置、本机设置与云端工具服务的定义文件。这些虽然受保护,但不在放行之内,各由自己的程序写(登记册由会话命令写),代签设置与项目设置由用户本人改;唯一运行器、部署门入口和空壳桩不在名单里,列在签过字的落点里就放行。
- 签字之后加格要重签
- 签字之后经核准加进来的格不放行受保护文件,要放行得先核准、再让用户重签(只有签字作废才有重签,没作废就只能请用户手动开闸一次,补签放行没做);减一格不用重签,减掉的格也不放行。
- 换入怎么走
- 换入照旧走施工区副本加换入帮手(自带备份,一条命令换回),帮手认的就是这份放行。
- 评估出错一律不放行
- 放行的评估自己出错(读不了账本、机器镜像坏了、抛异常),一律按不放行:吞掉、记一笔、不往外抛,受保护文件照拦,别的命令(含恢复命令)照放。
- 急救开闸
- 手动开闸只在急救时用,也只归用户:新换上的守卫要是坏了、连恢复命令都被拦住,才用它。做法:① 先停掉常驻会话和各位产品经理的会话 —— 项目设置会热加载,开闸那一刻所有在跑的会话同时失去守卫;② 用户把项目设置
.claude/settings.json里钩子接线PreToolUse那一行的键名改成_PreToolUse,写前拦截就停了,X大脑 告诉他什么时候开;③ 救完提醒用户改回来关上,X大脑 核一眼接线文件。
做到一半遇到顶层问题
只问一句:继续做,会不会让手上的需求做错或做不下去。会,是红灯(守卫错拦了一笔正当的写入、检测误报、流水线某一步走不通):发现的会话当场自己停,把问题记进计划「决策与遗留」页签的「欠下的」一栏,告诉 X大脑;顶层先修 —— 那是另一条需求,由 X大脑 立项、交给一位产品经理办到验收完结,修完由用户发话恢复。不会,是黄灯(别扭但能照规矩做对):同样记进「欠下的」一栏、不停,手上的做完、封到这一小步,顶层的修排到后面。Harness 本身的毛病走固定通道:报 X大脑,交 Harness架构师分析、出方案,方案过复杂化审查官,再由 X大脑 拿给用户定。
停与走不由 X大脑 替别的会话定,暂停与恢复由用户发话;「欠下的」一栏验收完结那一刻由钩子写进履历。机器不认暂停、也不记发现的去向(第八节「暂停与恢复」「发现的留存」)。
换主控怎么交接
不用交接的:在办的需求、签字、各单元封没封都在仓里(计划目录、需求账本、变更历史、锁清单),在办的会话和谁是谁在会话登记册里(仓里一份、用户目录里镜像一份),新会话开工时守卫逐条告诉它。会丢的只有 X大脑 脑子里的几样 —— 谁在谈什么、排了哪些窗口、哪些事等用户定:它们只在总账页里(计划目录下主控自己的一个子目录,不放机器镜像,平时由项目经理记)。
照四步做:① 总账页更新到当下;② 旧窗口手上直接派执行体办着的小事收一收;③ 名下还有没封的改动就自己封掉;④ 新窗口开工先做下面的例行三步,再读开工注入与总账页,跑一遍 loop 动作看每条需求在哪一态。旧主控还活着时换主控,用户要在新窗口说固定的话「会话登记册:换主控」(只认最近 10 分钟内说的、同一笔不能用第二次)。换主控选在两条需求之间;各专项的产品经理会话不受影响。四步是纪律(第八节「会话命令与登记册守不到的」)。
开新 X大脑 窗口的例行三步
在仓根运行 claude --agent x-brain --name X大脑 并带上型号配置里主控类的型号与推理档开窗口。开工先做三步,都是 X大脑 自己跑,命令是体系守护的会话命令(node .claude/skills/x-harness-dev/scripts/harness.js --action=session --do=…):
① 登记主控(--do=register-main):会话列表里种类是交互、名字叫 X大脑 的那一个才登得上;重复登记无妨;登记册里的旧主控已死、新窗口又叫 X大脑 时自动补登。放在最前:登记册里记着主控时,新窗口没登记之前,你在里面说的签字不记。② 看四位常驻在不在(--do=list,只读):登记册对照会话列表现查状态,名字对、没有哪一位显示失败;状态是 blocked 的当成要报用户的事。③ 不在就预览恢复(--do=recover,默认只预览):列出该拉的,确认之后再执行,做法见下一小节。
死机之后怎么办
机器卡死、后台服务停掉或电脑重启之后,在办的会话都停着。用户重新打开 X大脑 的窗口和 agent view,由 X大脑 在重开的窗口里跑恢复命令;第一步不能指望项目经理 —— 它自己也在被拉回的名单里。
- 先看:
node .claude/skills/x-harness-dev/scripts/harness.js --action=session --do=recover默认只预览(谁都能跑),列出登记册里该拉的会话;再用--do=list看现查的状态。 - 再拉:同一条命令加
--execute,只有 X大脑 或项目经理跑得了。只拉停了、失败、干着活的(被打断的会话是这几种);有进程的跳过,已完成的(只是进程被官方收掉)不拉。 - 怎么拉:对每个要拉的会话先停(原会话还活着时直接续上会复制出同名副本),再用完整会话号续上,不带任何别的参数 —— 带任何参数续上同样会复制出新会话号的副本。首句是一句固定的恢复句,提醒它先核对被打断的那一步有没有生效,再决定要不要重做;会话号不变,名字、型号、推理档、权限和设置都保留,回到原来的目录接着做。回执里出现「started a copy」、会话列表里同名的会话多出一个、短号对不上登记册,任何一种都当失败:停掉并删掉副本,报 X大脑。
- 拉完核一遍:每位被问一句「列出你的工具」,答得出。型号与 @名字 发起时由命令对着
claude logs的横幅核过(你直接跑 claude 会被守卫拦),拉回之后看各会话自己报的身份和工具;运维经理拉回之后会话命令另核云端工具(下一小节)。之后单个会话掉了,由项目经理的巡检去拉。
闲着的常驻不用拉:官方约一小时后把闲着的会话进程收掉,agent view 里显示在「做完」一栏,对话还在,叫一声就从原处接着干;只有项目经理靠自己的定时巡检常醒。停掉本机后台服务(claude daemon stop --any)是用户的动作,不在恢复命令里,第一条续上会把后台服务带起来。演练实测过的是停掉后台会话再恢复:停掉五个会话再用恢复命令拉回,会话号全没变,答得出工具名,记得停之前的对话;不带参数续上之后仍能写主仓;固定句没有进原话账本。没演过的是真重启电脑(第八节「后台会话与恢复守不到的」)。
运维经理的云端工具连不上怎么办
运维经理动线上的东西,靠项目里配的云端工具服务(cloudbase)。它开机时可能连不上:演练里它头一次开机,连接超时(30 秒),整个会话一个云端工具都没有。后台会话没有窗口,没人能点 /mcp 重连;这个服务是本机用 npx 起的进程,启动失败官方不会自动重试。所以分三层,前两层机器自己治,第三层才轮到你动手。
- 第一层 机器自己治:运维经理的定义要求它在被发起、叫醒、恢复后的第一回合,以及每次接部署或联调的活之前,先核云端工具在不在;不在就用 SendMessage 报 X大脑 并停手,不碰线上的东西。它重启不了自己,由 X大脑 或项目经理把它停掉,再不带参数叫醒。会话命令也核:运维经理被发起、叫醒、恢复之后,命令读它的会话记录,看云端工具连上没有并打印用时;没连上就停掉、再不带参数叫醒一次(换一个新进程重连),再核一遍,还没连上才报 X大脑。记录里没有结论算「核不出」,不算失败。
- 第二层 治根:发起命令带的设置里加了
MCP_TIMEOUT,把云端工具服务的启动连接时限从官方缺省的 30 秒放宽到 90 秒;项目设置不动。官方文档写明这个变量能放进设置的环境变量,但后台会话里它是不是在连接之前生效,文档没写,要实测。本机重启实测过六轮(删了重起三轮、停了叫醒三轮),都连上了,用时 16 到 49 秒,一轮没连上的都没有,所以它生没生效没测出来,别当成已经治好。 - 第三层 最后兜底,你动手:X大脑 告诉你两次都没连上时,你在 agent view 里选中运维经理,发
/mcp reconnect cloudbase。这条在 agent view 里不用点进会话也能发(官方文档写明,本机未实测);不行就点进它的会话,打/mcp选重连。平时用不上。
谁来发布、授权怎么算
往线上放东西只在运维经理的会话里做:别的会话要发布向 X大脑 要窗口,X大脑 告诉运维经理发什么、为什么,自己不动手发。小程序包由用户在微信开发者工具上传,不经运维经理。
授权每一次都要有:随某条需求验收而做的发布,授权就是那条需求的验收一签,它同时授权该发的每一格各发一次(出了问题立刻回滚算同一次)。① 亲签的,X大脑 把验收那句话逐字转给运维经理,运维经理以转来的原话为准、照发布技能自己动手、量大派运维发布专家,机器不核。② 代签的(「验收谁签与代签」),X大脑 把代签记录转给运维经理,命令里显式带需求名和「代授权」标记,机器核。验收题的正文列出会发哪几格。没有授权,运维经理不动手;动手之前照「转达的通则」核一遍原话账本。
要用户单次授权的:不随某条需求验收而做的发布(重发、每天的站点、回滚到更早的版本)和生产构建(后台构建、手机网页版装配),用户只对 X大脑 说,X大脑 逐字转给运维经理,单次有效、不跨轮;开发中途的联调上线另可照代签设置由 X大脑 代授权。
框架、规范、项目架构、agent 架构、业务总览落盘即生效;站点在需求完结之后发过一次才算已发布,没发的每次回话点名「待发布」。这几样是纪律 —— 机器拦的是没封版、没测过、版本比对不过的发布(阶段五;第八节「发布归谁与授权」)。
计划放哪
计划目录 .claude/plan/ 下一条需求一个子目录(目录名就是需求名),里面是给人看的看板 PLAN.html 与机器镜像 scope.json,签字那一刻守卫核它们一字不差;另有收尾单 WRAPUP.md。完结之后计划不删,由清理归档的命令整份搬进归档目录;它搬走之前,新的需求开不了工(阶段六)。计划目录下的任何一份,命令行都删不了、挪不走。
主控的临时文件不放计划目录:草稿、探针放平台给会话的草稿目录(那是平台自己的临时目录,丢了不影响项目);要留的写进主控线自己的设计目录。计划目录只放计划自己的东西,以及主控的总账页、总账旁边的待立项目清单、记忆文件夹与分析的产出。放错了收拾不掉 —— 命令行删不了,主控又跑不了自己新写的脚本。纪律,机器不核。
施工区放哪
办一条需求用到的一切临时东西 —— 产品经理的整仓副本、前后对照、探针、换文件前的备份、过程记录 —— 只放这条需求自己的施工区:x-test/zz-work/<需求名>/(需求名就是计划的目录名)。它在项目里、git 不管(忽略清单里 x-test/zz* 那一行盖住它),检测、治理站点、发布、对拍台都不读它。
- 谁写得进:签了字的需求的办理会话(连同它派的执行体),只写进自己的施工区。别的需求的办理会话、没签字的会话都写不进去,也不许跑别的需求施工区里的脚本;这条需求的办理会话签字之后,跑自己施工区里的脚本放行 —— 副本里要跑引擎和守卫。机器拦的是编辑工具和命令行里认得出落点的写。需求办完、计划归档之后,它的区成了死区:谁都不能再往里写,但谁都可以删。
- 里面的东西不算受治文件、不受写保护(副本里的守卫、检测引擎、执行体定义能直接编辑,真仓里同名的照旧受保护)、不记写证据、写完不提醒「不在设计范围里」。
- 怎么清:清理归档时整份删掉,不跟着联接走;收尾单先列出里面有什么,预览里也列。清单里多一列「停滞区」:对应的需求已完结、计划已归档或计划已不在的施工区,只列出来、不替你删(删用命令,谁都放)。
- 副本放进仓里之后:造副本只经体系守护的「造副本」动作,它决定副本里带什么、不带什么,并在副本根放一个空的
.git文件当标记 —— 副本里的床问 git,和副本在仓外时一样报错(退出码相同),不会悄悄读到真仓;副本里的工具认根以副本为根。平台读、写或编辑副本里的文件时(Bash 的cat、head读单个文件也算),会把里面嵌套的CLAUDE.md和.claude/rules当指令加载,项目设置里加了排除项;副本里的自研技能排除不了:/名仍跑根上的那份,但平台会把带目录前缀的那份也列给模型,并引导它在副本里干活时用副本那份 —— 多占一点上下文,也有误用副本版本的风险。
守不到的:脚本进程里自己写的东西、路径带变量通配的写法、经施工区里的联接或硬链接去写真仓、该放进施工区却放在系统临时目录以外别处的东西,机器不核。这几样靠纪律。要留给复盘和后续步骤看的记录(耗时、前后对比、改坏对照)不放施工区 —— 它归档时整份删;写进计划目录或设计目录。
从哪起
两份模板:.claude/skills/x-feature-dev/assets/plan/ 与 .claude/skills/x-feature-dev/assets/plan/,所有需求共用。立项时由产品经理在自己的会话里跑体系守护的 new 动作,把它们拷进计划目录、填上短名与档,并按给的单元认出的流程与档,在「步骤」页签填一段这条车道走哪几步(认不出流程的留占位,落点后来变了照车道表自己改);方括号占位要全部填掉,留着签不了字。
签字区与三查
体系守护的核对命令(reconcile):没签字时在看板「签字」页签里生成签字区(最顶上一行档与四个数、车道与中了哪几个风险标记,此刻签不了时写「确认区还没开:」加原因);签字之后出三查结果单。谁跑结果都一样:签过字的计划一律按办理会话算。同一个入口另有 review-brief(复盘者的任务说明)、checks(固定检查)、queue(排队)、run(接力)、loop(环的态)、handoff(改派)、ask(签字题的正文)、new(立项)几个动作,命令见「一圈最少跑哪几条命令」。
找谁干
要出设计找两位常驻架构师(业务找产品架构师,Harness 与规范找 Harness架构师),要起会话、记总账找项目经理,要上线找运维经理;动受治文件的事交给一位产品经理,由它按入口表派执行体。改的是哪一类东西、落在哪个版本单元、谁出设计、产品经理派哪些执行体、用哪条封版命令、往哪发,只查架构详图第十七节那张五类需求入口表;不归任何版本单元的东西(治理站点的源码与构建器、官网)怎么办,写在那张表下面。
五类需求入口表
只写在架构详图 §十七「术语表与五类需求入口表」,本页不另列。
只做分析的事
只看、不改任何东西的事(体检、复盘、调研)走分析流程:不立需求、不用签字。本会话不是哪一条在办需求的办理会话时(仓里没有在办需求时同样如此),命令行只放只读命令与仓里现成的脚本,自己新写的脚本跑不了 —— 要验证一个新的怀疑,留到修它的那条需求里先写测试复现。落点表为空的计划签不了字,所以分析不能单独立成一条需求。
分析的产出放哪
计划目录下自己另开的一个子目录(一份看板或一份说明),不放机器镜像:没有机器镜像的目录不算一条需求,不用签字、不挡任何人。分析得出要改的东西,另开一条需求。
体检与调研找谁
先看现状:跑六层体检 node .claude/skills/x-harness-dev/scripts/harness.js --action=audit。要人取证派体系体检官(x-harness-auditor,只读),要人挑刺派对抗审查官(x-adversarial-reviewer,只读),要先查清的派调研员(x-researcher)。这样派出去的只是分析,不算正式复盘 —— 正式复盘的提示词必须逐字是任务说明命令印出的派发表头。
一圈最少跑哪几条命令
按顺序八步,第 ③、⑤、⑦ 步跑的是同一条接力命令,它照这条需求走到哪自己挑那一段:
① 签字与开工:签字之前,先用排队动作看谁占着、有没有等着清理归档的。生成签字区:node .claude/skills/x-harness-dev/scripts/harness.js --action=reconcile --plan=需求名。弹题之前用 node .claude/skills/x-harness-dev/scripts/harness.js --action=ask --plan=需求名 --kind=确认(验收题换成 --kind=验收完结)出题目正文(正文里写着这条走哪条车道),预检与核对都过才打印;题目由主控弹,里面的仓内路径都写完整路径。签的那一刻开得了工就当场开工;记成排队的,排到它时项目经理(或主控)跑开工命令 node .claude/skills/x-harness-dev/scripts/harness.js --action=start --plan=需求名,叫醒这条需求的产品经理。
② 实施中每改完一批:增量检测 node .claude/skills/x-spec-checker/scripts/check-spec/check.js --changed 文件… -d,再按改动跑测试 node .claude/skills/x-harness-dev/scripts/harness.js --action=beds --changed=文件,…(业务开发流的 verify-feature.js --changed 一条顶这两条)。
③ 固化与复盘之前:变更历史加好新的一版(标题与说明自己写),跑接力命令 node .claude/skills/x-harness-dev/scripts/harness.js --action=run --plan=需求名:七步跑到生成复盘说明为止,哪一步红就停在哪一步,修好再跑同一条。
④ 派复盘:把接力命令末尾两条分隔线之间的派发表头逐字派给对抗审查官(生成它的是 node .claude/skills/x-harness-dev/scripts/harness.js --action=review-brief --plan=需求名)。
⑤ 复盘结论入账之后:再跑同一条接力命令,三步跑到打印「可以弹验收题」。弹之前主控把这条需求对待立项目清单的改动写进题目正文(第四节);验收设成代签的需求不弹题,X大脑 核完验收区证据后跑代签命令(「验收谁签与代签」)。验收完结那句回话里列出的遗留,由主控定去向,不挡归档。
⑥ 发布:完结之后经主控排窗口,请运维经理发布,授权照「谁来发布、授权怎么算」(阶段五)。
⑦ 收尾与清理归档(与发布的先后由主控排):验收完结之后跑一次接力命令 node .claude/skills/x-harness-dev/scripts/harness.js --action=run --plan=需求名:它刷新收尾单、预览清理归档,没人在跑床或建站就直接归档,收尾单交主控把原文转给用户;停在预览就照回话办;复盘与去向在后台办,不挡。清理归档也可以手跑 node .claude/skills/x-harness-dev/scripts/harness.js --action=wrapup --plan=需求名(带 --execute 真做;手跑不看有没有人在跑床或建站)。需求名写计划的目录名。
⑧ 治理站点与提交:站点在它完结之后发过一次、再跑一次发布登记 node .claude/skills/x-harness-dev/scripts/harness.js --action=record-release 才算已发布,可以攒几条一起发,但发完才轮到提交,同一单元的下一条要等它提交完才能开工;环收尾之后主控跑提交命令 node .claude/skills/x-harness-dev/scripts/harness.js --action=commit --plan=需求名(不带 --execute 只预览),提交完项目经理拿结案报告(--action=loop --plan=需求名 末尾印出)转 X大脑,之后才关这位产品经理的会话。
随时查走到哪:node .claude/skills/x-harness-dev/scripts/harness.js --action=loop --plan=需求名(只读;不带 --plan 列出每条需求各一行);接手一条在办的需求用改派命令(阶段二)。
有四条不必跑:封版不必先预演(直接执行也是先核后写);派复盘之前不必单跑核对命令;封完版不必再跑固定检查;治理站点平时不必建(发布之前必建)。
动了本页的节或锚点,要同批重建站点:本页的节名、节锚点、阶段的锚点与小标题写死在治理站点构建器的名册里、站点床逐字钉着;每个阶段恰好一句以加粗的「这一阶段做什么」打头的简述,由构建器照这几个字取;动它们的需求同批改构建器与站点床,并重建一次站点确认不报错。
换电脑清单
项目文件夹自带一切:换电脑时把整个项目文件夹(连隐藏的 .git 和 git 不管的区)拷过去,照下面四块装好工具、登好账号、做完几件事,就能接着干。代码、配置、账里不写死项目外的路径;必须留在项目外的只有三类,第四块写明;另有过渡期的账本备份,见第二块。
第一块 新电脑上先装好这些(一次性):
- Node.js
- 当前这台是 22.18.0,以
node -v为准(仓根package.json钉住 22.x),自带 npm(当前这台是 10.9.3);要在系统路径里。 - pnpm
- 当前这台是 9.15.9,以
x-core/package.json里钉的为准(后台x-admin和内核x-core用)。依赖仓库按新机的默认位置装,不拷旧机的。 - 云开发命令行 tcb
- npm 包
@cloudbase/cli,当前这台是 2.9.8,以tcb -v为准;装好后登录一次。 - Python
- 当前这台是 3.12,两个第三方技能用。
- Git 和它的本机设置
- 装好后设四样:
safe.directory、提交人(user.name、user.email)、凭据(credential.helper = manager)、换行(core.autocrlf = true,和现在这台一致)。 - Claude Code
- 装好后在用户级设置里设两项:自动模式(
permissions.defaultMode = auto)和跨会话消息(crossSessionInbound = accept);这两项只认用户级设置,项目里设不了;后台会话一律免确认模式,用户设置里的免确认开关也要开着。第一次打开项目点「信任」;云开发 MCP 的授权点一次。 - 连 Claude 的通道(x-vpn、x-proxy)
- x-vpn 把
claude这个启动命令写进本机的 PowerShell 启动文件,里面写着项目路径,所以新机要在项目文件夹里重跑一次 x-vpn 里的install.ps1。x-proxy 里是代理程序claude-code-proxy.exe,在仓里、跟着文件夹走;它的配置和账号授权放在用户目录的.config/claude-code-proxy/下,不在项目里,新机要用的话照仓根的CODEX-IN-CLAUDE-CONFIG.md重做(眼下用的是 Claude,暂时不用就跳过)。 - 微信开发者工具
- 做小程序预览和上传时用;仓里的脚本不调用它。
- Windows 的长路径
- 项目根路径别太长:仓内最长的路径近 200 个字符(归档里的旧备份文件),加上根路径要在 Windows 默认的 260 个字符之内,所以根路径别超过 60 个字符;有条件就把系统的长路径开关打开。
第二块 拷文件夹时一起带上(别用 git 克隆代替拷文件夹:下面有几样 git 里没有):
- 整个项目文件夹,连隐藏的
.git:克隆出来的换行由新机的设置决定,会和内核清单记的指纹对不上,所以拷整个文件夹。 - 施工区
x-test/zz-work/:还在办的需求的副本和备份在里面。拷之前先清掉停滞区(办完的需求留下的区,用命令删就行),免得把一个个整仓副本也搬过去。别用git clean -xdf:它会把全部施工区连同换入前的备份一起清空。用--git造的副本,.git/objects/info/alternates里写的是旧机上真仓对象库的路径,到新机要改成新路径(重新造一份更省事)。 - 记忆文件夹:已经入库,跟着项目走,放在主控线的目录里,具体位置写在主控线的总账里;随项目文件夹一起拷,不用另带。
- 代签设置文件
.claude/sign-settings.json:入库,随仓走,不用另带;换电脑后读到的就是上一次的值。 - 本机才有的几个文件:
.mcp.json(云开发 MCP 的启动定义,里面有明文密钥,别发给别人;项目设置里批准的云端工具服务名 cloudbase 对着它,新电脑上要重新配成同名)、仓根的.env和x-admin/.env.local、发布档案目录x-release/(回滚用的底本,丢了就没有底本)、本机设置.claude/settings.local.json(记忆位置写在这里,已写进忽略清单;里面是旧机的路径,拷过去按第三块改)和后台目录自己的x-admin/.claude/settings.local.json。旧参考案例x-demo/可以不带。 - 项目外有一样必须一起拷(等账本备份搬进项目那一步做完就不用了):用户目录里守卫的账本备份,
C:\Users\你的用户名\.claude\harness-mirror\E-myDream-x\。这个文件夹的名字由项目路径算出:路径里每一段连续的非字母数字换成一个「-」。项目放的路径变了,名字要跟着改,否则守卫判「账本被改过」,写前一律拦。 - 不用拷的:
node_modules(pnpm 的链接指回旧机,拷了是坏的)、各端的dist和.cache(构建产物)、miniprogram_npm(母本包物化出来的)、Claude Code 的会话记录。
第三块 新电脑上做这几件事:
- 在仓根、
x-admin、x-core各装一遍依赖。 - 物化移动端母本包:
node x-core/tools/mobile.js --materialize --end all --backend weapp。 - 登录 tcb;打开项目时点信任、云开发 MCP 点授权。起后台会话之前,仓目录要先在 X大脑 的窗口里信任一次(新目录、新克隆都算新工作区)。
- 重新起四位常驻:X大脑 先登记主控,再用会话命令的发起子动作按固定名字起项目经理、运维经理、产品架构师、Harness架构师,到 agent view 里看齐。会话登记册(
.claude/tmp/sessions/,不入库)只在本机有效,拷过来的会话号在新电脑上都不存在,不要照它恢复;仓里和用户目录里的两份都坏了,用户在 X大脑 的窗口说「会话登记册:重建」,再用重建子动作按名字重建。 - 云端工具服务(
.mcp.json里配的 cloudbase)要起得来:它用 npx 现拉最新版,第一次要联网下载;后台会话开机最多等 90 秒(发起命令带了MCP_TIMEOUT);开机可能超时,后台会话没人点/mcp,见「运维经理的云端工具连不上怎么办」。 - 设一次记忆位置:在本机的项目本地设置
.claude/settings.local.json里写autoMemoryDirectory,值是主控线总账里写明的那个记忆文件夹的完整路径(盘符开头,项目放在哪,路径就是哪)。设完新开一个会话,问它「你的记忆文件放在哪个目录」;答的不是这个位置,就把这一项改放到用户级设置~/.claude/settings.json(它对本机所有项目生效,只在这台机器没有别的项目时用)。 - 跑一遍体系体检,看各层是不是都绿:
node .claude/skills/x-harness-dev/scripts/harness.js --action=audit。
第四块 必须留在项目外的三类(各写理由):
- Claude Code 平台自己的目录
- 会话记录、会话临时目录、用户级设置、信任与授权。平台管的,里面有明文、量又大,搬不得也不该搬;换电脑后旧会话看不到了,要看结论靠计划目录里的看板和需求履历。
- 本机装的工具与账号登录态
- node、pnpm、tcb 和它的登录、python、git 和它的本机设置、微信开发者工具、x-vpn 写进 PowerShell 启动文件的那一行、代理程序的配置与授权。装在系统里、带着账号,只能在新机重装重登。
- 只活一次运行的东西
- 测试临时搭的假仓、运行器的锁与输出放系统临时目录、跑完即删,假仓到「测试用工作树」那一步搬进项目;云函数上传包永远在项目外 —— 云开发的打包器按忽略清单剥掉
sys/,放在项目里发上去的就是缺了内核的包 —— 用完即删。