xcdocs

XCDocs

在修改代码时，将 xcdocs 用作本地 Apple 框架参考。

在实现过程中使用

• 在依赖此技能之前，确保 xcdocs 可用。
• 遇到不熟悉、刚发布、已重命名或导致编译失败的 Apple API 时，使用它查询。
• 先使用 search --json --omit-content 查找可能相关的符号、文章或主题。
• 如果查询范围较广，添加可重复使用的 --framework 和 --kind {article|symbol|topic} 筛选条件。
• 将搜索结果中 documents[].uri 视为 get 的规范标识符。
• 在编辑依赖该 API 的代码之前，使用 get --json 检查完整条目。
• 将查到的信息应用到代码中：修正符号名称、选择正确的重载、调整可用性保护条件，或改用文档说明的 API。

常见用途

• 通过核实实际符号名称和入口点，修复 Apple 框架相关的编译错误。
• 在将新发布的框架或功能领域接入代码之前，先进行探索。
• 确认某个 API 是符号、更广泛的主题页面，还是附有设置指南的文章。
• 找到一个相关文档条目后，查找关联的类型或概念。

参考

• 阅读 references/cli.md，了解命令语法、JSON 格式和故障排查。