| name | cross-design-review |
| description | **设计集成评审技能** — 把需求设计(spec)、数据库设计(DB)、接口设计(IF)三份产物聚合成一份 量化评审报告:综合评分(4 等级)、P0/P1/P2 分级问题清单、spec→接口→表 追溯矩阵、跨文档联动校验、修复任务。 USE FOR: 对一个模块/分册做整体设计评审;检查需求/数据库/接口三份文档是否一致闭环; 生成评审报告 / 评分报告 / 设计质量报告;复评(修复后再评分)。 DO NOT USE FOR: 只评单一文档(DB 用 data/database/sub/04;接口用 api/restful/sub/04); 生成设计本身(用对应的 create skill)。
|
| tools | ["create_file","read_file","replace_string_in_file"] |
设计集成评审规范(wl-skills-design)
本 Skill 产出第二层评审报告:聚合各产物的 validate 结论 + 跨文档三角联动 + 综合评分。
它不重新逐项检查 spec/DB/IF(那是各自 review 的事),而是消费它们的结论再叠加 D4 联动与评分。
第一步(必须):加载规范
.github/standards/07-design-review.md
唯一权威来源,包含:评审对象(D1~D4)、评分模型(公式 + 4 等级 + P0 一票否决)、问题分级(P0/P1/P2/P3)、D4 联动 18 项、追溯矩阵、报告结构、执行清单(RV 12 项)、复评协议、报告模板。不读规范,不出报告。
第二步:按顺序加载 Sub-Skill(三步流水线)
| 顺序 | 任务 | Sub-Skill 路径 | 产出 |
|---|
| 1 | 采集 spec/DB/IF 三份 validate 结论 | sub/01-collect.md | 三维度通过/失败/暂挂计数 |
| 2 | 计算 D4 跨文档三角联动(18 项) | sub/02-cross-check.md ⬅ 核心 | 联动结果 + 追溯矩阵 |
| 3 | 评分 + 分级 + 出报告 | sub/03-score-report.md | DESIGN_REVIEW 报告 |
必须按 1→2→3 顺序执行,后一步依赖前一步的数据。
第三步(可选):参考模板
| 模板 | 用途 |
|---|
templates/review-report.md | 完整评审报告模板(仪表盘 + P0 清单 + 追溯矩阵 + 修复任务,直接套用) |
⚠️ 闭环工作流(必须遵循)
[阶段1] 采集(读取 DB_REVIEW_*/IF_REVIEW_*/spec 结论;缺则现场触发或标「未提供」)
↓
[阶段2] 联动(D4 18 项三角校验 + 追溯矩阵)
↓
[阶段3] 评分(各维度得分 + 综合得分 + 等级,应用 P0 一票否决)
↓
[阶段4] 自检(RV 12 项执行清单全过)→ 出报告 → ✅ DONE
执行规则
| 规则 | 说明 |
|---|
| 不重算逐项 | D1/D2/D3 引用各 artifact 报告结论;D4 现场计算 |
| 暂挂排除分母 | 「跨文件暂挂 / 待补充」不计入分母(§2.1),但显著标注 |
| P0 一票否决 | 有任何 P0 → 综合等级最高 🟠 待改进(§2.4) |
| 必出追溯矩阵 | spec功能 → 接口 → 落库表,覆盖所有功能编码(§五) |
| 修复任务排序 | 严格 P0 → P1 → P2,每条带修复建议(§六/§十) |
| 缺对端文档 | 显著标「⚠️ 缺 {文档},N 项联动未校验」,不静默跳过 |
产出位置
docs/review/
└── DESIGN_REVIEW_{模块}_{日期}.md
输出后必答(§七 Step 7)
- 使用 Skill:cross-design-review
- 参考规范:standards/07-design-review.md
- 综合得分 / 等级 / P0 数
- 报告路径
- 评审结论(可进入开发 / 修复后复评 / 重新设计)+ 下一步