SuperAPI AI 工具集

feedback-learning

通用与其它

查看项目

更新于 10-16 00:32

技能介绍

用途:当用户明确纠正实现或设计方法、否定某种模式,或要求智能体从反馈中学习时使用(字面 learn! 触发除外,后者由 .github/instructions/learnings.instructions.md 专属管理,本技能不得替换或重新解释)。目标是把可复用知识保存在最小且权威的产物中,纠正并不自动等于永久规则。

工作流:一,识别纠正内容,明确错在哪、为何错、用户偏好何种做法、影响哪些路径或子系统。二,写入前先搜索适用的指令、技能、设计文档、测试和范围化学习文件,更新已有规则而非新增重复条目。三,分类反馈并确定去向:任务特定偏好或一次性调整不持久化;必须防止回归的具体行为写回归测试;稳定的子系统架构或产品不变量写入相关设计/规格文档;通用仓库规则写入适用指令文件;可复用但尚不成熟的指引写入 .github/learnings/<area>.md;工具驱动的工作流写入相关技能。四,谨慎泛化,保留原则而非事件过程,除非构成持久契约,否则不写临时符号名、行号或实现细节;不因一次被拒的实现就上升为普遍禁令。五,只记录一次,设计文档与测试是权威,学习收件箱条目是临时的,晋升后应在同一次变更中移除;不把同一规则复制进技能、指令和设计文档多处。六,验证:确认目标适用受影响路径,检查链接并移除被取代或矛盾的指引。

学习收件箱格式:创建或更新 .github/learnings/<area>.md,含标题、Last reviewed: YYYY-MM-DD、## 短主题,以及 Scope(受影响路径)、Learning(一到两句泛化指引)、Evidence(为何可复用于当前任务之外)、Disposition(候选写入设计文档、指令、技能或测试)。条目需简洁,每个区域收件箱最多十个主题、8 KB;超出任一限制需先晋升、合并或移除现有条目。

读取学习:不要把收件箱注入每个任务,先搜索相关文件的标题和 Scope 字段,只读匹配条目。收件箱补充源代码、测试和设计文档,但不是无关工作的前置条件,也不凌驾于它们之上。

压缩与回收:每次写入前先压缩收件箱;当达到任一限制或 Last reviewed 超过 90 天时做完整审查,包括把稳定架构指引晋升到所属规格、把具体行为编码进测试、合并重叠条目为一条通用原则、移除过时或被否定或已晋升或证据薄弱的条目,并对照当前源码与权威文档更新 Last reviewed。收件箱可缩减到零条目,不因“也许以后有用”而保留。