用途与实际影响
这项功能怎样使用
为什么需要它
只改当次回复会丢失教训；把每次评价都追加成规则，又容易把一个场景的偏好误当成所有情况的要求。需要留下具体问题和适用范围，而不是积累越来越长的禁词清单。
举个实际例子
“这句话在当前语境不合适，改回我刚才说的意思。”AI 先调整眼前稿件；若这条反馈对以后有用，就记录实际语境、本人指出的问题、当前改法和适用范围。若新句子是 AI 的建议，会保留这个区别，不将它冒充本人定稿。
最后我会得到什么
当前问题得到处理，有价值的教训进入对应指南；只有来源可靠、值得参考的本人文字或本人修订才补入样本。更新后校验并重读，确认下一次普通读取确实能带出变化。
正常完成时
先交付改好的当前内容，再说明实际合入了哪项有价值教训；校验和受影响方向回读完成。
发现问题时
本人评价、本人给出的改法和 AI 未获认可的建议分清；没有新价值就不加记录。
资料不可用时
资料不可写或本人明确只讨论时，说明没有保存；不把当前上下文记住了称为长期资料已更新。
从哪里开始
指出这次解释或草稿哪里不好，并希望下次避免同类问题。
需要准备什么
- 这次解释或草稿的具体问题
- 教训只适用于某个场景时的说明
从开始到拿到结果
- 1
系统核对并处理
先改当前答复，再判断这条教训是否稳定有用；有价值时合入对应指南并校验读取。
- 2
交付与接续
交回当前修订及实际保存结果；未保存或只在本轮改好时不声称长期已学会。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
流程与读取接口已具备，跨任务执行随真实使用验收关键规则与设计选择
说明反馈进入 explain-to-me.md，代拟反馈进入 reply-guide.md，样本只收有来源的表达参考。
同类教训合并，保留足够语境与适用范围，不把一个例子推成永久全场景偏好。
标签格式检查和实际作者判断分开：程序无法识别一条被错误标成 self_message 的 AI 文字。
更新后在当前任务重新读取受影响资料，并在正常私有 Git 收口时同步备份。
本模块用到的名词
- 作者与状态
- author 记录本人原话、本人修订或 AI 草稿；status 记录参考、待定或退出参考。两类字段服务不同判断。
- 就地合并
- 修改现行相关说明、补充例外和范围；不为每次反馈新增一篇日志。
- 下一次能读到
- 文件已经编辑、校验且重新读取到变化；这仍不等于未来每个 AI 都会主动执行。
专业定义
保留反馈语境、合并同类教训，分清本人原话、本人修订和 AI 建议。
解决什么
新旧反馈可能分别适用于不同情况。优先明确场景或例外；真正更正时才修改现行结论，历史由已有 Git 版本保留。
当前怎样实现
- 反馈处理是 AGENTS.md 和两项技能交给当前 AI 的工作流程；expression.py 没有写入或反馈同步命令。
- read_samples 校验对象、唯一 id、作者与状态允许值、必要字段及非空文字列表；不核验事实归属或反馈含义。
- available_samples 排除 AI 草稿，即便其 status 为 reference 也不进入正式参考；新建议不能仅靠改标签变成本人原话。
执行流程
- 1
先按反馈改当前回答或草稿
- 2
区分所属方向、本人原话与 AI 建议
- 3
保留足够语境，把有价值教训合入现行说明
- 4
必要时增补有来源的本人文字或修订
- 5
校验并重读受影响方向，再同步既有私有备份
边界
- 不要求每次交流标注或审批，不为数量凑记录。
- 不能可靠归属的文字不伪装成本人原话，AI 草稿被发送也不自动改变作者。
- 不建立反馈数据库、监听服务、队列或表达评分体系。
失败与恢复
- 重复 id、非法作者或错误消息容器
- 读取器拒绝该资料；CLI（命令行工具） 返回 unavailable，由当前维护者修正真实格式问题。
- 语义与已有教训冲突
- 比较实际场景和来源，收窄范围、补例外或据真正更正更新结论。
- 本次更新未写入或缓存仍是旧内容
- 明确未保存或重新读受影响文件，不能声称新教训已经带出。
真实入口
AGENTS.md反馈处理的现有责任与顺序。
expression.py / read_samples格式验证的能力及局限。
tests/test_expression.py作者标签、重复标识与错误形状回归。
如何验证
- 6 项虚构回归包含错误记录对象与错误 messages 容器；格式错误不会被标为 valid，非对象记录按 unavailable 收束。
- 正常更新应由实际任务校验并重读受影响方向；本轮没有读取或写入私人反馈。
- 后续任务主动执行、长期稳定使用和本人认可分别等待真实结果，不用模拟试写证明。
与其他模块的关系
更新责任由处理真实事项的 AI 承担，本人不需要回到本项目另说保存；读取器不会监听其他对话或代替语义判断。