用途
memory-sync 用于同步项目中的 Codex 指令,使其与当前源码事实保持一致。它依据 references/sync-contract.md 执行,核心工作是对一组明确列入清单的 Codex 指令进行核对、去重与压缩。
主要能力
- 在编辑前盘点被授权的具体路径:适用的 AGENTS.md、被显式引用的 .codex/rules/ 或约定、原生 agent TOML,以及原生 skills/配套指令 Markdown。
- 判断授权:文件存在于某目录、被 git 跟踪或为 Markdown 格式,均不构成授权。
- 尊重用户缩小范围的要求,包括“仅规则”或明确的文件列表。
- 从请求中解析变更事实来源:默认会话,也可指定分支、提交/范围、近期提交或全部事实。
- 提供两种深度:NORMAL 核对事实、去重并压缩;HARD 额外审计规则激活情况,并在不丢失项目决策的前提下移除通用性指导。深度不会扩大编辑范围。
- 以英文说明来源、深度、具体盘点/排除项及核对情况。
使用方式
- 盘点被授权的具体路径,明确纳入与排除范围。
- 解析变更事实来源与深度(NORMAL 或 HARD)。
- 对实际被授权的文件做快照。
- 核对事实,选择规范归属并去重,使用 apply_patch 进行压缩。
- 保留决策、禁止项、例外、归属、来源、编号规则 ID 及受支持的原生元数据。
- 重新审计纳入的 agents/skills 的当前角色、路径、工具、契约与引用;将 TOML 按 TOML 解析。
- 在授权或可用时,使用有界的不相交负责人及独立的只读同步后检查;否则披露核对限制。
- 对照快照与实时证据核对每次编辑与删除,包括大幅缩减后的全文。
- 保持根规则索引(Rule、Load when、Purpose)与被授权的规则编辑一致:.codex/rules/ 与 paths 不自动加载。若根索引超出用户缩小后的范围,应报告所需的索引修正,而不是静默扩大写入。
- 报告编辑路径、已核对事实、移除的重复/过时声明、前后大小、不确定事实、仅核对漂移、检查项及延后建议。
适用场景
- 需要将项目 Codex 指令与当前源码事实对齐时。
- 需要去重、压缩指令,或审计规则激活情况时。
- 用户明确指定了授权文件范围或缩小了范围时。
限制
- 源码、分发模板/产品技能源、公开文档、配置、报告、任务/运行时状态、缓存、密钥及个人/全局指令层仅作为证据或被排除,绝不作为编辑目标。
- Claude 指令与共享符号链接目标仅做核对。
- 编辑前需解析真实路径;不得通过符号链接写入其他产品或共享/全局层。
- 持久化 Codex 记忆需要用户明确直接请求并符合当前记忆策略;仅调用本技能不足以授权。
- 不得为让过时声明成立而更改操作行为或权限。
- 无自动自同步:仅当本技能被显式纳入授权清单时才可编辑。