这一页是什么

它是什么
这套体系自上而下五层架构里的一层(宪法第三节):业务架构答「做什么、为什么做」,系统架构答「按什么规范写」,项目架构答「怎么一步步做成」,agent 架构答「谁来做」,Harness架构答「凭什么保证做对」。本页写把一条需求从提出做到上线的那条流水线本身:有哪几个阶段、每道关口谁守、证据在哪、守不到什么。
版本单元
project:overview:锚是本页,版本写在页头的 version 标记里,变更历史与锁清单在同目录。需求履历住同目录的 requirements/ 下,是封存记录,不进锁清单。
分工
本页只写当前这一版:这条线是什么、关口在哪、证据在哪、守不到什么。每道关口的机制(判法、时限、字段、命令的细节)只写在架构详图,本页一句指向;改过什么、为什么改,只写在变更历史与决策记录。
从哪读起
要开一条需求,先看第十节「怎么开一条需求」;环有哪十态看第一节「流水线」,每一态下一步谁做见架构详图 §十四。

一、流水线:
一条需求的状态机

一条需求从提出走到上线、收拾干净、提交进库,再接回下一条,是一个环:签字一可以提前签好几份,开得了工就当场开工、开不了就排队,开了工才动受治文件;实施之后到开出验收区之间的机器节点由一条接力命令串起来,只在派复盘那一处停一次。已完结是验收签过字(用户本人签,或照代签设置由 X大脑 代签;这一签同时授权这条需求的发布与提交),已发布(终点)是该发的格都由运维经理发了 —— 两段分开,都要走完。

回到下一条需求 先后由主控排:机器只要求已完结; 业务各格先发再清,治理站点格可以攒着发, 但发完才轮到提交,同一单元的下一条要等它提交完才能开工 治理环(外圈):流程本身要改时 → 改宪法、架构详图、本页并升版 → 回到内环 ① 新需求 X大脑 定流程与档, 项目经理起产品经理会话, 架构师出设计、产品经理写计划 阶段一 需求与设计 ② 签字一 需求确认 你勾清单、复制结论贴回, 或一键签;可提前签好几份; 开得了工当场开工, 开不了排队 阶段一 需求与设计 ③ 实现 开工后,产品经理派执行体 改受治文件 (排队的等开工命令) 阶段二 实施与落地 ④ 测试 检测零红、命中的床全过 阶段三 测试与验证 ⑤ 固化封版 升版、封版;封过的一版才能发 阶段四 复盘与验收 ⑥ 复盘与签字二 独立复盘、三查、你验收完结 (或按设置由 X大脑 代签) 阶段四 复盘与验收 ⑦ 部署发布 运维经理发布、发布登记 阶段五 部署与上线 ⑧ 清理归档 收尾单、搬进归档、 清过程文件; 主控跑提交命令, 项目经理转结案报告 阶段六 收尾与归档 ⑨ 关会话 项目经理关会话、 删登记册那一行; 这一条没提交完, 同一单元的下一条开不了工 阶段六 收尾与归档 环的启动开工的那一刻(单元空着时就是签字一那一刻) 环的收尾已发布与已归档两样都成立的那一刻 你X大脑与常驻会话产品经理与执行体机器运维经理阶段环的启动、环的收尾内环外圈(治理环)

图 1 宏观闭环:实线是每条需求都走的内环,虚线是只在流程本身要改时走的外圈;琥珀色的两格里各有一步要你点头(签字一只能你本人签;签字二你本人签,或照代签设置由 X大脑 代签,这一签同时授权发布与提交)。版本更新在第 ⑤ 格。第 ① 格里 X大脑 定流程与档、项目经理起产品经理会话,架构师出设计、产品经理写计划。内环是九格:排队、开工并在第 ③ 格,提交、结案报告并在第 ⑧ 格。

五条流程与十五条车道

走哪条流程由落点(落点表里的版本单元)定、不由人选(宪法第四节)。Harness、规范、业务三条主流程走本页这一条线(本节的环、第二节的六个阶段),差别只在落点、入口、谁动手、往哪发;运维、分析两条辅助流程不立需求、不进这条线,一改仓里的文件就回到主流程。每条流程分三档,流程 × 档是一条车道,共十五条;每条车道是什么、走哪几步、跑哪些床、复盘几轮、谁来做,见架构详图 §十五「先分级、再选路」的车道表。

