@agile-team/wl-skills-design — 产品设计 AI 技能包
版本：v0.7.0 · 9 条设计规范 + 8 个 AI Skill + 15 个 Copilot Prompt，支持 10 种 AI 编辑器
这是什么？
一套面向产品设计阶段的 AI 技能包 — 覆盖从业务流程图、需求说明书、原型标注到数据库设计、接口设计、术语词典、变更影响分析、集成评审的完整链路。让 AI 按团队规范做设计，且生成即合规、自检、可追溯。
与 wl-skills-kit（前端代码生成）和 wl-skills-ui（UI 风格对齐）形成三包协作：
wl-skills-design（需求设计）→ wl-skills-kit（代码生成）→ wl-skills-ui（视觉一致性）快速开始
bash
# 安装到设计项目
npx @agile-team/wl-skills-design
# 更新到最新版本（本地改动自动备份为 .bak）
npx @agile-team/wl-skills-design update
# 预览安装内容
npx @agile-team/wl-skills-design --dry-run安装完成后，直接在 AI 对话中描述设计需求即可触发对应 Skill。
核心架构：双层资料（模板 + 样例）
每个 Skill 目录下并排放两层资料，职责严格分离，两层都随包发布：
templates/ 默认模板 | examples/ 真实样例 | |
|---|---|---|
| 角色 | 空白起点（脚手架） | 质量标杆（参照系） |
| 内容 | 纯结构 + {占位符}，零业务数据 | 真实场景填好的内容 |
| AI 怎么用 | 复制后替换占位符开始写 | 生成后对照自检，且必须做得不低于它 |
模板告诉 AI「该有哪些结构」，样例告诉 AI「好到什么程度才算达标」。样例源自真实项目（如烟台华新数智化改造），规范升级时同步抬高。
技能覆盖
| 设计域 | 技能 | 关联规范 | 验证项 | 状态 |
|---|---|---|---|---|
| 系统需求 | draw.io 业务流程图（泳道图） | 01-flowchart.md | 20 项 | ✅ v1.0 |
| 系统需求 | 需求设计说明书（IPO / 流程说明 / 活动说明 / 报表） | 06-spec-doc.md | 43 项 | ✅ v1.0 |
| 系统需求 | 原型标注（交互模式 / 字段 / 组件 / D1–D3 深度） | 02-prototype.md | 23 项 | ✅ v1.0 |
| 数据设计 | 数据库设计（ER / DB 清单 / 数据字典 / DDL） | 03-database.md | 34 项 | ✅ v1.0 |
| 接口设计 | 接口设计（系统集成报文 / RESTful / OpenAPI） | 04-api-design.md | 38 项 | ✅ v1.0 |
| 跨域评审 | 设计集成评审（评分 / 追溯矩阵 / 跨文档一致性） | 07-design-review.md | D4 18 项 | ✅ v1.0 |
| 跨域词典 | 术语字段词典（中英文名 / 枚举 / 编码统一锚点） | 08-glossary.md | 18 项 | ✅ v1.0 |
| 跨域协同 | 变更影响分析（影响矩阵 / 补丁计划 / 复验顺序） | 09-change-impact.md | 20 项 | ✅ v1.0 |
| 代码设计 | 业务逻辑代码结构 | 05-code-design.md | — | 🔲 规划中 |
设计全链路工作流
每个环节：生成 → 验证 → 自动修复，全链路闭环。VS Code Copilot 中按 / 调用对应 prompt。
推荐顺序：先建词典骨架 → 再做 spec / 原型 → 推导数据库 / 接口（边做边登记词典）→ 变更时先跑影响分析 → 最后集成评审出评分。词典先行能让「字段对不齐」从「评审时发现」提前到「设计时杜绝」。
1. 流程图
bash
"帮我画一个废钢采购流程图，涉及采购部、质检部、仓储部"- 输出 draw.io 格式泳道流程图
- 自动对照 20 项规范验证并修复
2. 需求设计说明书
bash
"帮我编写订单管理模块的需求设计说明书 IPO 表"- 生成 IPO 表 / 流程说明 / 活动说明 / 报表设计（5 文件拆分）
- 验证字段完整性、编码格式、流程与 IPO 一致性（43 项）
3. 原型标注
bash
"帮我标注订单列表页的原型，达到开发就绪（D3）"- 输出 D3 开发就绪页面标注（7 区块）
- 执行 23 项验证
4. 数据库设计
bash
"帮我设计订单模块的数据库表结构和数据字典"- 从 spec IPO 表推导 ER 图 / 数据字典 / DDL
- 执行 34 项验证，自动注入 7 个系统字段、索引、命名前缀
5. 接口设计
bash
"帮我设计订单状态变更接口（RESTful）"- 从 spec 功能编码推导接口清单 / RESTful 定义
- 执行 38 项验证（统一响应包装、安全、幂等、spec/DB 字段联动）
6. 术语词典
bash
"帮我建订单模块的术语字段词典，统一 spec/数据库/接口的字段命名"- 统一中英文名 / 枚举 / 编码，作为字段对齐中央锚点
- 执行 18 项验证
7. 变更影响分析
bash
"订单状态新增退回，帮我分析会影响哪些设计文档并出补丁计划"- 逐域判断 spec / glossary / DB / API / prototype / review
- 输出 P0/P1/P2 补丁任务 + 推荐复验顺序（20 项）
8. 集成评审
bash
"对订单模块三份设计文档做一次整体评审，给我出评分报告"- 自动采集 spec / DB / IF 三份 validate 结论
- D4 跨文档三角联动 18 项检查
- 输出综合评分报告：仪表盘 + P0 阻断清单 + 追溯矩阵
规范体系（9 条）
| 编号 | 规范 | 状态 | 验证项数 |
|---|---|---|---|
| 01 | draw.io 泳道流程图规范 | ✅ | 20 项 |
| 02 | 原型标注规范 | ✅ | 23 项 |
| 03 | 数据库设计规范 | ✅ | 34 项 |
| 04 | 接口设计规范 | ✅ | 38 项 |
| 05 | 代码设计规范 | 🔲 | — |
| 06 | 需求设计说明书规范 | ✅ | 43 项 |
| 07 | 设计集成评审规范 | ✅ | 18 项（D4 联动） |
| 08 | 术语字段词典规范 | ✅ | 18 项 |
| 09 | 变更影响分析规范 | ✅ | 20 项 |
VS Code Copilot Prompts（15 个）
| Prompt | 用途 |
|---|---|
/create-flowchart | 创建业务流程图 |
/validate-flowchart | 验证流程图规范合规 |
/create-spec-section | 创建需求说明书章节 |
/validate-spec-section | 验证说明书完整性 |
/create-prototype | 创建原型标注 |
/validate-prototype | 验证原型规范 |
/create-db-design | 创建数据库设计 |
/validate-db-design | 验证数据库设计 |
/create-if-design | 创建接口设计 |
/validate-if-design | 验证接口设计 |
/create-glossary | 创建术语词典 |
/validate-glossary | 验证术语词典 |
/analyze-change-impact | 分析变更影响 |
/validate-change-impact | 验证变更影响 |
/design-review | 集成评审出报告 |
安装后的项目结构
你的设计项目/
├── .github/
│ ├── copilot-instructions.md AI 主入口
│ ├── standards/ 9 条设计规范 + index.md 门控
│ ├── skills/
│ │ ├── _manifest.json 机器可读执行路由（触发词/状态/上下文/输出/闭环）
│ │ ├── _registry.md 触发词路由表（人读索引）
│ │ ├── _compat/ 多编辑器适配源
│ │ ├── requirements/
│ │ │ ├── flowchart/ 流程图 Skill（SKILL + USAGE + templates + examples）
│ │ │ ├── spec/ 需求说明书 Skill
│ │ │ └── prototype/ 原型标注 Skill
│ │ ├── data/database/ 数据库设计 Skill
│ │ ├── api/restful/ 接口设计 Skill
│ │ └── cross/
│ │ ├── design-review/ 集成评审 Skill
│ │ ├── glossary/ 术语词典 Skill
│ │ └── change-impact/ 变更影响分析 Skill
│ ├── prompts/ 15 个 Copilot Prompt
│ └── guides/ 使用指南
├── CLAUDE.md / AGENTS.md Claude / Agents 规则
├── .cursorrules / .windsurfrules Cursor / Windsurf 规则
└── .kiro / .trae / .qoder Kiro / Trae / Qoder 规则每个 Skill 目录的标准形态：
SKILL.md（AI 触发层）+USAGE.md（人读说明）+sub/（Sub-Skill）+templates/（空白模板）+examples/（真实样例）。
多编辑器支持（10 种）
| 编辑器 | 配置文件 |
|---|---|
| GitHub Copilot | .github/copilot-instructions.md |
| Claude Code | CLAUDE.md |
| Cursor | .cursorrules + .cursor/rules/conventions.mdc |
| Windsurf | .windsurfrules |
| Cline | .clinerules |
| Kiro | .kiro/steering/conventions.md |
| Trae | .trae/rules/conventions.md |
| Generic Agents | AGENTS.md |
| Qoder | .qoder/rules/conventions.md |
三包协作关系
| 包 | 职责 | 面向角色 |
|---|---|---|
wl-skills-design | 需求设计（流程图/说明书/原型/数据库/接口/术语词典/变更/评审） | 产品经理、架构师、设计师 |
wl-skills-kit | 前端代码生成（页面/规范/菜单/字典/权限） | 前端开发 |
wl-skills-ui | UI 风格对齐（设计令牌/化妆层/Runtime） | 前端开发 |
三包独立安装、契约对齐，共同消费同一份设计产出物。