tools-registry-context 是一个面向 tools-registry 项目的技能，用于加载正确的设计文档片段并保持文档与代码一致。
用途 tools-registry 的设计文档以片段形式存放在 docs/context/ 目录下，每个子系统一个片段，并在 frontmatter 中声明其覆盖的源文件。与该技能同目录的 MAP.md 是生成的反向索引：源文件 → 记录它的片段。该技能提供两种工作模式。
模式 A — 加载上下文（默认） 根据被调用的时机自适应：
- 冷启动（全新会话、几乎没有先前上下文）→ 预热。先读 docs/context/README.md（索引），再读重要的片段（基础性概览片段，加上查询或仓库状态指向的子系统）。运行 git log --oneline -15 和 git status 以了解近期提交与未提交的工作。然后给出简短定位——tools-registry 是什么、涉及哪些子系统、最近有什么变化——并说明已就绪。
- 会话中途（已有任务或话题在进行）→ 保持聚焦。通过 MAP.md 的“源文件 → 片段”表定位当前涉及的产物或话题，只读这些片段并继续。不要重新预热整棵树。
- 聚焦查询（/tools-registry-context <query>）始终优先——用它来挑选片段，并在任一情况下把预热聚焦到该区域。
始终遵循：在改动任何内容前先阅读数据模型、行为、RCA 和符号锚点；只加载相关内容（绝不倾倒整棵树）；如果接触到的产物没有对应片段，将其记为模式 B 的缺口。
模式 B — 同步文档（/tools-registry-context sync，或在推送前） 在推送到主分支之前，提醒用户运行此模式；仅在用户同意后继续。然后遵循 MAINTAINING.md，简要流程如下：
- 检测漂移：bash .Codex/skills/tools-registry-context/scripts/drift.sh（默认范围为 origin/main..HEAD）。它会按每个变更的源文件打印哪些片段记录了它，以及缺口。
- 起草更新：对每个受影响的片段，阅读该片段与 diff；更新文字以匹配变更后的行为，并核实引用的符号仍然存在（不要追逐行号——符号不会漂移）。没有片段的新子系统 → 从 fragment.md.tmpl 起草新片段。
- 先展示再应用：在写入前展示拟议的更改并获得批准。
- 重新生成：python3 .Codex/skills/tools-registry-context/scripts/build-map.py（重写 README 与 MAP）。
- 一起提交：文档更新与代码在同一次提交/推送中同行。
不变量
- 文档是事实来源；该技能只是一个透镜。片段存放在 docs/context/；绝不把它们复制进技能。技能只保留生成的 MAP.md、脚本和配置。
- frontmatter 驱动一切。片段的 sources: 供给索引、MAP 和漂移检测。当片段开始覆盖新文件时，将其加入 sources: 并重新运行 build-map.py。
- 引用稳定符号，而非行号。把每条论断锚定到可 grep 的符号；裸行号会在每次编辑时漂移并拖慢同步。描述已交付的内容，而非意图。
- 不在用户背后自动化。同步是提醒 → 批准 → 应用。没有 git hook。
- 交接与计划不是文档。它们存放在 docs/context/ 之外（例如 .context/），不在范围内——绝不读取、合并或将其作为片段输入扫描。
适用场景 适用于在 tools-registry 项目中开始新会话时快速定位架构与近期改动，或在会话中途针对特定话题精准加载相关设计片段；也适用于在推送主分支前同步文档、检测文档漂移并更新片段。
限制 该技能依赖 docs/context/ 下的片段与 frontmatter 中的 sources: 声明，以及 MAP.md、drift.sh、build-map.py 等脚本和配置。资料未提供其支持的具体平台、安装方式、收费或价格信息。