用途:把不熟悉的代码快速讲清楚,同时不降低理解深度。它适合被要求“解释代码”“讲解某个函数”“理解一段实现”等场景。技能说明提到,即使只有代码片段,也应始终给出完整解释,并按提问者水平匹配深度。
主要能力与输出结构:一是“一句话”总结代码做什么,让忙碌的读者可以复述;二是“逐步讲解”,按块或函数顺序梳理逻辑,对非平凡之处解释原因而不只是复述代码,必要时引用行范围;三是“值得了解”,指出巧妙技巧、陷阱、副作用、复杂度、依赖或代码所做的假设;四是“有没有问题”,标出阅读中发现的缺陷、边界情况或坏味道,并给出修复建议,若代码干净则说明。
使用方式:若资料未提供,需要先询问代码(片段或路径)、语言或运行时(若不明显)、读者是谁及其已有知识、想理解什么(缺陷、评审、交接等),其余可推断。应从代码本身推断语言和意图,并标注假设(assumed — confirm)。
质量检查:一句话总结应能独立成立;逐步讲解要解释为什么,而不是用英文逐行叙述;要暴露非显而易见的行为,如副作用、复杂度、边界情况;发现缺陷或坏味道要连同修复建议标出。
限制与反模式:不要逐行用英语叙述(如“这一行把 x 设为 5”),而应解释意图与结构;不要跳过陷阱,价值就在非显而易见的部分;不要误判读者水平;不要因为未被要求评审就忽略看得见的缺陷。资料未提供具体安装命令、平台或收费信息。