SuperAPI AI 工具集

context-lifecycle

智能体与模型

查看项目

更新于 10-22 16:15

技能介绍

用途

Context Lifecycle 用于管理长期运行的 AI 协作项目中的上下文(工作记忆)。AI 协作者每次会话都从零上下文开始,其效果完全取决于所接收上下文的质量。短周期项目(2-3 次会话)用单个上下文文件即可;但跨周或跨月的长期项目会让该文件无限增长,因为它混合了四种生命周期截然不同的信息:工作记忆(当前状态、活跃任务)、情景记忆(会话日志)、语义记忆(稳定事实、参考资料)以及已完成工作记录。把四者放在一个文件里,文件会随会话数线性增长,且没有任何信息退出机制。这本质上是数据库工程中的热/温/冷数据问题在 AI 上下文管理中的体现。

主要能力

该技能提供一套三层上下文架构:

  • CONTEXT.md — 工作记忆:本次会话中 AI 协作者有效工作所需的全部内容。硬性预算 ≤150 行(已完成项目 ≤80 行)。仅包含阶段/状态头部(约 5 行)、当前状态(约 15 行)、带优先级的活跃任务(约 50 行)、最近 1-2 次会话摘要(约 30 行)、指向 REFERENCE.md 和 sessions/ 的链接(约 5 行)以及预算页脚(约 2 行)。不包含已完成任务清单、超过 1 周的会话日志、稳定参考事实和详细历史叙述。
  • REFERENCE.md — 语义记忆:会话间不变化的稳定事实,软预算 ≤300 行。包含项目概览与目标、团队名册与角色、URL/仓库/远程/部署配置、架构决策与约定、文件索引、设置与清理说明。关键属性是就地更新而非追加:成员离开就更新名册,URL 变化就改 URL,它是活的参考文档而非日志。
  • sessions/ — 情景档案:按月份命名的 YYYY-MM.md 文件,记录发生了什么以及何时发生。很少被读取,但在需要历史背景时可搜索。

该架构同时映射认知科学(工作记忆/语义记忆/情景记忆/程序记忆)与系统工程(L1/L2/L3 缓存/固件)。

使用方式

技能提供归档协议:当 CONTEXT.md 超过 120 行、会话日志超过 1 周、发生项目阶段转换或用户明确要求清理时触发归档。步骤为:读取并统计行数、识别冷内容、按需创建 REFERENCE.md 与 sessions/YYYY-MM.md、先归档(两阶段提交:先写入目标文件)、验证归档存在、再重写 CONTEXT.md 移除已归档内容、最后验证(≤150 行、无信息丢失、交叉引用已更新)并提交。关键原则是“先归档,后删除”,绝不在确认内容已存在于 sessions/ 或 REFERENCE.md 之前从 CONTEXT.md 删除。

技能还提供内容归属决策树(今天要用→CONTEXT.md;稳定事实→REFERENCE.md;会话记录→sessions/;可复用经验→_lessons/;否则删除),以及按项目规模划分的迁移指南:超过 500 行需完整重构,150-500 行需中度重构,150 行以下做轻量处理。此外还涵盖项目状态转换(活跃→完成/暂停/派生等)对应的 CONTEXT.md 操作,以及项目派生(子范围超出父项目边界时新建项目并交叉引用)的规则。

适用场景

适用于跨周或跨月的长期 AI 辅助开发项目,尤其是上下文文件已开始膨胀、需要区分工作记忆与参考事实与历史档案的场景。技能将上下文视为“上下文基础设施”,与代码基础设施、知识基础设施并列为第三层基础设施。

限制

资料未提供该技能的安装命令、依赖环境、支持的平台或工具集成方式。资料未说明任何收费、价格或效果保证。技能中的行数预算(150/300/80 行)为设计建议值,实际效果取决于项目具体情况。