用途：sync-context 用于在代码改动后，把 .agents/docs/CONTEXT/ 下已归档的上下文与仓库现状对齐，避免过时条目误导决策。cooking 里的 spec.md 由 explore / to-spec / archive 负责，不在此修改。
主要能力：确定本次变更文件（用户给定路径，或取 git 工作区与暂存区变更的并集，忽略 .agents/cooking/）；查询归档条目的「影响文件」；命中则只打开命中条目并更新术语、领域、影响文件；条目被推翻则删除，被新能力替代则先建后删，仅更名或换归属则改名并同步索引；未命中时，琐碎改动结束，构成新能力则按模板新建条目。
使用方式：先运行 node .agents/scripts/precheck.mjs，FAIL 则停止，提示用户执行 setup（仅缺脚本类走 setup 更新模式），不要代跑。查询命令为 node .agents/scripts/spec-files.mjs query <文件1> <文件2>...，或从 git 输出传入：git diff --name-only | node .agents/scripts/spec-files.mjs query --stdin。查询只跟新增和修改走，某条目无法 parse 时先修好「影响文件」。工作区与暂存区都无变更时，用交互式提问工具问用户要同步哪次提交或哪些文件，不要自动取最近一次提交。
更新规则：只改被本次变更推翻的句子，不重写全文；旧条目若仍含验收标准、非目标、用户故事，改成上下文模板并丢弃那些章节；在 ## 更新记录 追加 - <日期>: <一句话>；涉及：<文件路径>，不要补旧账；标题或摘要变了同步 <模块>/index.md 对应行；废弃条目时删文件、删索引行，模块无条目时连目录与 CONTEXT/index.md 模块行一并删。不确定是否废弃或合并时，用交互式提问工具询问用户，不要猜。
限制：不写业务代码，不改 cooking，不代替 setup 更新 ARCHITECTURE.md；发现架构级变化时停止，让用户跑 setup 更新模式。代码类路径或职责被推翻时按 code-map-update.md 更新 CODE-MAP.md，非代码不要打开 CODE-MAP。结束需汇报扫描文件数、命中并更新的条目、删除与新建条目、CODE-MAP.md 是否更新、是否需要 setup。