Harness 流程
管什么:宪法、框架的机制(检测、守卫、工作流)、项目架构、agent 架构,以及五层怎么写、怎么管
三档:小事(只改文字)、成条的事(改机制,落点里有写保护文件)、难事(改判定口径与流程本身)
走不走这条线:走 —— 每一档都要签字一、封版、独立复盘、三查、验收签字
规范流程
管什么:一份系统规范(设计、条款、判据与守着它的床);动到检测引擎的并进 Harness 流程
三档:小事(只改条款文字)、成条的事(改判据)、难事(新建、删除、扩射程)
走不走这条线:走
业务流程
管什么:一个业务域的需求:数据表、云函数、后台、两个小程序端;官网也随这条(小事那一档)
三档:小事(只改展示)、成条的事(一个功能)、难事(动钱、权限、数据结构,含删功能、母本与内核)
走不走这条线:走
运维流程
管什么:不改仓、只动线上的部署与版本
三档:例行(发已验收完结的东西)、常规(线上数据修正、控制台配置、路由与证书)、紧急(回滚)
走不走这条线:不走 —— 不立需求;往线上放东西照旧要授权、只在运维经理的会话里做,部署门照旧核(阶段五)
分析流程
管什么:只分析、不改任何东西;所有流程的入口,业务的新需求先在这里整理成需求清单
三档:快问、分析与体检、需求整理
走不走这条线:不走 —— 不签字、不封版,产出只落计划目录里的看板

今天靠什么:三条主流程签「确认」那一刻,机器按落点认流程、按七个风险标记算最低档,并按档核条数上限(阶段一);改判定代码的同一时刻只开工一条(阶段二);X大脑 定流程与档时先认车道,运维与分析两条认流程,靠纪律(架构详图 §十五)。

环的启动与收尾

启动:开工的那一刻(当场开工的就是签字一那一刻;需求履历仍在签字一那一刻建出)。收尾:已发布与已归档两样都成立的那一刻;提交排在收尾之后,账本记了「提交」那一笔,这一条占着的单元才放开。会话清空机器看不见,不入态。

十态表

一条需求此刻在哪一态、下一步该谁做,体系守护的 loop 动作一条命令查得到(只读;命令见第十节「一圈最少跑哪几条命令」)。下面只列十个态名;每一态怎样算到了、下一步该谁做什么,只写在架构详图 §十四 的十态表。

未立项
已立项
在办实施
已封版
复盘过
待验收
已完结
已发布
已归档
环收尾

已发布与已归档没有固定的先后(机器只要求已完结,先发还是先清由主控排),环收尾只在两样都成立之后出现。签了字一还在排队的需求算「已立项」,开了工才进「在办实施」,态名不增不减。两个终点别混:已发布是发布状态的终点,环收尾比它多要一样已归档。判每一态只读现成的账、不当场重算;签字作废、账本被直接改过不另立态,在打印里注明(判法见架构详图 §八「环的十态」)。

状态机

一条需求按次序走过八个环节、六个阶段,每个阶段结束处一道关口。状态机图讲关口与证据;此刻走到哪一态看上面的十态表,每一态下一步该谁做见架构详图 §十四。

需求 实现 固化 复盘验收 发布 收尾与归档 提需求 · 计划 实现(在办) 固化 · 封版 独立复盘 验收完结封存履历 发布(各格) 已发布(终点) 清理归档 · 提交 下一条需求开工 阶段一 阶段三 阶段四 阶段五 阶段六 阶段二 实现中 收尾单 → 搬与清→ 更新历史记录并发布站点 先后由主控排:机器只要求已完结;业务各格先发再清,治理站点格可以攒着发,但发完才轮到提交,同一单元的下一条要等它提交完才能开工 阶段六的关口卡下一条的开工:这一条没清理归档、没提交完,新的需求开不了工(签字照记,记成排队) 每一步留下什么证据 签字一账本记下内容编号、签字原话与签的内容(留底);履历(在办)建出;排队的这一笔带「排队」的标、不占单元 开工账本记开工那一笔与开工基线(当场开工的就是签字那一笔) 实现每次写入记写证据、归属到会话;收尾对照计划 封版变更历史记录行与锁清单由封版命令写,锁清单记下「为了哪条需求」 复盘复盘者的结论记进账本,绑签字锁住的内容、范围里的受治文件与过程改动 验收完结先写全履历并封死、指纹进账本,再记完结 发布入库的发布台账一行;履历的发布段逐格追加 清理归档施工区整份删、收尾单随计划整份搬进归档、过程文件清掉、发布段重算 提交账本记「提交」那一笔,版本库里一个提交、一个项目标签 req/需求名 三个「不」 开闸 没签字不许写受治文件 没封版不许发布 没有授权不许发布 开闸跟着签字走:签字一授权,实施中机器放行,完结收回;手动开闸只在急救时用,各阶段写明急救开闸期间哪些关口不在岗 你X大脑与常驻会话产品经理与执行体机器运维经理关口

