SuperAPI AI 工具集

lode-session-start-recall

编程与开发

查看项目

更新于 10-16 09:58

技能介绍

用途:在智能体编程会话开始时召回最近的 Lode 项目记忆,将 Lode 从只写记忆变为读写习惯循环,为开发者和 AI 准备有界的项目上下文,避免从零重新开始。

范围:仅限项目内部。原始条目是语义事实来源;产物索引条目是可选的来源导航。v1 不使用 git 提交作为回退,在没有 vault 数据时不虚构历史。

工作流:解析当前项目上下文;运行辅助脚本: python <this-skill>/scripts/recall_context.py --cwd "$PWD" --limit 12 若用户明确给出项目 slug,传入 --slug <slug>;若用户或配置提供 vault 路径,传入 --vault <path>。然后读取 references/recall-output-template.md,在对话中以 Markdown 输出。

输出契约:回复必须包含最近进展、相关决策、可能影响当前任务的已放弃替代方案、未决问题、实现前需检查的风险、值得阅读的仓库内文档、可能过时的意图产物、当前会话的建议入口点。若无 vault 或无原始数据,应说明 Lode 对当前项目尚无持久记忆,并建议本次会话后使用“收工”,不得用 git 历史或假设填补空白。

证据规则:决策、风险、已放弃替代方案与未决问题需引用原始条目的时间戳;值得阅读的文档需引用产物 id;intent_artifact_flags 视为只读过时性提示,表述为“可能需要复查”而非事实;本技能不写入也不提出 diff;当辅助脚本返回较弱或旧 schema 条目时,使用“推断(Inferred)”措辞;缺失产物索引可接受,不得阻塞输出。

存储:读取 {vault}/raw/weeks/{YYYY-WNN}/{project-slug}.json,以及存在时的 {vault}/raw/artifacts/{project-slug}.json。本技能不写入任何文件。

内化的意图产物标记:当最近的原始条目包含 sync_suggestions,或提到意图产物及设计、计划、架构、提示词、schema、契约、迁移、配置等契约类术语时,加入“可能过时的意图产物”一节。该节只读,用于告诉下一次会话检查什么,不判定文档过时,也不修改文档。

限制:仅在项目内工作;依赖已有 vault 原始数据;不写文件、不改文档;无数据时不补造历史。