SuperAPI AI 工具集

lore-recall

智能体与模型

查看项目

更新于 10-15 23:34

技能介绍

用途:当过往会话记忆对当前任务重要时使用本工作流。它位于底层 skills/lore CLI 技能之上:命令机制、安装与索引交给 skills/lore,本技能负责证据规划、可信度、新鲜度与最终证据包形态。

主要能力:先做状态检查,再制定召回计划(2-4 个查询变体、可能的过滤条件及每个查询的理由),先窄后宽地搜索,仅基于 Lore 返回的真实 id 下钻,最后输出有界证据包。

使用方式:先运行 lore status --json,并用最窄的有用范围(--project、--source、--since、--until)。搜索用 lore search "<terms>" --json,关注时效时加 --relevant。下钻用 lore get <id> --full、lore context <id> --json 或 lore session <session> --around <id> --json。证据包结构见 references/evidence-packet.md,查询扩展与下钻规则见 references/query-planning.md,新鲜度语义见 references/freshness.md。

可信规则:Lore 记录是证词而非事实,当前文件、测试、运行时产物与实时系统状态优先于陈旧记录。不要倾倒整个会话,不要编造 id,保留来源信息(消息 id、会话 id、来源、项目、分支、时间戳、角色/模型),未知数据保持 null 或 unknown。真实记录片段属私密内容,示例与评测只用合成 id 与文本。

新鲜度标签:current(被当前文件/测试/运行时佐证)、recent(时间戳合理且未发现矛盾)、stale(可能漂移或与当前产物冲突)、unknown(缺时间戳或来源不足)。

失败恢复:若状态为 missing_store、empty_store、source_absent、possibly_unsynced、stale_schema 或 unreadable_store,应停止并报告状态与恢复方式。若 schemaVersion 高于 supportedSchemaVersion,需说明只读检索可能可用,但 lore sync 等写入恢复可能被拒绝,直到更新 Lore。搜索零命中时,放宽一次、尝试一个同义查询,并报告缺口而非假装有结果。

验证:对示例证据包运行 node skills/lore-recall/scripts/validate-evidence-packet.mjs skills/lore-recall/examples/good-evidence-packet.json;完成前运行 node skills/lore-dev-verification/scripts/validate-workflow-skill.mjs skills/lore-recall。