读开源项目还在翻 README？这个 Skill 一句话给你出完整架构报告

看开源项目最烦的是什么？clone 下来一堆文件，README 写得像产品宣传页，但你最想知道的那几件事——架构为什么这么设计、哪个模块是核心、和同类项目比差在哪——一个字都没有。

今天翻到一个 Skill，专门治这个毛病：repo-analyzer。

它到底干了什么

你只需要在 Claude Code 里说一句”分析项目 xxx/yyy”，它就自己启动 8 阶段工作流：

• 自动 clone 目标仓库
• 做外部调研（搜评测、官方文档、技术博客）
• 并行拆解每个核心模块（用 subagent 并发跑）
• 交叉验证不同模块的发现
• 自适应 Q&A 阶段（针对项目类型问深一层）
• 生成带 Mermaid 架构图的完整 Markdown 报告

整套活儿跑下来，从输入到出报告你不用再写一行 prompt。

跟普通 AI 提问的差别在哪

普通的”AI 帮我看看这个项目”基本是给你复读 README——讲讲函数签名、列列目录结构，完事。repo-analyzer 的 SKILL.md 第一条原则写得很直白：从”这个项目解决什么问题”出发，不是”这个文件里有什么函数”。

举个栗子。同样一个 Web 框架：

• 普通 AI 答：”handleRequest(ctx) 函数接收一个 Context 参数”
• repo-analyzer 答：”路由系统选择洋葱模型而非线性管道。线性管道实现更简单，但洋葱模型让每个中间件能同时处理请求和响应阶段，这对日志、计时、错误恢复至关重要”

前者是 read the code，后者是 understand the design。这就是差距。

三种深度模式可选

它提供三种分析深度，适合不同场景：

• Quick：5 分钟出概要，适合技术选型初筛
• Standard：15-20 分钟出完整架构图，适合 Code Review 前置
• Deep：30+ 分钟带模块级细节 + 竞品对比，适合做技术分享或团队培训

实际使用感受

我拿它分析过几个中型项目，最大的感受是竞品对比那一节写得到位——它会自动找同类项目（按 stars 排序 + 同期活跃度筛选），然后告诉你”这个项目选择了 A 方案而隔壁选 B 方案，各自的代价是什么”。这种横向对比自己手动搜要花两小时，它 30 秒给你。

Mermaid 架构图也是真能用——不是那种敷衍的方块连接图，而是带数据流方向、条件分支、模块依赖关系的工程级图。直接贴到 Confluence 或飞书文档里毫无违和感。

一点使用提醒

默认输出是中文，但如果你用英文提问，它会跟着切英文。建议指定 MCP 增强效果：装上 Tavily（网站爬取）和 Brave Search（替代搜索引擎）后，外部调研的质量会明显高一档。

怎么装

一行命令搞定（兼容 Claude Code、Codex、Cursor）：

• npx -y skills add yzddmr6/repo-analyzer –agent claude-code

项目地址 → https://github.com/yzddmr6/repo-analyzer

下次遇到想挖的开源项目，别再对着 README 发呆了。让 AI 替你先做一遍尽职调查。🔍

GitHub: https://github.com/yzddmr6/repo-analyzer