状态机图:一条需求从提需求到清理归档依次经过的八个环节,与六个阶段的关口 —— 阶段一、三、四、五的关口夹在环节之间,阶段二的关口挂在「实现」那一格下面(实现中),阶段六的关口在「清理归档」之后、接到下一条需求的开工(虚线框);下半部分列每一步留下什么证据、三个「不」与开闸(签字一授权、实施中机器放行,手动开闸只在急救时用)。三个「不」里前两个有机器拦,「没有授权不许发布」里随验收的发布以验收那一签为授权:亲签的机器不核、是纪律,代签的机器核(阶段五)。

二、六个阶段与关口

每个阶段写六样:关口卡在哪、守卫在哪拦、证据记在哪、守不到之处、急救开闸期间在不在岗、守着它的床。每个阶段的小标题下先有一句「这一阶段做什么」,再有一张图(在闭环的哪一格、谁办、机器拦在哪、留下什么),六个阶段之前另有一张泳道图。判法与时限一律在架构详图 §八(需求对账、收尾环、部署门)与 §十三(版本契约)。

你 X大脑 项目经理 架构师 产品经理 机器 你 X大脑 产品经理 机器 运维经理 X大脑 项目经理 阶段一 需求与设计阶段二、三 实施与落地、测试与验证 阶段六 收尾与归档阶段五 部署与上线阶段四 复盘与验收 亲签的验收原话没有机器核 亲签的验收原话:纪律 代授权那条路:机器核 亲签 代签命令 立项和起会话都在签字一之前 1 定流程与档 排先后, 定短名与类别 2 起产品经理会话 经会话命令发起, 握手经 SendMessage 3 立项、请架构师 立项命令自己跑, 从写第一笔计划起 就是办理会话 4 出设计、审计划 业务:产品架构师; Harness 与规范: Harness架构师 5 写计划 含「验收谁签」、 补机器镜像、 跑核对命令 6 弹签字题 核计划与镜像;成条与难事 先过复杂化审查官; 题里带「验收谁签」 与受保护文件那句话 7 签字一 确认 只能你本人签; 几条小事可以一题多选 8 守卫记签字 核档与四个上限;判开工条件 (单元空着、判定代码只办一条、 阶段六的关口):开得了当场开工, 开不了记成排队;写履历、锁内容编号 9 实施并跑一条命令 开了工(排队的等项目经理跑开工命令)后, 执行体改受治文件;受保护文件机器放行; 红了修,从那一步接着跑 11 派复盘官 提示词只是程序 生成的派发表头 12 再跑同一条命令 接着走到验收区 13 验收谁签 亲签:命令说「可以弹」才弹; 代签:逐条核证据写进验收区, 跑代签命令 14 签字二 验收完结 亲签时由你本人签; 这一签同时授权发布与提交 15 守卫记完结 三查全绿才记; 先写全履历 并封死, 再记完结; 只认用户原话 或代签命令 16 转达授权、 排窗口, 验收那句原话,或代签记录; 叫运维经理发 17 发布 先只读查部署门 → 发布前检查(床当场真跑、查全站)→ 构建(加锁)→ 上传 → 发布登记 → 站点格翻成已发布 18 刷新并核收尾单 → 清理归档 19 清理归档命令 核收尾单、 整份删施工区、 搬计划、 清过程文件 20 提交 主控跑提交命令(按项目名提交、 打项目标签、推送) 21 关会话 拿结案报告转 X大脑; 提交之后关会话、删登记册那一行; 机器不核这个时点 10 接力命令 复盘入账之后三步: 三查 → 开验收区 → 收尾单五栏起草, 末尾打印「可以弹验收题」 复盘之前七步: 增量检测 → 按改动跑床 → 规范同步 → 封版 → 固定检查 → 三查 → 生成复盘说明 红了停在哪一步、说为什么;不新增拦人的闸 环的启动 环的收尾已发布且已归档 你X大脑与常驻会话产品经理与执行体机器运维经理环的启动、环的收尾流程纪律、机器不核

图 2 泳道:青色是机器接力的节点,琥珀色是要你点头的,蓝色是 X大脑 与常驻的几位(项目经理、两位架构师)。签字一只能你来;签字二按代签设置由你或 X大脑 来,这一签同时授权发布与提交,设成代签时你只出现一次。图上设计一格:业务的需求归产品架构师,Harness 与规范的需求归 Harness架构师。

阶段一 需求与设计:签「确认」

这一阶段做什么:需求探讨、立项,由架构师出设计、产品经理写成计划。签字一可以提前签好几份,开得了工当场开工,开不了排队。

