teach-me

用途：teach-me 用于深入浅出地解释一个具体对象，例如某个文件、函数、功能、子系统、概念或错误信息。它要求按固定框架组织输出，并根据听众调整讲解方式与深度，题面为“这个是怎么运行的”“解释给我听”。不适用于理解整个陌生代码库或编写 wiki。\n\n主要能力：输出结构固定为听众 → 一句话摘要与类比 → 七部分（名称、来源、存在原因、运作机制、权衡、限制、在整体系统中的位置）→ So what。七部分必须按序齐全，缺一部分要说明原因。运作机制分系统级与代码级，并尽量用真实运行观察佐证；无法运行则说明这是静态解释，未经验证。可为非技术听众简化措辞，但不得歪曲事实，强简化处需标注。非技术听众不出现代码块和反引号。\n\n使用方式：先确定听众，不注明默认按工程师；再确定范围并读对应来源（代码、概念、错误、文档）。能跑起来就用具体输入运行，借助 pdb、breakpoint、print、node --inspect、console.log、/run、/verify 等观察真实状态；为观察插入的插桩需移除，并用 git diff 确认用户代码干净。图示默认使用内联 mermaid，仅在用户同意时制作 HTML 解释页。\n\n适用场景：给特定对象做面向某位听者的深讲解，如向工程师、经理、设计师、学生或家人解释同一件事。多对象系列不按“N 篇”汇报覆盖率，需调用 surface-coverage 报告 N/M 表面覆盖及未覆盖清单。\n\n限制：不分析整个项目、不写 wiki；不新增调试器，只用现有工具；权衡（有意取舍）与限制（不可逾越的边界）不得混同；观察不到却需依赖运行时的断言要记入 unknown-ledger；git diff 中仍残留插桩即视为未完成。