weaveboard-pmlisted
Install: claude install-skill tohnee/weaveboard
# Weaveboard PM — 项目管理看板生成
把用户的项目信息变成一个**可直接打开的单文件看板**:里程碑、任务依赖、关键路径、风险登记册、决策记录(ADR)、状态看板,全部内嵌在一个 HTML 里,双击即用,数据不出本机。
## 工作流一:新建看板(最常用)
1. **收集信息**:从用户口述、PRD、周报或 issue 里提取——里程碑(≤3)、任务与负责人/日期、任务依赖(谁卡谁)、风险(概率×影响)、关键决策。信息不全时按 `references/authoring.md` 的口径补全合理默认值,并明确告知用户哪些是假设。
2. **写数据**:严格按 `references/schema.md` 的字段表与枚举生成 `data.json`。布局、依赖建模、风险评分口径遵循 `references/authoring.md`。
3. **校验(必须,直到 0 错误)**:
```bash
node scripts/validate_board.mjs <data.json>
```
输出会给出 CPM 推演完工日期与关键路径链——检查链条能否读成一句话,浮时分布是否合理;不���理先修数据。
4. **生成看板**:
```bash
node scripts/new_board.mjs <data.json> -o <项目名>.html
```
(引擎默认取 `assets/weaveboard-offline.html`;若提示缺内嵌入口,先跑 `scripts/sync_engine.sh`。)
5. **交付**:告诉用户双击打开即见"概览"驾驶舱;所有视图(概览/空间/WBS/看板/时间线/图谱)可直接用;改数据在右侧属性面板编辑,自动保存到浏览器。
## 工作流二:周度维护(进度 / 基线 / 效率)
1. 用户给出进展(口头或 issue 列表)→ 更新对应任务的 `status` / `progress` / `actualHours`,受阻的加 blocker。
2. **基线纪律**:项目首次计划冻结时提醒用户在 WBS 概览点「设为基线」;此后每次更新关注"基线偏差" chip——顺延集中在关键路径上时必须在回报中指出。
3. **效率读数**:驾驶舱 SPI(EV/PV,进度绩效)与 CPI(EV/AC,按工时的投入效率)< 0.9 会在概览标红;向用户解释时给口径(EV=Σ进度%×预计工时)。
4. 数据落盘:编辑 JSON → 校验 → `inject_data.mjs` 重注入,或让用户在应用内编辑后导出 JSON 回传。
## 工作流三:更新看板数据
- 仓库/目录里有 `*.weaveboard.json` 时:编辑 JSON → 再跑校验 → 原地重注入:
```bash
node scripts/inject_data.mjs <看板.html> <data.json>
```
- 用户在应用里改过并导出了新 JSON:用它覆盖源 JSON 后走同样流程。
- 提醒:浏览器 LocalStorage 里的数据优先于内嵌数据;注入后需在应用"数据与备份"里清空看板再刷新,或清理站点数据。
## 工作流四:导出报告
指引用户在应用内"数据与备份"操作(无需脚本):
- **导出 Excel**:5 个工作表(项目概览/任务清单/风险登记册/决策记录/依赖关系),数值单元格可直接汇总。
- **导出 Word 报告**:六