项目架构全景可视化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_989eb8f0/tri-html。
技能介绍
解决什么问题
大型项目的架构往往散落在数百个源文件和配置文件中。直接阅读代码很难快速建立全局认知:技术栈版本是否一致、模块边界是否清晰、请求链路如何流转,这些问题的答案通常隐藏在依赖图和目录结构深处。
核心工作流
该技能的核心是六维分析框架:架构设计、目录结构、技术栈选型、代码设计、功能设计、特殊设计。激活后它会先扫描项目结构,在确认分析范围后逐维产出结论与图表。
图表生成采用双引擎分流:
- 架构图、时序图、数据流等五类技术图走
viewer高精引擎,生成带交互能力的独立 HTML 文件; - 目录树、技术栈矩阵、ER 图等走 Mermaid,内联进主报告。
最终交付物是一个零依赖单文件 HTML,CSS/JS/Mermaid 全部内联,可离线双击打开。报告支持深浅主题切换、维度折叠展开,并包含完整的架构观察记录。
适用边界
- 只分析不改代码:发现的问题记录在报告「架构观察」章节,修复需交由其他技能处理;
- 可独立使用,但配合
tri-intent快照路由时意图识别更精确; analysis.json作为可选中间产物,便于二次定制。
使用场景
- 接手复杂项目时,需要快速生成架构可视化 HTML 报告,包含六维分析,帮助理解项目全貌。
- 项目重构前,想清晰看到模块依赖和技术栈选型,要六维架构分析报告。
- 需要离线分享项目架构,生成可双击打开的单文件 HTML,零依赖可归档。
- 做架构评审时,要展示功能模块关系和特殊设计策略,用可视化图表呈现。
适合人员
- 后端开发者,接手新项目时想快速理解架构,生成可视化报告辅助分析。
- 架构师,做架构评审或版本对比时,需要六维分析报告展示设计决策。
- 技术负责人,项目迭代后想检查技术栈是否过时,通过报告了解全局。
- 开源项目维护者,需要为贡献者提供架构说明,生成可离线打开的可视化文档。