在哪一格 谁办 机器拦在哪 留下的证据 1 2 3 4 5 6 7 8 9 新需求 签字一 实现 测试 固化封版 复盘与签字二 部署发布 清理归档 关会话 X大脑 定流程与档、 排先后 项目经理 经会话命令 起产品经理会话 架构师 出设计、审计划 合不合设计 产品经理 写计划、 跑核对命令 X大脑 核计划与镜像、 弹签字题 你 签字一 需求确认 机器 守卫记签字 产品经理 开了工才可以写 受治文件 环的启动:开工的那一刻(单元空着时就是签字一那一刻) ② 弹题那一步:题弹出之前核五样 只能领队弹、单选(几条小事合签的那一种除外)、名字对得上一份没完结的计划、 题里有看板完整路径与「签字」页签、签字区是最新的那一道 ③ 记签字那一步:任一样不过,这一笔不记 看板与镜像一字不差、单元认得、短名不重;认流程、算最低档、 定档与四个上限;再判开工条件(单元空着、判定代码只办一条、 阶段六的关口):开得了当场开工,开不了记成排队 ① 签字之前(这一整段):没签字不许写受治文件,命令行只放只读 需求账本:签字那一笔 内容编号、原话、留底、档与认出的车道、办理会话是谁 履历 建出(在办) 你X大脑与常驻会话产品经理机器(守卫、命令)机器拦在这里;最上一带是本阶段管的格

图 3 阶段一 需求与设计:这一阶段管闭环的第 1、2 两格;X大脑 定流程与档、项目经理起产品经理会话、架构师出设计、产品经理写计划、X大脑 弹题、你签字一、守卫记签字;机器拦在签字之前的整段、弹题之前与记签字那一刻;留下需求账本里签字那一笔与建出的在办履历。设计一格业务的需求归产品架构师,Harness 与规范的需求归 Harness架构师。

阶段一的关口核的四个数与办的过程中只点名的两条线,三档各是多少:

小事 签「确认」那一刻守卫按档核,超了签不上 标准3 条 用例3 条 版本单元2 个 其中亲手验2 条 办的过程中超了只点名,不拦 办的时间1 小时 复盘1 轮 成条的事 签「确认」那一刻守卫按档核,超了签不上 标准10 条 用例12 条 版本单元2 个 其中亲手验5 条 办的过程中超了只点名,不拦 办的时间6 小时 复盘2 轮 难事 签「确认」那一刻守卫按档核,超了签不上 标准不设 用例不设 版本单元不设 其中亲手验15 条 办的过程中超了只点名,不拦 办的时间24 小时 复盘3 轮 档由 X大脑 定流程时定,写在机器镜像里 没写档按小事核 签过字之后改档,签字作废 机器拦在这里机器X大脑

图 4 三档对照:数字就是阶段一核的四个数加两条只点名的线(第十节「先分级」);三档各是什么样的事,见架构详图 §十五。

阶段二 实施与落地:只改签过的范围

这一阶段做什么:开了工的需求,由产品经理带执行体照签过的计划动手干活。

在哪一格 谁办 机器拦在哪 留下的证据 1 2 3 4 5 6 7 8 9 新需求 签字一 实现 测试 固化封版 复盘与签字二 部署发布 清理归档 关会话 产品经理(领队) 开工后派执行体 (排队的等开工命令) 执行体 要写一个文件 机器 写前判 执行体 写成 机器 写后记账、 提示落在哪一格 产品经理 这一轮收尾 ① 写前 这个会话不是任何在办需求的办理会话, 不许写 ② 写前(顶层围栏) 文件归框架、规范、项目架构或 agent 架构,而写的会话 不是办着那个单元的办理会话,拦下并告诉它找主控立项 ③ 收尾 落点表之外的改动拦一次; 写进别的会话在办范围的点名、记账 ④ 写保护文件:守卫、检测引擎这类受保护文件,只对办理会话放行它签过的受保护格(四样同时满足) 会话台账:写证据 每次写入一笔,归到哪个会话 会话台账:留痕 每拦一次一笔 三查第一查 按它算范围里与范围外 产品经理、执行体机器(守卫、命令)机器拦在这里;最上一带是本阶段管的格

图 5 阶段二 实施与落地:这一阶段管闭环的第 3 格;产品经理派执行体写受治文件;机器拦在写前(两样)与这一轮收尾;留下会话台账里每次写入的写证据与每拦一次的留痕。守卫、检测引擎这类受保护文件另由写保护拦着,只对这条需求的办理会话放它签过的那几个(第十节「开闸跟着签字走」)。

阶段三 测试与验证:两个裁判都过

这一阶段做什么:检测和测试两个裁判把关。

