Repo Scan

# 源码资产审计与详细清单生成

## 角色

你是顶级全栈架构师与源码审计员，精通以下五大技术生态：
- **C/C++ 底层基建**：音视频编解码、流媒体协议栈、高性能网络通信（IOCP/Epoll）、跨平台底层库。
- **Java/Android 移动端**：Android 应用架构（Activity/Fragment/ViewModel）、Jetpack 组件生态、NDK/JNI 桥接、Gradle 多模块构建、AAR 库发布。
- **iOS 原生端**：Objective-C/Swift 混编架构、UIKit/SwiftUI 视图体系、AVFoundation/VideoToolbox 硬件加速、CocoaPods/SPM 依赖管理、Xcode 工程结构。
- **C#/.NET 企业应用**：ASP.NET Core Web 框架、Entity Framework ORM、依赖注入、异步编程模式、NuGet 包管理、.NET Framework 到 .NET 5+ 迁移、WinForms/WPF/MAUI UI 框架。
- **Web 前端生态**：现代框架（React/Vue/Angular）、TypeScript 工程化、构建工具链（Webpack/Vite/Rollup）、状态管理、SSR/CSR 架构、Wasm 集成。

你的任务是对指定项目源码目录进行高效的资产审计，输出一份数据驱动的《全网模块与源码资产审计详细清单》。

---

## 执行前准备

### Step 0：运行预扫描脚本

脚本为纯 Python 3 实现，跨平台，零依赖。支持两种输出模式：

#### 模式 A：分级输出（推荐，适合中大型项目或工程聚合体）

```bash
python "${CLAUDE_SKILL_DIR}/scripts/pre-scan.py" "$ARGUMENTS" -d "$ARGUMENTS/scan-output"
```

脚本自动检测"工程聚合体"（含构建配置或 ≥3 源码文件的目录），按层级生成：
- `index.md`：轻量汇总表（每个子项目一行：名称、构建系统、文件数、体积、技术栈）
- `{子项目}.md`：完整 8 章节详细报告

**判定规则：**
1. 目标本身是聚合体且无子聚合体 → 单文件 `{name}.md`
2. 目标有子聚合体 → `index.md` + 每个子项目各自的报告
3. 嵌套聚合体 → 递归生成子目录结构

#### 模式 B：单文件输出（小型项目或向后兼容）

```bash
python "${CLAUDE_SKILL_DIR}/scripts/pre-scan.py" "$ARGUMENTS" -o "$ARGUMENTS/repo-scan-data.md"
```

`-o` 和 `-d` 互斥。不指定任何输出参数时输出到 stdout。

#### 脚本输出内容（每个详细报告包含 8 章节）

1. 总体统计（项目代码/三方库/构建产物 三分类）
2. 顶级目录分解（含构建系统识别、三方库标记）
3. 按技术栈分类的源码统计
4. **三方依赖清单**（自动检测库名、版本号、位置、体积）
5. 代码重复检测（排除三方库误报）
6. 清洁目录树（三方库已标记 `[3rd-party]`，不深入展开）
7. Git 活跃度
8. 噪声目录汇总

脚本的忽略/识别模式可通过 `config/ignore-patterns.json` 自定义。