dsh-crwu-workbench 0.0.10

package/skills/crwu/crwu-audit-public-general-standards/references/03-execution-contract.md

@@ -0,0 +1,89 @@
+# 通用准则公共能力 · 执行契约（本 Skill 本地）
+
+| 版本 | v1.0 | 状态 | 2026-09-25 立规 | 维护 | crwu-audit-public-general-standards |
+| --- | --- | --- | --- | --- | --- |
+
+> 本文件是**本能力自己的、自包含的执行契约**：只保留 `public` 轴通用准则能力真正需要的共同口径
+> （输入边界、执行顺序、条目状态、来源优先级、证据字段、capability gap）。
+> 资产/业务叶子共同约束里的**轴边界、一级根装配与二级选择对本能力不适用**，因此不在此复制。
+> 本 Skill 运行时**只读取自己目录内的文件**，不读取任何 sibling Skill 的文件，也不把它们的文件当作优先级来源。
+
+## 1 调用边界与输入边界
+
+- **仅经 `crwu-audit` router 编排调用**，禁止单独调用；不查询报告记录、不自行获取材料、不重新下载规则。
+- 输入只有三项，缺任一项记 capability gap，不自行补取：
+  1. 编排层冻结的 `route_profile`（本能力只消费 `report_form`、`record_context` 与材料分区，
+     不消费具体专业轴标签）；
+  2. 编排层已准备并隔离的报告、评估说明、测算明细表等材料路径；
+  3. 编排层已验证的**本次** DWS manifest 及其文件路径、`exportedAt`。
+- 不得沿用上一轮下载物、目录缓存或历史摘录充当本次正文。
+- 本能力**不做外部取数**，也不依赖任何外部数据核验能力的规程；交付件涉及外部数据核验结论时只引用编排层给出的回执。
+
+## 2 执行顺序
+
+1. 按 `00-applicability.md` 界定适用范围，不改变编排层已确定的任何轴标签；
+2. **先判规则版本**：新旧两版施行日期不同时，按报告基准日／报告日所属期间选定**整段**引用版本，
+   禁止新旧条款混引；版本无法确定时记录冲突并转人工判断，不任选一版；
+3. 用本次 manifest 验证 `01-kb-assembly.md` 所需文件；缺失项按路径与原因记 gap，对应检查不引用、不编造；
+4. 报告披露层与程序质控层**各自独立**执行、各自独立出条目状态；一层缺依据不影响另一层执行；
+5. 按 `02-review-focus.md` 分别审核报告、评估说明、测算明细表，不以"未发现问题"笼统概括。
+
+## 3 条目状态
+
+命中审核文件后，其中**每一项**必须产生一条状态，不得以"未发现问题"笼统概括。
+
+必检项 / 必检项要点：
+
+| 字段 | 允许值或要求 |
+| --- | --- |
+| `status` | `符合`、`不符合`、`不适用`、`无法核验` |
+| `report_evidence` | 当前报告页码、章节、表格或附件位置 |
+| `rule_source` | 对应来源路径及 RULE/CHK 标识 |
+| `reason` | `不适用`、`无法核验` 时必填 |
+| `finding` | `不符合` 时必填，描述当前项目具体问题 |
+
+历史高频复核问题：
+
+| 状态 | 含义 |
+| --- | --- |
+| `涉及` | 当前报告存在对应风险迹象，并给出本项目证据 |
+| `未涉及` | 已检查，当前报告未出现 |
+| `无法核验` | 资料不足，并列明缺失资料 |
+
+- 来源写有"待补"、`TODO`、空文档时：**登记知识库内容缺口**，不根据标题、经验或历史补造要求，
+  该层覆盖记为不完整。
+- 索引卡类文件**不构成规则条目**，不得作为规则性缺陷的 `rule_source` 依据；模板参考类文件只做格式基线对照。
+- 相同检查点稳定去重，但保留全部 `source_skills[]` 与 `rule_source`。
+
+## 4 来源优先级与冲突
+
+1. 现行法律法规、执业准则和有效监管规则（硬约束）；
+2. 必检项（确保约束与业务要求被完整执行）；
+3. 历史高频复核问题（防止重复发生既往缺陷）；
+4. 审核经验（补充视角，不得降低或覆盖更高层级要求）。
+
+来源冲突、失效或版本不明时：停止形成确定性结论，记录冲突双方与来源，转人工判断；
+不得用低层级经验覆盖准则。历史次数、旧项目名称与案例只用于提示检查方向，**不是当前事实，也不是现行准则**。
+
+## 5 证据字段与出处
+
+- 每条 finding 的出处至少包含：**本次下载文件、实际行号、库内路径、本次运行返回的 `nodeId`、`exportedAt`**。
+- 运行时值（`nodeId` 等）不得写回技能文件。
+- 技能文件只写 RULE/CHK 编号与库内层级路径寻址键，以及基于本次真实读取归纳的要点；**不得逐字复制知识库正文**。
+- 每条 finding 带 `source_skills[]`（至少包含 `crwu-audit-public-general-standards`）、
+  `report_evidence`、`rule_source`、`status`；按报告 / 评估说明 / 测算明细表分区组织，不混写。
+
+## 6 capability gap
+
+以下情形必须留 gap，且**只影响对应检查**，不得让其他可用能力停止执行：
+目录未完整、递归下载失败、空目录、不支持导出的节点、审核文件缺失、内容为占位/待补、
+规则版本不明、来源冲突、报告证据不足。
+
+gap 要写清：缺什么、在哪个库内层级路径、影响哪些检查、需要谁补。
+
+## 7 输出前自检
+
+- 报告披露层与程序质控层是否**各自**有独立条目状态；
+- 版本选择结论（选定版本与依据）是否显式记录，便于人工复核；
+- 必检项是否逐项有状态、gap 是否登记；
+- 索引卡 / 模板参考类是否被误用为规则性缺陷依据。

