宣贯方案总览
五包工程能力的落地宣贯文档（多项目集群管控方案）线上版。每份文档面向对应角色，覆盖：为什么统一、包已固化哪些能力、三种接入场景怎么做、问题归属怎么判断、验收清单与会议输出。
最新版本以各包 npm 发布与
wl仓库根目录源文档为准，本站内容随版本发布同步更新。
文档目录
| 包 | 宣贯文档 | 当前核对版本 | 适用对象 |
|---|---|---|---|
wl-skills-ui | 前端 UI 统一规范落地宣贯 | v1.12.0 | 前端负责人、前端开发、UI 相关协作人员 |
wl-skills-kit | 前端编码规范落地宣贯 | v2.20.1 | 项目负责人、前端负责人、前端开发 |
wl-skills-design | 产品设计规范落地宣贯 | v0.11.1 | 产品负责人、设计人员、架构师 |
wl-skills-bd | 后端开发规范落地宣贯 | v0.24.0 | 后端负责人、后端开发、DBA、运维 |
wl-skills-test | 测试工程规范落地宣贯 | v0.11.0 | 测试负责人、测试开发、前端/后端协作人员 |
五份文档的共同结构
每份宣贯文档遵循同一骨架，便于跨包对照阅读：
- 宣贯目标与核心结论 — 一段统一认识 + 版本演进速览
- 落地背景与现存问题 — 具体到代码/文档的痛点清单与根因判断
- 方案定位与统一原则 — 不是什么/是什么、事实来源、管控方式
- 整体工程架构 — 分层图与层级职责
- 统一管控覆盖维度 — 逐条规范/规则展开
- Skill/工具全景 — 数量、能力、触发方式
- 接入流程 — 新项目 / 存量整改 / 日常增量三种场景
- 问题归属判断 — 决策树：改公共包、改本项目还是改契约
- 全员执行要求 — 必须执行 / 明确禁止 / 允许但需评审
- 角色职责 · 验收清单 · 反馈机制 · 落地价值 · 会议输出
- 附录 — 常用命令速查、规范与工程能力对应表
宣贯会后建议动作
- 各角色按"我该从哪里开始"路径完成对应包的安装与
doctor体检； - 按 快速上手（后端）/ 前端快速上手（前端）跑通最小闭环；
- 存量项目先做只读体检（
validate/audit/verify db），拿报告再定整改计划； - 公共问题按各文档"问题归属判断"决策树归口，不在项目内打局部补丁。
反馈与更新
- 文档与包能力不一致时，按对应宣贯文档第十三章（反馈机制）提供版本、场景、复现样例；
- 每次包发版后，本目录随在线站点同步更新"当前核对版本"与能力变化。