| name | project-visualization |
| description | 项目可视化 — 把既有知识图谱/文档索引/事件日志/纠偏日志/agent-skill 资产渲染为图、时间线、指标看板(经 cataforge viz CLI)。当需要看编排拓扑、需求→模块→任务→测试追溯链、Feature 覆盖盲区、架构模块依赖、文档依赖(stale 高亮)、任务 DAG 关键路径、SDLC 阶段进度、腐化趋势,或想要一张项目健康度总览看板时使用。文本(mermaid/dot/json)可内联文档,--html 出单文件离线交互页。 |
| argument-hint | <视图: overview|framework|assets|trace|coverage|arch|docs|tasks|phase|timeline|decay|dashboard> |
| suggested-tools | shell_exec |
| depends | [] |
| disable-model-invocation | false |
| user-invocable | false |
项目可视化 (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 再选有数据的视图