package/skills/crwu/crwu-dev-audit-optimize/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: crwu-dev-audit-optimize
+description: Use when maintaining CRWU audit rules, checkpoints, routing, assembly, or skills, or when comparing AI audit results with human review feedback; not for issuing audit opinions.
+---
+
+# crwu-dev-audit-optimize（审核能力族 · 维护/优化入口）
+
+> 本技能**不是审核叶子**：不产出任何审核意见、不参与 crwu-audit 分发。它是"按真实反馈演进族技能与
+> 知识库"的总入口：先诊断定位 → 出方案 → **等用户明确确认** → 按方案执行 → 校验回归汇报。
+> 正式审核请走 `crwu-audit`；技能安装机制 / 知识库版本管理 / 钉钉知识库内容打通属外部事项，本技能不处理。
+
+## 脚本运行时（Python）
+
+共享的 Python 运行时安全口径由 `crwu-dev-audit-skill-maintainer/SKILL.md` 的
+**`## 脚本运行时（Python）`** 一节**唯一维护**（本技能不复制第二份，**按名回指、不复述**）。
+执行本技能自带脚本前，按该 owner 的口径取得解释器；owner 不可用（取不到解释器路径 / 缺包）时，
+登记 `capability gap` 并**停止**，不静默降级。
+
+## 何时用 / 何时不用
+
+| 用（触发本技能） | 不用 |
+| --- | --- |
+| 反馈"某检查点/口径错了、漏了、过严、缺依据"，要改审核规则 | 正式报告审核 → `crwu-audit` |
+| 反馈"缺 XX 文档对 XX 文档 / 某业务·对象·形态组合的审核"（路由兜底/空能力） | 发布/试点状态处理 → 无此机制（知识库文档即权威、下载即审） |
+| 审核结果与规则对不上，怀疑装配/索引/路径漂移 | 氚云/钉钉操作 → `crwu-h3yun-*` / `dingtalk-*` 技能 |
+| 想新增对象方向、方法场景、文档分区的审核能力 | 技能安装/同步机制 → 三方维护 |
+| 审核完成后对比 AI 审核结果与人工复核文件，分析仅人工发现项及修复方向 | 仅复述人工意见、不做根因与证据追溯 |
+
+## 铁律与授权边界
+
+1. **先方案、后动文件**：任何修改前必须输出《优化方案》并取得**用户明确确认**；禁止"边查边改"，
+   禁止把方案与执行混在同一轮（模板见 `references/02-方案模板与确认门禁.md`；共享**两阶段修改门禁**见
+   `crwu-dev-audit-skill-maintainer/references/04-registry-and-mapping-update.md`）。
+2. 本技能不产审核判断、不复制规则正文进技能：规则正文只在钉钉知识库（经 `crwu-dws` 实时下载），
+   技能内只写 RULE/CHK 编号 + 库内层级路径寻址键。
+3. 改动只落在**唯一落点文件**并提交源仓（分层落点、红线与执行顺序见
+   `references/00-优化规范与文件落点.md`）；**不得写运行时技能目录**（`~/.skills-manager`、`~/.dsh`、
+   `~/.workbuddy` 等），运行时部署由用户 skills 管理机制负责。
+4. 引用协议：技能正文引用一律写 RULE/CHK 编号 + 库内层级路径寻址键，不写知识库名称、不写本地根路径
+   字面、不写 nodeId；正文经 `crwu-dws` 实时下载后只读引用，文件零缓存。
+5. **知识库只读、修复必须人工执行**：知识库正文只可经 `crwu-dws` 只读下载用于诊断；所有知识库修复
+   计划必须标记 `manual_only`，只输出目标文档、证据、建议修改位置与人工操作说明，**禁止修改知识库**；
+   AI 只能在用户明确批准具体 `FIX-*` 后修改源仓 Skill 文件，批准不得从一次差距分析自动继承。
+
+## 模式选择
+
+- **AI—人工差距分析模式**：已有同一次审核的 AI 结果与人工复核文件时进入；流程与交付见
+  `references/03-AI人工差距分析流程.md`。
+- **常规反馈优化模式**：只有用户反馈或缺口描述时进入；定位、分桶与出方案按
+  `references/01-反馈定位与画像流程.md` → `references/02-方案模板与确认门禁.md` 执行。
+- **受控执行模式**：只有用户明确批准具体修复项后才进入；知识库项始终由用户人工处理，AI 不执行。
+
+## 必读 references
+
+按下列分工理解所有权；详细内容只按名回指，本入口不复述：
+
+1. [00-优化规范与文件落点.md](references/00-优化规范与文件落点.md)：分层落点、红线与 optimize 特有执行顺序。
+2. [01-反馈定位与画像流程.md](references/01-反馈定位与画像流程.md)：输入、五维画像、证据定位和反馈分桶。
+3. [02-方案模板与确认门禁.md](references/02-方案模板与确认门禁.md)：优化方案模板与 optimize 特有授权补充。
+4. [03-AI人工差距分析流程.md](references/03-AI人工差距分析流程.md)：双基线、状态、分层追踪、L/FIX 关系与 HTML 交付。
+
+**共享 owner（跨技能按名回指，不建相对链接，保持安装自包含）**：**两阶段修改门禁**（阶段一：只读方案 → 阶段二：确认后执行）见
+`crwu-dev-audit-skill-maintainer/references/04-registry-and-mapping-update.md`；**校验命令、执行方法与完成判据**见
+`crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md`。这两项只在那两个文件里定义一次，本技能只回指、不复述。
+
+## A–E 根因桶与执行归属
+
+本技能只做**诊断**（"为什么要改、改哪一层"），并**只亲自执行内容层与算法层**的 Skill 改动；
+结构与映射层一律交接 `crwu-dev-audit-skill-maintainer`。
+
+| 桶 | 落点 | 谁执行 |
+| --- | --- | --- |
+| **A 规则/清单内容** | 知识库 `06-规则库/`（精编条目 / `M-*` / `清单-M-*`） | 本技能出**知识库人工修复单**；用户手动修改知识库 |
+| **B 覆盖缺失** | 一级 Skill 的创建与登记 | **交接 maintainer**（`create`） |
+| **C 词表/画像取值** | `00-总纲/治理/标签词典` + router 画像契约 | **知识库部分人工修复**；Skill 部分经逐项批准后由本技能执行，但目标含 classification / registry 三份 owner 文件时**一律交接 maintainer** |
+| **D 技能算法与流程** | 对应叶子 `SKILL.md` + 其 `02-review-focus.md` | **本技能执行**（公共规则改动落规范源，再同步叶子副本） |
+| **E 路径/装配/指针漂移** | 叶子 `01-kb-assembly.md` / registry / classification | **交接 maintainer**（`audit`／`remap`／`repair`） |
+
+每桶给出证据、影响面与最低改动集；**交接不继承修改授权**——维护器仍须先出逐文件方案并取得用户确认；细化与映射规则以维护器 references 为准，本技能不重复定义。
+**classification / registry 排他归口**：一级资产/业务 `03-asset-classification.md`、`04-business-classification.md` 与 `07-skill-registry.md` 的标签、别名、状态、一级 Skill 映射修改，**无论根因来自 B、C 还是 E 桶，一律交接 `crwu-dev-audit-skill-maintainer`，本技能不得自行修改**（交接只含根因、证据与最低改动集）。
+router 的 scope / method / overlay / 并集分发 / 降级与冲突处理等**运行时算法**仍属 D 桶：本技能诊断后、经逐项批准可执行。
+
+## 执行入口
+
+1. **出方案**：按 `references/01-反馈定位与画像流程.md` 定位分桶，按 `references/02-方案模板与确认门禁.md`
+   输出《优化方案》，然后**停下等用户确认**；未确认不动任何文件。
+2. **执行**：仅执行用户明确批准的源仓 Skill `FIX-*`，按 `references/00-优化规范与文件落点.md` 的顺序改
+   文件；知识库 `FIX-*` 只交付人工修复单，不执行、不通过 CLI 写入。
+3. **校验回归**：按 `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md` 的校验命令与
+   完成判据执行，**全过才算完成**；随后汇报文件级改动清单、校验结果与剩余风险。
+
+## 边界与回退
+
+- 方案被驳回 → 记录驳回原因，可缩小范围重提（引用原方案编号）；
+- 执行中发现超范围新问题 → **停下**，回到「执行入口」第 1 步重新出方案；
+- 无发布状态判定与登记机制（知识库文档即权威、下载即审，不做发布/试点状态判定与登记）；
+- 新增审核叶子能力属 **B 桶 → 交接 `crwu-dev-audit-skill-maintainer`**（`create`），本技能不代办；新叶子必须自带"仅经 `crwu-audit` 编排调用、禁止单独调用"门禁；
+- 知识库版本管理、钉钉知识库内容打通、基线脚本、技能安装机制均不在本技能范围。