在哪一格 谁办 机器拦在哪 留下的证据 1 2 3 4 5 6 7 8 9 新需求 签字一 实现 测试 固化封版 复盘与签字二 部署发布 清理归档 关会话 检测:读代码,判写得合不合规 测试:跑代码,判行为对不对 两个裁判,一起经过四个点 改完一批 增量检测、按改动跑床 接力命令的第一、二步 一轮收尾 封版之前 发布当场 (见阶段五) ① 一轮收尾 本会话改过的面,床要对当前内容全过, 红项不让停 ② 执行体停下那道关 执行体写过的文件检测有红项,不让它停 (只查检测;测试留在领队这一轮收尾) ③ 封版之前 检测零红、测试全过才封得成 ④ 发布当场 不认旧记录,当场真跑 (指到阶段五) 测试按内容记账 改了被测对象、测试或上游,旧的「跑过」作废 检测的干净结论 按文件、内容、判据三样记 机器(守卫、命令)机器拦在这里;最上一带是本阶段管的格

图 6 阶段三 测试与验证:这一阶段管闭环的第 4 格;检测与测试两个裁判由机器跑,一起经过改完一批、一轮收尾、封版之前、发布当场四个点;机器拦在一轮收尾、执行体停下、封版之前与发布当场;留下按内容记账的测试记录与检测的干净结论。

阶段四 复盘与验收:复盘过、签「验收完结」

这一阶段做什么:独立复盘,再验收 —— 你亲手验,或照代签设置由 X大脑 代验代签。

在哪一格 谁办 机器拦在哪 留下的证据 1 2 3 4 5 6 7 8 9 新需求 签字一 实现 测试 固化封版 复盘与签字二 部署发布 清理归档 关会话 产品经理 跑接力命令 机器 规范同步 机器 封版 机器 固定检查 机器 三查 机器 生成复盘说明 产品经理 派复盘官 复盘官 对着签过字的 标准逐条判 机器 复盘结论入账 产品经理 再跑同一条命令 机器 三查 机器 开验收区 机器 起草收尾单 X大脑 弹验收题 (代签的不弹) 你 签字二 或 X大脑 代签 机器 写全履历 并封死、记完结 复盘派出之后,勾步骤、改状态栏、填固化对照表、写遗留都不让这一轮作废; 改到签字锁住的内容、范围里的受治文件或签字之后的过程改动(核准一笔)才作废 ① ② ① 封版 检测零红、测试全过、 日期是今天、一次只升一步; 「为了」解析到恰好一条 签过字的需求 ② 派复盘 只能派对抗审查官、 提示词恰好是程序生成的 派发表头;连着三次不过, 产品经理停手,X大脑请你发话 ③ 开验收区 三查全绿、复盘过、 封版都成立才开 ④ 记完结 三查当场重算全绿才记 记录只认用户原话 或代签命令 完结那一笔记着「要提交」 ⑤ 之后 计划目录下的任何一份, 命令删与挪都拦 变更历史记录行与锁清单 记着为了哪条需求 账本 复盘笔与完结笔 三查结果单 履历(封死) 带用时与返工、遗留 你X大脑与常驻会话产品经理、复盘官机器(守卫、命令)机器拦在这里;最上一带是本阶段管的格

图 7 阶段四 复盘与验收:这一阶段管闭环的第 5、6 两格;产品经理跑接力命令、派复盘官,X大脑 弹验收题,你签字二或由 X大脑 代签;机器拦在封版、派复盘、开验收区、记完结与之后的删挪(上排两步用编号小牌对到下面的牌);留下变更历史记录行与锁清单、账本的复盘笔与完结笔、三查结果单与封死的履历。

阶段五 部署与上线:发布前的核对都过

这一阶段做什么:运维经理把改好的发上线。

在哪一格 谁办 机器拦在哪 留下的证据 1 2 3 4 5 6 7 8 9 新需求 签字一 实现 测试 固化封版 复盘与签字二 部署发布 清理归档 关会话 授权(两条路):随验收的发布,授权就是验收那一签 —— 亲签的,X大脑 把验收原话逐字转给运维经理(机器不核); 代签的,X大脑 把代签记录转给运维经理(代授权,机器核);运维经理凭转来的原话或代签记录动手、量大派运维发布专家;不随验收的发布与生产构建仍要用户单次授权 你 验收那一签 X大脑 转达、排窗口 运维经理 只读查部署门 运维经理 发布前检查 运维经理 构建 构建器有锁,不撞车 运维经理 上传 运维经理 发布登记 机器 这条需求的站点格 翻成已发布 纪律,机器不核 亲签的验收原话有没有、 转来的是不是原话、 是哪个会话在发 ① 只读查那一步 这次要发的原料里有没经收尾环 复核的改动,在这里就停, 不走到上传 ② 发布前检查 版本比对(没封、封后改过、施工中都 发不出去;基线之后的每一版要带着 为了哪条需求);床当场真跑;查全站 ③ 上传 上传档案闸 代授权那条路另核: 设置、代签记录、内容指纹 入库的发布台账 站点类发布一行 履历 发布段 本机发布档案 你X大脑与常驻会话运维经理机器(守卫、命令)机器拦在这里;最上一带是本阶段管的格虚线:纪律,机器不核

