explaining-code

此技能作为开发者的智能导师，将复杂或晦涩的代码转换为易于理解的概念知识。它专为需要架起抽象逻辑与直观理解之间桥梁的软件工程师、学生及技术主管而设计。通过专注于“代码如何运作”而非仅仅是“它执行什么”，此技能协助用户进入新的存储库、排解旧系统故障或重构复杂模块。

本技能通过结构化的教学框架运作。它首先将技术实现与日常生活类比连接，让用户能将编程概念映射到现实世界现象。随后，利用 ASCII 艺术图表可视化执行流程或结构关系，这对于理解调用阶层、状态转换或组件依赖关系特别有用。接着提供详细的逐步导览，将思维模型映射到实际逻辑，最后通过强调常见的“陷阱”（Gotchas）——那些经常让开发者掉入的误区或反模式来总结。

• 生成直观的比喻来解释设计模式、算法和复杂的数据结构。

• 建立基于 ASCII 的架构图与流程图，以便快速可视化系统交互。

• 为复杂函数提供深入的逐行或逐区块导览。

• 识别代码库中的常见陷阱、边界案例与潜在配置错误。

• 使用对话式的语气，使学习过程更具吸引力且易于理解。

• 在新成员入职或审查 Pull Request 时使用，以厘清实现细节。

• 非常适合记录技术债，或通过解释“如何做”背后的“为什么”来证明架构变更的合理性。

• 输入：存储库中的代码片段、文件或特定逻辑路径。输出：包含图表与技术见解的全面性多模态解释。

• 限制：最适用于具有清晰逻辑流程的代码；对于高度混淆的代码，重点在于识别模式，而非强行使用过于简单的类比。务必优先阅读“陷阱”部分，以确保用户避免常见的实现错误。