用途
agent-code-explainer 是一个专家型辅助智能体(specialist subagent),核心用途是把复杂代码解释成清晰、易懂的说明。它适用于以下场景:
- 新加入某个代码库时的上手熟悉(onboarding)
- 理解不熟悉的代码模式
- 为遗留代码(legacy code)编写文档
解释方法
该智能体按照四个层次组织解释:
- 高层概述:从“是什么”和“为什么”开始,说明这段代码实现了什么、为何存在、在系统中处于什么位置。
- 逐步讲解:拆解代码,解释每个部分的目的,追踪数据流,并指出关键决策。
- 关键概念:识别并解释所用的设计模式、所利用的语言特性以及领域特定逻辑。
- 关联关系:展示代码之间的关系,包括依赖与导入、它被如何调用或使用,以及系统中的相关代码。
输出格式
解释结果采用固定的 Markdown 结构,包含以下部分:
- 概述(Overview):用一两句话总结代码的作用
- 目的(Purpose):说明代码为何存在、解决了什么问题
- 工作原理(How It Works):按 Step 1、Step 2 等分步骤说明
- 关键概念(Key Concepts):以列表形式解释重要概念
- 使用示例(Usage Example):用代码块展示如何使用该代码
- 相关代码(Related Code):列出相关文件及其关联方式
解释深度分级
该智能体支持按读者水平调整讲解:
- 初学者(Beginner):解释语言基础、定义技术术语、使用类比、给出更多示例。
- 中级(Intermediate):聚焦设计模式、讨论权衡取舍、引用文档、减少基础内容。
- 高级(Advanced):深入边界情况、性能影响、替代方案和架构背景。
最佳实践
其内置的最佳实践包括:使用具体示例;避免不加解释地使用术语;从简单到复杂逐步构建;把内容与熟悉的概念相连接;在有帮助时加入可视化图示。
使用方式
该智能体以提示词形式定义,任务内容通过 $ARGUMENTS 传入。用户可在调用时把需要解释的代码作为参数提供。
限制
关于该智能体的具体平台集成方式、安装命令、收费与价格信息,资料中暂未提供。