综合治理管家 技术标准

前言

本文件为「综合治理管家」在现役版本 V1.16.0 下的技术标准载体，按《全域任务脑手架构宪法》第 17–23 条规定的六层主干组织， 效力层级为行政法规（skill 载体）。

本文件的上位法为《全域任务脑手架构宪法》与《全域文件体系基本法》；凡本文件出现的义务性表述，其唯一效力来源均为所标注的宪法条号与源章节，本文件不写宪法未规定者。

本文件替代 2026-09-18 归档版（无归档），差异根源是载体已由 V— 迭代至 V1.16.0。

1　范围

本文件规定了「综合治理管家」（V1.16.0）的术语和定义、工作流架构、技术要求、校验方法与交付要件。

利衡辨_DIY_综合治理管家（综合治理管家）：同时承担执行层（长文报告产出，单次全程 Token ≤ 8000 并自动降级）与校核层（法规/架构图/台账一致性校核），并内联四大自治能力——进化引擎（把每次行动/决策/反思复盘为可量化认知资产）、专家载体存活巡检（专家/插件从专家入口消失的三类真根因判定、幂等自愈、可见性先验推演）、五层规范锚定与条款对应关系自动校核（宪法/基本法/行政法规/地方法规/地方规章的失锚、断链、僵尸闸脚本、同题多版本并存体检，只读留痕不改本体）、载体命名合规与存量整改（基本法 M2 判据机器可读化＋第 11 个 checker＋六段施工器，原命名整改件并入）、悬空载体引用校核（已销毁载体的入边闭包，第 8 个 checker）、.bak 全域清扫（scan→report→quarantine→purge 四段式，删除仅限隔离区、干跑默认、配额感知可续跑）。触发词：综合治理、长文分析、资料处理、研究报告生

本文件适用于该载体的加载、执行、返工、验收与升级迭代全过程。

2　规范性引用文件

• 《全域任务脑手架构宪法》—— 管任务链路（上位法）
• 《全域文件体系基本法》—— 管文件（上位法）
• 《全域工作流行政法规》—— 管工作流（同级上位）
• GB/T 1.1-2020 标准化工作导则 第 1 部分：标准化文件的结构和起草规则

3　术语和定义

下列术语和定义适用于本文件。六层主干的定义由宪法第 17 条规定，本文件直接引用。

3.1 脑（K3）

负责定标、裁决、诊断与留痕，不施工。

3.2 手（DeepSeek）

按脑下发的标准施工、返工与落盘，不定标。

3.3 本地机械闸

零 Token 校验实体，退出码非零禁止交付，不自备标准。

3.4 人

负责确认、放行与宣布；闭环宣布权留人。

3.5 六层主干

宪法第 17 条规定的架构主干，由 A 入口层至 F 终结层六级构成。

3.6 一进一出

每个任务一次进入、一次交付，不并发多形态产出。

4　工作流架构

本章按宪法第 18–23 条逐层给出本载体的承载节点。共 29 个节点，层序与条号严格对齐；每层节点均标注源章节，可逐条回查。

5　技术要求

本章汇集载体的定标性要求（脑层节点），全部来自源章节，未作增补。

12.6 规范件库洁净口径（`V1.10.0` 收紧 · 炳哥 2026-10-02 定标 · **常驻口径**）

• spec\ 的定位 ＝ 规范件库，只放两类件 ——
• 常态化禁止入 spec\ 的两类（命中即 P1·待裁，由第 22 闸 spec_layout_check 承接）：
• _archive 亦禁用（V1.10.0 收紧 · 炳哥 2026-10-02 定标） ——
• 判据真源：config.yaml::spec_layout（禁用名单／允许名单／库根）；
• 血泪教训（写死）：

15.3 施工铁律（照做，别改顺序）

