全域文件体系基本法
C:/Users/xub/.workbuddy/spec/2.基本法/全域文件体系基本法_V2.4.0_2026-10-19_0952.md版本 V2.4.0(2026-10-19 修订:M5.4 废止双盘自动同步/自动备份,改人工定期备份;锚定宪法升 V1.3.0)|发布 2026-09-20|实施 2026-09-25|现行有效
效力层级(宪法第3条):宪法《全域任务脑手架构宪法_V1.3.0》> 本基本法 > 行政法规(MEMORY.md/分项技术标准/SOP/范式)> 地方法规(工作区级规范/台账场景映射)> 地方规章(任务夹级临时规程)。下位与上位冲突以上位为准;与宪法冲突以宪法为准。层级口径唯一以宪法第3条为本体,本文不重复列举。
分管边界:宪法管「任务链路」;本基本法管「文件」(命名/排版/场景/交付/留存/分级/工作流/记录)。宪法已规定的角色、四条红线、回路熔断、终止汇流排、降级、链路经济性、施工验收与缺陷分级七类,本文不重复承载,一律直接引宪法条号。
适用与基准:适用于 WorkBuddy 全域受控文件(技术标准、规范、SOP、范式、报告、设计文件、管理文档、科研文档)及 AI 生成文件;公众号三件套排版独立豁免(M13 EX-1)。成文格式以《MASTER RULE · 技术标准成文规范》V1.1.0(范式 M01,STD 九组 87 条)为唯一基准。
精简口径(2026-09-19 炳哥裁定):本文为自包含压缩本——命名、排版、场景、交付、分级、工作流、记录与指导方法论全部规则均在本文内,可直接单件执行。历史细则与模板字段定义按需装载原基本法全本(_archive/旧版_2026-09-19/),历史可选模块按需装载原基本法全本,默认不装载(宪法第34条第5项)。
目次:第一篇 总则 | 第二篇 文件规则 M0–M6、M8、M13(含 M5.8 输出与执行契约) | 第三篇 工作流准则 W1–W3、W5–W6 | 第四篇 指导方法论 G1–G6 | 第五篇 记录规范化 R0–R1 | 附件清单(已删除,历史内容按需装载原基本法全本)
第一篇 总则与上位法
1 目的与治理分工
1.1 目的 建立全域文件从创建、命名、排版、校核、审批、发布到归档/作废的统一技术标准,提升跨项目可读性、检索效率与自动化治理能力。
1.2 治理分工 规则做应用底座、工具链做硬闸门、场景做路由入口;每条规则=「触发条件/执行动作/责任人/例外处理/校验方式」五要素,可被机器校验。
1.3 四阶闭环 规则(M/W/G/R)→ 工具链(_tools)→ 闸门(命名/排版/区域/四件套闸)→ 反馈(拦截告警回流规则库与版本清单)。
2 效力与冲突
2.1 裁决序 宪法 > 本基本法 > MEMORY.md 与分项技术标准/SOP/范式 > 工作区级规范与台账场景映射 > 任务夹级临时规程 > 引用国家标准 > 其他规范。下位与上位不一致的以上位为准,并应在下次升版修正。
2.2 不得自备标准 机器闸判据一律取自准据本体(宪法第16条),禁止闸门自备标准。
2.3 管理 标准委员会负责本基本法的制定、解释、修订与培训;每年至少一次符合性评审。
3 术语与模态词
3.1 模态词(RFC 2119) 必须/禁止=强制;应=推荐(偏离须记录理由);宜=建议(不采用宜说明原因);可=许可(表能力用「能够」)。未标注者一律视为「必须」,违反即不合规。
3.2 核心术语 UUID=全生命周期不变标识;版本号=V主.次.修订;受控文件=已分配 UUID、命名合规、进入正式工作流的文件;任务夹=<三字标题>_<YYYY-MM-DD_HHMM>(含 产出/、素材/);四件套合一(Class B)=技术规范要求、摘要、变更履历、版本清单合并的离线可运行单件 HTML 报告;区域路由=按动作类型强制分配物理盘的硬闸;权威盘=C:\Users\xub\.workbuddy(唯一可写 SSOT);台账=全域更新逻辑图_映射台账(场景-技能-规范映射唯一权威);文件状态=生命周期状态码(W1);载体收敛=独有能力为零时能力并入承接方并注销原载体的治理动作(以 skills_registry.json retired 区为准)。
第二篇 文件规则
M0 总则与治理
M0.1 冲突解决 同 2.1;MEMORY.md、台账或分项标准与本基本法不一致的以本基本法为准;与宪法不一致的以宪法为准。二者均应在下次升版修正。
M0.2 审计 KPI KPI-1 命名合规率 ≥95%(月度;分母=新建/修订/流转受控文件,不含已填 R3.1 的迁移期历史文件);KPI-2 月度流程错误率 ≤2%(分子=违反状态机/命名/必填项的强制校验事件数,分母=当月 AI 执行日志事件数);KPI-3 按期归档率 ≥90%(月度)。责任人=标准委员会或质量审计岗/标准委员会/归档管理员。
M0.3 体系版本管理 升版必须:更新版本号与修订日期;同步 spec/3.行政法规/范式/ 相关范式;更新 skills_registry.json 记录;发布四件套(M5.2)并按宪法第48条落位归档。升版留痕外置:实测锚点、首例落地、三原则校验、同步清单与一切订正说明必须写入当次任务夹 产出/ 与冻结历史版,禁止进入正文;违者按宪法第40条处置。
M0.4 管理承诺 同 2.3。
M0.6 场景隔离(S10 触发范围) 生效判据以 _tools/scene_gate.json 的 effective_status 为单一事实来源(非 active 时每任务结束即收尾)。仅场景B触发 S10(治理流:skill/专家升级、升版、迭代、训练、知识注入、订阅源训练、规则库写回、四件套生成、权威库发布、宪法/规范修订);场景A禁止触发(通用执行流:公众号写作、报告生成、排版、画图等未改变治理资产的日常交付)。判定优先级:①用户显式意图词 > ②脚本指纹 > ③落盘指纹 > ④skill 路由节点;全缺失默认场景A;混合会话以最后一轮实质动作所属场景为准。令牌 S10_FORCE/S10_OFF(仅 active 态生效)。执行点=settings.json → hooks.Stop 审查器第 0 步。五款逐项全文见 spec/3.行政法规/SOP/S10_任务收尾总结SOP.md。
M0.7 业务交付铁律(索引) 十条——第1条 三字标题命名与存量整改|第2条 HTML 交付自包含与版式统一|第3条 单文件可视交付三闸校验|第4条 专家与 Skill 评价|第5条 公众号成文查重降重|第6条 项目立项 PPT 蓝本克隆生成|第7条 产业链公司映射四要素补录|第8条 产业链设备解构与 BOM 成本构成|第9条 理财专家输出治理与实现状态透明|第10条 异源双模校核体系。细则见附1,引用任一条时必须装载附1。
M1 基础定义
M1.1 角色与职责 CRE 创建编辑(读写 draft)/CHK 校核(读+校核记录)/REV 审核(读+审查记录)/APR 批准(读+批准)/ARC 归档作废(读+状态变更)/STC 标准委员会(规则制定与审计,全权限·审计只读)。
M1.2 脑手分离映射 脑=K3→定标/裁决/根因诊断,不施工,对应 STC+REV;手=DeepSeek→按标施工/返工,不定标,对应 CRE;本地=机械闸→零 Token 机械判定、零自备标准,对应 CHK;人=炳哥→确认/裁决/放行/宣布,对应 APR;混合=跨层必声明,对应 ARC。本表为职责边界映射而非等同;最高约束=宪法第16条四条红线。
M1.3 分类与编码 受控文件必须分配 UUID、遵循完整工作流、命名合规;非受控文件不分配 UUID,不得进入正式流程。编码=场景代码-年份-序列号(如 DES-2026-001)。
M1.4 格式与工具链 Word→.docx 且须符合 M3;Excel→.xlsx,变更履历与版本清单须含指定列;范式源→.md。工具链(禁止手写路径与文件名):deliverable.py(命名与落盘闸)/check_deliverables.py(整目录扫描)/fourpiece.emit()/skill_upgrade.py(四件套)/region_gate.py(区域路由)/doc_style_check.py(成文风格)/sync_disks.py(~~双盘同步~~ 2026-10-19 起停用,见 M5.4),均在 _tools/。
M2 命名规则
M2.1 通用字符规则 仅允许中英文、数字、下划线、连字符(推荐下划线);禁止空格与特殊符号。时间戳统一 YYYY-MM-DD_HHMM(24 小时制)。版本号格式 V主.次.修订,递增规则见 G4。
M2.2 命名模板
:表题: 命名模板
| 文件类型 | 命名模板 |
|---|---|
| 业务交付物(Class A) | <主题>_<YYYY-MM-DD_HHMM>.<ext> |
| 四件套合一治理件(Class B) | <主题>_<YYYY-MM-DD_HHMM>_四件套合一.html |
| 任务文件夹 | <三字标题>_<YYYY-MM-DD_HHMM>(标题段纯汉字恰三字) |
| 技能/专家/自建(DIY)目录 | V<版本号>_lihengbian_DIY_<中文功能名>(如 V1.0.0_lihengbian_DIY_智能摘要);功能段一律中文题名,不含空格、不含连字符 |
| 技术标准发布态 | <标准名称>_V<版本号>_<YYYY-MM-DD>_<HHMM>.docx |
M2.3 三字标题强制 任务夹标题段必须匹配 ^[一-鿿]{3}$(纯汉字恰三字,禁英文/数字/版本号/连字符/下划线/空格/标点);时间戳必须为 YYYY-MM-DD_HHMM(同分钟重复追加两位秒 _%S),禁省。标题由任务标题凝练(非机械截取),非文章类功能夹取功能名;载体名、版本号、任务描述短语禁止进入标题段。闸门:建夹必须走 _tools/deliverable.py::ensure_task_folder()(内联 assert_title3(),标题非纯三汉字即 raise NamingError),禁止手写 os.makedirs 或绕过该入口;assert_in_task_folder() 同口径复核落盘路径;唯一逃生阀为 WB_TITLE3_OFF=1(受控例外)。存量整改四要件:①可执行改名脚本+同构回滚脚本;②改名日志(产出/_rename_log.jsonl)与落盘核验映射(产出/_rename_verified.json)双留档;③改后复评写入 R3.1;④占用项(WinError 5)不得强改,登记为未处置项并附重试命令与占用归因。豁免清单(明列,禁扩张):结构目录 _tools/scripts/spec/skills/README/dist/output;任务夹固定子目录 产出/素材/图源;隐藏与系统目录 .git/.workbuddy/.sync_snapshots;备份与临时夹 _bak_*/_backup_*/_archive_*/*_tmp/_probe;载体目录按 M2.4/M2.5;顶层子工作空间沿用「利衡辨_XXX」(另案专项裁定)。
M2.4 自建(DIY)技能目录命名 凡由本人或 Agent 自行创建(SKILL.md frontmatter 含 agent_created: true)的 skill,目录名与 frontmatter name 必须一致,一律四段式 V<版本号>_lihengbian_DIY_<功能名>:①版本段 V主.次.补 三段式,新建一律 V1.0.0,升位按 G4;②品牌段固定小写 lihengbian(禁 利衡辨/Lihengbian 等变体);③标识段固定大写 DIY;④功能段必须采用中文题名,不含空格、不含连字符;纯英文原名件或 kebab-case 件必须先定中文题名再落目录,禁止直接沿用英文原名或拼音。配套:frontmatter 三必含 name/description/version,name 必须等于目录名,时间字段用 updated(YYYY-MM-DD)。
M2.5 第三方 skill 转化自建(DIY)强制流程 凡从外部下载并加载成功的 skill,一经在本机落盘并纳入自有体系,即视为「自建(DIY)skill」,必须四步转化,禁止长期保留 skill_<数字ID> 形态或第三方原名:①_skillhub_meta.json 改造——source 置 local-diy,新增 origin_skillId/convertedAt/convertedBy: 利衡辨;②目录更名——skill_<数字ID> 或第三方原名 → V1.0.0_lihengbian_DIY_<中文功能名>(功能段改为中文题名,不含空格、不含连字符);③frontmatter 重写——name=目录名,description 改为「利衡辨_DIY_<中文功能名> V1.0.0 — <能力一句话>……触发词:……」句式,补齐 version: 1.0.0/author: 利衡辨/created/updated/based_on/agent_created: true/allowed-tools;④双端同步——用户级 ~/.workbuddy/skills/ 与工作区 skills/ 必须同名同内容,旧 ID 目录移入任务夹 _backup_*/ 归档,禁止直接删除。
M2.6 标题缺失硬闸 主题名(任务文件夹/交付物主题)缺失或经字符清洗后为空时,生成/封包环节必须失败终止(raise),禁止以「未命名」「未命名_<时间戳>」兜底产出。中间产物(源稿、配图、编译缓存等)严禁直落工作区根目录或个人目录,必须落于任务夹 产出|素材/ 或 _build/ 归档区,任务结束立即清理。
M2.7 命名校验工具 一切命名合规校验必须调用 _tools/deliverable.py 的 assert_naming_ok/save_doc/save_wb,禁止手写文件名;交付前必须运行 check_deliverables.py 整目录扫描,退出码 0 方为合规。
M2.8 受控/非受控判定 受控文件必须满足三条件:已分配 UUID;文件名符合 M2.2 模板;已进入工作流状态(至少 draft)。非受控文件不满足上述任一条件,不得进入正式流程,定期清理(30 天未转受控即删除)。
M3 排版规则
M3.1 总方法论 采用「分级套版 → 模板驱动 → 字段化 → 机器校核闭环」。一切技术标准、规范、范式、SOP 类文档必须使用 GB/T 1.1 国标模式;公众号文章可使用楷体五号模式,但该模式严禁用于技术标准(M13 EX-7)。
M3.2 格式参数(国标模式) 纸张 A4 纵向,上下 2.54cm、左右 3.17cm;正文宋体五号(10.5pt)、1.15 倍行距、首行缩进 2 字符;标题黑体,篇级小二(18pt)居中、章级小三(15pt)、节级四号(14pt)、条目小四(12pt);表格 Table Grid 全边框,表头黑体加粗加浅底纹,表题居上居中、编号如「表3.1」;图居中、图题居下「图 X — 名称」、图号随章连续;页眉=标准名称与版本,页脚=页码域「第 X 页 共 Y 页」;目录必须用 TOC 域自动生成,禁止手敲静态目录;封面必须含五要素(标准名称/标准编号/版本号/发布日期/实施日期/发布机构)并附版本线、适用范围、权威关系、上位关系、待确认事项。
M3.3 技术标准成文母规则(STD 系列) 成文格式类问题以 spec/3.行政法规/范式/M01_MASTER_RULE_技术标准成文规范.md(V1.1.0)为唯一基准,配套自动判定器 _tools/doc_style_check.py;发布前必须运行且 P1 阻断项清零方可发布。母规则 87 条分组与严重度:STD-A 文档命名与版本号(9 条,P1 阻断)/STD-B 章节层级与编号(10 条,P1)/STD-C 论证逻辑链条(15 条,P1·缺图)/STD-D 条款句式与模态词(11 条,P2 整改)/STD-E 术语与定义一致性(8 条,P2)/STD-F 引用与交叉索引(8 条,P1)/STD-G 附录与变更记录结构(9 条,P2)/STD-H 标点与排版体例(10 条,P2)/STD-Z 元规则与冲突裁决(7 条,P1)。母规则高于其他一切成文规则;新规则仅可「扩展」或「细化」,禁止冲突、禁止放宽既有阈值;基线 MD5 篡改即 P1 阻断。
M3.4 排版引擎路由 技术标准/规范→V1.13.0_lihengbian_DIY_jishubiaozhunpaibanzhushou 的 render.py(国标模式);学术论文→V1.0.0_利衡辨_学术论文排版 的 render_thesis.py(模板锚定华南理工大学硕士学位论文答辩终稿 V21,仅限学术论文,其他风格拒绝执行);期刊论文→V1.0.0_利衡辨_期刊论文排版 的 render_journal.py(《电源技术》版式);公众号→lihengbian_DIY_gongzhonghaozhushou(版本以 skills_registry.json 为准)的 build_word.py/build_package.py。
M3.5 量化校验标准 字体、字号、行距、缩进、页边距、表格边框、题注位置必须与 M3.2 一致,由 doc_style_check.py 自动检查(STD-H 全条款)。
M3.6 公众号三件套豁免 公众号排版独立于本 M3 强制校验,由其自身流程保证(楷体五号,10.5pt,行距 1.15,首行缩进 2 字符);命名豁免见 M13 EX-1。
M4 场景定义
M4.1 场景总览 本体系覆盖 6 个一级场景、32 个子场景:
:表题: 一级场景与子场景
| 代码 | 一级场景 | 子场景 |
|---|---|---|
| A | 写文章 | A1 公众号文章、A2 专利(技术交底书/权利要求书)、A3 技术调查、A4 理财调查、A5 财报分析、A6 大论文、A7 小论文、A8 技术报告/策划报告 |
| B | 更新 Skill/专家 | B1 更新 Skill、B2 更新专家、B3 双端同步、B4 新建 Skill/专家 |
| C | 建立工作台 | C1 领域/个人工作台、C2 专题工作台、C3 项目工作台 |
| D | 建立工作流 | D1 工作流搭建、D2 知识库建立、D3 自动化任务与巡检、D4 工具链与脚本建设 |
| E | 文档校核 | E1 技术规范/技术标准校核、E2 算法与文档校核(含排版复核)、E3 标准(GB)校核与电池标准库、E4 交付物合规校核 |
| F | 其他场景 | F1 微云/网盘连接、F2 多端文件体系、F3 文档格式转换/生成、F4 微信封面配图、F5 git 仓库与命名门禁、F6 运维/巡检/杂项、F7 规范库/SSOT 治理、F8 模型与平台兼容、F9 区域路由与双盘治理 |
M4.2 场景映射使用规则 每子场景的详细配置(调用 Skill/专家名称及版本、输出物清单、引用 SOP 编号、引用技术规范编号、关联与复用关系)一律以台账「映射台账」工作表对应行为唯一权威定义,本体系不再重复列出。任务启动时 AI 必须先读取台账确认当前场景完整配置,再执行后续步骤;台账更新时本体系自动同步,无需升版。
M4.3 场景与工作流模板对应 六个一级场景分别对应 W2 定义的场景化工作流(DES/CON/MGT/RND/EMG/AI),子场景继承所属一级场景的工作流路径与分级要求。具体归属由任务发起人按文件内容性质在启动时指定,本体系不硬性绑定。
M5 文件交付与留存规则
M5.1 发布规则 所有发布文件必须经校核、审批(或按场景豁免),终态为 released 或 released_pending(紧急);发布前必须通过命名校验(M2)和排版校验(M3),技术标准类必须通过 doc_style_check.py 全部 P1 项清零;发布前必须将发布态文件同步至权威库 spec/ 相应分层目录,并更新 spec/3.行政法规/文档登记表.json。
M5.2 输出物规则(四件套强制) 凡涉及 skill/专家迭代升版、训练、知识注入,或单份报告/文档(业务交付物 Class A),必须同时产出四件套合一治理件(Class B):技术规范要求、摘要、变更履历、版本清单等合并为离线可运行的单件 HTML 报告。单报告版本清单=本次交付物清单(列:交付物/类型/版本/状态);升级/迭代时为全域登记表快照。生成必须调用 _tools/fourpiece.emit()(输出单件 HTML)或 skill_upgrade.py,禁止手工拼凑;命名须符合 M2.2 Class B 正则,由 save_doc/save_wb 校验后落盘。
M5.3 任务夹铁律 所有交付物必须先建任务夹 <三字标题>_YYYY-MM-DD_HHMM/产出/ 再落盘,禁止直落工作区根、桌面、下载、文档等个人目录;由 deliverable.py 的 ensure_task_folder 与 assert_in_task_folder 硬闸保障;轻量活不豁免。
M5.4 规范盘配置与同步(2026-10-19 修订) 工作区动作落盘路由以宪法第48条为唯一准据。原「全域统一为双盘、自动同步即备份」的口径已废止:①规范件落权威盘 C:\Users\xub\.workbuddy;②任务产物与交付物落发布盘 F:\★WorkBuddy_ReStructuration★\★利衡辨_全域发布★;③全域备份改由人工定期执行,系统不设自动备份作业,sync_disks.py/check_dual_end.py 停用、不再纳入收尾必做步;④不再设训练盘/校核盘落盘路由。
M5.5 技术标准版本保留策略 权威盘 spec/3.行政法规/范式/ 下技术标准 docx 升版后立即删除该主题旧版,仅保留最新版;旧版不归档 .bak,直接删除。校验方式:同一技术标准主题的 docx 版本数 = 1,旧版残留 = 0。
M5.6 训练资料唯一归档区 高级专家、异源双模校核、电池专家等对象的训练资料须归档至各自专用归档区,由 _tools/archive_train_assets.py/archive_battery_assets.py 执行非破坏复制+MD5 校验,禁止手工零散拷贝。每轮训练后必须归档并跑 --check,结果写入场景B任务收尾总结(S10,见 M0.6)。
M5.7 收尾白话呈现(锚定宪法第22条) 任务收尾回给人的那段话必须用日常白话讲清「做了什么、结果如何、还差什么、下一步怎么办」四件事,禁止夹用信息行业专有说法——凡普通读者看不懂的词一律换成日常说法。适用域切分:本款只约束「给人看的那段收尾话」;本基本法正文、其他技术标准/SOP/范式正文、以及机器可读字段(前置元信息、JSON、台账列名、脚本变量等)不受本款限制,仍按各自体例书写。Token 消耗量必须照报(适用域见 M5.8:仅「审计」模式适用),但须附白话注解(如「本次共消耗 XXXXX 个字(Token)」),禁止只甩数字。适用范围:全域一切任务、一切工作区、一切专家与技能,无豁免。禁用词表、写法模板与检查方式见 spec/3.行政法规/SOP/S10_任务收尾总结SOP.md;该 SOP 与宪法第22条不一致的,以宪法为准(2.1 裁决序)。
M5.8 输出与执行契约(简报模式 · 2026-09-25 炳哥定标) 面向用户的全部输出一律按本款执行。本条优先于任何默认风格;用户当次明确指令优先于本条(本条不改变 2.1 与宪法第3条的效力层级,「用户当次明确指令」指放行人的直接指定)。
(一)总原则 只报增量,不重复上一轮;同一信息只出现一次;先结果、后证据,能一句说完不写两句;无新信息写「无」;超限先删再发;用户回「重写」时立即按简报模式重写;语言用中文白话、短句,少形容词。
(二)默认模式:简报模式 总字数 ≤200 中文字符;固定五段,缺一不可,无内容写「无」——结论(一句话说结果)/已完成(事项→结果,带数字)/验证(证据、判据、命令→结果)/待决(事实、选项、建议、影响)/下一步(一句话)。
(三)禁止项 禁止:寒暄、称呼、「收到/好的」、背景复述、过程解释、心理活动、重复、表格、Token 统计、报账口径、附件正文展开、法规与知识文件全文、无关提醒。附件只写文件名、状态、路径、作用;清账报告、任务书只报文件名和状态,不展开正文。
(四)详略切换 默认简报模式;用户说「详报」≤800 字,可给关键证据,但仍禁重复、寒暄、Token、报账;用户说「审计」才允许 Token 统计、报账口径、逐条证据;用户说「重写」立即按简报模式重写。
(五)决策项 需用户定的事只给四项:事实、选项、建议、影响。凡涉「正本/归档/删除/改指路/改法规/改知识文件」等,不擅自定规矩,先摆事实,等用户明确指令。
(六)数据不一致处理 发现两份数据不一致时只列:新/旧、路径、生成时间、关键数字、名称与合规性、机器实际读哪份、说明书或配置指哪份、建议。一份都不动,除非用户明确指令。
(七)执行原则 先查后动,用机器判据核验;改动前留回滚点并报告回滚点位置;不删在用文件、法规、知识文件;不确定归属不擅自处理;完成即复验(问题从 X 变 Y,双端/指纹/残留检查结果);未完成不写「已完成」,写「未完成:原因;需什么;下一步」。
(八)新任务书 只输出可直接粘贴的任务描述:目标、输入、动作、输出、验收、禁止项;不解释背景。
(九)安全边界 删除、覆盖、归档、移动、改配置、改说明书指路,必须先列待决,除非用户已明确说「执行/认新的」。
M5.8 对 M5.7 的适用域裁定(Token 口径) 本条第(三)(四)项禁 Token 统计与报账;M5.7 第四句「Token 消耗量必须照报」据此限缩适用——仅当用户说「审计」时照报,默认简报模式与「详报」模式不报,二者为适用域切分、非冲突。用户级记忆与用户自定义指令中与本款不一致的 Token 报账口径,以本款为准。
M6 文件分级管理规则
M6.1 分级判定标准 A 级(重要):影响跨项目/全组织、强制合规或合同关键交付物、密级机密及以上、失效致重大损失/安全事故/法律纠纷、生命周期 ≥10 年(示例:设计图纸、合同、验收报告、安全分析)。B 级(一般):影响单项目内、内部规范要求、密级内部、失效致工作延误或返工、生命周期 1–10 年(示例:施工方案、会议纪要、周报)。C 级(参考):影响个人或小组临时参考、无强制要求、密级公开、无实质影响、生命周期 <1 年(示例:临时笔记、参考资料、草稿)。若无法确定,默认按 B 级处理。
M6.2 分级与工作流/模板映射
:表题: 分级映射
| 级别 | 最小工作流路径 | 审批节点 | 模板必填字段 | AI 校验强度 | 四件套合一 |
|---|---|---|---|---|---|
| A | draft → check → review → approved → released | 校核+审核+批准 | 全字段必填 | 强制所有校验 | 必须 |
| B | draft → check → approved → released(或按场景调整) | 校核+批准(审核可选) | 关键字段必填 | 关键校验 | 必须(可简化) |
| C | draft → check → released(或直接 draft → released) | 校核(可简化为命名检查) | 仅 UUID、文件名、日期 | 仅命名与存储 | 可选 |
M6.3 AI 校验强度细化 A 级:命名校验(100%)、排版全项(P1+P2)、内容完整性、引用有效性、版本连续性、哈希校验。B 级:命名校验、排版关键项(P1)、内容关键字段。C 级:仅命名与存储路径检查。
M8 变更管理规则
M8.1 变更类型与优先级
:表题: 变更类型与优先级
| 变更类型 | 定义 | 优先级 | 审批路径 |
|---|---|---|---|
| 紧急变更 | 必须立即修复的严重问题(安全、法律、重大功能缺陷) | 最高 | 项目负责人紧急批准,事后 24 小时内补标准流程 |
| 标准变更 | 功能新增、结构变化、结论修改 | 高 | 校核→审核→批准 |
| 微调变更 | 错别字、格式微调、非实质性增删 | 中 | 校核→批准 |
优先级一律采用文字口径(最高/高/中);缺陷分级一律以宪法第40条 P0 阻断性/P1 严重/P2 一般/P3 轻微为准,禁止以 P1/P2/P3 作变更优先级代码(同形异义必生歧义)。
M8.2 变更影响评估维度 变更请求必须评估下列维度,影响评分=范围×严重性:范围为单文件(1 分)/多文件(2 分)/跨项目(3 分);严重性为轻微(1 分)/中等(2 分)/重大(3 分)。评分 ≥6 必须升主版本并通知所有下游用户。
M8.3 变更请求模板(R7) 所有变更须填写 R7 问题报告与改进表单,包含变更原因、变更内容、影响分析、测试结果。
M13 豁免清单
任何豁免仅在满足触发条件时生效,不得扩展解释。
:表题: 豁免清单
| 编号 | 豁免项 | 触发条件 | 生效范围 |
|---|---|---|---|
| EX-1 | 公众号三件套命名 | 公众号助手流程产出 | M3.5(原 M3.6) |
| EX-2 | P0/P1 清零硬闸 | 非 Craft 模式(Ask/Plan) | S10 收尾审查(M0.6) |
| EX-3 | 母规则四篇式/配图/必备附录 | 母规则自身(STD-Z-006) | M3.3 |
| EX-4 | STD-A-009 载体例外 | 范式源 md/README(不适用文件名版本号规则) | M3.3 |
| EX-5 | 安全红线删除例外 | 用户授权+MD5 比对+send2trash | 待 M9 本体登记安全红线条款后另行锚定 |
| EX-6 | 技术标准只留最新版 | spec/3.行政法规/范式/ 技术标准 docx | M5.5 |
| EX-7 | 楷体五号排版 | 仅公众号文章 | M3.1 |
EX-2 适用域说明(对宪法第40条) 宪法第40条「P0、P1 未清零不得交付」为施工交付总闸;EX-2 适用域限于 Ask/Plan 模式下的 S10 收尾审查——Ask 只答不动、Plan 尚未施工,故无「交付」可闸;二者为适用域切分,非冲突。如经裁定为冲突,按 2.1 条以宪法为准并删除 EX-2。
第三篇 全域文件工作流准则
本篇以 MEMORY.md「skill 生命周期统一 SOP」及「启动顺序」为基础。主干:draft 草稿(创建/修订·文件创建者·命名校验)→ check 校核(校核人)→ review 审核(审核人)→ approved 批准(批准人)→ released 发布(发布人·四件套+权威库同步)→ archived/obsolete 归档作废(归档管理员)。
W1 工作流基础模型|W2 场景化工作流定义|W3 并发控制与例外处理|W4 规则版本与系统集成|W5 非受控文件生命周期管理|W6 工作流绩效与审计
W1 工作流基础模型
W1.1 状态定义
:表题: 文件状态定义
| 状态码 | 名称 | 使用场景 |
|---|---|---|
| draft | 草稿 | 所有场景起始 |
| check | 校核中 | 需要校核的场景 |
| review | 审核中 | 需要审核的场景 |
| approved | 已批准 | 需要批准的场景 |
| released | 已发布 | 所有场景终态之一 |
| released_pending | 已发布待补记录 | 仅紧急场景(可被引用但须标记「待补记录」,24 小时内补记录) |
| archived | 已归档 | 所有场景终态之一 |
| obsolete | 已作废 | 所有场景终态之一 |
| withdrawn | 已撤回 | 仅 check/review/approved 可撤回,回到 draft |
| merging | 合并中 | 并发编辑合并时临时状态 |
| ai_pending | AI 生成待确认 | 仅 AI 场景起始 |
| ai_confirmed | AI 生成已确认 | 仅 AI 场景中间态,转 draft 后按分级进入后续流程 |
| ai_rejected | AI 生成已驳回 | 仅 AI 场景 |
W1.2 通用转移规则 所有文件必须从 draft 开始(AI 生成文件从 ai_pending 开始)。发布前必须经过至少一次校核(紧急场景和 AI 场景 C 级文件除外)。超时处理:各节点超时后系统自动向责任人及上级发送提醒;超时 24 小时升级至项目经理或部门负责人;超时 72 小时挂起流程并通知标准委员会。withdrawn 仅允许在 check、review、approved 状态由提交者发起,撤回后回到 draft。merging 由版本控制工具自动置入,合并完成后进入 check 重新校核,并须在 24 小时内发起。released_pending → released:补充校核/审核记录完成后由系统自动触发;released_pending → obsolete:超过 7 天未补充记录,归档管理员可手动转;released_pending → withdrawn:提交者或批准人发现重大缺陷时可发起,经批准人确认后回到 draft。ai_rejected → draft:人工接管修改后直接进入 draft。所有状态转移必须记录审计日志(时间戳、操作人、原因)。
W1.3 并发控制与锁定 编辑前必须签出,其他用户只读。签入哈希比较基准:首次签入记哈希并分配 V1.0;后续签出记录当前哈希为基准;签入时计算新哈希与基准比较——相同则仅解除锁定,不同则提示选择变更类型。已发布文件修订:从 released 发起修订,创建新草稿(继承 UUID,自动分配下一版本号),旧版转为 archived;默认升主版本,仅错别字/格式微调可申请次版本(经批准人确认)。非 draft 状态文件自动锁定编辑权限。
W2 场景化工作流定义
W2.1 场景路径与审批矩阵 每种场景按文件级别(A/B/C)定义状态路径,级别对应的最小路径与审批节点见 M6.2;各场景差异仅体现在审批角色与时限:
:表题: 六场景审批矩阵
| 场景 | A 级审批链 | B 级审批链 | 时限 |
|---|---|---|---|
| DES 设计 | 校核人(技术)→审核人(合规)→批准人(项目负责人) | 校核人(技术)→批准人(项目负责人) | 校核≤2 工作日,审核/批准各≤1 工作日 |
| CON 施工 | 校核人(现场技术负责人)→审核人(合规负责人)→批准人(项目经理) | 同左(省略审核) | 各节点≤4 小时 |
| MGT 管理 | 校核人(部门负责人)→审核人(合规/分管领导)→批准人(分管领导) | 校核人(部门负责人) | 校核≤1 工作日 |
| RND 科研 | 校核人(课题组负责人)→审核人(项目负责人或指定专家)→批准人(项目负责人) | 校核人(课题组负责人) | 无硬性时限,1 周内完成 |
| EMG 紧急 | 全级别同一路径:draft→approved→released_pending | 同左 | 立即处理,批准后 1 小时内发布 |
| AI 生成 | ai_pending→ai_confirmed→draft→check→review→approved→released | ai_pending→ai_confirmed→draft→check→approved→released | AI 生成后 4 小时内必须人工确认 |
C 级路径统一为 draft → check → released(DES 追加 →archived/obsolete;EMG、AI 见上表)。MGT 与 RND 的 B 级依 M6.2 例外条款省略批准节点,以场景定义为准。
W2.2 场景例外处理 DES:允许并行编辑,合并时进入 merging,合并后重新校核;紧急变更可转 EMG 场景;设计变更需重新校核并升版。CON:口头指令可先执行,事后 24 小时内补文件流程。MGT:周报、会议纪要可批量校核。RND:实验记录可采用非受控命名,但需定期归档。EMG:项目负责人可预先指定 1–2 名授权代表授予紧急批准权限(有效期 ≤30 天);紧急发布后进入 released_pending,可被引用但须标记「待补记录」,必须在 24 小时内补充校核和审核记录(A 级须补审核,B/C 级可仅补校核),补充完成后状态自动转 released 并清除标记;24 小时内未补系统持续提醒,超过 7 天归档管理员可决定转 obsolete;下游引用时系统应提示风险。AI:未经人工确认不得用于正式用途;AI 生成后 4 小时内必须人工确认,否则自动标记「待处理」;ai_rejected 后由人工接管修改进入 draft,或直接废弃(转 obsolete)。
W3 并发控制与例外处理
W3.1 并发控制与锁定 同 W1.3。
W3.2 例外处理规则 紧急放行按 W2.5 执行,使用 released_pending 状态。历史文件处理:历史文件首次流转时不强制立即改名,但必须填写 R3.1 历史文件命名差异记录表,并制定迁移计划(最长期限 6 个月);填写 R3.1 后,G1 校核判定中的「命名错误=0」和「版本断裂=0」不适用,以 R3.1 替代 R3;历史文件不参与命名合规率 KPI 统计,直至完成迁移(逾期未完成迁移的文件恢复纳入 KPI 统计,并由标准委员会启动整改)。规则变更迁移:新规则生效后仅适用于新建文件,历史文件保持原规则,可在下次升版时逐步迁移。
W4 规则版本与系统集成(规则仓库拉取与哈希校验、集成冲突优先级、规则优化库评审、一键升版脚本)属未启用基础设施,历史规则全文按需装载原基本法全本(_archive/旧版_2026-09-19/),默认不装载。
W5 非受控文件生命周期管理
W5.1 定义 不满足 M2.8 受控条件的文件:临时笔记、参考资料、草稿片段、实验原始数据等。
W5.2 生命周期 创建:直接保存至非受控区域(素材/ 或临时目录),不分配 UUID,不进入工作流。使用:仅限个人或小组内部参考,不得用于正式交付或下游引用。转受控:必须经过命名校验、元数据补全、审批,分配新 UUID,进入 draft。清理:保存期限不超过 30 天,超期未转受控即删除;归档管理员每月执行一次清理。
W5.3 标识与隔离 非受控文件在文件名或元数据中标记 UNCONTROLLED,与受控文件物理隔离存储。
W6 工作流绩效与审计
W6.1 审计范围与频率 范围:所有 A 级文件、B 级关键文件、全部紧急放行记录、AI 生成文件抽样。频率:每季度进行一次全面审计;月度进行 KPI 指标通报。
W6.2 抽样方法 采用基于风险的抽样方法,从各场景、各级别中分层抽样:高风险场景(紧急放行、A 级文件)抽样比例不低于 10%,其他场景不低于 2%;最低抽检数量不少于 20 条,最高不超过 200 条;若当月日志总数不足 20 条,则全量抽检。
W6.3 审计报告要素 R6 审计报告须包含:审计范围、抽样方法、KPI 达成情况、不符合项清单(引用 R4)、改进建议、审计结论。
W6.4 不符合项闭环 发现的不符合项必须填入 R4-B,指定整改责任人、期限;整改完成后由审计人员验证并关闭。
第四篇 全域文件指导方法论
G1 校核方法论
输入:待校核文件、命名检查单(或 R3.1 历史文件差异记录表)、技术依据、关联文件。步骤:①命名合规检查——调 _tools/check_deliverables.py 或 naming_audit.py 机器扫描,常规文件命名错误=0,历史文件以 R3.1 为准并检查差异记录表是否填写完整;②内容完整性检查——比对 M6 分级模板必填项,缺失项=0;③技术正确性检查——核验引用规范版本、计算公式、数据来源是否有效;④格式一致性检查——调 doc_style_check.py 校验排版参数(A 级强制全项,B 级关键项,C 级仅命名);⑤版本连续性检查——检查版本号、UUID、文件哈希链是否连续(历史文件版本断裂豁免);⑥填写校核记录表(R2),记录缺陷项与结论。判定标准:常规文件 命名错误=0、重名未处理=0、缺失项=0、技术错误=0、格式问题≤3 处、版本断裂=0;历史文件 命名错误和版本断裂豁免但 R3.1 必须完整(含迁移计划)。结论:通过/不通过(附缺陷清单)。
G2 审查方法论
输入:已通过校核的文件、校核记录、相关合规要求。步骤:合规性检查(是否符合法律法规、公司制度、合同要求);完整性检查(是否覆盖所有必要要素);一致性检查(与其他相关文件是否矛盾)。判定标准:严重不符合项=0;一般不符合项≤2 且已制定整改计划;不符合项在 R4-B 中逐行记录。输出:R4-A 审查主表 + R4-B 不符合项子表。
G3 命名方法论
哈希算法:全文统一使用 SHA-256(对文件正文内容的规范化纯文本计算,去除所有元数据、排版信息、页眉页脚、批注),摘要长度为 64 位十六进制字符串。命名正则:M2.2 定义的 Class A/Class B 正则,由 deliverable.py 维护为唯一真相源。命名校验:必须通过 deliverable.assert_naming_ok,否则拒绝落盘(save_doc/save_wb 抛 NamingError)。文件夹命名:任务夹由 ensure_task_folder 自动生成,禁止手工拼接。历史文件处理:使用 R3.1 差异记录表替代 R3,并在命名合规率 KPI 中豁免。
G4 版本控制方法论
版本号规则:主版本(主.0.0)=重大技术修改、结论改变、结构变化、影响下游文件;次版本(主.次.0)=新增功能、知识、能力(如新增章节、新增规则);补丁版本(主.次.修订)=错别字修正、格式微调、非实质性内容增删。升级辅助机制:签入时若检测到文件结构重大变化(章节增删超过 30%、关键数据修改),系统提示用户确认是否升主版本。版本登记表:所有 skill/专家版本记录在 ~/.workbuddy/skills_registry.json,为唯一真相源;每次升版必须同步更新,由 skill_upgrade.py 自动完成。升版工具:skill 升版必须使用 skill_upgrade.py,专家升版必须使用 expert_upgrade.py,禁止手工修改版本号;历史版本目录归档为 .bak;技术标准 docx 仅保留最新版并按 M5.5 直接删除旧版,不做 .bak 归档。版本变更记录(R5):每次变更须填写 R5(UUID、变更前后哈希、变更类型、变更说明);哈希计算范围明确为正文内容;格式转换不触发版本递增。
G5 工作流建模方法论
使用状态机模型定义文件生命周期,状态转移遵循 W1.2 规则。每个场景(W2)可定义不同的状态路径,但必须遵守 M6 分级要求。状态图使用 Mermaid 或 BPMN 描述,关键转移(如 released_pending → released)必须明确定义触发条件和操作人。工作流模型中每个节点必须标注:触发条件、责任人、校验方式、时限。
G6 其他方法论
G6.1 模板使用方法论 所有记录模板(R2–R8)必须包含 UUID 字段用于追溯;模板字段分为「必填」与「选填」,必填项缺失即校核不通过;模板版本与体系版本同步更新,变更时须填写 R5。
G6.2 四件套合一生成方法论 四件套合一 HTML 报告由 _tools/fourpiece.emit() 一键生成;主题从任务文件夹名派生,时间戳继承任务夹;单报告版本清单取本次交付物清单(非全域登记表),升级/迭代取全域登记表快照。
G6.3 工具链调用方法论 所有命名、路径、落盘操作必须通过 _tools 工具链,禁止直接文件系统操作;调用前需 sys.path.insert(0, '~/.workbuddy/_tools');交付后必须运行 check_deliverables.py 整目录校验,退出码 0 方为合规。
第五篇 全域文件记录规范化
R0 记录总则
所有记录必须含 UUID、文件名、版本号、状态、时间戳、操作人。哈希校验用 SHA-256,摘要 64 位十六进制。保存期限:A 级关联记录 ≥10 年、B 级 ≥5 年、C 级 ≥1 年。记录不可篡改,任何修改须新增版本并保留前序版本。
R1–R8 记录字段
R2 校核记录表/R3 命名检查单/R3.1 历史文件命名差异记录表/R4 审查记录表(父子表)/R5 版本变更记录表/R6 审计报告模板/R7 问题报告与改进表单/R8 AI 执行日志规范的全字段定义按需装载原基本法全本(_archive/旧版_2026-09-19/),引用任一模板时按需装载历史原基本法全本。闭环 不符合项数量按 R4-B 子表行数计算;审查不通过时主表填「不通过」且子表至少一条记录。发现错误自动入规则优化库(W4.3);月度错误率 >2% 时标准委员会立即评审并触发修订。兜底:当月 AI 执行日志不足 20 条则全量抽检,并在审计报告注明「样本量低于最低抽检数,已全量检查」。
附加模块 新技术适配
AI 生成文件管理 自动标记 AI-GEN,初始 ai_pending→人工确认→ai_confirmed→draft(按级别进入后续流程);遵守 M2 命名并分配 UUID;未经确认不得用于正式用途;不通过转 ai_rejected,人工接管修改后进 draft 或废弃(转 obsolete);若为业务交付物必须配套四件套合一(Class B)HTML 报告。
新兴技术适配 引入新工具或协作方式时评估影响,通过变更流程更新规则;实时协作可简化锁定,但版本记录更频繁。
第六章 附件清单(已删除)
本章所列附1–附3 已于 2026-09-19 对应核二期整体删除并归档至 _archive/附件/(宪法第45条)。本文正文为自包含压缩本;历史细则、模板字段、可选模块按需装载原基本法全本(_archive/旧版_2026-09-19/),禁止全量灌入上下文(宪法第34条第5项)。
宪法 > 基本法 > 行政法规 > 地方法规 > 地方规章