用途与实际影响
这项功能怎样使用
为什么需要它
重复术语或缩短几句话，未必补得上真正缺失的背景。本人说没听懂时，AI 要回到那件具体事情，找出人物、事实或判断哪里没有说明白。
举个实际例子
“这个功能为什么失败，我没听懂，结合刚才的操作讲清楚。”当前 AI 复用已有证据和说明反馈，重讲失败发生在哪一步、有什么影响和实际处理办法；最终是否讲懂，以本人的实际回应判断。
最后我会得到什么
得到一段围绕原问题的清楚说明。若发现新的有效讲解教训，当前 AI 在本次任务里合入说明指南；没有固定字数、段落顺序或必须举例的模板。
正常完成时
说明围绕真实问题展开，本人能据此理解和行动；有新反馈时完成相应资料更新。
发现问题时
本人仍没听懂时，回到未说明白的事实、背景或判断继续讲，不把一次成功解释推成永久模板。
资料不可用时
说明指南读不到时，明确本次未引用已保存反馈；当前任务仍可依据眼前事实组织解释。
从哪里开始
说这段解释太绕，请结合眼前事情讲清楚。
需要准备什么
- 这次没听懂的具体位置或问题
从开始到拿到结果
- 1
系统核对并处理
当前 AI 读取说明方向的反馈，回到事实、理由、影响和可执行下一步重讲。
- 2
交付与接续
交回可追问的说明；讲法仍不通时按具体反馈继续改，不用删掉必要专业条件。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
入口已具备，理解效果随真实问题验收关键规则与设计选择
向本人说明使用讲解反馈，不从本人聊天口吻推断其理解偏好。
文书正文遵循文书规范；向本人解释文书时才使用这一方向。
同任务已读且上下文足够时复用；资料更新后重新读一次受影响方向。
本模块用到的名词
- 说明方向
- 说话者是 AI，听者是本人；目标是理解眼前事实与判断。
- 具体反馈
- 保留本人指出的问题和适用语境，不把 AI 猜测写成固定偏好。
专业定义
根据本人对说明的具体反馈，把事情讲清楚；专业判断仍由当前任务负责。
解决什么
专业事实不足时先由当前任务补证据；重要信息不清才问具体问题，不让本人选择抽象的讲解套路。
当前怎样实现
- explain-to-me 技能把当前任务路由到项目的说明方向。
- read_direction(root, 'explain') 只读 explain-to-me.md，返回 direction=ai_to_user 与 guidance，不打开 reply-samples.jsonl。
- 程序不生成解释也不改指南；表达组织和有价值反馈合并由当前 AI 执行。
执行流程
- 1
确认当前任务是在向本人说明
- 2
复用当前事实与已经读取的指南，缺少时读取 explain
- 3
围绕原问题组织解释，必要时补具体背景
- 4
有价值反馈合入 explain-to-me.md，校验并重读
边界
- 不加载聊天样本来模仿本人说话。
- 不接管本人背景库、专业事实或领域策略。
- 本轮没有用虚构场景试写来宣称本人已理解。
失败与恢复
- 解释仍然难懂
- 重新说明原问题中缺失的关系或背景；确实影响结果的不确定再问清。
- 指南缺失或不可读
- CLI（命令行工具） 返回 unavailable 与错误，当前 AI 明确哪些历史反馈没读到。
- 指南被清空
- validate 可发现 empty guidance；单独 explain 只负责读文件，不会自动执行完整校验。
真实入口
expression.py / read_direction说明分支的实际读文件行为。
explain-to-me/SKILL.md说明方向的既有技能职责。
AGENTS.md说明反馈的来源与更新约定。
如何验证
- 本机虚构测试删除样本文件后，说明命令仍能读到虚构指南；输出没有 examples。
- 已读取当前技能入口；没有开展真实理解效果验收。
- 实际使用由处理真人问题的 AI 检查是否讲清楚，不新建模拟表达评分。
与其他模块的关系
说明资料由本项目维护；本人背景仍由理解库拥有，专业事实和当前知识状态仍由相应领域负责。