用途:explain 是一个解释类技能,调用形式为 /explain [arguments],用于讲解代码、概念或技术决策,核心原则是清晰优先于完整,解释只有被理解才有用。
主要能力:先理解真实问题(字面问题与深层问题,并考虑提问者背景),再收集完整上下文(相关代码、周边代码、调用关系、测试、注释、Git 历史),然后按“一句话总结、目的、高层思路、实现细节、边界情况、相关概念”的结构展开。支持四种解释层次:高层、实现、技术细节、历史决策。
内置模板:代码解释(What it does、Purpose、How it works、Key details、Example、Related)、概念解释(定义、为何重要、如何工作、示例、代码库中的位置、常见陷阱)、决策解释(背景、备选方案及利弊、选择与理由、接受的权衡、参考)、报错解释、为何不用 X、遗留代码解释。
写作要求:具体而非空泛,慎用类比,展示而非只说,避免术语(除非在解释术语),引用要精确到文件与行号,回答“为什么”时不要只讲“怎么做”。
适用场景:解释函数作用、为何采用某模式、两种方案差异、认证流程、错误信息等。可与其他技能配合,如解释代码质量问题时用 code-reviewer,解释行为时用 proof-of-work,解释为何更简单更好时用 simplicity-principles。
限制:资料未提供安装方式、收费、平台支持、性能效果等信息;该技能依赖对代码库上下文的读取,若上下文不足则解释质量受限。