# Repo Analyzer

> Static AST analysis of Python repositories without pip install. Use when analyzing external/unfamiliar repos where installing dependencies is impractical. Extracts classes, functions, signatures, inheritance chains, and import relationships. Triggers: AST分析, 仓库分析, 结构分析, analyze repo, 代码结构

- Skill: `zhizhunbao/repo-analyzer` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add zhizhunbao/repo-analyzer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhizhunbao/repo-analyzer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zhizhunbao (https://skillmd.com/u/zhizhunbao)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhizhunbao/repo-analyzer

---


# Repo Analyzer

> **核心问题**: 如何在不安装目标包的情况下，理解一个陌生仓库的结构？

## 方法论

用 Python `ast` 模块做纯静态分析，零运行时依赖。

### 分析优先级

```
1. 先读 AI 指令文件（信号密度最高）
   └─ AGENTS.md / CLAUDE.md / CONTRIBUTING.md

2. 再跑 AST 结构分析
   └─ scripts/analyze_repo.py → *_structure.json

3. 可选 gitingest 生成摘要
   └─ scripts/gitingest_all.ps1 → *_digest.txt
```

### AI 指令文件

很多主流项目自带 AI 理解指令（如 langchain 有 `AGENTS.md` + `CLAUDE.md`），
这是项目维护者专门为 AI 编写的架构说明，**信号密度极高，应优先读取**。

### AST 提取内容

| 维度 | 提取内容 |
|------|----------|
| 结构 | 类定义、函数/方法签名、装饰器 |
| 关系 | import 语句、继承链、模块间依赖 |
| 度量 | 文件行数、类数量、函数数量 |

### 反模式

| 工具 | 为什么不用 |
|------|----------|
| `pydeps` | 需要 pip install，无法分析未安装的外部仓库 |
| `Tach` | 面向自己项目的边界管理，不适合拆解外部代码 |
| `importlab` | 依赖运行时 import 解析 |

## 使用

```bash
cd c:/Users/40270/.workbuddy/skills/repo-reuse-flow

# 分析单个仓库
.venv\Scripts\python.exe skills/repo-analyzer/scripts/analyze_repo.py /path/to/cloned/repo \
  -o outputs/03_analysis/structures/repo_structure.json

# 批量克隆 + 分析
skills/repo-analyzer/scripts/clone_repos.ps1 -Repos "owner/repo1","owner/repo2"
skills/repo-analyzer/scripts/gitingest_all.ps1
```

## 输出

`*_structure.json` 包含：
- `files` — 每个 .py 文件的类/函数/import 列表
- `summary` — 统计信息（总文件数、总类数、总函数数）

## 脚本

| 脚本 | 作用 |
|------|------|
| `scripts/analyze_repo.py` | 核心 AST 分析（本 skill 目录下） |
| `scripts/clone_repos.ps1` | 克隆仓库 |
| `scripts/gitingest_all.ps1` | 批量 gitingest 摘要 |