Summary Report Skill — Trae IDE 项目审查报告生成器
一句话生成专业级项目分析报告，12 个板块覆盖项目全貌，支持 HTML 交互式报告和 Markdown 纯文本报告
GitHub：GitHub - Luociqvq/Summary-Report-Skill: 📋 多项目通用的交互式项目审查报告生成器 — Trae IDE Skill · GitHub ｜ Gitee：Summary-Report-Skill: 📋 多项目通用的交互式项目审查报告生成器 — Trae IDE Skill ｜ License：MIT ｜ Version：v2.0
这是什么？
这是一个 Trae IDE 的 Skill 插件。当你在项目中说 “总结” 时，它会：
- 自动检测你的技术栈（9 种后端 + 5 种前端框架，无需手动配置）
- 并行采集项目数据（4 批次 17 路并行搜索，快速高效）
- 生成交互式 HTML 审查报告 或 Markdown 格式报告（用户可选择）
报告包含 12 个板块：项目概览、系统架构、请求流程、功能表、API 列表、文件列表、安全漏洞审查、逻辑问题、前后端匹配、优化建议、增量对比、优化路线图。每个板块可折叠展开，漏洞附带修复代码，路线图可勾选追踪进度。
此外，该 Skill 还支持 分析其他 Skill 的功能——读取目标 Skill 的 SKILL.md，生成结构化的功能分析报告，说明该 Skill 是做什么的、如何触发、核心功能、工作流程等。
解决了什么问题？
| 痛点 | 解决方案 |
|---|---|
| 手动翻代码找漏洞？ | 4 批次 17 路并行搜索，自动扫描安全漏洞 + 逻辑问题 |
| 不知道项目整体状况？ | 一键生成 12 板块审查报告，四维健康分数一目了然 |
| 漏洞看不懂怎么修？ | 漏洞代码 vs 修复代码双栏并排，关键行高亮标注 |
| 优化建议没有优先级？ | P0-P3 分级排序，可勾选路线图追踪进度，刷新不丢失 |
| 想了解别人的 Skill？ | Skill 分析模式，读取 SKILL.md 生成结构化功能说明 |
| 全部模板一次加载浪费 token？ | 模板按需加载架构，检测到什么框架才读什么模板，省 60-70% token |
报告效果预览
总览 — 统计卡片 + 四维健康分数
展开后展示统计卡片（后端控制器数、前端视图数、数据库表数）和四维健康分数进度条：安全性、逻辑性、兼容性、代码质量。
系统架构 — 分层架构图
Flexbox 盒子布局的系统架构图，从上到下展示应用层、前端模块、后端中间件、数据层的分层关系和连接方式。
请求流程 — 完整生命周期
基于项目实际代码分析总结的数据请求流程图，展示从用户操作到界面更新的完整请求链路。
功能表 — 模块卡片网格
每个功能模块一张卡片，包含功能描述、能力标签（CRUD/统计/筛选/安全警告）和详细说明。
API 列表 — 端点详情表格
完整的 API 端点表格，包含 HTTP 方法（颜色编码）、路径、功能描述、所属控制器。
安全漏洞 — 漏洞代码 vs 修复代码
漏洞按严重性分级（严重/高危/中危），每个漏洞附带 漏洞代码 和 修复代码 双栏并排对比，关键行高亮标注。
逻辑问题 — 逻辑缺陷 + 冗余代码
逻辑问题审查：字段不匹配、数据流错误、业务逻辑缺陷，以及冗余代码和孤立文件检测。
前后端匹配 — 兼容性验证
前后端模块兼容性验证表格，状态标注（匹配/警告/错误），检测 API 对齐、字段匹配、配置一致性。
优化建议 — P0-P3 优先级排序
按 P0 紧急 → P3 体验提升排序的优化建议卡片，每条包含影响范围和实施建议。
优化路线图 — 可勾选追踪
分 5 个阶段（P0 紧急 → P3 体验提升），checkbox 勾选后进度条自动更新，状态持久化到 localStorage，刷新不丢失。
更多截图见 Gitee 仓库
v2.0 架构亮点：模板按需加载
v2.0 进行了重大架构重构，将原来 808 行的 SKILL.md 瘦身为 238 行的轻量调度器，框架特定的分析逻辑拆分到独立模板文件中，按需加载：
传统做法（v1.0） 模板按需加载（v2.0）
┌──────────────────┐ ┌─────────────────────┐
│ SKILL.md 808行 │ │ SKILL.md 238行 │
│ 全部框架模板堆在 │ │ 轻量调度器 │
│ 一个文件里 │ │ ↓ 检测框架 │
│ → 上下文丢失 │ │ ↓ 按需读取模板 │
│ → token 浪费 │ │ ↓ 精准分析 │
│ → 结果不精准 │ │ → 省 60-70% token │
└──────────────────┘ └─────────────────────┘
优势：
- 节省约 60-70% token 消耗
- 避免无关框架模板干扰，分析结果更精准
- 不会因为上下文过长导致分析结果失真
- 便于扩展新框架，只需添加对应模板文件
12 个报告板块详解
| 板块 | 内容 | 亮点 |
|---|---|---|
| 概览 |
统计卡片 + 四维健康分数 | 安全性/逻辑性/兼容性/代码质量进度条 |
| 架构 |
Flexbox 系统架构图 | 前端 + 后端 + 数据库分层展示 |
| 流程 |
数据请求流程图 | 基于项目代码动态总结，非固定模板 |
| 功能表 |
模块卡片 + 能力标签 | CRUD/统计/筛选/安全警告标签 |
| API |
端点详情表格 | HTTP 方法颜色编码 + 参数 + 控制器 |
 文件 |
