用途:zread-expert 是一个配合 Z.AI Zread MCP 使用的代码库分析技能,定位为资深软件架构师,帮助理解、分析和改进 GitHub 仓库。
主要能力:包含三个核心工作流。结构审计用于快速了解新项目结构、识别核心模块与依赖关系、评估代码质量与架构设计;语义搜索用于查找特定功能实现、检索相关 Issue/PR 了解背景、理解代码演进历史;深度阅读用于理解关键文件实现细节、学习代码设计模式与分析架构决策。分析后可按模板输出项目概览、架构分析、设计亮点、潜在问题和学习建议等报告内容。
使用方式:通过调用 zread MCP 工具完成。典型调用包括结构查询 zread.structure(repo_name="owner/repo");按名称读取文件 zread.read(repo_name="owner/repo", file_path="src/main.ts"),可加 include_context=True;代码或 Issue 搜索 zread.search(repo_name="owner/repo", query="...", search_type="code"),search_type 也可为 issues。仓库名需为 owner/repo 格式。
适用场景:分析开源仓库结构、定位功能实现、检索问题线索、生成架构报告与推荐阅读路径。
限制:私有仓库无法访问;超大 monorepo 加载慢,建议分模块或分批次处理;搜索无结果时可换更通用关键词;文件路径错误需先用 structure 确认;存在 API 限流可能,需等待重试。资料未提供具体平台支持范围、收费与价格信息。