用途：这是一个知识编译工作流，用于从已验证的上游版本更新 Contentful Optimization SDK 的现代化知识，产出面向代理的简洁、明确、按运行时分层的参考文档，而非整篇照搬上游指南。它管理现代 @contentful/optimization* 指南，保留旧版 @ninetailed/* 指南，除非上游证据要求兼容性修正。
支持的运行时：共享概念与行为、React Web、Next.js App Router、Next.js Pages Router、browser Web、Node.js、React Native。上游未提供等价知识库事实、公共 API 声明与指南蓝图前，不合成 iOS 或 Android 指南。
来源解析：默认使用 https://github.com/contentful/optimization.git，依次解析用户提供的本地路径、缓存 .docs/optimization-sdk-sync/repository、或全新克隆。缓存为仓库本地工作状态，不提交、不分发。默认远程流程需检查缓存 origin 与工作树状态，确认 origin 为官方 HTTPS 仓库后再取，解析为完整不可变提交 SHA，并以分离检出方式查看，不使用 git pull 或 merge。绝不修改源仓库。
证据层级：知识库事实、公共导出与类型、指南蓝图、维护中的实现与公开文档四层并用；API 形状以公共导出与类型为准，行为语义以知识库事实为准，实现拓扑以一方实现为准，任务完整性以蓝图为准。
使用方式：先读取各适用 AGENTS.md，再运行 pnpm knowledge:check 与 pnpm guides:check，结果为通过、失败或阻塞。两项均通过前停止权威性写入。随后比较旧上游 SHA 与新 SHA 确定增量，编译到 src/skills/contentful-personalization/references/ 下的 overview、shared 及各运行时文件，更新消费者与 provenance 清单，并运行 build、lint、typecheck、test 等校验。未获用户要求时不提交、推送或发起 PR。暂未提供收费与价格信息。