SuperAPI AI 工具集

memory-sync

智能体与模型

查看项目

更新于 10-16 07:07

技能介绍

用途

memory-sync 用于同步项目中的 Codex 指令,使其与当前源码事实保持一致。它依据 references/sync-contract.md 执行,核心工作是对一组明确列入清单的 Codex 指令进行核对、去重与压缩。

主要能力

  • 在编辑前盘点被授权的具体路径:适用的 AGENTS.md、被显式引用的 .codex/rules/ 或约定、原生 agent TOML,以及原生 skills/配套指令 Markdown。
  • 判断授权:文件存在于某目录、被 git 跟踪或为 Markdown 格式,均不构成授权。
  • 尊重用户缩小范围的要求,包括“仅规则”或明确的文件列表。
  • 从请求中解析变更事实来源:默认会话,也可指定分支、提交/范围、近期提交或全部事实。
  • 提供两种深度:NORMAL 核对事实、去重并压缩;HARD 额外审计规则激活情况,并在不丢失项目决策的前提下移除通用性指导。深度不会扩大编辑范围。
  • 以英文说明来源、深度、具体盘点/排除项及核对情况。

使用方式

  1. 盘点被授权的具体路径,明确纳入与排除范围。
  2. 解析变更事实来源与深度(NORMAL 或 HARD)。
  3. 对实际被授权的文件做快照。
  4. 核对事实,选择规范归属并去重,使用 apply_patch 进行压缩。
  5. 保留决策、禁止项、例外、归属、来源、编号规则 ID 及受支持的原生元数据。
  6. 重新审计纳入的 agents/skills 的当前角色、路径、工具、契约与引用;将 TOML 按 TOML 解析。
  7. 在授权或可用时,使用有界的不相交负责人及独立的只读同步后检查;否则披露核对限制。
  8. 对照快照与实时证据核对每次编辑与删除,包括大幅缩减后的全文。
  9. 保持根规则索引(Rule、Load when、Purpose)与被授权的规则编辑一致:.codex/rules/ 与 paths 不自动加载。若根索引超出用户缩小后的范围,应报告所需的索引修正,而不是静默扩大写入。
  10. 报告编辑路径、已核对事实、移除的重复/过时声明、前后大小、不确定事实、仅核对漂移、检查项及延后建议。

适用场景

  • 需要将项目 Codex 指令与当前源码事实对齐时。
  • 需要去重、压缩指令,或审计规则激活情况时。
  • 用户明确指定了授权文件范围或缩小了范围时。

限制

  • 源码、分发模板/产品技能源、公开文档、配置、报告、任务/运行时状态、缓存、密钥及个人/全局指令层仅作为证据或被排除,绝不作为编辑目标。
  • Claude 指令与共享符号链接目标仅做核对。
  • 编辑前需解析真实路径;不得通过符号链接写入其他产品或共享/全局层。
  • 持久化 Codex 记忆需要用户明确直接请求并符合当前记忆策略;仅调用本技能不足以授权。
  • 不得为让过时声明成立而更改操作行为或权限。
  • 无自动自同步:仅当本技能被显式纳入授权清单时才可编辑。