版本: v1.1 (增强版) 创建时间: 2026-03-12 作者: OpenClaw AI Assistant
Git Project Analyzer 是一个强大的项目深度分析工具，能够对 Git 项目进行多维度、细粒度的分析。支持目录级深度分析，自动拆分子任务对每个目录进行详细剖析。
- 📁 结构分析 - 目录树、文件类型、代码行数
- 🏗️ 架构分析 - 模块划分、设计模式、架构风格
- 🔗 模块关系 - 依赖关系、耦合度分析
- 🔄 代码流程 - 核心功能流程、数据流向
- ⚙️ 配置分析 - 构建系统、依赖管理
- 自动拆分子任务对每个目录进行详细分析
- 智能识别目录类型（Skill/Agent/Rule/Script/Test/Doc等）
- 专项分析策略（每个目录类型有专门的分析方法）
- 并行执行支持（大幅提升分析速度）
- 自动生成 Markdown 报告
- 支持创建/追加/更新飞书文档
- 增量更新，不覆盖已有内容
# 1. 保存当前会话上下文（推荐）
save-chat-context myproject-context.jsonl
# 2. 克隆项目
git clone https://github.com/user/repo.git /tmp/myproject
# 3. 执行完整分析
analyze-git-project /tmp/myproject --all
# 4. 查看报告
cat /tmp/myproject-analysis/ANALYSIS_REPORT.md# 对所有目录进行深度分析（并行模式）
analyze-directories /tmp/myproject \\
--output /tmp/myproject-dir-analysis \\
--parallel \\
--max-jobs 6
# 查看分析索引
cat /tmp/myproject-dir-analysis/DIRECTORY_INDEX.md
# 查看具体目录分析
cat /tmp/myproject-dir-analysis/skills_analysis.mdgit-project-analyzer/
├── SKILL.md # 主技能文档
├── README.md # 本文件
├── scripts/ # 脚本工具
│ ├── analyze-git-project.sh # 主分析脚本（5维度）
│ ├── analyze-directories.sh # 目录级深度分析
│ ├── save-chat-context.sh # 上下文保存
│ └── update-feishu-doc.sh # 飞书文档更新
└── references/ # 参考文档
├── structure-analysis.md # 结构分析方法
└── architecture-patterns.md # 架构模式参考
analyze-git-project /tmp/new-project --allanalyze-git-project /tmp/project --dimension architecture
analyze-directories /tmp/project --output /tmp/analysis# 分析
analyze-directories /tmp/project --output /tmp/analysis
# 生成飞书文档（通过AI助手调用）
# 将分析结果上传到飞书analyze-directories /tmp/large-project \\
--output /tmp/analysis \\
--parallel \\
--max-jobs 8功能: 5维度项目分析 参数:
--all- 执行所有维度分析--dimension <name>- 执行特定维度--parallel- 并行执行--output <path>- 输出目录--format <type>- 输出格式
示例:
analyze-git-project /tmp/project --all --parallel功能: 目录级深度分析 参数:
--output <path>- 输出目录（必需）--parallel- 并行分析--max-jobs <n>- 最大并行任务数（默认4）
智能识别:
- Skill目录 → 提取SKILL.md、资源统计
- Agent目录 → 提取配置、模型参数
- Rule目录 → 列出规则文件
- Script目录 → 按类型统计
- Test目录 → 列出测试文件
- Doc目录 → 列出文档
示例:
analyze-directories /tmp/project --output /tmp/analysis --parallel --max-jobs 6功能: 保存当前会话上下文 参数:
--compress- 压缩和优化上下文
示例:
save-chat-context myproject-context.jsonl --compress功能: 飞书文档增量更新 参数:
--doc-token <token>- 飞书文档token--analysis-dir <dir>- 分析结果目录--title <title>- 文档标题--type <type>- 操作类型（create|append|update）
示例:
update-feishu-doc \\
--doc-token "your-token" \\
--analysis-dir /tmp/analysis \\
--title "项目分析报告" \\
--type appenddir-analysis/
├── DIRECTORY_INDEX.md # 目录索引
├── agents_analysis.md # Agent目录分析
├── skills_analysis.md # Skills目录分析
├── rules_analysis.md # Rules目录分析
├── scripts_analysis.md # Scripts目录分析
└── ... (每个目录一个分析文件)
- 目录信息（路径、类型、文件数）
- 目录结构（2-3层树）
- 文件类型统计
- 代码行数统计（需要cloc）
- 专项分析（根据目录类型）
分析器会自动识别以下目录类型：
| 目录模式 | 类型 | 分析重点 |
|---|---|---|
| skill | Skill | SKILL.md定义、资源文件、子技能 |
| agent | Agent | Agent配置、模型参数、工具集 |
| rule | Rule | 规则文件列表、规则维度 |
| script | Script | 脚本类型统计、依赖分析 |
| test | Test | 测试文件、测试类型 |
| doc | Documentation | 文档列表、内容统计 |
- 并行模式 - 同时分析多个目录或维度
- 智能过滤 - 自动跳过node_modules、.git、dist、build
- 增量更新 - 支持追加模式，不覆盖已有内容
- 可配置并发 - 通过--max-jobs控制并行任务数
- ✅ 保存当前会话上下文
- ✅ 确认项目已克隆
- ✅ 检查磁盘空间（大型项目需要）
- ✅ 使用并行模式（提高效率）
- ✅ 监控进度（大型项目可能需要数分钟）
- ✅ 检查中间结果
- ✅ 查看目录索引（DIRECTORY_INDEX.md）
- ✅ 阅读关键目录分析
- ✅ 生成飞书文档并分享
- 检查项目是否为有效Git仓库
- 确认有足够的磁盘空间
- 查看分析日志
- 减少并行任务数（--max-jobs）
- 检查系统资源
- 使用单线程模式
- 检查飞书凭证配置
- 确认文档token有效
- 尝试重新发布
- structure-analysis.md - 结构分析详细方法
- architecture-patterns.md - 架构模式识别参考
- SKILL.md - 完整技能文档
- ✨ 新增目录级深度分析功能
- ✨ 新增智能目录类型识别
- ✨ 新增并行分析支持
- ✨ 新增飞书文档增量更新
- 🐛 修复文件路径处理问题
- 📝 完善文档和使用示例
- 🎉 初始版本
- ✅ 5维度分析功能
- ✅ 多任务并行支持
- ✅ 飞书文档集成
MIT License
欢迎提交 Issue 和 Pull Request！
分析工具: Git Project Analyzer Skill 版本: v1.1 创建时间: 2026-03-12 维护者: OpenClaw AI Assistant