用途
Repo Explorer 用于快速探索 Gitee 仓库的结构与核心内容，并生成一份仓库概览报告，帮助用户快速上手一个不熟悉的项目。当用户提出“探索某个仓库”“了解这个项目”“告诉我这个仓库是做什么的”等需求时，可以使用该技能。
主要能力
- 读取仓库关键文档：README.md 或 README_CN.md、CONTRIBUTING.md、CHANGELOG.md，以及 package.json / go.mod / pom.xml / requirements.txt 等依赖清单。
- 获取根目录树：通过 get_file_content 并设置 path="/" 一次性返回顶层目录结构，快速了解项目布局。
- 浏览关键子目录：识别 src/ 或 lib/、cmd/ 或 bin/、api/ 或 routes/、tests/ 或 test/、docs/、scripts/ 或 .gitee/ 或 .github/、config/ 或 configs/ 等常见结构。
- 分析核心代码：根据项目类型（Web 应用、库/SDK、CLI 工具）深入阅读入口文件、路由定义、数据模型、核心算法、命令定义、配置处理等关键文件。
- 定向搜索：使用 search_files_by_content 定位核心逻辑，例如搜索 main、init、Router，或按用户关注领域搜索 auth、token、permission、SELECT、INSERT、Model、config、env、ENV 等关键词。
- 生成概览报告：按固定模板输出项目简介、技术栈、目录结构、核心模块、数据模型、快速开始、贡献要点、近期动态等内容。
使用方式
前置条件：已配置 Gitee MCP Server，且可用工具包括 get_file_content、search_files_by_content、list_user_repos。
用户需要提供：仓库所有者（owner）、仓库名称（repo）。可选提供：具体关注领域，例如“我想了解认证机制”。
如果本地安装了 mcporter，建议使用 mcporter 调用 MCP 工具，而不是直接调用 MCP 工具，因为 mcporter CLI 提供更便捷的接口和更好的错误处理。
执行步骤：
- 获取关键文档：使用 get_file_content 读取 README、CONTRIBUTING、CHANGELOG、依赖清单等。
- 探索项目结构：先用 get_file_content(owner="[owner]", repo="[repo]", path="/") 获取根目录树，再浏览关键子目录。
- 分析核心代码：根据项目类型深入阅读关键文件，并用 search_files_by_content 定位核心逻辑。
- 生成仓库概览报告：按模板输出报告。
- 深度探索（可选）：若用户有特定关注领域，使用 search_files_by_content 进行定向搜索。
报告模板包含以下部分：
- 关于：基于 README 的一段项目描述。
- 技术栈：语言、框架、存储、部署。
- 目录结构：关键目录注释。
- 核心模块：模块、路径、职责的表格。
- 数据模型（如适用）：主要实体及其关系。
- 快速开始：从 README / CONTRIBUTING 提取的安装与启动步骤。
- 贡献要点：CONTRIBUTING.md 中的关键约定。
- 近期动态：CHANGELOG 或 README 中的最新版本亮点。
适用场景
- 需要快速了解一个陌生的 Gitee 仓库。
- 需要生成项目概览报告以便团队分享或上手。
- 需要针对特定领域（如认证、数据库操作、配置）进行定向代码搜索。
限制
- 依赖 Gitee MCP Server 及指定工具，未配置时无法使用。
- 必须由用户提供仓库所有者与仓库名称。
- 读取时应优先选择较小文件，避免一次性加载超大文件。
- 报告应保持聚焦简洁，不必覆盖所有内容。
- 如果项目没有 README，需要从代码结构和注释推断其用途。
- 关于收费、价格、平台支持范围、实际效果等未在资料中提供，暂未提供。