package/skills/crwu/crwu-dev-audit-optimize/references/00-/344/274/230/345/214/226/350/247/204/350/214/203/344/270/216/346/226/207/344/273/266/350/220/275/347/202/271.md

@@ -0,0 +1,132 @@
+# references/00 · 优化规范与文件落点（改动类型 → 唯一落点）
+
+| 版本 | v0.4 | 状态 | 2026-09-10 本地知识库根模型废止（正文唯一来源=钉钉知识库，经 crwu-dws 按清单实时下载；工具只做引用与实时协议校验） | 维护 | crwu-dev-audit-optimize |
+| --- | --- | --- | --- | --- |
+
+> 本文件把"审核能力族 + 知识库"的维护规范固化成**改动类型→唯一落点**地图：优化动作只许动对应落点，
+> 其余文件禁止顺手改；改完的**校验与验收按 maintainer
+> `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md`** 执行（本文件不复述命令与判据）。
+> 改 crwu-audit 族任何技能前，另须先读 `crwu-audit/references/99-maintenance.md`。
+
+## 1. 引用协议与运行时真身（2026-09-08 实时引用协议；2026-09-10 本地根模型废止）
+
+- **知识库 = 钉钉知识库（crwu-dws 实时下载源）**。技能正文不保存、不缓存知识库正文：引用一律写
+  RULE/CHK 编号 + 库内层级路径寻址键（如 `00-总纲/执行契约/01-调度器-SKILL总纲`、`06-规则库/…`），不写知识库名称、
+  不写本地根路径字面、不写 nodeId；需要正文时经 crwu-dws 按清单实时下载后只读引用
+  （出处 = 本次下载文件:行号 + exportedAt，下载时刻即最新）。
+- **本仓不再有本地知识库根**：`CRWU_KB_ROOT` 与 `KB/<相对路径>` 引用均已废止。技能侧只保留
+  寻址键；是否存在、是否改名一律以 crwu-dws 的**最新目录**为准（本地目录缓存只用于定位加速，
+  不能提供正文）。校验口径 = maintainer 技能的引用卫生 + "三不写" lint
+  （禁知识库名称 / 禁本地正文路径字面 / 禁 nodeId 常量）；**命令、参数与判据见
+  `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md`**，本文件不复制其命令签名。
+- 运行时布局（事实）：技能按**层**组织，DSH 侧随**插件包**发布（一个层 = 一个技能根），
+  其它宿主由 `make skills-install AGENT_DIR=<宿主 skills 根>` 落一份副本。
+  **部署/同步由插件打包与用户执行**：维护者/agent 只改源仓并提交，
+  不直接写/ln/cp/rm 任何运行时目录（校验以部署结果为准）。
+- **校验工具归 maintainer**：引用/实时协议校验工具与映射检查器均属
+  `crwu-dev-audit-skill-maintainer` 技能（随该技能安装），其调用方式与参数只在
+  `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md` 维护一次；本文件只说明"有这两个工具"。
+  装配清单不再由工具生成——下载清单 = 命中叶子的 `references/01-kb-assembly.md`（一级目录根或单文件路径）
+  ＋ 执行契约路径并集，由 crwu-dws M2 实时下载。无工具时按装配表定位引用路径，正文一律经 crwu-dws
+  实时下载后人工核对，**方案必须附手工证据**；下载不可得 → 显式报告。
+- 本技能 references 随技能安装，内容自带寻址键表与落点地图，不回指源仓技能索引（那些文档不随技能安装）。
+
+## 2. 分层地图（改动类型 → 唯一落点）
+
+> **执行分界（2026-09-15）**：本表是"改动落在哪个文件"的地图。知识库相关 A/C 项由本技能诊断并生成
+> `manual_only` 人工修复单，**禁止修改知识库**；经用户明确批准的源仓 Skill D 项可由本技能执行。
+> **B/E（一级 Skill 的新增/改名/结构/一级根/registry/classification）一律交接 `crwu-dev-audit-skill-maintainer`**，
+> 本技能只给根因与最低改动集，不自行改结构（见 SKILL.md §2、§2.1）。
+
+> 文内『KB/知识库』= 钉钉知识库（crwu-dws 实时下载源）：规则/清单/契约等正文只在其内，技能不复制正文；
+> 下表 `00-总纲/…`、`06-规则库/…` 等均为库内层级路径（寻址键），正文需要时经 crwu-dws 实时下载后只读引用。
+
+| 改动类型 | 唯一落点 | 联动 / 红线 |
+| --- | --- | --- |
+| 规则/清单正文（RULE/CHK 依据、判定要点、检查点、新增条目） | KB `06-规则库/`（精编条目 / `M-*` 模块 / `清单-M-*`）＋对应批次 README | 词表先登记；`### <id>` 定义锚点唯一；B/C 禁作硬依据 |
+| 词表/画像取值（dims、modules、report_type、角度、业务主线、场景） | KB `00-总纲/治理/标签词典` ＋ crwu-audit `references/00`、`01` | **先登记后使用**；改动提示部署方复跑 pull_全量画像.py |
+| router 运行时算法（scope / method / overlay classification、并集分发、降级与冲突处理） | crwu-audit `SKILL.md`（§2 分发）＋ 运行时 `references/02`/`08` 等 | 与 design §4 能力树同步；示例路由同步；**本技能**诊断后经逐项批准执行（属 D 桶算法层，非一级标签数据） |
+| 一级资产/业务 classification 与 registry（标签、别名、状态、一级 Skill 映射） | `crwu-audit/references/03-asset-classification.md`、`crwu-audit/references/04-business-classification.md`、`crwu-audit/references/07-skill-registry.md` | **owner / executor = `crwu-dev-audit-skill-maintainer`**；optimize **只诊断与交接**、**不得自行修改**这三份文件（即使由 C 桶反馈触发）；一级标签取值域以 `04-business-classification.md` v2.0 为准 |
+| 叶子审核逻辑/算法/流程（分区、C1–C6、去重、输出流程） | 对应叶子 `SKILL.md`（`crwu-audit-asset-*` / `crwu-audit-biz-*` ／ `crwu-audit-datacheck`） | 公共逻辑只在轴技能一份；细分增量写在父技能内，禁止复制正文；不建资产×业务组合技能 |
+| 输出/防幻觉/统计契约 | KB `00-总纲/执行契约/01-04-*.md`（技能侧只留 RULE/CHK 编号 + 库内层级路径寻址键） | 技能内禁止展开复制契约正文 |
+| 路径/指针/装配范围（改名、迁移、指向） | 叶子 `references/01-kb-assembly.md` ＋ KB `00-总纲/README`（总纲登记行） | 改名必同步两处 ＋ `validate`；一级目录根变更交 `crwu-dev-audit-skill-maintainer` |
+| 校准/回测记录（案例覆盖、回测结论） | KB `00-总纲/治理/校准案例记录`、`回测报告-真实案例覆盖.md` | 规则/清单变更后回填对应案例/缺口行 |
+| 校验工具本身 | `crwu-dev-audit-skill-maintainer` 技能的 `scripts/`（`kb_tool.py` + `README.md`，随技能安装） | 行为变更须更新其 README 并跑 `crwu-dws` 技能的 `scripts/test_dws_source_contract.py` |
+| 族架构/变更记录 | 源仓的设计文档、变更纪要、技能清单（均由源仓维护，不随技能安装） | 三处登记（99 流程）；新增/改名一级 Skill 由 `crwu-dev-audit-skill-maintainer` 代办 |
+| 画像数据基线/统计（8,486 条快照等） | 部署方脚本 `pull_全量画像.py`——**本仓不提供、不随技能安装**（外部依赖，非技能资产） | 基线变化只提示，不在本流程改 |
+
+## 2.1 知识库变更的同步义务（装配表 / 知识库登记 两件套）
+
+> **铁律：技能里不得留下指向已不存在路径的寻址键。** 下载清单直接由叶子装配表产生，
+> 指针一旦漂移，本次审核就会漏装或多装文件；禁止出现"文件已动、指针没跟"的中间态。
+> 本流程收尾的校验命令与通过判据见
+> `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md`。
+
+| KB 变更类型 | 必做同步 | 说明 |
+| --- | --- | --- |
+| 条目正文/判定要点/dims/modules/标题（同文件内编辑） | ① validate ② 受影响装配导出两跑 | 装配表指针不受影响，不用动；正文本身按知识库维护流程改 |
+| 同文件新增条目 | ① 批次 README/进度总表对应行（条目计数/段位变化时） | 新增条目须先登记词表取值（若用新标签）；`### <id>` 锚点唯一 |
+| 新增/改名/移动/删除 KB 文件或目录 | ① 受影响叶子的 `references/01-kb-assembly.md`（路径键行）② KB `00-总纲/README`（总纲登记行）③ 相关文档内引用文本 ④ validate | 改名前先 grep 全库引用（装配表/SKILL/治理文档），一个不漏；一级目录根改名交 `crwu-dev-audit-skill-maintainer` 重映射 |
+| 装配范围/模块标签体系变化（某技能该装哪些清单与规则段） | ① 对应叶子 `references/01-kb-assembly.md` ② 词表登记（若模块/取值变化）③ validate | 影响"命中/排除"语义，须重跑受影响画像两遍验证 |
+| KB 引用路径/文件名出现在技能正文中（SKILL.md） | ① 技能正文同步 ② 装配表同步 ③ validate --skill-root | 个人绝对路径、「KB/…」式前缀省略（技能引用一律=库内层级路径寻址键）、已废止的 `KB/<rel>` 与 `CRWU_KB_ROOT`、知识库名称 / 本地正文路径字面 / nodeId 常量一律禁止 |
+| 校准/回测结论更新（案例覆盖、缺口 G） | ① `校准案例记录.md`/`回测报告-真实案例覆盖.md` 回填 ② 受影响清单/规则条目若改 → 同步装配表路径键 | 回测与规则互为证据链，不同步=下次优化失去基线 |
+
+**知识库侧缺口（2026-09-10T18:12 经 crwu-dws 实时目录核对，库侧待处理，不代改）**
+
+- 00-总纲/目录地图 **已从库内移除**：同位置现为 `00-总纲/历史数据资产 x 业务数据统计`（内容为氚云「业务行为 × 资产类型」项目统计表，**不是目录映射**，不能替代）。
+  → 本技能原「KB 登记点」一律改指 `00-总纲/README`（现存的知识库总纲与维护契约，其 §3 才是登记要求的出处）；库侧恢复或改名后按本 §2.1 表格同步。
+- 知识库 `00-总纲/README` §3 自身仍要求"登记到 00-总纲/目录地图"，并引用 00-总纲/治理/知识库大纲与进度总表——该两个文档在库内**均不存在**。
+  **治理目录当前 9 个文档**（2026-09-27 经 crwu-dws 实时目录核对）：`RULE 编号与引用完整性规范.md`、`同义术语表.md`、
+  `回测报告-真实案例覆盖.md`、`审核模块注册表.md`、`时效核查日历.md`、`标签词典.md`、`校准案例记录.md`、
+  `知识库规则分层与引用规范.md`、`规则时效与适用日期规范.md`。库侧自相矛盾处属知识库维护事项；
+  **本轮只登记目录事实，不代表这些正文已完成内容级审核。**
+- 本文件 §2 落点表写的 `00-总纲/执行契约/01-04-*.md` 是**通配示例**：**执行契约当前 4 个文档**（2026-09-27 核对）：
+  `01-调度器-SKILL总纲.md`、`02-防幻觉协议执行细则.md`、`03-审核统计与台账规范.md`、`04-复核规定动作清单.md`。
+  即 **04 确实存在**，它是《复核规定动作清单》；**审核统计与台账规范仍是 03**。
+  **不存在的是** `04-审核统计与台账规范` 这个文件名（历史误按"序号即同名主题"推断所致）——不得据旧口径声称 04 缺失。
+  引用契约正文时按实际名称寻址。
+
+## 3. 红线（不许绕过）
+
+1. **未出方案、未经用户确认，不动任何文件**（含 KB 内容）；
+2. 不产审核判断、不出审核意见（那是 crwu-audit 流程）；
+3. 不判定、不依赖"发布/待发布"状态（口径 2026-09-08：知识库文档即权威、下载即审——不存在发布状态
+   判定与登记动作；内容侧历史"待发布"标注仅信息残留，AI 不读取判定，清理归知识库维护）；
+4. 不把规则/清单正文复制进技能（技能=流程+寻址键+算法，正文=钉钉知识库，即 crwu-dws 实时下载源）；
+5. 编号唯一性以定义锚点为准（正文区间引用不算重复）；
+6. 个人绝对路径、「KB/…」式前缀省略、已废止的 `KB/<rel>` 本地根相对引用与 `CRWU_KB_ROOT` 常量、
+   旧树目录名（01-规则库/02-审核清单库/执业准则-*/06-素材库-L2 等）一律禁止出现；
+7. SKILL.md ≤300 行；改 crwu-audit 族技能前先读 `crwu-audit/references/99-maintenance.md`；
+8. 每次改动只落源仓并提交；运行时部署由用户 skills 管理机制负责（不直接写/ln/cp/rm `~/.skills-manager`、`~/.dsh`、`~/.workbuddy` 等运行时目录）；登记三处（design/README/CHANGELOG）。
+9. 知识库正文、目录、标签词典与治理记录均只允许经 `crwu-dws` 只读核对；修复统一标记 `manual_only` 并交用户人工执行，任何 CLI 禁止写入。
+
+## 3.1 AI—人工差距分析的唯一交付落点
+
+| 资产 | 唯一落点 | 用途 |
+| --- | --- | --- |
+| 分析流程 | `references/03-AI人工差距分析流程.md` | 差异状态、双基线、八层追踪、根因与权限 |
+| 数据契约 | `scripts/gap_analysis.schema.json` | 结构化结果与双向关系字段 |
+| 校验/渲染 | `scripts/gap_analysis_delivery.py` | `validate` 与单文件 HTML `render` |
+| HTML 模板 | `template/gap-analysis-report.html` | 固定表格、操作中心与打印布局 |
+| 图表运行时 | `template/echarts.min.js` | 离线 ECharts，不依赖 CDN |
+| 图表许可 | `template/NOTICE.echarts.txt` | 随离线 ECharts 资源（`template/echarts.min.js`）**同包分发**的第三方许可 / NOTICE 入口；离线报告不依赖 CDN |
+| 回归样例 | `scripts/examples/gap-analysis.sample.json` | 可复现验收输入 |
+
+验收时至少证明：`L-open.linkedFixIds[]` 与 `FIX-*.sourceGapIds[]` 双向一致、知识库计划均为
+`manual_only`、非可执行状态不进入计划、输出不泄露个人绝对路径、HTML 离线可打开且可打印。
+
+## 4. 验收口径的 owner 归口（本文件不定义第二份基线）
+
+- **两阶段修改门禁**（阶段一：只读方案 → 阶段二：确认后执行）：
+  `crwu-dev-audit-skill-maintainer/references/04-registry-and-mapping-update.md`。
+- **校验命令、执行方法与完成判据**（引用卫生与"三不写" lint、映射一致性、受影响装配两跑导出一致、
+  案例回归 `BG8169 / 300673` 不劣化、`git diff --check`）：
+  `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md`。
+
+上述口径**只在 maintainer 那两个文件里定义一次**；本文件不复述命令与通过判据，任何一条不过 → 回到方案修订。
+
+## 5. 顺序纪律（确认后的执行顺序）
+
+落点文件 → 引用它的上层文件 → 登记（词表/路由表/design/README/CHANGELOG/批次 README）→
+完成修改后按 `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md` 校验 → 汇报
+（文件级清单 + 校验结果 + 剩余风险）。

