lync-cyber 项目可视化 (project-visualization)
把框架内既有的结构化数据渲染为可读图形。viz 不造数据、不做内容决策,只在 KG / doc-index / EVENT-LOG / CORRECTIONS / agent-skill 资产之上做薄渲染,经 cataforge viz <视图> CLI 调用。
能力边界
- 能做: 渲染追溯链、覆盖矩阵、依赖图、编排拓扑、阶段进度、时间线、腐化趋势为图/时间线/指标
- 不做: 不查实体属性(走
cataforge kg query/cataforge context read)、不出审查 verdict(走 code-review / doc-review / framework-review)、不写业务数据
输入规范
按"想看什么"选视图（先用 cataforge viz status 看哪些视图当前有数据），可选 --format mermaid|dot|json / --html / -o PATH / 各视图过滤参数:
| 想看什么 | 命令 |
|---|---|
| 项目健康 KPI(阶段/文档/覆盖/断链/腐化,默认 json) | cataforge viz overview |
| 编排拓扑 orchestrator→phase→agent→skill | cataforge viz framework |
| agent / skill / rules 资产目录(元数据+体量+依赖图,--html 出可搜索面板) | cataforge viz assets |
| 需求→模块→任务→测试追溯链 / 断链 | cataforge viz trace [实体ID] |
| Feature 实现 / 测试覆盖盲区 | cataforge viz coverage |
| 架构模块依赖图 | cataforge viz arch |
| 文档依赖图(stale / 断链高亮) | cataforge viz docs |
| 任务 DAG + 关键路径 | cataforge viz tasks |
| SDLC 阶段进度 + 门禁状态 | cataforge viz phase |
| EVENT-LOG 时间线 | cataforge viz timeline |
| 纠偏 / 腐化趋势 | cataforge viz decay |
| 全视图聚合健康度看板 | cataforge viz dashboard |
输出规范
- 默认文本:
--format mermaid|dot|json,GitHub / IDE / 文档站原生渲染,可-o PATH内联进文档 - 交互页:
--html产单文件离线 HTML(图用 Cytoscape.js、看板用 ECharts),零外链可断网打开 - 本地看板:
cataforge viz quickstart一键生成 + 本地服务 + 开浏览器 + 源变更自动重生成（浏览器刷新可见）
Anti-Patterns
- 禁止: 手写 mermaid 依赖图嵌进 dev-plan — 应跑
cataforge viz tasks --format mermaid,同一图算法产出,手写易与关键路径标注漂移 - 禁止: 把 viz 当数据源去查实体属性 — 结构化查询走
cataforge kg query/cataforge context read,viz 只渲染既有数据 - 禁止: 用 viz 产物替代质量门禁结论 — 覆盖图能暴露盲区但不出 verdict,审查结论仍由 code-review / doc-review 给出
- 避免: 无视空数据源直接跑视图 — KG / EVENT-LOG 未就绪时先
cataforge viz status再选有数据的视图