• 固定动作链：改权威盘 → 升版 → 发布盘旧目录归档 → 再跑全闸 → 取读数（~~sync_disks 同步~~ 2026-10-19 废止）。
• 读数顺序不可颠倒：闸每跑一次即在权威盘新增 reports\archive\* ＋ 素材\*（都在同步面内）；
• ~~同步前先 --dry-run~~（2026-10-19 废止）：原「凡出现删除项，立即走四列报备、等炳哥放行」。双盘同步停用后本条自动失效；其中「删除类动作仍须四列报备 + 人放行」的纪律由铁律 ⑯／§十四 纪律二独
• 跨盘归档禁用 shutil.move：跨盘 os.rename 抛 WinError 17，归档必须同盘。
• 冻结副本必须进 _archive\：留在被扫目录会被闸判缺陷。

铁律五条（违者禁交付）

• 禁私造 style 段 —— <style> 段必须逐字节等于 assets/统一版式/baseline.css；禁新增、禁追加、禁自创配色与字号。
• 禁自建壳层 —— 出稿起点一律复制 assets/统一版式/template_universal.html，壳层四件（doctype+viewport／.wrap 版心／.docmeta+<dl> 网格头／nav.toc
• 图表必配题注 —— 每张表必配 <caption>、每图必配 figcap；闸门强制计数，缺一即 FAIL。
• 出稿必过双闸，RC≠0 禁交付：
• 母版升版须全系列重刷 —— 禁只改新件不改旧件。

6　校验方法

本章给出载体自带的机械校验点（安全与权限层）。退出码非零即禁止交付。

4.1 S3 前置闸的四重校验

• quality_rules.rules[*].check 必须存在于 checker 注册表；未知名 → 前置闸失败。
• threshold.mode_table 的 min_remaining 严格降序。
• level_map 的 on_fail 取值集合必须覆盖 rules[*].on_fail 所有取值。
• exit_codes.summary.final_order 末尾必须有 default 兜底。
• finding_disposition.yaml 的 rules[*].(checker,dtype) 必须覆盖 dtype 清单全部条目。

5.3 五层规范锚定与条款对应关系校核（`modules/spec_anchor.py`，V1.1.0 新增）

• 定位：对权威盘 ~/.workbuddy/spec 五层（宪法／基本法／行政法规／地方法规／地方规章）做只读体检，核验五件事：① 各载体声明的锚定宪法版本是否等于现行宪法版本（失锚）；② 跨层条款引用（宪法第 N 条）是
• 流水线（五步，全离线）：
• 建任务夹：_tools/deliverable.py → ensure_task_folder('对应核', base_dir, title3='对应核')，产出 产出/ ＋ 素材/。
• 锚定校核：_tools/spec_anchor_audit.py --json-out <产出>/spec_anchor_result.json --html-out <产出>/宪法-法律法规条款对应关系表_V1.0.0
• 结构闸：_tools/html_onefile_gate.py <html>，未 PASS 即返 4，绝不静默放行。

5.6 悬空载体引用校核（`checks/dangling_ref_check.py`，V1.1.1 新增 · 第 8 个 checker）

• 定位：补上「删除动作是单向的」这一缺口。原有 7 个 checker 中，没有任何一个负责「载体被销毁后，谁还在指它」（悬空入边）。
• 与既有能力的边界（不得混淆）：
• 判定数据源：mapping/retired_carriers.csv（治理区，只读）。列：carrier_id,path,variants,retired_at,evidence,note。
• 词形变体铁律：变体必须同时覆盖「裸编号」与「编号＋分隔符」两种形态。
• 扫描面（V1.2.0-r2 已扩）：config.yaml → dangling_scan_roots，扁平 <绝对根>|<根下相对面>，14 面／三盘全层：

5.7 联动更新面校核（`checks/linkage_update_check.py`，V1.2.0 新增 · 第 9 个 checker）

• 「单件归集」覆盖面只判件数，不判集合差集——载体架构图目录（短名/中文名）与
• 镜像面「残留孤儿」是待核线索，不等于错：可能是有意留存的旧版归档。
• 本 checker 对三盘纯读，发现仅登记转人，不改任何载体本体。

5.8 载体命名合规与存量整改（`checks/naming_carrier_check.py` ＋ `modules/naming_rehab.py`，V1.4.0 新增 · 第 11 个 checker）