package/skills/crwu/crwu-dev-audit-optimize/references/01-/345/217/215/351/246/210/345/256/232/344/275/215/344/270/216/347/224/273/345/203/217/346/265/201/347/250/213.md

@@ -0,0 +1,108 @@
+# references/01 · 反馈定位：单子画像 → 审核规则 / 业务路线 / 资产类型
+
+| 版本 | v0.1 | 状态 | 定稿 | 维护 | crwu-dev-audit-optimize |
+| --- | --- | --- | --- | --- |
+
+> 目标：把用户的模糊反馈（"这个单子审得不对/缺了某类审核"）变成**可证伪的定位结论**：
+> 该单子 现行路由路径 + 实际命中规则集 + 库内应有而缺失的规则段。所有定位结论必须附证据
+> （references/02 §1），禁止凭印象下结论。
+>
+> 文内『KB/知识库』= 钉钉知识库（crwu-dws 实时下载源）。本流程需要读知识库治理/目录/规则正文时，一律经
+> crwu-dws 按库内层级路径实时下载后只读核对（出处=本次下载文件:行号+exportedAt）；下载不可得 → 显式报告，
+> 目录缓存不能提供正文。`crwu-dev-audit-skill-maintainer` 技能提供维护侧引用/实时协议校验工具与映射检查器（调用方式见
+> `references/05-validation-and-delivery.md`）；
+> 装配面不再由工具生成，读叶子 `references/01-kb-assembly.md` 的路径键即可。
+
+## 1. 输入与来源
+
+| 输入 | 来源 | 说明 |
+| --- | --- | --- |
+| 单子标识 | 用户口述/文号（BG8xxx、LX…）或材料目录 | 材料包目录约定由部署环境注入 |
+| 历史审核产物 | 本地审核意见单（`审核意见.*.json/md`）、路由路径、适用规则集快照 | **现状基线**：真实命中面 vs 期望 |
+| 人工复核产物 | 与 AI 审核同项目、同版本、同批次的人工复核文件 | 存在时进入 `references/03-AI人工差距分析流程.md`，逐条生成 `L-*` |
+| 同次知识工作集 | 本次审核下载的 `knowledge/` 与 manifest | 历史归因基线；与 crwu-dws 最新只读正文分开使用 |
+| 校准/回测案例 | KB `00-总纲/治理/校准案例记录`（案例 A/B）、`回测报告-真实案例覆盖.md` §5 | 已闭合检查点（R）与缺口（G）清单 |
+| 路由/装配现状 | crwu-audit `SKILL.md` §3 + `references/07-skill-registry.md`；叶子 `references/01-kb-assembly.md`（技能→知识库寻址键）；知识库 `00-总纲/README`（总纲与维护契约） | 画像→技能/知识库层级路径 |
+
+## 2. 画像五维提取（口径与 crwu-audit references/00 一致）
+
+1. **报告形态**：评估报告 / 咨询报告 / 估值报告 / 其他（首判，决定条款强制力与参照口径）；
+2. **对象大类**：委托合同/报告对象章节 → 02-资产类型 子目录（房地产/企业价值/无形资产/机器设备/组合…）；
+3. **业务主线（一级业务标签）**：评估目的原文 → `01-业务路线/` 一级目录（资产经营/交易与处置/财务报告/融资与债务/投资与资本运作/税务与历史确认/司法清算与补偿/咨询复核与其他）；历史行为词（转让、并购、增资、清算、抵押、司法、减值测试…）只作**命中信号**映射到上述一级业务，子业务在父级内选用，不产生独立标签；
+4. **方法**：附件文件名提示 + 报告方法章节抽验（多方法逐一列 role，禁止凭附件名定论）；
+5. **监管覆盖**：国资/证券/司法/金融标志 → 04-监管覆盖 对应装载。
+
+产出一份画像（供人工/脚本比对装配面），形如：
+
+```json
+{
+  "dims": { "object_type": ["不动产评估"], "method": ["市场法"],
+            "scenario": ["经营性物业出租"], "stage": ["报告"] },
+  "modules": ["M-市场法", "M-报告披露", "M-基准要素一致性", "M-数据校对"]
+}
+```
+
+（stage 不作硬过滤，由叶子按材料分区判断。画像字段口径以 crwu-audit `references/00-input-and-route-profile.md` 为准；本仓不再持有画像示例文件。）
+
+## 3. 机器辅助定位（标准三步）
+
+1. **现行命中面**：读 crwu-audit 路由输出（画像五维 + 路由路径 + 适用规则集快照）与命中叶子的
+   `references/01-kb-assembly.md` 路径键（一级目录根 / 单文件路径）。
+2. **库内是否已有对应规则/清单段**：按路径键经 crwu-dws 实时下载正文后核对（本次工作集，清单外零下载）。
+3. **漂移 / 一致性线索**：收集 **maintainer 验证输出**作为证据 —— 引用卫生与"三不写" lint、
+   registry ↔ classification ↔ 真实技能目录 ↔ 最新知识库目录是否一致。
+   **具体命令、参数与完成判据只在 `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md`**；
+   本文件**不复制**其命令签名，也不重复定义判据。
+
+## 4. 覆盖缺失模式："缺 XX 文档对 XX 文档的审核"
+
+把反馈拆成 **(形态对 × 对象 × 业务 × 阶段/分区)** 组合，例如：
+
+| 用户反馈 | 拆解 | 判定路径 |
+| --- | --- | --- |
+| 缺"报告↔测算明细表"勾稽 | 已有分区（报告/评估说明/测算明细表）CHK-MKT-013 等 | 若已覆盖→反馈为内容问题（A/D）；未覆盖→清单漏项（A） |
+| 缺"底稿↔报告"跨文档一致性 | 现无该分区/模块 | M-数据校对扩分区或新增 CHK 段（A）＋调度总纲分区表（契约） |
+| 缺"某业务路线（如司法-抵债资产）× 不动产"审核 | 路由注册表该组合空/🅿️ | B：先查 01-业务路线 与 02-资产类型 精编现状 → 新建叶子候选（三处登记）或先扩词表+装配 |
+| 缺"咨询文书×无形资产成果转化" | 报告形态=咨询 → 参照口径族 | C/B：词表 report_type/角度登记 → advisory 大方向或参照口径清单 |
+
+判定三步：
+1. 该组合**应命中**现有路由吗？应命中却兜底 → 词表/路由/装配范围问题（C 或 B，小改）；
+2. 命中后**库内有对应 RULE/CHK 段**吗？没有 → 内容缺口（A：补精编条目或清单项，走入库规范四步）；
+3. 命中且库内有、但真实意见仍对不上 → 检查点文字/算法/执行问题（A 或 D）。
+
+每个缺口在方案里给出**建议最小新增物**（新 CHK 项 / 新模块 / 新分区 / 新画像取值 / 新叶子技能），
+不要一上来就建议新建技能——优先最小落点（先在 references/00 §2 找已有落点复用）。
+
+### 4.1 与路由兜底提案衔接
+
+crwu-audit 路由兜底时会自动产出《待建子技能提案》卡（`crwu-audit/references/04`）：候选技能名 /
+定位职责 / 需要审核什么 / 现成依据段 / 内容缺口 / 前置登记 / 优先级，并附路径键与下载证据。本技能 B 桶
+诊断**直接以该卡为输入**（用户批注即需求补充）：把卡细化成《优化方案》——新 SKILL.md 骨架、词表登记行、
+内容缺口补精编任务、三处登记与拷贝同步；确认门禁与验收口径不变（见 `crwu-dev-audit-skill-maintainer/references/04-registry-and-mapping-update.md` /
+`references/05-validation-and-delivery.md`）。
+
+## 5. 证据清单（方案必须引用其一以上）
+
+- crwu-audit 路由输出（画像五维 + 路由路径 + 适用规则集快照）与命中叶子的装配表路径键；
+- 经 crwu-dws 实时下载的规则段落正文（含库内层级路径 + 下载文件实测锚点行号 + exportedAt）；
+- 历史审核意见单中的路由路径与适用规则集快照；
+- 回测报告 §5 的检查点重映射（R/缺口 G 编号）；
+- 上述 **maintainer 校验输出**（error/warn 明细；命令见 `references/05-validation-and-delivery.md`）。
+
+## 6. 典型反馈 → 分桶速查
+
+| 反馈现象 | 首选桶 | 次选桶 | 落点参考（references/00 §2） |
+| --- | --- | --- | --- |
+| 意见"无依据"但规则应存在 | B（装配漏） | E（路径漂移） | 装配表/目录地图/注册表 |
+| 意见与清单检查点描述不符 | A | D | 清单-M-* / 叶子 SKILL |
+| 单子走了兜底但应命中细分 | B | C | 路由注册表/词表 |
+| 新场景/对象/方法词表外 | C | B | 标签词典+references/00、01 |
+| 装配表路径键对不上知识库目录 / 引用断裂 | E | — | 装配表/目录地图/validate |
+| 表格勾稽误报或漏报 | D | A | datacheck SKILL / M-数据校对 |
+| 意见单格式/统计不符契约 | D | — | 叶子 SKILL / 执行契约（只读引用） |
+
+## 7. 审核后有人工作业时的分流
+
+如果同时存在 AI 审核结果与人工复核文件，先验证两者同源，再转入
+`references/03-AI人工差距分析流程.md`。常规 A–E 分桶仍作为最终落点，但必须先完成 `L-resolved` / `L-open` /
+`unclosed` / `uncheckable` / `questionable` 对齐，避免把 AI 已覆盖项或有争议的人工项误当成修复需求。