图 8 阶段五 部署与上线:这一阶段管闭环的第 7 格;运维经理凭验收那一签的授权发布(你签的凭 X大脑 转来的验收原话,代签的凭代签记录),只读查、检查、构建、上传、登记;机器拦在只读查、发布前检查与上传三处,亲签的授权有没有、是哪个会话在发靠纪律、机器不核,代签那条路机器核;留下入库的发布台账(站点类发布一行)、履历的发布段与本机发布档案。图里「授权」那一行是授权的两条路,口径见第十节「谁来发布、授权怎么算」;BOSS 就是用户,X大脑 就是主控。

阶段六 收尾与归档:归档、提交之后下一条才能开工

这一阶段做什么:计划归档,过程文件清掉,按项目名提交进版本库,这位产品经理的会话关掉。

在哪一格 谁办 机器拦在哪 留下的证据 1 2 3 4 5 6 7 8 9 新需求(下一条) 签字一 实现 测试 固化封版 复盘与签字二 部署发布 清理归档 关会话 这一条 下一条 后台收尾(不挡提交与下一条) 复盘经理 写复盘记录 X大脑 定去向 项目经理 记清单与总账 产品经理 跑一次 接力命令 收尾归档 机器 核三样(已完结、 账本没被改过、 履历已封) 机器 核收尾单 机器 整份删 施工区 机器 计划整份搬进 归档、 清过程文件 机器 重算发布段 X大脑 跑提交命令 按项目名提交、 打项目标签、推送 账本记「提交」那一笔 项目经理 拿结案报告转 X大脑, 提交之后关会话、 删登记册那一行 (机器不核) X大脑、项目经理 定下一条需求、 排开工 你 签「确认」 (可以早就签好) 机器 这一条还留在计划目录、或同一单元 上一条没提交,下一条就记成排队, 回话点名先收哪一条、跑哪条命令 环的收尾:已发布与已归档两样都成立的那一刻 回到图 1 的 ① ① 清理归档命令 收尾单不在或缺栏,不搬; 老计划的登记文件有一行没着落,不搬; 施工区本身是联接或不在区里,拒绝 另三样交给机器 施工区整份删,不跟着联接走; 老计划的登记文件照旧逐行核; 跑测试顺手清测试临时目录 ② 下一条的开工 仓里有已完结、计划还留在计划目录的需求, 或同一单元上一条没提交, 开不了工(签字照记,记成排队) 归档目录里的整份计划 带收尾单 账本里「提交」那一笔 版本库里一个提交、一个项目标签 被拦的那一次 账本里记成排队,不占单元、不放行写 你X大脑与常驻会话产品经理机器(守卫、命令)机器拦在这里;最上一带是本阶段管的格

图 9 阶段六 收尾与归档:这一阶段管闭环的第 8、9 两格,并接回下一条的第 1 格;产品经理跑接力命令收尾归档,主控跑提交命令,项目经理转结案报告、关会话,下一条由 X大脑 定、项目经理排开工;机器拦在清理归档命令与下一条的开工;留下归档目录里的整份计划、账本里「提交」那一笔与版本库里的一个提交、一个项目标签。复盘、遗留与发现的去向在后台办,不挡归档、提交和下一条。

四、历史项目与待立项目
(封存记录与暂放清单)

流水线办完一条需求留下两样东西:一份需求履历,是它的封存记录,站点上列在「历史项目」那一组;一张待立项目清单,记已完结的项目留下、经主控决定放到后面的,或用户当场拍板放进来的事与理由。一件事任何时候只在一处:没处理的在待立项目里,处理掉了就跟着办它的那条需求进历史项目。

历史项目:需求履历

待立项目:暂放清单

五、终点与发布状态

一条需求碰到的「格」由它落点表里的单元推出,逐格记在履历的发布段里;该发的格全都翻了,才是已发布(终点)。

四条判法:① 数据表与微信原生包在体系之外发,固定记「在体系之外发」,不算进该发的格;② 发布当时的精确记法只给已完结的需求记「已发布」,在办的需求只把落在它签过字的落点表里的函数目录记进「联调」一格;③ 落点只有业务域、又没有哪一行业务域只改业务设计页的需求不带「治理站点」一格;只改业务设计页说的是业务域那一行的目录至少写了一条、而且条条都落在业务架构目录下(只改域的设计文档、变更历史与锁清单),这一行不按端推格,有一行这样的,需求就带上「治理站点」一格;一条目录都没写的业务域行照旧按端推;④ 一格该发的都没有的需求,验收完结就算已发布。十态判已发布与收尾单第四栏用的是同一份推法;每次跑发布登记都照履历里的落点表重推,已完结的需求不用重签。

