Agent4cs: A Multi-agent System for Code Summarization in Large Hierarchical Codebases

摘要：理解庞大而复杂的代码库，尤其是那些结构混乱且文档不完整的代码库，仍然是一项重大挑战。现有的代码摘要解决方案通常依赖单一语言模型或像 Claude Code 这样的编码助手，并将源代码视为平面文本，未能充分利用代码仓库中丰富的相互依赖关系和层级信息。为了解决这些不足，我们提出了 Agent4cs——一个多智能体框架，能够以自底向上的方式对大型代码库进行摘要。其中，摘要智能体专注于生成稳健的摘要；关键词提取智能体主动从子文件夹中识别关键信息；质量保证智能体则迭代优化输出结果，确保其可读性、连贯性和完整性。在 7 个前沿模型上的评估表明，与两种基于代码片段的结构化提示基线方法相比，Agent4cs 在所有文件夹层级上的语义一致性平均提升了 8%。此外，在真实世界数据集上的广泛评估显示，与相同基线方法相比，归一化关键词覆盖率最高提升了 38%。