package/skills/crwu/crwu-dev-audit-optimize/references/02-/346/226/271/346/241/210/346/250/241/346/235/277/344/270/216/347/241/256/350/256/244/351/227/250/347/246/201.md

@@ -0,0 +1,92 @@
+# references/02 · 《优化方案》模板与确认门禁
+
+| 版本 | v0.1 | 状态 | 定稿（2026-09-08 实时引用协议同步：知识库正文不复制进技能，引用=编号+库内层级路径寻址键） | 维护 | crwu-dev-audit-optimize |
+| --- | --- | --- | --- | --- | --- |
+
+> 知识库（KB）= 钉钉知识库，即 crwu-dws 实时下载源：本模板的拟改文件清单涉及知识库文件时只写库内层级路径
+> （如 `00-总纲/…`），正文一律经 crwu-dws 实时下载后只读引用（出处=本次下载文件:行号+exportedAt），
+> 不写知识库名称 / 本地根路径 / nodeId，不做任何正文缓存。
+>
+> **门禁与校验口径不在此重复定义**：两阶段门禁（阶段一：只读方案 → 阶段二：确认后执行）、拟改文件清单的
+> 逐文件要求、校验与回归命令，一律沿用
+> `crwu-dev-audit-skill-maintainer/references/04-registry-and-mapping-update.md` 与
+> `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md`；
+> 本文件只保留**优化方案特有**的模板差异（分桶结论、桶归属与交接项）。凡 B/E 桶命中，
+> 方案里必须写明"交接 `crwu-dev-audit-skill-maintainer`"及交接内容，不得自行改 skill 结构。
+>
+> AI—人工差距报告中的 `FIX-*` 可直接作为本模板的逐项方案编号，但必须保留
+> `L-*.linkedFixIds[] ↔ FIX-*.sourceGapIds[]` 双向关系。知识库项始终 `manual_only`，不因用户批准而转为 AI 执行；
+> Skill 项只有在用户明确批准对应 `FIX-*` 后才可生成并执行修复 prompt。
+
+## 1. 方案必答项（逐项齐全才可提交确认）
+
+```markdown
+# 《优化方案》<编号/日期/单子或反馈摘要>
+
+## 1. 问题与证据
+- 反馈原文（引用用户原话）
+- 单子画像：形态 / 对象(02) / 业务主线(01) / 方法(03) / 监管覆盖(04)
+- 证据：装配清单 / 规则段落(文件:行号) / 历史审核产物 / 回测编号 / validate 输出（至少其一）
+
+## 2. 分桶结论
+- 根因桶：A 规则内容 / B 覆盖缺失 / C 词表画像 / D 技能算法 / E 路径漂移
+- 影响面：涉及哪些叶子技能；涉及哪些 KB 目录
+
+## 3. 拟改文件清单（确认后逐文件执行；未确认不动）
+| # | 文件（源仓路径） | 部署说明（运行时由用户 skills 管理机制负责；本列不再列运行时路径） | 改动说明（一句话） |
+| 1 | `<技能目录>/SKILL.md` | —（提交源仓即交付，由管理机制部署） | … |
+| 2 | 知识库库内文件：`00-总纲/…`（库内层级路径寻址键；正文修改按知识库内容维护流程另办） | —（知识库正文不复制进技能；引用经 crwu-dws 实时下载） | … |
+| 新增文件：目录 + 文件 + 内容概要 + 预计条数/行数
+
+## 4. 联动登记（随改动同步完成）
+- [ ] 标签词典（若涉及词表取值）   [ ] 路由注册表（若涉及技能/路由）
+- [ ] 叶子 `references/01-kb-assembly.md`（新增/改名/移动 KB 文件或装配范围变化时）
+- [ ] KB `00-总纲/README`（同上，总纲登记行；该库当前缺 `目录地图`，见 references/00 §2.1）
+- [ ] `crwu-dev-audit-skill-maintainer` 映射检查器已跑（一级目录根/registry/classification 一致性）
+- [ ] 源仓设计文档   [ ] 源仓技能清单   [ ] 源仓变更纪要
+- [ ] 批次 README / 进度总表对应行   [ ] 校准案例/回测记录回填
+
+## 5. 校验与回归步骤
+（按 `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md` 执行并如实引用其结果；
+不在此照抄另一份命令清单或通过判据）
+
+## 6. 不做项与风险
+- 明确写"本次不做"（如：版本管理、钉钉迁移、基线脚本复跑）
+- 风险：影响现行审核？需人工复核点？回滚方式（git checkout / 拷贝还原）？
+```
+
+## 2. 确认与授权（optimize 特有补充）
+
+两阶段门禁本身（阶段一：只读方案 → 阶段二：确认后执行）、确认粒度、逐条驳回与"确认后重提"的规则见
+`crwu-dev-audit-skill-maintainer/references/04-registry-and-mapping-update.md`；本文件**不复述**。
+
+optimize 侧只补充以下几点：
+
+1. 差距报告确认必须引用具体 `FIX-*`：知识库项的确认仅表示用户接受人工修复建议，AI/CLI 仍**禁止修改知识库**；
+   Skill 项的确认才授权修改列明的源仓文件，不授权清单外文件或运行时目录。
+2. Skill 修复依赖知识库内容时，先等用户确认对应 `kb_manual` 已人工完成并提供可核验结果，再执行后续 `skill_ai`。
+3. 涉及"新增 crwu-audit-* 叶子技能"的方案：三处登记 + 自带"仅经 crwu-audit 编排调用"门禁缺一不可（99 流程），
+   并明确"不装到运行时则不影响路由"的预期；该情形属 B 桶，交接 `crwu-dev-audit-skill-maintainer`。
+
+## 3. 执行后核对（optimize 特有项）
+
+共享的完成判据与校验/回归命令见
+`crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md`；本文件不复述命令与判据。
+
+- [ ] 落点文件已按 §1 清单改完（无清单外改动）
+- [ ] 源仓已提交；运行时部署已交由用户 skills 管理机制执行/校验（本侧未直接写运行时）
+- [ ] 登记全部完成（§1 联动清单；涉及 KB 时含装配表 / 总纲登记同步）
+- [ ] 差距报告：`L-*.linkedFixIds[] ↔ FIX-*.sourceGapIds[]` 双向一致；知识库计划全为 `manual_only`
+- [ ] 汇报已发出（文件级改动 / 校验结果 / 剩余风险与待办）
+
+## 4. 汇报模板（执行完成后）
+
+```markdown
+## 优化完成汇报 <编号>
+- 已改文件：逐文件列出源仓路径
+- 运行时部署状态：由用户 skills 管理机制负责；本侧未直接写运行时目录
+- 校验与回归结果：按 `crwu-dev-audit-skill-maintainer/references/05-validation-and-delivery.md`
+  的完成判据如实填写（未过项必须原样列出，不得改写判据）
+- 剩余风险/待办：…
+- 建议下一步：…
+```

