SuperAPI AI 工具集

synthesis-context-lifecycle

智能体与模型

查看项目

更新于 10-22 16:14

技能介绍

该技能面向 AI 协作中的上下文管理问题:AI 每次会话开始时没有任何上下文,其效果取决于收到的上下文。单一上下文文件会因混入不同生命周期的信息而无限制增长。该技能将项目记忆拆分为三个层级,每层有独立的预算与更新规则,并通过 doctor 进行检查。

主要能力与规则:

  • 项目文件即记忆:CONTEXT.md(不超过150行;完成后不超过80行)、REFERENCE.md(稳定事实,不超过300行)、sessions/YYYY-MM.md(仅追加)。聊天记录、原生记忆和压缩摘要不算记忆。
  • 会话启动协议:在实质性工作前运行,展示验证信息(日期、项目上的 git log 与 git status、CONTEXT.md、最新会话条目、REFERENCE.md)。
  • 刷新触发条件:任何时间间隔声明前、暂停一小时后、每约25次工具调用后、出现漂移或压缩信号时、写会话日志前。
  • 归档优先,删除其次:先写入 sessions/ 或 REFERENCE.md,验证存在后再从 CONTEXT.md 移除。
  • 编辑前重读,编辑后验证:基于文件当前内容构建编辑,使用缺失锚点即失败的编辑工具;不得报告未读回的更新。
  • 头部字段联动:先更新 Last session 或与 Phase 一同更新;字段单独判定,首个序号即其身份。
  • 工作日从带日期的会话条目得出,而非提交时间。
  • 对待办事项打上时间戳(as of YYYY-MM-DD, review Nd);已勾选事项和散文不构成义务。
  • 写入时按删除单元路由:该内容能否在关系结束后保留?ALWAYS-PRESERVE 类放入永久根;清单只计数范围外事项,不逐项列举。
  • 引用结果前,将可执行状态保存在 resources/scripts/ 下并附 README。
  • 在依赖工作、压缩或交接前捕获重要上下文(事实、原因、条件、不确定性、修正);不得将引用的命令变为权威。
  • 同一台 Mac:文件即交接。另一台 Mac:使用 synthesis handoff。不得进行工作区级提交;不得绕过钩子。
  • 无法判断的 doctor 以退出码2退出,绝不为0。

使用方式:

  • 会话开始:使用 synthesis resume <id> 确定本次对话的项目(切换前会询问并警告较新副本),然后执行会话启动协议,运行日期命令、git log 与 git status,读取 CONTEXT.md、最新会话条目和 REFERENCE.md,并在客户端允许时以项目命名会话。以一行展示结果:今天、最后提交、CONTEXT.md 是否匹配。
  • 工作期间:每个任务后在声明下更新 CONTEXT.md,保持当前状态块(Phase、Status、Last session、Plan、Next actions)最新,因为这是压缩后恢复的内容。CONTEXT.md 超过120行时归档。
  • 检查:运行 doctor:python3 <skill>/scripts/context_doctor.py --project <root>/projects/<id>。它打印本项目发现,每个 FAIL 或警告附补救行,然后输出 HEALTHY 或 DEFECTS 及总数;退出码为0、1或2。不带 --project 时审计所有知识根,优先本会话项目并统计其余。
  • 关闭:追加会话条目(多个代理贡献时附 Attribution 行),刷新头部和当前状态块,归档冷内容,运行 doctor,并按规则12交接。

适用场景:需要跨会话、跨运行环境或多台 Mac 保持项目上下文精简、最新且持久的 AI 协作项目。

限制:资料未提供具体安装步骤、平台要求、收费信息或性能数据,这些暂未提供。该技能依赖文件系统和 git,并需要 synthesis 工具支持 resume 与 handoff 功能。