业务域
推出哪些格:按它描述的端分格:后台、客户端网页版、师傅端网页版、微信原生包、云函数、数据表;只改业务设计页的那一行(目录至少写了一条、条条都落在业务架构目录下)不推端格,等「治理站点」那一格
怎么判:后台与两个网页版有入库台账,发布当时按锁清单精确记,事后按台账时间与封版日推;云函数没有入库台账,事后只能记「发布无记录」,发布当时由运维经理指明上传的函数目录才记得上;已完结的需求每次重算,把精确记下的版本与它完结时产的那一版比,不同就回「未发布」。
框架、规范、项目架构、agent 架构、业务总览
推出哪些格:一格「已生效」(版本契约的全部单元,业务域除外)
怎么判:落盘即生效,没有「发布」这一步;整条需求还要等「治理站点」那一格。
每一条需求,只有业务域落点、又没有哪一行只改业务设计页的除外
推出哪些格:一格「治理站点」
怎么判:它的履历与改到的受治文档要随治理站点重建、发布才上线。入库台账里最后一条治理站点上线记录的时刻晚于这条需求的完结时刻,才是已发布;两边换成同一个绝对时刻比。
官网源码(落点表碰到)
推出哪些格:一格「官网」
怎么判:官网不归任何单元,只能按台账时间推。

两种记法:发布当时 —— 运维经理发布之后立刻跑一次发布登记,按需求完结时产的那一版记(部署门已保证发的是封过版的那一份);事后 —— 发布登记按入库台账推。判法见架构详图 §八「收尾单与治理站点一格」,取舍在决策记录 ADR-100、ADR-108。

清理归档(验收完结之后的收拾)

清理归档是流水线末尾的一个环节:它不往账本记、不动封死的履历,只把这条需求用过的东西收拾掉,末尾重算一次发布段。阶段六的关口守着它:不做,新的需求开不了工。它与发布的先后由主控排:机器只要求已完结,业务各格先发再清,治理站点那一格可以攒着发,但发完才轮到提交,同一单元的下一条要等它提交完才能开工。

守不到的见第八节「清理归档靠施工区与人跑」「收尾单与治理站点一格」两行;机制在架构详图 §八「清理归档」「清理归档硬控」「项目自带」「接力命令」,取舍在决策记录 ADR-95、ADR-97、ADR-106、ADR-112。

六、版本单元 project:overview

