创建人员:Codex
文件职责:记录管理体系下所有项目、所有 AI、所有事项默认遵守的全局规则。
管理规范/模板:参考 管理系统说明.md 和 体系说明.md;本文件是全局执行规则,不是体系说明书。
引用文件:管理系统说明.md;体系说明.md;体系创建流程.md;全局存储体系.md;全局数据格式.md;common/ai-workplace/AI工作空间创建指南.md;common/pro-doc/需求规范.md;common/dev-doc/编码规范.md;common/exp-doc/实验规范.md;common/exp-doc/实验审核规范.md。
记录方式:本文件为全局规则文档;新增规则默认追加到对应章节,重大口径变化必须保留变更说明,不得静默覆盖历史原因。
全局规范.md 是所有项目和所有 AI 的最高通用执行规则。
它负责规定:
管理系统说明.md 负责解释体系结构;全局规范.md 负责规定执行约束。两者冲突时,以 全局规范.md 为准,并同步修正说明文档。
本文件适用于:
manage_system 下所有项目。规范优先级:
全局规范.md
-> common/<体系>/全局体系规范(项目体系为 common/project-doc/项目规范.md)
-> 项目根目录/项目规范.md
-> 项目本地体系规范
-> 具体需求 / 设计 / 实验 / 执行文档
项目管理员通过项目根目录 项目配置清单.md 决定启用哪些体系。一旦启用某个体系,该体系的 common 规范自动生效。
项目根目录 项目规范.md 只记录项目目标、边界、项目配置入口和项目特殊补充,不重复书写对应体系规范或全局规范已经规定的内容,避免多处重复后产生冲突。
项目本地规范可以补充项目特化规则,也可以在满足全局硬约束和 common 体系硬约束的前提下,设计本地事项流程。全局硬约束和 common 体系硬约束不能被削弱或冲突。
流程优先级按两阶段判断:
如果发生冲突:
common/ 下的需求体系、开发体系、实验体系、数据体系、案例分析体系、运维体系,都是体系插件。项目体系和开发体系是项目创建时默认自带的基础体系;其他体系由项目管理员按需启用。
默认口径:
common/ 是全局能力库。dev/、dev-doc/ 根目录;创建具体目标开发工作区时,只创建 dev/<target>-dev/ 和 dev-doc/<target>-doc/ 目标代码文档区,不再复制第二套开发规范或开发账本。common 全局体系规范和项目本地体系规范。开发体系在未创建具体目标开发工作区前,先遵守 common/dev-doc 全局开发规范。项目管理员必须在项目根目录 项目配置清单.md 中记录:
一句话:common 是插件库,项目根目录 项目配置清单.md 是项目装了哪些插件、谁来做、目录在哪里的清单。
除临时文档外,所有正式文档类文件创建后,文件头部必须包含:
新增正式文档后,必须同步更新所在目录的导读、索引或入口文档。
如果所在目录没有导读或索引,项目管理员或当前执行者应补一个轻量入口,至少说明本目录关键文件和子目录作用。
代码、数据表、图片、压缩包、二进制产物不强制写文件头,但必须能通过相邻 README、manifest、索引表、执行日志或结果包说明追到职责、来源、生成方式和引用关系。
修改文件时必须遵守:
文件改名或移动,按“删除旧文件 + 创建新文件”处理。
必须同步完成:
临时文件必须进入对应体系的 tmp/ 目录或项目约定的临时目录。
临时文件包括:
正式目录只放正式文档、正式代码、正式数据或稳定归档入口。
文本文件默认使用 UTF-8。
PowerShell、Python 或其他脚本读写文本时,应显式使用 UTF-8。
在 Windows / PowerShell 环境读取中文 Markdown 或中文文本时,必须显式指定编码,避免默认编码导致乱码和误读。例如:
Get-Content -Encoding UTF8 <path>
Select-String -Path <path> -Pattern <pattern>
如果需要先确保控制台输出为 UTF-8,可在命令前设置:
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
遇到历史非 UTF-8 文件时:
manage_system 根目录只放:
common/。data/。不得把具体项目的临时脚本、临时结果、业务数据散落到根目录。
common/ 存放通用体系规范、模板和公共资产。
推荐结构:
common/
project-doc/ 项目规范、项目创建、项目审计规范
pro-doc/ 需求、策略规范
dev-doc/ 开发体系、编码、测试、代码审核规范
exp-doc/ 实验规范、实验模板、实验审核规范
data-doc/ 数据存储、数据样本、数据字典规范
ana-doc/ 案例分析规范
ai-workplace/ AI 工作空间创建、角色指派、工作说明生成指南
common/ 下不得写入具体项目专属结论、业务样本、项目路径或历史运行包。
一个项目一个项目目录。
项目目录至少应包含:
项目规范.md项目配置清单.md。项目启用某个体系后,才需要创建对应体系目录。
典型体系目录:
dev/ 开发代码根目录;具体代码放 dev/<target>-dev/
dev-doc/ 开发文档根目录;根级开发账本和规范放 dev-doc/;目标代码文档和方案附件放 dev-doc/<target>-doc/
pro-doc/ 需求文档、策略说明、业务规则说明
exp-doc/ 实验文档
exp-data/ 实验数据和结果包
ana-doc/ 案例分析文档
ana-data/ 案例分析数据和图片
tmp/ 项目级临时文件
开发体系比较特殊:开发角色必须绑定目标体系或目标事项。常见映射是 dev/pro-dev/ + dev-doc/pro-doc/、dev/exp-dev/ + dev-doc/exp-doc/、dev/ana-dev/ + dev-doc/ana-doc/。不得把所有代码直接堆到 dev/ 根目录。
项目启用体系时,应创建本地体系规范。
例如启用实验体系时:
exp-doc/实验规范.mdexp-doc/实验审计规范.md本地体系规范必须引用 common 对应规范,并声明:
所有 AI 的权限跟角色走。
这里的权限是协作约束,不等同于操作系统或工具实际权限。即使工具层面能写某个文件,AI 也必须按角色权限边界执行。
同一个 AI 拥有多个角色时,权限取角色权限并集。
默认角色:
pro-doc/ 写权限,负责需求、策略和业务规则文档。dev/<target>-dev/、dev/<target>-dev/test/、dev-doc/<target>-doc/ 写权限;不默认拥有所有开发子目录写权限。exp-doc/、exp-data/ 写权限。ana-doc/、ana-data/ 写权限。所有 AI 默认拥有项目内所有文件的读权限。
每个 AI 在项目中应有自己的工作空间目录。
工作空间目录必须统一使用 ai-<name>/ 命名,<name> 使用稳定英文名或拼音小写。例如 Andrew 使用 ai-andrew/,Codex 使用 ai-codex/。禁止直接使用裸 AI 名目录,例如 Andrew/、Codex/。
创建 AI 工作空间、分配角色、生成 工作说明.md 和 项目问题反馈.md 时,按 common/ai-workplace/AI工作空间创建指南.md 执行,并同步更新项目根目录 项目配置清单.md、项目执行日志.md 和 项目变更记录.md。
工作空间用于:
项目问题反馈.md 不替代正式审计报告、项目问题记录或执行日志;具体边界按 common/project-doc/项目规范.md 和 common/ai-workplace/AI工作空间创建指南.md 执行。
AI 对自己的工作空间有读写权限。
工作空间内产物如果进入正式事项,必须迁入对应正式目录,并登记到导读、总纲、执行日志或结果索引中。
审核员负责判断事项是否符合目标、流程、证据和规范。
审核员默认可以:
实验审计规范.md、案例审核规范.md、开发审计规范.md、需求审核规范.md。该权限只用于审核流程、审计口径和阻断标准维护,不得削弱全局规范、全局项目规范或 common 体系硬约束。审核员默认不得:
实验规范.md,案例审核员不默认修改 案例分析规范.md。如果审核员必须临时修复工具脚本,应明确标记为“审计辅助脚本”,不能冒充执行方正式产物。
如果确实需要修改被审体系执行规范,应创建独立的规范维护事项,或在 项目配置清单.md 中额外授予体系维护员 / 规范维护员角色;修改必须记录原因、影响范围、证据路径和复审入口,重大改动应由项目管理员或另一个审核员确认。
项目规范.md 规范每个项目根目录必须有 项目规范.md。
项目规范.md 至少记录:
项目规范.md 不应复制全局规范或 common 体系规范正文,只记录项目目标、边界、配置入口和项目特化补充。体系启用、目录映射、角色权限和工作空间记录在 项目配置清单.md;体系内部流程、字段、模板、审核细则应放在对应体系规范里。
所有事项都必须能追踪。正式事项必须完整记录,临时事项可以轻量记录,但也必须留下最小证据链。
事项必须能回答:
事项类型可以包括:
不同体系可以有自己的总纲、设计、执行日志和审计报告,但必须能通过统一 ID 串起来。
所有事项至少应形成证据链。正式事项要求完整证据链;临时事项允许轻量证据链,但不能完全无记录。
正式事项证据链:
来源聊天记录 / 上游文档
-> 事项总纲 / 目标记录
-> 事项设计 / 执行计划
-> 执行日志
-> 中间数据 / 结果包
-> 审计报告
-> 问题记录索引(仅在需要跨轮跟踪或非审计问题进入闭环时)
-> 修复复验
-> 结论回写
关键来源聊天记录必须进入事项背景或被明确路径引用。
如果实际事项和聊天要求不一致,审核员必须指出。
不能只在聊天中解释关键背景,而不落到正式文档。
临时事项最低证据链:
来源 / 目的
-> 执行了什么
-> 产物在哪里
-> 当前结论或是否废弃
临时事项一旦被后续引用、进入交付、影响结论或被纳入正式结果,必须补齐为正式事项证据链。
MB-X 默认遵循“实用、快速落地、小步快跑、避免过度设计”。治理的作用是保护目标、边界和关键证据,不是证明每一个动作都再次获得许可。
审核的目标是发现真问题,不是制造流程负担。
审核员必须检查:
审核员不得把以下问题升级为阻断:
审核员还必须遵守最小充分原则:普通事项由请求者或安排者验收即可;需要独立审核时,以完整事项或实质阶段门为单位,一次给全问题,不逐文件、逐步骤、逐尝试重复审核。
审核复杂事项时,可以拆分审计步骤,也可以使用 subagent,但必须由主审核员整合判断,不得直接转发未经复核的碎片结论。
发现问题时必须先归因。
问题类型:
真 bug 必须至少满足一项:
不应记为 bug 的内容:
需求问题必须谨慎判定。只有需求缺字段合同、口径冲突、主链边界不清、验收规则不清,并足以导致实现分叉或验收误判时,才判为需求问题。
问题记录是非审计来源问题的主记录入口,也是审计问题跨轮跟踪时的索引入口。
审计人员在设计审核、执行审核、复审中发现的问题,主记录必须写入对应审计报告;只有当该问题需要跨轮跟踪、跨事项汇总或后续由非审计角色长期处理时,才在问题记录中建立索引或关联,不重复全文。
非审计人员发现的问题,例如执行者、实验员、案例分析员、项目管理员、开发 AI 或人工同事反馈的问题,主记录写入问题记录;如后续进入审计复核,应在问题记录中引用对应审计报告 ID。
问题记录至少包含:
问题关闭必须有复验。
不能因为“已经改了”就关闭。
如果问题反复出现,应优先检查:
需求文档必须服务实现和验收。
小需求走轻流程;系统需求走完整流程。
需求必须审核通过后才算完成。
轻量代码可以不写完整编码方案,但必须自测和自检。
重型、多模块、长流程或公共能力开发,必须先写代码编写方案,并经过审核员审核通过后再编码。
实验是事项类型。
实验必须有目标、设计、执行日志、结果包、审计报告和结论边界。
是否需要防未来函数,应根据实验目标判断,不得机械套用。
所有 AI 需要使用全局公共数据时,必须先看根目录下两个入口文档:
全局存储体系.md:说明当前有哪些全局数据源、每个数据源是什么、哪些表属于全局公共表、哪些表只是专题研究表、数据库连接口径、数据源之间的关系和使用边界。全局数据格式.md:说明全局公共表和公共文件型数据的字段级 schema,包括字段名、字段类型、主键 / 约束、字段含义和使用注意。默认使用规则:
全局存储体系.md 选择数据源。全局数据格式.md 核对字段和主键,不得凭记忆猜字段。全局存储体系.md 中纳入公共表,必须在事项文档里说明它是临时表、专题研究表、私有产物还是待升格公共表。全局存储体系.md 和 全局数据格式.md,再让其他 AI 依赖该表。全局存储体系.md 的口径执行;不得在新事项文档里复制扩散明文密码。一句话:找全局数据先看 全局存储体系.md,写字段和接口先看 全局数据格式.md。
数据校验必须轻重分层。
主流程只保留核心校验:
复杂校验应放到只读 helper:
不得为了“看起来严谨”不断增加 gate,把主流程拖成验证系统。
长流程必须记录重跑原则:
不得只靠文件存在判断可复用。
半成品、空壳文件、失败包不得被下游当成正式完成产物。
角色窗口处理任务时,必须遵守“主体内容落文档,窗口只展示摘要和证据入口”的原则。
禁止将大文件、大目录、大量搜索结果、批量日志或批量图片内容直接回显到 Codex 会话窗口。
具体要求:
Get-Content -Raw 将大文件完整输出到窗口。rg、Select-String、日志检索、代码检索等操作必须限制输出行数;如需全量结果,应写入 tmp/、readout 文件、证据包、审计附件或正式结果文档。view_image 把大图片载荷写入会话历史。tmp/、evidence package、readout 文件、审计附件或正式结果文档。context window full 或上下文耗尽时,不得未经确认直接创建新 thread;应优先执行备份、摘要、裁剪、审计记录和原 thread 恢复。对用户汇报时,默认先说结论。
正式汇报应包含:
不得用空泛标签代替大白话结论。
不得把“代码能跑”“测试通过”“summary 好看”直接说成“事项通过”。
禁止:
common/ 或全局规范。修改本文件时必须遵守:
dev/<target>-dev/,目标代码文档和方案附件放 dev-doc/<target>-doc/;正式开发账本统一放 dev-doc/ 根目录。全局存储体系.md 和 全局数据格式.md;读数据先找数据源,写字段先核 schema。