From b439c5fa09b25e511abab4402a6c18c85625711d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=89=E6=BE=9C?= Date: Wed, 5 Aug 2026 18:22:40 +0800 Subject: [PATCH] =?UTF-8?q?docs(skill):=20add=20mono=E2=86=94multi=20conte?= =?UTF-8?q?nt=20QA=20track=20to=20align=20plan?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Specify coverage/structure/drift gates against mono, inventory existing skill policy tests, and extend the §7 checklist for the QA track. Co-authored-by: Cursor --- docs/skill-wukong-align-plan.md | 304 ++++++++++++++++---------------- 1 file changed, 150 insertions(+), 154 deletions(-) diff --git a/docs/skill-wukong-align-plan.md b/docs/skill-wukong-align-plan.md index 896b1fda..0d0387b5 100644 --- a/docs/skill-wukong-align-plan.md +++ b/docs/skill-wukong-align-plan.md @@ -1,11 +1,11 @@ # DWS multi-skill **内容框架**对齐方案（相对 dws-wukong develop） -> 状态：**方案待 owner 按 §7 重新批准后编码**。本文只做内容架构盘点与分期建议，**不含实现**。 +> 状态：**方案待 owner 按 §7 重新批准后编码**。本文只做内容架构与 **mono↔multi 内容质检**盘点/分期，**不含实现**。 > -> 撰写 / 二次收窄：2026-08-05 +> 撰写 / 收窄 / 质检增补：2026-08-05 > 工作树：`/Users/john/GolandProjects/open-source/dws-multi-skill-align` > 分支：`feat/multi-skill-framework-align`（自 `origin/main` @ `a37e6e68`） -> **本分支范围：只做 skill 内容的这个框架**（目录布局、文档契约、共享内容约定、zip 内内容树合同）。 +> **本分支范围：只做 skill 内容的这个框架**（目录布局、文档契约、共享内容约定、zip 内容树合同、**相对 mono 的内容质检**）。 > **不做**安装/升级引擎、agent-home、脚本 skill-install 行为翻转。 > > 对照仓： @@ -15,264 +15,260 @@ > | DWS OSS CLI（本工作树） | `dws-multi-skill-align` | `origin/main` | > | dws-wukong | `~/GolandProjects/open-source/dws-wukong` | `origin/develop` @ `ab76629a`（调研时） | > | 行为参考（**另一分支**） | `dws-skill-mode-migration` @ `402429ac`/`d5c8982c` | 安装默认 multi / upgrade 强制 multi —— **不在本分支排期** | +> | 内容缺口留档（参考） | 同迁移分支 `docs/skill-capability-completion.md`（M1–M6 / X1 等） | **仅作质检目标线索**，非本分支权威 | --- ## 0. TL;DR -1. **本分支 = skill 内容框架**：`skills/mono` 与尤其 `skills/multi` 如何组织（目录、`SKILL.md`、references、共享层、跨 skill 约定），以及 `dws-skills.zip` 里 multi/mono **内容树布局合同**（不是 Go 安装引擎）。 -2. **对齐对象**：dws-wukong develop 的 **skill 内容树**（`dingtalk-skills/`、flat `dingtalk-*` + `dws-shared`、references 分层），只取对 DWS 内容组织有用的概念；**不**对齐客户端 `_install.sh` / dual 包 / RewindDesktop。 -3. **安装/升级行为**（默认 multi、`LocateSkillsRoot`、`skill_setup`、`paths.go`、install 脚本、`402429ac`/`d5c8982c`）→ **单独 follow-up 分支**，本方案只登记延期，不进 Phase。 -4. 可选「内容包元数据」（如树内 `manifest` 仅描述内容版本/布局）与安装运行时 manifest **分开**；后者不在本分支。 +1. **本分支 = skill 内容框架 + 相对 mono 的内容质检**：固化 `skills/multi` 组织合同，并用 **mono 单 skill 布局作对照基准**做覆盖/结构/漂移门禁（文档 + CI 内容护栏）。 +2. **对齐悟空**：只取内容树组织概念；质检以 **DWS-native** 设计为主（已有 policy/测试可复用）。悟空 `validate-multiskill-bundle.py` 仅借鉴「frontmatter / 断链 / requires」类检查思路，**不**移植 bundle/安装校验。 +3. **安装/升级行为**与 `402429ac`/`d5c8982c` → **单独 follow-up 分支**，本方案只登记。 +4. 质检 **不改**默认安装哪棵树；只保证 multi 内容相对 mono **可解释、可覆盖、可回归**。 -### 0.1 IN SCOPE（本分支唯一交付面） +### 0.1 IN SCOPE | 类别 | 包含 | |---|---| -| 内容树结构 | `skills/mono/`（单入口 + `references/products/*`）与 `skills/multi//`（平铺产品 skill）的目录合同 | -| 单 skill 内部约定 | `SKILL.md` frontmatter / 运行时契约块 / Golden Route；`references/` 分层与索引；可选 `scripts/` 归属规则 | -| 共享内容 | `skills/multi/dws-shared/` 职责边界、被产品 skill 引用的方式、与 mono 共享文的映射关系（文档级） | -| 命名与集合 | `dingtalk-` + `dws-shared`；相对悟空树的「共有 / 仅 DWS」清单（**文档与缺口表**，不强制内容抄库） | -| Zip **内容布局合同** | 发布物中 `mono/`、`multi/`、根 mono 副本各自代表什么内容树（描述与必要时校验「树形状」）；**不改**安装谁、默认装哪棵 | -| 内容架构文档 | 本文件 + 可选短文：multi 内容架构 / mono↔multi 内容映射约定 | +| 内容树结构 | `skills/mono/` 与 `skills/multi//` 目录合同 | +| 单 skill 约定 | `SKILL.md` frontmatter / 契约块 / Golden Route；`references/`；可选 `scripts/` | +| 共享内容 | `dws-shared` 职责与被引用方式；与 mono 全局文映射（文档级） | +| 命名与集合 | `dingtalk-*` + `dws-shared`；相对悟空的共有/独有清单（文档） | +| Zip **内容布局合同** | `mono/` / `multi/` / 根 mono 副本的内容含义与树形状；不改安装默认 | +| **Mono↔multi 内容质检** | 覆盖、结构、漂移三类门禁；复用/扩展现有 policy 与测试；缺口修复属内容编辑（另批或同分支内容 Phase） | +| 内容架构文档 | 本文件 + 可选短文（架构合同 + 质检矩阵） | -### 0.2 OUT OF SCOPE（本分支不做 → 另分支 / 延期） +### 0.2 OUT OF SCOPE | 类别 | 去向 | |---|---| -| 安装默认 multi、upgrade 有 multi 则强制刷 multi | **Follow-up 分支**（可基于 `402429ac` / `d5c8982c`） | -| `LocateSkillsRoot`、`skill_setup.go`、`internal/upgrade/paths.go` | 同上 | -| `internal/skillhome`（agent-home / 互斥 / stale 安装逻辑） | 同上 | -| `install.sh` / `install.ps1` / `install.js` / `install-skills.sh` 的 skill-install 行为 | 同上 | -| Cherry-pick `402429ac` / `d5c8982c` 作为本分支 Phase 1 | **明确不排期**；§6 仅作指针 | -| 面向安装/运行时的 manifest、state.json、`dws skill mode`、telemetry header | 拒绝或属行为分支；已取消产品仍拒绝 | -| 悟空 `_install.sh` symlink、dual/Qwen/RewindDesktop/pod | 拒绝 | -| Schema catalog / chat shortcut 代码 / whiteboard等非 skill-内容工作 | 拒绝（除非某 reference **正文**本身是本分支内容编辑任务且 owner 点名） | +| 安装默认 multi、upgrade always-multi | Follow-up 分支（`402429ac`/`d5c8982c`） | +| `LocateSkillsRoot` / `skill_setup` / `paths.go` / `skillhome` / install 脚本行为 | 同上 | +| 安装/运行时 manifest、state.json、mode 切换、telemetry header | 拒绝或行为分支 | +| 悟空 `_install.sh` / dual / Qwen / RewindDesktop / pod | 拒绝 | +| 非 skill 内容的 CLI 功能（schema/shortcut 代码等） | 拒绝 | +| 把质检做成「改安装默认值」的后门 | 拒绝 | --- ## 1. 内容现状盘点 -### 1.1 DWS `skills/mono`（单 skill 内容） +### 1.1 DWS `skills/mono`（质检对照基准 · 单 skill） ```text skills/mono/ -├── SKILL.md # 总入口 +├── SKILL.md ├── references/ -│ ├── products/.md| -│ ├── best_practices/… -│ └── （全局：error-codes、intent-guide、…） -└── scripts/ # 可选辅助脚本 +│ ├── products/.md|…/ # 产品能力面（质检「覆盖」主源） +│ ├── recovery-guide.md、error-codes.md、… # 全局协议 +│ └── best_practices/… +└── scripts/ ``` -特点：一个 skill id；产品能力以 `references/products/*` 挂在同一棵树下。 - -### 1.2 DWS `skills/multi`（多 skill 内容 · 本分支重点） +### 1.2 DWS `skills/multi`（内容主体） ```text skills/multi/ -├── dws-shared/ -│ ├── SKILL.md -│ └── references/ # 全局契约、routing、error-codes、best_practices/_common、… -└── dingtalk-/ # 当前 19 个产品 skill - ├── SKILL.md # frontmatter + 运行时契约块 + Golden Route / 意图表 - ├── references/ # 产品内分层（如 chat/、card/） - └── scripts/ # 部分产品有 +├── dws-shared/ # 跨产品契约 / routing / 全局协议应落点 +└── dingtalk-*/ # 19 产品 + 各 references、scripts ``` -当前产品集合（调研时）： -aisearch, aitable, calendar, chat, contact, **dev**, doc, drive, **event**, **hrbrain**, mail, **markdown**, minutes, misc, **pat**, **profile**, **skill**, todo, wiki + `dws-shared`。 -（加粗 = 悟空 `dingtalk-skills/` 无对应目录。） +仅 DWS 有（悟空无）：dev, event, hrbrain, markdown, pat, profile, skill。 -### 1.3 dws-wukong develop `dingtalk-skills/`（内容树对照） +### 1.3 悟空 `dingtalk-skills/`（内容组织对照，非质检权威） -```text -dingtalk-skills/ -├── dws-shared/ # 含 overlays/、package.json 等悟空侧扩展（OSS 未必需要） -└── dingtalk-* / # 12 产品：aisearch…wiki（无 dev/event/hrbrain/…） - ├── SKILL.md - ├── references/ - └── scripts/ -``` +Flat `dingtalk-*` + `dws-shared`；单 skill 骨架同构。**不作为 mono 覆盖基准**（集合更小、不同源）。 -打包侧另有「bundle 内再套一层 `skills/` + 根 `manifest.json`」——那是 **客户端/Qwen 包形态**，本分支只关心 **子树本身的内容组织**（`SKILL.md` + `references` + 命名），不移植 bundle 外壳。 - -### 1.4 Zip 内容布局（内容合同，非安装行为） - -`dws-skills.zip` 现行内容形状（`post-goreleaser.sh` 注释）： +### 1.4 Zip 内容布局合同 | Zip 路径 | 内容含义 | |---|---| -| `/`（SKILL.md + references + …） | mono 树副本（兼容旧消费者看根） | +| `/` | mono 副本（兼容） | | `/mono/` | 显式 mono 内容源 | -| `/multi/` | multi 平铺内容源（与 `skills/multi/` 同构） | +| `/multi/` | 与 `skills/multi/` 同构 | -本分支若动打包，**仅**为澄清/加固「内容树合同」（例如校验 multi 下每个子目录含 `SKILL.md`、命名符合 `dingtalk-*|dws-shared`）。**不**在此改变「默认安装哪棵树」。 +质检可断言「源树形状」；**不**断言安装面默认选哪棵。 + +### 1.5 现有 DWS skill 内容质检资产（复用清单） + +| 资产 | 作用 | 与 mono↔multi 质检关系 | +|---|---|---| +| `scripts/policy/check-skill-commands.sh` + `skill-command-check/` | Skill 文内 `dws …` 命令路径存在性 | **复用**（命令真实性）；非覆盖映射 | +| `scripts/policy/check-skill-context-budget.sh` | chat/event/mono/`dws-shared` 上下文预算与冷启动约束 | **复用**（结构/预算）；可扩展 shared 引用规则 | +| `scripts/policy/check-multi-im-skill-chain.sh` + `multi-im-skill-chain/` | IM 意图单默认路由、retired scripts、handoff | **复用**（chat/event 链）；面窄 | +| `test/unit/skill_docs_policy_test.go` | 退役命令、event 扁平输出契约等 | **复用**；可加 mono↔multi 断言 | +| `test/unit/whiteboard_skill_docs_test.go` | mono/multi whiteboard recipes **字节一致** | **样板**：产品面「同源文件」门禁范式 | +| `test/skill_static`（`-tags skill_verify`） | 文内命令 vs Cobra；multi 查 flag | **复用**（opt-in 深度）；非 CI 默认全量时可保持 tags | +| `test/skill_e2e` / `test/run_skill_tests.py` | 执行层 / 用例驱动 | **偏行为**；本分支质检默认不依赖 e2e | +| `Makefile` → `policy` 含 context-budget、multi-im-skill-chain；`skill-command-integrity` 独立 | 已有 CI 钩子 | 新门禁优先挂同类 policy / `test/unit` | + +**缺口（尚无的门禁）**：系统的「mono `references/products/*` → multi 目录/文」覆盖表；frontmatter 全集完备性；orphan scripts；recovery / 确认门禁等 **全局协议**是否进入 `dws-shared`。这些正是本分支质检轨要补的。 + +### 1.6 悟空侧类比质检 + +| 悟空 | 说明 | 本分支 | +|---|---|---| +| `scripts/validate-multiskill-bundle.py` | 校验 **已打好的 bundle zip**：frontmatter keys/category、`requires`、markdown 断链、scenario 编排 | **Adapt 思路** → DWS 源树（`skills/multi` + 对照 mono），不跑 zip 安装语义 | +| `sync-monolith-to-multiskill.py` | mono→multi 派生 | **不**作默认质检手段；DWS 直接维护 multi | + +结论：**DWS-native mono↔multi 质检**；悟空仅参考检查维度。 --- -## 2. Diff：内容组织已对齐 / 分叉 / 勿移植 +## 2. Diff（内容组织 + 质检视角） -### 2.1 已大致同构 +### 2.1 已同构 -| 概念 | DWS multi | 悟空 dingtalk-skills | +Flat `dingtalk-*` + `dws-shared`；`SKILL.md` + `references/`（+ 可选 `scripts/`）。 + +### 2.2 分叉与已知内容风险（质检要盯的） + +| 风险 ID | 现象（线索） | 质检类型 | |---|---|---| -| 目录名 | `dingtalk-` | 同 | -| 共享层目录 | `dws-shared` | 同 | -| 单 skill 骨架 | `SKILL.md` + `references/`（+ 可选 `scripts/`） | 同 | -| 平铺多 skill | `skills/multi/*` | `dingtalk-skills/*`（再被打进 bundle 的 `skills/*`） | +| **C-cov** | mono `products/*` 能力面在 multi 无对应 skill/reference，或未登记「有意省略」 | 覆盖 | +| **C-struct** | multi 缺 frontmatter 字段、`references/`、`DWS_RUNTIME_CONTRACT`、对 `dws-shared` 引用不一致 | 结构 | +| **C-drift-global** | mono 有 recovery / 确认门禁 / Schema 教学等全局协议，multi/`dws-shared` 缺失或断链（留档 M1/M2 等） | 漂移（协议） | +| **C-drift-orphan** | multi（或 mono）scripts/refs 无文档引用；或 routing 指向无索引产品（留档 X1/M6） | 漂移（孤儿） | +| **C-pair** | 应对齐的成对文件（如 whiteboard recipes）内容不一致 | 漂移（成对） | -### 2.2 内容分叉（本分支可讨论） +### 2.3 Reject -| 维度 | DWS | 悟空内容树 | 本分支态度 | -|---|---|---|---| -| 产品数量 | 19 + shared | 12 + shared | **保留 DWS 超集**；文档化共有/独有，不合一抄库 | -| mono 形态 | 独立完整树 `skills/mono` | 另有 `dingtalk-workspace/` mono 源 | 文档化 mono↔multi **内容映射**；不删 mono | -| `dws-shared` | 无 overlays/package.json | 有 overlays、package.json | **不**移植悟空 overlay 流水线；可借鉴「共享层只放跨产品契约」边界 | -| references 命名 | 产品自洽（如 `chat/`、`01-*.md` 混用） | 部分产品有 `01-messaging`、`lite-recipes` 等 | 订 **DWS multi 内容约定**（索引方式、是否统一编号），不对齐抄文件名 | -| 运行时契约块 | multi `SKILL.md` 含 `DWS_RUNTIME_CONTRACT` 等标记块 | 文案可能不同源 | 以 DWS 契约为准；只统一 **内容框架标记** 是否每个产品 skill 必有 | -| Zip 外壳 | 三树（根+mono+multi） | bundle = manifest + skills/ | **保持 DWS 三树**；不改为悟空 bundle 外壳 | - -### 2.3 内容侧 Reject - -- 悟空 symlink 安装记账、dual 包、Qwen overlay、pod 链路 -- 为「像悟空」而删掉 DWS 独有 7 个产品 skill -- 把 mono 产品文机械搬进 multi 而不经内容评审（若做映射，走内容 Phase，不走安装 Phase） +悟空安装包校验整文件照搬、内容集 19→12 砍产品、安装行为门禁冒充内容质检。 --- ## 3. Goals / Non-goals -### 3.1 Goals（内容框架） +### 3.1 Goals -1. **写清并固化** multi 内容目录合同：合法子树名、必有文件、`dws-shared` 边界、产品 skill 最小 `SKILL.md`/references 结构。 -2. **文档化** mono ↔ multi 内容关系（哪些全局文在 shared、哪些在产品树、与 `references/products/*` 的对应），便于后续演进，而非本分支做安装切换。 -3. **对照悟空内容树**产出「共有 12 / 仅 DWS 7」与结构差异表；只吸收有用的组织概念（flat + shared），不抄客户端包。 -4. **（可选）** zip/源树级 **内容元数据**（例如 `multi/CONTENT_LAYOUT.md` 或纯内容 `manifest`：layout 版本、skill 列表）——标明 content-only，**不**驱动 setup/upgrade。 -5. **（可选）** 内容形状校验脚本/测试：multi 下每个 skill 含 `SKILL.md`、命名合法、shared 存在——仍属内容合同，不碰安装默认值。 +1. 固化 multi **内容目录合同**与 mono↔multi **映射说明**。 +2. 建立 **质检矩阵**（覆盖 / 结构 / 漂移）并以 mono 为对照基准；有意省略必须 reviewed 登记。 +3. **复用** §1.5 资产；新增门禁走 `scripts/policy` 或 `test/unit`，内容-only。 +4. （可选）纯内容元数据；**禁止**被安装引擎读取改行为。 +5. 质检失败 → 修 **内容**或更新「有意省略」表，不改 setup/upgrade。 -### 3.2 Non-goals（本分支） +### 3.2 Non-goals -| 项 | 说明 | -|---|---| -| 安装/升级行为翻转 | 另分支；见 §6 | -| Go skill 安装引擎重构 | 另分支 | -| Cherry-pick `402429ac`/`d5c8982c` | 另分支，**不**作本分支 Phase 1 | -| 取消产品（mode / state.json / header） | 仍拒绝 | -| 悟空客户端打包与安装器 | 拒绝 | -| 非 skill 内容的 CLI 功能开发 | 拒绝 | +安装/升级翻转；cherry-pick 行为提交；取消产品；悟空客户端；非 skill CLI 功能；用质检驱动默认 multi 安装。 --- -## 4. 分期（全部为内容-only） +## 4. 分期（内容框架 + 质检 · 均无安装引擎） -> 批准前 **零编码**。下列阶段 **均不包含** install/upgrade Go/脚本行为变更。 +> 批准前 **零编码**（含不实现新 gates）。 ### Phase 0 — 方案冻结（本文） | | | |---|---| -| **范围** | 本文件；§7 勾选 | -| **文件** | 仅 `docs/skill-wukong-align-plan.md` | -| **验收** | owner 按「内容框架 only」重新批准 | +| **范围** | 本文件；§7（含质检轨）勾选 | +| **验收** | owner 重新批准 | ### Phase 1 — Multi 内容目录合同 + 架构短文 | | | |---|---| -| **范围** | 成文：`skills/multi` 目录合同（命名、必有 `SKILL.md`、`references/` 约定、`dws-shared` 职责）；与悟空内容树对照表（共有/独有/结构差异）；明确 zip 内 `multi/` 与源树同构的 **内容合同** | -| **可能触达** | `docs/` 下 skill 内容架构短文（新建）；必要时各 `SKILL.md` **仅**目录/约定说明级极小修订（非产品能力扩写） | -| **不碰** | 任何 `internal/app`、`internal/upgrade`、install 脚本行为 | -| **验收** | 文档可独立指导「如何新增一个 dingtalk-* 内容目录」；对照表完整；§0.2 未破线 | +| **范围** | `skills/multi` 目录合同；与悟空内容树对照表；zip `multi/` 同构合同 | +| **触达** | `docs/` 短文；极小约定级文案 | +| **验收** | 可指导「如何新增 dingtalk-* 内容目录」 | -### Phase 2 — Mono↔multi 内容映射与缺口表 +### Phase 2 — Mono↔multi **内容质检规格**（矩阵 + 缺口基线） | | | |---|---| -| **范围** | 盘点 mono `references/products/*`（及全局文）与 multi 各树的覆盖/重复/缺口；输出缺口表与「共享层 vs 产品层」归属建议 | -| **可能触达** | 文档；可选在 `dws-shared` 或产品 references **补索引/链接**（内容导航），不做安装逻辑 | -| **验收** | 缺口表经 owner 过目；无安装行为 diff | +| **范围** | 写出质检规格文档（可并入架构短文附录）：三类门禁的输入源、通过准则、有意省略登记格式；固化覆盖映射初表（mono `references/products/*` ↔ multi skill/reference）；收录已知缺口基线（recovery、确认门禁、orphan scripts 等，对齐留档 M1/M2/X1…） | +| **触达** | 仅文档 / 登记表（YAML/Markdown allowlist 亦可，仍属内容合同） | +| **不碰** | Go 安装代码；本阶段 **仍不实现** 新 CI gate（实现在 Phase 3） | +| **验收** | owner 能按矩阵人工抽查；缺口基线列表完整且每条有「修内容 / 登记省略 / 延后」 disposition | -### Phase 3 — 内容形状护栏（可选） +### Phase 3 — 质检落地：CI 内容护栏（复用 + 新 gate） | | | |---|---| -| **范围** | 测试或轻量脚本：断言 multi 子目录命名、`SKILL.md` 存在、必有 shared；可选检查 zip staging 树形状与源树一致（**内容合同**） | -| **可能触达** | `test/unit/*skill*content*` 或 `scripts/policy/check-multi-skill-content.sh` 一类；**不**改 `LocateSkillsRoot`/默认 mode | -| **验收** | 故意破坏目录合同会失败；CI 仅绑内容护栏 | +| **范围** | 实现 **content-only** 自动门禁，建议分层： | +| | **G1 形状**：multi 子目录命名、`SKILL.md` 存在、必有 `dws-shared` | +| | **G2 结构**：frontmatter 最小集（name/description/metadata.category 等，DWS 自定；可借鉴悟空允许键但不照搬）；产品 skill 契约块/对 shared 引用规则（与 context-budget 协调） | +| | **G3 覆盖**：mono products 索引 ↔ multi 映射表强制完整（未映射必须在 reviewed omit 表） | +| | **G4 漂移**：orphan scripts（无 md 引用）；可选成对文件哈希/一致（推广 whiteboard 样板）；全局协议文件存在性（如 `recovery-guide` 在 shared 或 omit） | +| **复用** | 保持 skill-commands / context-budget / multi-im / skill_docs_policy；新逻辑优先 `test/unit` 或 `scripts/policy/check-mono-multi-skill-content.sh` | +| **不碰** | install 默认值、`LocateSkillsRoot`、upgrade | +| **验收** | `make policy`（或约定 target）失败当且仅当内容合同破；故意破坏夹具测试；无安装行为 diff | -### Phase 4 — 可选内容包元数据（content-only） +### Phase 4 — 可选：内容包元数据 + 缺口修复波次 | | | |---|---| -| **范围** | 若需要：在 `skills/multi/`（或 zip `multi/`）增加 **纯内容** 元数据文件（layout 版本、skill 列表），供人/校验脚本阅读 | -| **禁止** | 被 setup/upgrade/install 脚本读取并改变安装行为（那属行为分支） | -| **验收** | 元数据缺省不影响现行安装；文档写明「非运行时合同」 | +| **范围 A** | 纯内容 layout/skill 列表元数据（人不读安装器） | +| **范围 B** | 按 Phase 2 disposition **修内容**（如 shared 补 recovery/确认协议、清 orphan）——属内容编辑，可与门禁分 PR | +| **验收** | 元数据不驱动安装；修复项关闭对应质检失败或转入 omit | -### 延期登记（不在本分支 Phase） +### 延期登记（非本分支） -| 主题 | 建议载体 | +| 主题 | 载体 | |---|---| -| 默认 multi + upgrade always-multi | 新分支，cherry-pick/移植 `402429ac` → `d5c8982c`（skill 行为 diff only） | -| `skillhome` / agent-home / 互斥安装 | 行为/框架分支（安装向） | -| 安装面 skill-install bootstrap | 同上 | +| 默认 multi + upgrade always-multi | 行为分支 ← `402429ac`/`d5c8982c` | +| skillhome / 安装面 bootstrap | 行为分支 | --- -## 5. Port / Adapt / Reject（悟空 · **内容树**） +## 5. Port / Adapt / Reject -| 悟空内容相关 | 决策 | 说明 | +| 项 | 决策 | 说明 | |---|---|---| -| flat `dingtalk-*` + `dws-shared` 目录模型 | **Port（内容语义）** | DWS 已具备；固化为合同 | -| 单 skill = `SKILL.md` + `references/` + 可选 `scripts/` | **Port** | 已同构 | -| `dws-shared` 放跨产品契约/routing | **Adapt** | 对齐职责边界；不抄 overlays | -| references 编号/文件名习惯 | **Adapt（可选）** | 订 DWS 自己的索引约定，不强制改名大爆发 | -| 12 产品内容正文 | **Reject（抄库）** | 不合一；缺口用文档跟踪 | -| bundle `manifest` + `_install.sh` + 外层 `skills/` | **Reject** | 安装/客户端包形态 | -| `sync-monolith-to-multiskill.py` | **Reject / 另议** | 派生流水线属内容工程化，仅当 Phase 2 证明需要「从 mono 生成 multi」再开题；默认直接维护 multi | -| dual / Qwen overlay / pod | **Reject** | 非内容树 | +| flat + `dws-shared` 内容模型 | **Port** | 已有；合同 + 质检加固 | +| 悟空 bundle frontmatter/断链/requires 检查维度 | **Adapt** | 做成 DWS 源树门禁，不校验 bundle zip/安装 | +| whiteboard 式 mono/multi 成对一致 | **Port（范式）** | 推广到 reviewed 文件对 | +| `validate-multiskill-bundle.py` 整脚本 | **Reject** | 绑定悟空 zip/Qwen 语义 | +| `_install.sh` / dual / overlay | **Reject** | 非内容 | +| 行为 cherry-pick | **Defer** | 另分支 | --- -## 6. 与 `402429ac` / `d5c8982c` 的关系 +## 6. 与 `402429ac` / `d5c8982c` -| 问题 | 结论 | +| | | |---|---| -| 本分支是否 cherry-pick？ | **否** | -| 是否作为 Phase 1？ | **否** | -| 它们是什么？ | 安装/升级 **行为**（默认 multi、upgrade 强制 multi、脚本真装） | -| 何时做？ | **单独 follow-up 分支**（建议仍从 `origin/main` 拉出，例如 `feat/multi-skill-install-default`），且只带 skill 行为 diff、不绑内容大改 | -| 本分支与行为分支顺序？ | 可并行；内容合同稳定有利于行为分支少踩「目录假设」；**不**要求内容分支先合并才能做行为分支 | +| 本分支 cherry-pick？ | **否** | +| 质检是否替代行为翻转？ | **否** | +| 行为分支 | 另开；可与内容/质检并行 | --- -## 7. 批准清单（内容框架 only · 请重新勾选） +## 7. 批准清单（请重新勾选） **范围** -- [ ] 认可本分支 **仅** skill **内容**框架（§0.1） -- [ ] 认可 §0.2：安装/升级/`skill_setup`/`paths`/`skillhome`/install 脚本/`402429ac`·`d5c8982c` **均不在本分支** -- [ ] 认可取消产品与悟空客户端链路仍拒绝 +- [ ] 本分支 = skill **内容**框架 + **mono↔multi 内容质检**（§0.1）；无安装/升级引擎 +- [ ] `402429ac`/`d5c8982c` 及 setup/paths/install 脚本行为 **不在本分支** +- [ ] 取消产品与悟空客户端链路仍拒绝 -**Phase（内容）** +**内容框架 Phase** -- [ ] **Phase 1**：multi 内容目录合同 + 与悟空内容树对照短文（可执行） -- [ ] **Phase 2**：mono↔multi 内容映射与缺口表 —— 本迭代做 / 拆后续 -- [ ] **Phase 3**：内容形状护栏（测试/policy）—— 做 / 不做 / 以后 -- [ ] **Phase 4**：纯内容元数据文件 —— 做 / 不做 / 以后 +- [ ] **Phase 1**：multi 目录合同 + 悟空内容树对照短文 -**Follow-up（仅登记，不批准即不在本分支做）** +**质检轨 Phase** -- [ ] 知悉安装默认 multi + upgrade always-multi 将走 **另一分支**（可基于 `402429ac`/`d5c8982c`） +- [ ] **Phase 2**：质检矩阵 + mono↔multi 覆盖/缺口基线规格（先文档，可执行） +- [ ] **Phase 3**：CI 内容护栏（G1–G4）—— 本迭代做 / 拆 PR / 只要规格暂不落地 +- [ ] 质检失败处置原则：修内容或 reviewed omit，**不**改安装默认 + +**可选** + +- [ ] **Phase 4A** 纯内容元数据：做 / 不做 / 以后 +- [ ] **Phase 4B** 按缺口基线修内容（recovery/确认/orphan 等）：本分支做 / 另开内容 PR / 以后 + +**Follow-up 知悉** + +- [ ] 安装默认 multi + upgrade always-multi → **另一分支** --- ## 8. 下一步 -**请 owner 按 §7 对「内容框架 only」重新批准。** -批准前不编码。批准后默认推进 Phase 1 文档/合同；Phase 2–4 按勾选。 -安装/升级 cherry-pick **等待另开分支指令**，不在本方案 Phase 内启动。 +**请 owner 按 §7（含质检轨）重新批准。** +批准前不实现新 gates、不改安装代码。 +批准后建议顺序：Phase 1 合同 → Phase 2 质检规格 →（勾选后）Phase 3 护栏 → Phase 4 按需。 --- -*内容路径锚点：`skills/mono`、`skills/multi`、wukong `dingtalk-skills/`（`git show origin/develop:…`）。* +*锚点：`skills/mono`、`skills/multi`、§1.5 policy/测试、wukong `dingtalk-skills/` + `validate-multiskill-bundle.py`（思路 only）。*