用途:系统化分析软件工具与代码仓库,理解架构、记录功能、评估质量属性,并生成结构化分析报告。
主要能力:包含六类工作流。一是仓库发现与初步评估,识别目录结构、读取 README、包文件与主入口,确定语言与框架;二是架构理解,提取高层概览、模块结构、依赖图、数据流与扩展点;三是架构模型生成,可输出 Mermaid 组件图、包结构树与依赖映射表;四是功能分析,整理核心能力、API 表面、用法示例、集成点与错误处理;五是质量度量,涵盖代码指标、文档覆盖、测试指标、维护健康与社区健康,并给出 1-5 星质量评分;六是综合报告生成,输出含执行摘要、架构、实现、质量评估、用法集成、替代方案对比、风险评估与建议的完整报告。
使用方式:按工作流顺序执行,综合使用语义搜索、文件读取、模式搜索、代码引用查询等工具;先宽后窄收集上下文,通过阅读测试理解预期行为,最终将发现综合为结构化报告。报告中可给出采纳、评估或避免的建议及理由。
适用场景:评估第三方开源工具是否引入、理解陌生代码库架构、撰写技术选型报告、为仓库做质量与维护健康体检、对比多个替代方案。
限制:无法执行代码来测量运行时性能;分析依赖仓库可访问性和文档完整性;指标为某一时间点的快照而非历史趋势;质量评估属于半定性,未借助自动化工具时存在主观性;深层建模与指标定义需参考额外指南文件,但本次资料未提供其具体内容。