• 与既有能力的边界（不得混淆）：
• 五 dtype：carrier_name_noncompliant(P1)／carrier_name_drift(P1)／
• 施工器 modules/naming_rehab.py：--task rename（干跑默认集＝s1＋residual）；
• 判据增量定标（炳哥 2026-09-23 签发）：功能段纯拼音连写 >32 字符（无词界）判不合规
• 来源真值：自建件判定＝agent_created: true 或 无 _skillhub_meta.json（无 meta ≠ 违规）；

5.10 M06 规则可校验化 · 七闸（第 12–18 checker，V1.5.0·r2 新增）

• 人工动作（T2 开窗／关窗）：
• 三闸分工不重叠：T1 管交付文档引用、T3 管可执行件（.py）、T5 管规范文档（.md/.txt）——各扫各的面，不重叠计票。
• 自指闭环：本载体自身亦登记于 spec/rule_checker_map.json（M06-Z-001..005 → checker），
• 配套标准：权威盘 spec/3.行政法规/范式/ 下 M06《从规定到校验 · 规则可校验化技术标准》V0.2.2（全量闭环版）。

5.11 载体自证一致性校核（`checks/carrier_selfprove_check.py`，V1.7.0 新增 · 第 19 个 checker · B2）

• 定位：补上「载体说自己是什么，与它实际是什么」这一缺口。18 闸里原没有一闸扫载体自证——
• 判据（八处同版，按字段锚定）：① 目录名版本段 ② SKILL.md frontmatter name: ③ frontmatter version:
• 避误伤硬约束：只读上述锚定字段，绝不做全文串匹配 ⇒ 天然不碰 §3.0 版本沿革表，
• 先证后改实证（2026-09-25）：独立实跑，判 36 个现役载体，咬出 3 条真实自证漂移
• 八处扩面实证（V1.7.0·r2 · 2026-09-25 收官轮 · D8）：锚点由七处扩为八处后，

5.16 版本一致性与登记完整性校核（`checks/version_registry_consistency_check.py`，V1.11.0·r2 新增 · 第 23 个 checker · D1）

• 定位：补上「registry ／ 专家双 manifest ／ R1-R4 索引 四路版本互相打架」这一全闸无感态（一致性交叉核对报告_20261008 主线）。原 22 闸里：carrier_selfprove_che
• 判据（4 类，全 P1·待裁，与 carrier_selfprove 同口径）：
• 判据真源＝config.yaml::version_registry（registry 路径＋专家市场源根＋skills 根＋authority 标记），dtype 处置态见 spec/finding_dispositi
• 避误伤硬约束：缺件不报（如某专家无 .codebuddy-plugin/plugin.json）——只报「说得到、对不上」；退役（*.bak／_archive／_absorbed／skills_superseded）一律
• 与既有能力边界：resolver_path_check（§5.10 第 14 闸）管工具内写死版本 vs registry；本闸管专家/技能登记面本身的一致性，二者不重叠。

14.1 纪律一 · 开工先出方案 ＋ Token 闸

• 脑（K3）在每个任务开工前，须先给出施工方案，并判断该方案的全流程 Token 总量。
• 判据：预估全流程 Token > 8000 ⇒ 优先级请示炳哥，放行后方可动工；
• 口径统一称「Token」（不称积分）。

7　交付要件

本章规定交付物形态、命名与落盘要求，逐条对应源章节。

六、输出规范

