axiom-apple-docs-research

用途

该技能用于研究 Apple 框架、API 或 WWDC 会议。当需要检索 WidgetKit、SwiftUI 等 Apple 框架与 API，获取带代码示例的完整 WWDC 会议逐字稿，查找 Apple 开发者文档，从 WWDC 演示中提取代码示例，或基于 Apple 技术构建综合性技能时使用。它不适用于第三方框架文档、通用网络研究、已有技能中已解答的问题，以及基础 Swift 语言问题（应使用 Swift 文档）。

核心理念

Apple 开发者视频页面包含带时间戳的完整逐字稿和完整代码示例。Chrome 的自动捕获功能使这些内容无需手动复制即可即时获取。关键洞察：不要手动转录或从 WWDC 视频复制代码，逐字稿已在页面上完整呈现，带时间戳且已格式化。

主要能力一：通过 Chrome 获取 WWDC 会议逐字稿

Apple 开发者视频页面（developer.apple.com/videos/play/wwdc20XX/XXXXX/）包含 Chrome 可自动捕获的完整逐字稿。操作步骤：

使用 Chrome 浏览器 MCP 工具导航：工具名为 mcp__plugin_superpowers-chrome_chrome__use_browser，调用时设置 action: "navigate"，payload 为会话 URL，例如 https://developer.apple.com/videos/play/wwdc2025/278/。
定位自动捕获文件：Chrome 保存路径为 ~/.../superpowers/browser/YYYY-MM-DD/session-TIMESTAMP/，会话目录使用毫秒级 Unix 时间戳（如 session-1765217804099），文件名模式为 NNN-navigate.md（如 001-navigate.md）。查找最新会话的命令：ls -lt ~/Library/Caches/superpowers/browser//session- | head -5。
读取捕获的逐字稿，其中包含带时间戳的完整口语内容（如 [0:07]、[1:23]）、对代码和 API 用法的描述（口语化，未格式化）、章节标记和资源链接。

逐字稿包含：带时间戳的完整口语内容、演讲者提到的 API 名称（如 widgetRenderingMode、supportedMountingStyles）、对代码功能的描述（如“I'll add the widgetRenderingMode environment variable”）、实现的分步解释、章节标记和资源链接。

逐字稿不包含：可直接复制粘贴的格式化 Swift 代码块、完整实现、结构化的代码示例。关键理解：逐字稿是口语内容，不是代码。需要根据描述自行重建代码。

当逐字稿中代码不清晰时的备用流程

查看 Resources 标签：返回 WWDC 会话页面，点击 "Resources" 标签，寻找 "Download Sample Code" 或 "View on GitHub"，下载包含完整可运行实现的 Xcode 项目。
使用 sosumi.ai 查询 API 细节：查找逐字稿中提到的具体 API。例如逐字稿说 "widgetAccentedRenderingMode"，则查询 sosumi.ai/documentation/swiftui/widgetaccentedrenderingmode，获取确切签名、参数和用法。
跳转到视频时间戳：使用逐字稿时间戳直接跳到视频中的代码讲解处。例如逐字稿说代码位于 [4:23]，则观看该特定 30 秒片段，比观看整段 45 分钟会话更快。
组合来源：逐字稿提供概念理解与工作流，Resources 提供完整代码，sosumi.ai 提供 API 细节。

主要能力二：通过 sosumi.ai 获取 Apple 文档

developer.apple.com 文档 HTML 繁重、难以解析。sosumi.ai 以干净的 Markdown 格式提供相同内容。URL 模式为 https://sosumi.ai/documentation/[framework]，替代 https://developer.apple.com/documentation/[framework]。

框架名规则：小写（即使框架名大写，SwiftUI → swiftui）；无空格（Core Data → coredata）；无连字符（App Intents → appintents，不是 app-intents）；大小写不敏感（SwiftUI 和 swiftui 均可，推荐小写）。常见错误：app-intents 应为 appintents；axiom-core-data 应为 coredata；AVFoundation 应为 avfoundation。

示例：SwiftUI → sosumi.ai/documentation/swiftui；App Intents → sosumi.ai/documentation/appintents；Core Data → sosumi.ai/documentation/coredata；AVFoundation → sosumi.ai/documentation/avfoundation；UIKit → sosumi.ai/documentation/uikit。

配合 WebFetch 或 Read 工具使用，例如 WebFetch 设置 url: https://sosumi.ai/documentation/widgetkit/widget，prompt: "Extract information about Widget protocol"，即可获得含 API 签名、描述、示例的干净 Markdown。框架示例：WidgetKit、SwiftUI、ActivityKit、App Intents、Foundation 均对应各自的 sosumi.ai/documentation 路径。

常见研究工作流

工作流一：新 iOS 功能研究。目标是创建新 iOS 26 功能的综合技能。步骤：搜索 "WWDC 2025 [功能名]" 找到会话；用 Chrome 导航至每个会话获取逐字稿；阅读逐字稿提取关键概念、代码模式与注意事项；用 sosumi.ai 获取框架参考；交叉验证代码示例与文档是否一致；结合逐字稿洞察与 API 参考创建技能。相比观看视频与手动转录可节省 3 至 4 小时。

工作流二：API 深度研究。目标是理解特定 API 或协议。步骤：用 sosumi.ai 获取协议/类定义；搜索提及该 API 的 WWDC 会话；从逐字稿代码块提取代码示例；验证示例与最新 API 是否匹配。

工作流三：多会话研究。目标是跨多年进行全面覆盖（如 widgets 演进）。步骤：用 Chrome 并行访问 3 至 6 个会话；阅读全部逐字稿比较 API 如何演进；提取时间线（iOS 14 → 17 → 18 → 26 变化）；合并为带版本标注的统一技能。示例：Extensions & Widgets 技能使用了 6 个 WWDC 会话（2023-2025）。

反模式

避免手动观看视频：播放、暂停记笔记、回退捕获代码、手动输入，每个会话约耗时 45 分钟。应使用 Chrome 自动捕获：导航、读取捕获的 .md 文件、直接复制代码块、参考时间戳获取上下文，每个会话约 5 分钟。

避免抓取 developer.apple.com 的 HTML：需复杂 HTML 解析。应使用 sosumi.ai：获得干净 Markdown，即时访问。

故障排查

Chrome 会话目录未找到：确认 Chrome 确实已导航（查看 URL 确认）；用 ls -lt ~/Library/Caches/superpowers/browser/*/ 查找最新会话；会话目录格式为 YYYY-MM-DD/session-TIMESTAMP/。

逐字稿不完整：页面可能仍在加载，等待 2 至 3 秒；尝试重新导航；部分会话需滚动以加载完整内容。

sosumi.ai 返回错误（404 或无效 URL）：核实框架名拼写；检查格式为 /documentation/[frameworkname]；回退到 developer.apple.com，但需预期 HTML。

使用前验证清单

逐字稿包含时间戳；代码示例完整（未截断）；演讲者姓名与章节标记存在；多位演讲者归属正确；代码语法高亮保留。

技能介绍

用途