前后端文件完整清单 | 按类别分组，含路径和功能说明 |
| 漏洞 |
漏洞 vs 修复代码 | 双栏并排，关键行高亮，严重性分级 |
| 逻辑 |
逻辑缺陷 + 冗余代码 | 字段不匹配/数据流错误/孤立文件 |
| 匹配 |
前后端兼容性验证 | 匹配/警告/错误状态标注 |
| 优化 |
P0-P3 优化建议 | 含影响范围和实施建议 |
| 对比 |
增量对比 | 与上次报告比较，标记新增/已修复/变化项 |
| 路线图 |
可勾选任务 | localStorage 持久化进度，刷新不丢失 |
使用方式
触发词
| 触发词 | 示例 |
|---|---|
总结 |
“帮我总结一下项目” |
生成总结 |
“生成总结报告” |
| 审查请求 | “检查项目漏洞并生成报告” |
分析skill |
“分析这个 skill 是做什么的” |
交互流程
1️⃣ 框架检测 → 2️⃣ 格式选择 → 3️⃣ 交互选板 → 4️⃣ 并行采集 → 5️⃣ 生成报告 → 6️⃣ 输出文件
- 框架检测 — 自动检测项目技术栈
- 格式选择 — 若用户未指定格式，询问选择 HTML 或 Markdown
- 交互选板 — 询问你需要哪些板块和审查深度
- 并行采集 — 4 批次 17 路并行搜索采集项目数据
- 生成报告 — 按模板生成交互式 HTML 报告或 Markdown 报告
- 输出文件 — 在项目根目录生成报告文件 +
report-assets/（仅 HTML 模式）
使用示例
你：总结一下这个项目
Skill：检测到 ThinkPHP + Vue3 → 加载对应模板 → 询问格式/板块/深度 → 并行采集 → 生成报告
你：用 Markdown 格式总结
Skill：跳过格式询问 → 直接用 Markdown 输出
你：分析一下这个 Skill 是做什么的
Skill：读取 SKILL.md → 生成结构化功能说明报告
模糊回答自动使用默认值：HTML 格式 / 全选所有板块 / 深度模式
支持的技术栈
后端框架（9 种）
| 框架 | 检测方式 |
|---|---|
| ThinkPHP | server/think + server/app/controller/ |
| Laravel | app/Http/Controllers/ + artisan |
| Symfony | src/Controller/ + composer.json |
| Django/Flask | manage.py / app.py + views.py |
| Spring Boot | src/main/java/ + pom.xml |
| Express | app.js + package.json(express) |
| NestJS | nest-cli.json + src/index.ts |
| Node.js | server/ + package.json |
| Go | main.go + go.mod |
前端框架（5 种）
| 框架 | 检测方式 |
|---|---|
| Vue 3 + Vite | vite.config.js + src/*.vue |
| Vue 2 + Webpack | vue.config.js + src/*.vue |
| Next.js | next.config.js + src/app/ |
| React CRA | react-scripts in package.json |
| Nuxt 3 | nuxt.config.ts + app.vue |
自动检测，无需手动配置。 检测到什么框架就加载什么分析模板。
快速开始
# 1. 进入 Trae skills 目录
cd ~/.trae/skills # macOS/Linux
cd %USERPROFILE%\.trae\skills # Windows
# 2. 克隆
git clone https://gitee.com/luociqvq/Summary-Report-Skill.git
# 或从 GitHub 克隆
git clone https://github.com/Luociqvq/Summary-Report-Skill.git
在 Trae IDE 对话中输入 “总结” 即可触发。
目录结构
Summary-Report-Skill/
├── SKILL.md ← 轻量调度器（238行）
├── DOCS.html ← HTML 格式使用文档
├── DOCS.md ← Markdown 格式使用文档
├── explain.md ← 中文说明文档
├── summary-report_example.html ← 示例报告
├── screenshots/ ← 报告截图
├── analysis-templates/
│ ├── backend/ ← 7 个后端框架模板
│ │ ├── thinkphp.md
│ │ ├── laravel.md
│ │ ├── django.md
│ │ ├── spring-boot.md
│ │ ├── express.md
│ │ ├── go.md
│ │ └── generic-node.md
│ ├── frontend/ ← 5 个前端框架模板
│ │ ├── vue3.md
│ │ ├── vue2.md
│ │ ├── react.md
│ │ ├── nextjs.md
│ │ └── nuxt3.md
│ └── skill-analysis.md ← Skill 分析模板
├── report-templates/
│ ├── html-template.md ← HTML 报告模板
│ └── markdown-template.md ← Markdown 报告模板
└── report-assets/
├── report.css ← 报告样式（布局/组件/暗色/打印/响应式）
└── report.js ← 报告交互（折叠/路线图/主题/复制/排序/对比）
报告特色功能
暗色模式 — CSS 变量驱动，一键切换，状态保存到 localStorage- 增量对比 — 与上次报告对比，标记新增和已修复问题，数据保存到 localStorage
- 可勾选路线图 — 分 5 个阶段，checkbox 勾选后进度条自动更新，刷新不丢失
- 漏洞修复对照 — Critical/High/Medium 漏洞附漏洞代码和修复代码双栏对比
打印优化 — CSS 打印媒体查询，打印时自动隐藏导航和交互元素
响应式 — 移动端自适应布局
链接
许可证
MIT License — 自由使用、修改、分发
如果觉得有用，给个 
Star 吧！ Made by Luoci
编辑 → 下拉类别选「你要选的分类」→ 
保存，即可。