SuperAPI AI 工具集

recall

编程与开发

查看项目

更新于 10-15 23:46

技能介绍

用途:在智能体编程会话开始时读取 Lode 已保存的项目记忆,把只写记忆变为读写习惯循环,为开发者与 AI 准备一段有边界的项目上下文,避免重新从零开始。仅限项目内使用,原始条目是语义事实来源,不把 git 提交作为 v1 回退,也不在无 vault 数据时编造历史。

主要能力与工作流:先做 vault 健康检查,从配置解析 vault 路径,检查 {vault}/raw/weeks/ 是否有对应 {slug}.json 文件;若完全无原始条目,建议使用 /lode:capture 并停止;若原始条目超过 14 天,在输出中注明陈旧;若缺少 recall_context.py,警告并建议重新安装。检查通过后运行辅助脚本:python <this-skill>/scripts/recall_context.py --cwd "$PWD" --limit 12;用户明确指定项目 slug 时传 --slug <slug>,有 vault 路径时传 --vault <path>。随后读取 references/recall-output-template.md,在对话中生成 Markdown。

输出契约:需包含最近进展、相关决策、Decision Context(当 {vault}/raw/decisions/{project-slug}.json 存在或可从原始条目重建时)、可能影响当前任务的被放弃方案、待确认问题、实现前需检查的风险、值得阅读的仓库内文档、可能陈旧的意图制品、当前会话的建议入口。

存储与读取:读取 {vault}/raw/weeks/{YYYY-WNN}/{project-slug}.json、{vault}/raw/artifacts/{project-slug}.json(存在时)、{vault}/raw/decisions/{project-slug}.json(存在时);仅当派生决策索引缺失、无效、为空或比原始条目旧时,才写入 {vault}/raw/decisions/{project-slug}.json。原始条目仍是事实来源。

证据与限制:决策、风险、被放弃方案和待确认问题需引用原始条目时间戳;文档引用需给 artifact id;使用 decision_context 时引用 source_entry_refs,保留 confidence 与 inference_notes,不把推断节点当作事实;有 decision_context_source 时一并展示,尤其 rebuilt=true。intent_artifact_flags 只作只读陈旧提示,措辞为“可能需要复核”,本技能不写文件、不提议 diff。辅助脚本返回弱或旧 schema 条目时使用“Inferred”措辞。缺少 artifact 索引可以接受,不阻塞输出;缺失时仅从原始条目字段推导文档引用。当近期原始条目含 sync_suggestions,或提到设计、计划、架构、提示、schema、契约、迁移、配置等意图制品与契约类术语时,加入“可能陈旧的意图制品”只读小节,只告诉下一会话要检查什么。