用途：把本地 Xcode 的 macOS SDK 作为 macOS 26 API 的真实来源，在需要确认某个 SwiftUI/AppKit 符号是否可用、如何声明、可用性版本时优先使用，而不是先做网络搜索。
主要能力：通过脚本构建并缓存符号图，搜索 SwiftUI、SwiftUICore、AppKit 的符号文档；支持按模块、结果类型、macOS 26 引入版本过滤；可列出或按模式查找 SDK 模块；probe_symbol.py 与 --verify-interfaces 会附带 .swiftinterface、头文件或 apinotes 中的精确源码片段与诊断。
使用方式：先运行 python3 "$HOME/.codex/skills/search-macos26-docs/scripts/build_cache.py" 构建缓存；用 python3 "$HOME/.codex/skills/search-macos26-docs/scripts/search_symbols.py glass button style 搜索，可加 --module、--macos26、--kind、--json 等参数；用 probe_symbol.py ZoomNavigationTransition --module SwiftUI 做精确探查。缓存默认位于 ${CODEX_MACOS26_DOCS_CACHE:-$HOME/.cache/codex/search-macos26-docs}/<sdk-name>/<target>/<module>/，Xcode 变更或结果陈旧时用 --force 重建。
限制：Swift 接口文件是 API 表面而非完整文档；符号图与已验证源码冲突时应以源码为准并报告差异；不能假定 Apple 开发者网页对 macOS 26 新 SDK API 完整或最新；提取失败时可退回在 $SDK_PATH 下用 rg 搜索框架接口；精度重要时需报告当前 SDK 基名、target 三元组与模块。修改脚本后需运行端到端测试。