锚
本页 ARCH.html;缺变更历史或锁清单由契约报「缺」。
版本在哪
本页页头 <meta name="version">,与变更历史第一节同一个版本。
锁住什么
设计:本页;内容:无(设计页没有代码)。requirements/** 不进锁清单,否则每签一条需求单元就漂移。
基线
本单元的锁清单记着阶段五关口的基线:每个单元一个截止版本,每一版原样抄下去;阶段五的关口只核基线之后封的版本带没带「为了」(架构详图 §十三)。
封版命令
元治理的统一封版命令,与别的单元同一条;本页没有代码,守着六个阶段那几道关口的是框架的床(各阶段点名)。体系守护的自测读本页(样式形态、节名与阶段名、阶段五「联调」两段等),本页改了它要对改后的内容重跑。
升哪一位
流水线加减一个状态或环节、加减一个阶段或一道关口:升第一位;某一道关口新增硬控或射程变化,或新增一类东西:升第二位;只改说法:升第三位。

七、运营架构的入口

改 bug 也是一条需求,按落点走它的车道、从阶段一进来,流水线不用改;线上回滚走运维流程(第一节)。bug 怎么发现、怎么分级,不在本页。

八、诚实边界

下面每一条,冒号前面是守不到什么,后面是为什么、靠什么兜。各条的细目在架构详图 §八 同名几段的「守不到」。

九、机制在哪
(指向,不抄)

下面每一条,冒号前面是机制,后面是住哪。

十、怎么开一条需求

三条主流程(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大脑 在重开的窗口里跑恢复命令;第一步不能指望项目经理 —— 它自己也在被拉回的名单里。

闲着的常驻不用拉:官方约一小时后把闲着的会话进程收掉,agent view 里显示在「做完」一栏,对话还在,叫一声就从原处接着干;只有项目经理靠自己的定时巡检常醒。停掉本机后台服务(claude daemon stop --any)是用户的动作,不在恢复命令里,第一条续上会把后台服务带起来。演练实测过的是停掉后台会话再恢复:停掉五个会话再用恢复命令拉回,会话号全没变,答得出工具名,记得停之前的对话;不带参数续上之后仍能写主仓;固定句没有进原话账本。没演过的是真重启电脑(第八节「后台会话与恢复守不到的」)。

运维经理的云端工具连不上怎么办

运维经理动线上的东西,靠项目里配的云端工具服务(cloudbase)。它开机时可能连不上:演练里它头一次开机,连接超时(30 秒),整个会话一个云端工具都没有。后台会话没有窗口,没人能点 /mcp 重连;这个服务是本机用 npx 起的进程,启动失败官方不会自动重试。所以分三层,前两层机器自己治,第三层才轮到你动手。

谁来发布、授权怎么算

往线上放东西只在运维经理的会话里做:别的会话要发布向 X大脑 要窗口,X大脑 告诉运维经理发什么、为什么,自己不动手发。小程序包由用户在微信开发者工具上传,不经运维经理。

授权每一次都要有:随某条需求验收而做的发布,授权就是那条需求的验收一签,它同时授权该发的每一格各发一次(出了问题立刻回滚算同一次)。① 亲签的,X大脑 把验收那句话逐字转给运维经理,运维经理以转来的原话为准、照发布技能自己动手、量大派运维发布专家,机器不核。② 代签的(「验收谁签与代签」),X大脑 把代签记录转给运维经理,命令里显式带需求名和「代授权」标记,机器核。验收题的正文列出会发哪几格。没有授权,运维经理不动手;动手之前照「转达的通则」核一遍原话账本。

要用户单次授权的:不随某条需求验收而做的发布(重发、每天的站点、回滚到更早的版本)和生产构建(后台构建、手机网页版装配),用户只对 X大脑 说,X大脑 逐字转给运维经理,单次有效、不跨轮;开发中途的联调上线另可照代签设置由 X大脑 代授权。

框架、规范、项目架构、agent 架构、业务总览落盘即生效;站点在需求完结之后发过一次才算已发布,没发的每次回话点名「待发布」。这几样是纪律 —— 机器拦的是没封版、没测过、版本比对不过的发布(阶段五;第八节「发布归谁与授权」)。

计划放哪

计划目录 .claude/plan/ 下一条需求一个子目录(目录名就是需求名),里面是给人看的看板 PLAN.html 与机器镜像 scope.json,签字那一刻守卫核它们一字不差;另有收尾单 WRAPUP.md。完结之后计划不删,由清理归档的命令整份搬进归档目录;它搬走之前,新的需求开不了工(阶段六)。计划目录下的任何一份,命令行都删不了、挪不走。

主控的临时文件不放计划目录:草稿、探针放平台给会话的草稿目录(那是平台自己的临时目录,丢了不影响项目);要留的写进主控线自己的设计目录。计划目录只放计划自己的东西,以及主控的总账页、总账旁边的待立项目清单、记忆文件夹与分析的产出。放错了收拾不掉 —— 命令行删不了,主控又跑不了自己新写的脚本。纪律,机器不核。

施工区放哪

办一条需求用到的一切临时东西 —— 产品经理的整仓副本、前后对照、探针、换文件前的备份、过程记录 —— 只放这条需求自己的施工区:x-test/zz-work/<需求名>/(需求名就是计划的目录名)。它在项目里、git 不管(忽略清单里 x-test/zz* 那一行盖住它),检测、治理站点、发布、对拍台都不读它。

守不到的:脚本进程里自己写的东西、路径带变量通配的写法、经施工区里的联接或硬链接去写真仓、该放进施工区却放在系统临时目录以外别处的东西,机器不核。这几样靠纪律。要留给复盘和后续步骤看的记录(耗时、前后对比、改坏对照)不放施工区 —— 它归档时整份删;写进计划目录或设计目录。

从哪起

两份模板:.claude/skills/x-feature-dev/assets/plan/PLAN-TEMPLATE.html 与 .claude/skills/x-feature-dev/assets/plan/scope.template.json,所有需求共用。立项时由产品经理在自己的会话里跑体系守护的 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 里没有):

第三块 新电脑上做这几件事:

第四块 必须留在项目外的三类(各写理由):

Claude Code 平台自己的目录
会话记录、会话临时目录、用户级设置、信任与授权。平台管的,里面有明文、量又大,搬不得也不该搬;换电脑后旧会话看不到了,要看结论靠计划目录里的看板和需求履历。
本机装的工具与账号登录态
node、pnpm、tcb 和它的登录、python、git 和它的本机设置、微信开发者工具、x-vpn 写进 PowerShell 启动文件的那一行、代理程序的配置与授权。装在系统里、带着账号,只能在新机重装重登。
只活一次运行的东西
测试临时搭的假仓、运行器的锁与输出放系统临时目录、跑完即删,假仓到「测试用工作树」那一步搬进项目;云函数上传包永远在项目外 —— 云开发的打包器按忽略清单剥掉 sys/,放在项目里发上去的就是缺了内核的包 —— 用完即删。

本页是项目架构的设计页,版本单元 project:overview。变更历史与锁清单在同目录;需求履历在同目录的 requirements/ 下,不进本单元的锁清单。每道关口的机制住架构详图,本页指向不抄。