• 交付：reports/archive/<run_id>/ 下 报告正文.md ＋ 校核报告.txt ＋ 三份 JSON（差异清单.json／冲突告警清单.json／待裁清单.json）＋ 可选 脑手架构图.svg。
• 留痕：ledger/runs.sqlite（runs/steps/findings 三表）＋ ledger/runs.jsonl（每 step 一行）＋ state/budget.jsonl（每笔 LLM 调用一行）＋
• state/budget.jsonl 每行字段（齐全，缺字段视为坏行 → exit 4）：{"ts","run_id","node","model","max_tokens","tokens","prompt_sha25
• 页脚固定声明（报告正文.md 与 校核报告.txt 末尾必须逐字包含）：
• 报告型四件套（若出 HTML 报告）须过 html_onefile_gate.py：壳层四件 docmeta／nav.toc／main.article／doc-foot，目次锚点对齐正文 id。

13.2 必须交付的一件（V1.6.1 改：两件 → 一件）（缺该件视为未收尾）

• 格式：纯 Markdown（.md）。不要求 HTML、不要求过 html_onefile_gate.py。
• 内容：每个遗留问题逐项给出 ——
• 自包含硬要求：须含角色 ／ 四条红线 ／ 效力层级 ／ 准据绝对路径 ／ 执行铁律 ／
• 落位：项目根 work\，命名 _prompt_<主题>_<YYYY-MM-DD>.md。

15.2 收官标准（终检十条 · 缺一不可 · 未过不得交付）

• [ ] 全闸 p0 = 0
• [ ] 新增 findings = 0（且无静默消失）—— 唯一放行硬判据，不看消除数；
• [ ] ~~双盘 sync_disks.py --verify 逐字一致，删除 = 0~~（2026-10-19 废止：双盘自动同步机制已取消，dual_disk_check／sync_disks.py 停用，本条不再作
• [ ] 版本号四处一致：目录名 ＝ frontmatter ＝ config.yaml::version ＝ SKILL.md 正文
• [ ] SKILL.md 沿革行逐字未动（V1.7.0 轮第 102 行那次授权已用尽，后续不得再改）
• [ ] 冻结件全部落在 _archive\，被扫目录内无 .bak 残留

附录 A（规范性）六层主干与宪法条号对照

附录 B（资料性）载体源清单

附录 C（资料性）未纳入六层的源章节

下列章节不对应宪法第 18–23 条的任何一层，原文保留于载体，此处仅登记不归类。

• 〇、元信息
• 一、上位约束（原文内化，不得省略）
• 1.1 退出码（全 skill 统一，唯一真相源＝`spec/exit_codes.yaml`）
• 二、角色声明
• 三、任务路径（三选一，由 `--task` 决定）
• 3.0 版本沿革
• 3.1 governance 的两条子路径
• 4.2 final 合成
• 4.3 熔断（跨 run，可恢复）
• 五、功能二 · 内联自治子模块
• 5.1 进化引擎（`modules/evolution.py`，原 `V1.0.0_lihengbian_DIY_Self_Improvement`）
• 5.2 专家载体存活巡检（`modules/expert_carrier.py`，原 `V1.1.0_lihengbian_DIY_zhuanjiazaiticunhuoshouhu`）
• 5.5 专家载体巡检「两套程序分家」取证（V1.1.1 登记 · 待裁 · 未收工）
• 5.5.1 载体类工具分工索引（J7 增 · 2026-09-22 · 一次登记，永绝误判）
• 5.4 钩子与定时
• 5.9 .bak 全域清扫（`modules/bak_sweeper.py`，V1.5.0 新增 · 功能六）
• 5.14 报数口径与工具侧改动（B5／B6／B7，V1.7.0 新增）
• 5.15 工作空间残留清扫（`modules/workspace_sweeper.py`，V1.8.0 新增 · 功能七）
• 八、目录结构
• 九、使用说明
• 十、边界自检（五条）
• 十一、长文工作流挂载声明（跨层 · 标准提供方）
• 12.2 全域文件更新 ＝ 同步更新两库（标准数库 ＋ 权威库）
• 12.3 旧版折叠归档（同题多版本 → 只留新版，旧版折叠）
• 12.4 与既有 checker 的分工（不得混淆）
• 12.5 血泪教训（2026-09-21 定名轮实测 · 写死）
• 13.1 触发条件
• 13.3 三条硬纪律
• 14.2 纪律二 · 删除前置四列报备
• 14.3 纪律三 · 收尾只用白话 ＋ 照报 Token
• 14.4 纪律四 · 遗留只出 Markdown 方案 Prompt
• 15.4 版本口径（`r` 修订号记法）
• 15.5 收官轮遗留登记（`D` 档＝载体面 · `E` 档＝专家·工具留痕面 · 2026-09-25）
• 形态适配（本 skill 专项）
• 为何立这条（事故记要）
• 六徽章口径
• 自查口诀（交稿前默念）
• 体裁归属排除清单（G28 §10 · 2026-10-16 炳哥定案）