package/skills/crwu/crwu-dev-audit-optimize/references/03-AI/344/272/272/345/267/245/345/267/256/350/267/235/345/210/206/346/236/220/346/265/201/347/250/213.md

@@ -0,0 +1,95 @@
+# references/03 · AI—人工差距分析流程
+
+| 版本 | v0.1 | 状态 | 定稿 | 维护 | crwu-dev-audit-optimize |
+| --- | --- | --- | --- | --- |
+
+> 目标：审核结束后，把同一次审核的 AI 结果与人工复核文件逐条对齐，解释 AI 为什么漏检，并把每个
+> 仅人工发现项连接到可执行的修复计划。知识库始终只读，知识库修复只能由用户人工完成。
+
+## 1. 输入与同源门禁
+
+必需输入：AI 审核结果、人工复核文件、被审核材料标识、AI 审核时的路由/装配记录，以及同次审核下载的
+知识库 `knowledge/` 工作集和 manifest。先核对项目、报告版本、审核批次与材料范围；不能证明同源时，
+状态记为 `uncheckable`，不得把差异直接归因于 AI 漏检。
+
+分析使用双基线：
+
+1. **历史基线**：本次审核本地下载的 `knowledge/` + manifest，回答“当时 AI 能看到什么”，用于历史归因；
+2. **当前基线**：通过 `crwu-dws` 按已识别的库内层级路径只读下载最新正文，回答“现在是否仍缺”，用于修复建议；
+3. 两者不一致时必须分别陈述，禁止用当前知识库反推当时必然存在，也禁止写入知识库。
+
+## 2. 差异对齐与状态
+
+先规范化问题对象、页码/段落、问题类型、事实描述、依据和建议，再做语义匹配：
+
+- `L-resolved`：仅人工文本出现，但 AI 已在别处实质覆盖；非漏检，不进入修复计划；
+- `L-open`：人工发现成立且 AI 未覆盖；进入根因分析和修复计划；
+- `unclosed`：疑似漏检，但材料或证据不足；列待补证，不生成执行项；
+- `uncheckable`：输入不同源或关键文件不可读；列阻塞原因；
+- `questionable`：人工意见本身可能不成立；说明反证，不据此修复。
+
+每个差异项使用稳定 ID `L-*`。报告必须保留人工原问题摘要、AI 匹配结果、证据位置、状态、置信度和解释，
+不得只给数量。
+
+## 3. 八层追踪与根因
+
+对每个 `L-open` 依次检查：输入可见性 → 画像 → 路由 → 装配 → 知识库正文 → Skill 流程/算法 →
+实际执行轨迹 → 输出合并/去重。根因码：
+
+| 根因 | 含义 | 典型修复方向 |
+| --- | --- | --- |
+| `K1` | 历史与当前知识库均无所需规则/检查点 | 知识库人工补充 |
+| `K2` | 当时缺失、当前已补齐 | 回归验证；通常不再修改 |
+| `S1` | Skill 未引用或未要求检查已有知识 | Skill 修复 |
+| `S2` | Skill 算法、分区、勾稽或输出流程不合理 | Skill 修复 |
+| `R` | 画像、路由或能力覆盖缺失 | 路由/结构方案，必要时交 maintainer |
+| `I` | 装配路径或范围错误 | 装配/映射方案，交 maintainer |
+| `E` | 执行时未完成已定义动作 | 执行约束、回归或提示修复 |
+| `O` | 已检出但在输出合并、去重或格式阶段丢失 | 输出逻辑修复 |
+| `H` | 人工项已覆盖、不可核验或本身可疑 | 不进入可执行根因统计 |
+
+根因必须引用证据；不能定位时写“待补证”，不得猜测为知识库缺失或 Skill 缺陷。
+
+## 4. `L-*` 与 `FIX-*` 双向关系
+
+每个可执行修复使用稳定 ID `FIX-*`，并满足：
+
+- 每个 `L-open.linkedFixIds[]` 至少包含一个存在的 `FIX-*`；
+- 每个 `FIX-*.sourceGapIds[]` 至少包含一个存在的 `L-open`；
+- 两侧关系必须完全互反；一个 `L-*` 可对应多个修复，一个 `FIX-*` 可解决多个同因问题；
+- `L-resolved`、`unclosed`、`uncheckable`、`questionable` 禁止进入修复计划；
+- HTML 同时用明细表、映射表和 `L → 根因 → FIX` ECharts 图展示关系。
+
+## 5. 修复计划与权限边界
+
+修复计划分为两类：
+
+1. `kb_manual`：必须标记 `executionPolicy: manual_only`。逐项给出 `sourceGapIds`、库内目标文档、现有证据、
+   缺失内容、建议插入章节/锚点、建议新增的 RULE/CHK 结构、联动文档、人工操作步骤及验证方法。
+   本技能与任何 CLI **禁止修改知识库**，也不得生成暗示 AI 已执行知识库写入的提示词。
+2. `skill_ai`：给出源仓目标文件、拟修改内容、风险、回归命令和可直接复制给 AI 的修复 prompt。
+   prompt 必须列出获批的 `FIX-*` 与 `sourceGapIds`，声明只改批准的源仓文件、知识库只读、不得写运行时目录。
+   未获用户明确批准时只展示计划，不生成“立即执行”语义；批准后才可执行。
+
+依赖知识库先补齐的 Skill 修复必须标记依赖门禁，用户未确认人工知识库修复完成前不得执行后续 Skill 项。
+
+## 6. HTML 交付
+
+结构化结果遵循 `scripts/gap_analysis.schema.json`，先校验再渲染：
+
+```bash
+python3 scripts/gap_analysis_delivery.py validate --input <gap-analysis.json>
+python3 scripts/gap_analysis_delivery.py render --input <gap-analysis.json> --output <gap-analysis.html>
+```
+
+模板固定为 `template/gap-analysis-report.html`，ECharts 资源来自本地 `template/echarts.min.js`；输出是离线可打开、
+可打印 A4 的单文件 HTML。必须包含：结论摘要、根因与状态图表、仅人工发现明细、八层执行轨迹、差距—修复映射、
+知识库人工修复单、Skill 修复 prompt、验证计划。渲染前校验 ID 唯一性、双向映射、权限类型、绝对路径泄露和汇总数。
+
+## 7. 完成判据
+
+- 所有人工项都有状态，所有 `L-open` 都有证据化根因和 `FIX-*`；
+- `linkedFixIds[]` 与 `sourceGapIds[]` 双向一致；
+- 知识库项全部为 `manual_only`，报告明确目标文档和人工修复方法；
+- Skill 项只有在明确批准后才允许 AI 改源仓，并包含回归验证；
+- HTML 离线打开正常，表格与 ECharts 均可读，打印时不截断关键映射。