workflow-dashboard

name	workflow-dashboard
description	工作流度量仪表盘 Skill。一条命令扫描 pm-assistant 项目目录的本地产物（gate-results JSON、PRD 文档、wireframes、hifi-wireframes），生成含 Chart.js 图表的自包含 HTML 仪表盘（dashboard.html）。展示：7 阶段流程进度时间轴、产物统计卡片（Module PRD 数 / 低保真原型数 / 高保真原型数 / Gate 评审轮次）、Gate 评审雷达图 + 堆叠条形图（pass/warn/fail）、待改进事项清单。触发条件：(1) 查看/生成项目指标或度量，(2) 生成工作流仪表盘，(3) 可视化 Gate 评审结果，(4) 流程健康检查，(5) 产物覆盖率统计，(6) 生成 dashboard，(7) 查看评审进度或产物状态。

工作流度量仪表盘

概述

本 Skill 读取仓库内本地文件，为单个 pm-assistant 项目生成 自包含的 HTML 度量仪表盘。
无需服务器、无需 GitHub API、无需额外 npm install，一条命令即可运行。

适用范围：单项目，不跨项目汇总。

---

数据来源（全部本地文件）

数据	来源路径	采集内容
Gate 评审结果	projects/prd-{项目}/gate-results/*.json	decision、各维度分数、pass/warn/fail 计数
PRD 版本号	projects/prd-{项目}/prd-{项目}.md	正则提取 vX.Y.Z
Module PRD 数	projects/prd-{项目}/modules/prd-*.md	文件计数
低保真原型数	projects/prd-{项目}/wireframes/*.html	文件计数（排除 index.html）
高保真原型数	projects/prd-{项目}/hifi-wireframes/*.html	文件计数（排除 index.html）
阶段完成状态	各阶段关键产物文件的存在性	7 阶段 ✅/⏳/⬜

---

使用方式

推荐：npm script

npm run dashboard -- videoprompt-ai

直接运行（推荐，从 skill 包执行）

node .github/skills/workflow-dashboard/scripts/generate-dashboard.js <项目名>

示例：

node .github/skills/workflow-dashboard/scripts/generate-dashboard.js videoprompt-ai

scripts/generate-dashboard.js 是一个转发入口，实际逻辑在 skills/workflow-dashboard/scripts/generate-dashboard.js，两者效果相同。

生成后打开

open projects/prd-videoprompt-ai/dashboard.html

---

输出

• 生成文件：projects/prd-{项目名}/dashboard.html
• 打开方式：直接双击或 open 命令，无需服务器
• Chart.js：从 CDN 加载（需联网）；项目数据已内联，离线仅图表不渲染

---

仪表盘内容结构

┌──────────────────────────────────────────────────────┐
│  项目名 · PRD 版本 · 生成日期                         │
│  ████████████░░░░░  工作流进度 5/7 阶段 (71%)         │
├──────────────────────────────────────────────────────┤
│  流程阶段时间轴                                       │
│  ✅ 立项 › ✅ PRD › ✅ Gate1 › ⏳ 高保真 › ⬜ 架构… │
├────────┬────────┬────────┬─────────────────────────┤
│ Module │ 低保真 │ 高保真  │ Gate 评审轮次             │
│ PRD 数 │ 原型数 │ 原型数  │                         │
├──────────────────────────────────────────────────────┤
│  Gate 1 评审       [Conditional Go]  2026-04-13      │
│  摘要文字（蓝色左边框）                               │
│  [雷达图：各维度得分]  [横向堆叠条形图：✅⚠️❌]       │
├──────────────────────────────────────────────────────┤
│  待改进事项 (N 条)                                    │
│  ⚠️ Gate 1 · 商业合理性 · 目标用户和痛点无数据支撑…  │
└──────────────────────────────────────────────────────┘

---

前置条件

• Node.js 已安装（无需额外安装 npm 包，使用内置 fs/path）
• 项目目录符合 pm-assistant 规范：projects/prd-{项目名}/
• gate-results/ 目录下有标准格式的 Gate 评审 JSON（无 JSON 时仍可生成，仅展示产物统计和阶段状态）

---

Gate JSON 格式要求

Gate 评审 JSON 需包含以下字段才能渲染图表：

{
  "gate": "Gate 1",
  "project": "videoprompt-ai",
  "date": "2026-04-13",
  "decision": "Conditional Go",
  "summary": "...",
  "dimensions": [
    {
      "name": "需求完整性",
      "weight": 0.30,
      "score": 0.90,
      "pass_count": 9,
      "warn_count": 1,
      "fail_count": 0,
      "items": [
        { "id": 1, "check": "...", "result": "pass", "note": "..." }
      ]
    }
  ]
}

weight: 0.00 的维度会包含在条形图中，但不参与雷达图和加权总分计算。

---

约束

• 仅读取本地仓库数据，不调用 GitHub API 或任何外部服务
• 单项目视图，不跨项目汇总
• 生成的 dashboard.html 可以放入 .gitignore（按需）或提交到仓库作为快照