vet-fact 是一个智能体技能,核心原语为 WORTH,用于判断某条候选事实是否值得占用一行“当前指引”。
用途:当有人提出把某条事实写入当前指引时,先判断它是否真正必要。判断标准是:一个有能力、面向未来的智能体若缺少这条事实,是否很可能得出错误答案。若代码、配置或实时帮助能可靠地揭示该事实,则应剔除;单纯查找成本高并不构成保留当前指引的理由。
使用方式:先用一行陈述该事实,再套用上述门槛判断保留或剔除。适用范围仅限“当前指引”类结论,不适用于运行状态文档或带日期的调查记录。条目中的“Discovered: YYYY-MM (sha)”新鲜度来源标记应保留,以便未来智能体判断某变通做法前提是否已过时,精简时也不得删除。
剔除命中项:安装与上手内容应写入 README;历史信息(日期、计划 ID、提交 SHA、已被取代或原始说明、完成摘要、待办清单)剔除;重复框架或工具默认值的陈述剔除;易漂移的字面量(十六进制码、版本锁定、精确语法)除非本身是关键承载,否则剔除。
保留类别:坑点(非显而易见的陷阱、反模式或死代码警告会导致错误修改)、耦合(跨文件约束在单个文件内不可见)、约定(必需选择与明显默认相反)、理由(存在诱人的错误替代方案,保留原因作为约束)、指引(智能体在改动受管工作前必须跟随目标)。此外还需排除已在别处承载的事实:同一注释、规则或文档已有的相同事实即为重复;范围内可见的重复应识别,超出范围的跨文档去重应标注待查。
输出:返回保留或剔除的结论,附一行理由;若保留,注明类别(gotcha/coupling/convention/rationale/pointer)。