前言¶
接手别人的 uni-app 或 Vue 仓库时,结构是否清晰、技术债是否可控,往往要靠人工翻目录、扫依赖、看规范执行情况才能有个印象。这类工作重复且容易漏项。下面介绍 SkillHub 上的 Uni-app 项目分析器,它把「项目结构梳理、代码质量与隐患、技术债务量化、分析报告生成」交给 Agent 按 Skill 约定执行,适合在 Cursor、Claude Code 等支持 Skills 的环境里使用。
这是什么¶
Uni-app 项目分析器(坐标 @user_1cf5565c/uniapp-analyzer,版本 1.0.0)是 SkillHub 社区来源(community)的编程类 Skill,发布者为 user_1cf5565c,分类为 dev-programming。官方页面标注 requires_api_key=false,安装后无需额外 API Key。
一句话定位:面向 Vue 2/3 与 uni-app 技术栈,智能分析项目并输出可读的评估与报告;不适用于 React、Angular、Svelte、Python、Java、原生小程序或其他非 Vue 技术栈项目。
核心功能¶
依据 SkillHub 简介,已核实的能力包括:
- 项目结构分析:针对 Vue 2/3、uni-app 仓库做结构层面的梳理与理解。
- 代码质量与隐患:在分析过程中发现潜在代码风险与质量问题(具体检查项由 Skill 内指令定义,使用时以安装后的 SKILL 内容为准)。
- 技术债务量化:对技术债做量化评估,便于排期与重构决策。
- 分析报告生成:自动生成项目分析报告,可用于内部分享或文档沉淀。
适用触发场景(官方描述):需要分析 uni-app / Vue 项目结构、检查代码质量、评估技术债务、生成项目文档时,可启用该 Skill。
安装与启用¶
SkillHub 推荐通过 CLI 将技能安装到当前 Agent 的 skills 目录;未指定 --dir 时默认装到 ./skills/,Agent 可能无法识别。
1、安装 SkillHub CLI(若尚未安装)¶
先检查是否已有 CLI:
command -v skillhub && skillhub --version
未安装时可执行完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
将 @user_1cf5565c/uniapp-analyzer 安装到对应客户端的 skills 目录,例如:
# Cursor
skillhub install user_1cf5565c/uniapp-analyzer --dir ~/.cursor/skills/
# Claude Code
skillhub install user_1cf5565c/uniapp-analyzer --dir ~/.claude/skills/
# Codex(用户级或项目级二选一)
skillhub install user_1cf5565c/uniapp-analyzer --dir ~/.codex/skills/
SkillHub 页面亦提供自然语言安装方式:让 Agent 根据 SkillHub 安装说明 安装 @user_1cf5565c/uniapp-analyzer。安装后按所用客户端要求重启或刷新 Agent,使 Skill 生效。
典型用法¶
本 Skill 遵循通用 SKILL.md 格式,无单独 REST 接口;用法是在已打开目标 Vue / uni-app 项目的工作区中,向 Agent 提出与分析相关的任务,由 Skill 引导分析流程。可复现的表述示例(与官方简介一致,不承诺额外能力):
- 打开待分析的 uni-app 或 Vue 2/3 项目根目录。
- 在对话中说明需求,例如:「请用项目分析能力梳理目录结构、评估技术债务,并生成一份项目分析报告。」
- 根据 Agent 输出核对报告中的结构说明、风险点与技术债结论,再决定重构或文档归档。
不要在 React、Angular 等非 Vue 栈仓库上期望该 Skill 生效;官方已明确排除这些场景。
适用场景与注意¶
适合谁
- 维护或接手 uni-app、Vue 2/3 单体或多端项目的开发者。
- 需要在评审、交接或立项前快速产出结构化分析结论的团队。
限制与注意
- 技术栈边界清晰:仅 Vue / uni-app;其他框架应选用对应领域的 Skill。
- 分析深度取决于仓库规模与 Agent 上下文;超大单体仓库可能需要分模块多次分析。
- SkillHub 页面统计(截至资料抓取):评分 100000,下载 2868 次,安装 108 次;选用时可结合社区反馈与自身试点结果判断。
结尾¶
Uni-app 项目分析器把 Vue / uni-app 项目的结构梳理、质量与隐患关注、技术债量化以及报告生成收敛到一条 Agent 工作流里,适合在支持 Skills 的 IDE 或 CLI 中作为固定能力安装。官方 Skill 页与 API 入口:
- https://www.skillhub.cn/skills/user_1cf5565c/uniapp-analyzer
- https://api.skillhub.cn/user_1cf5565c/uniapp-analyzer