axiom-apple-docs-research

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Apple Documentation Research

Apple文档研究

When to Use This Skill

何时使用本技能

Use this skill when:
  • Researching Apple frameworks or APIs (WidgetKit, SwiftUI, etc.)
  • Need full WWDC session transcripts with code samples
  • Looking for Apple Developer documentation
  • Want to extract code examples from WWDC presentations
  • Building comprehensive skills based on Apple technologies
Do NOT use this skill for:
  • Third-party framework documentation
  • General web research
  • Questions already answered in existing skills
  • Basic Swift language questions (use Swift documentation)
适用于以下场景使用本技能:
  • 研究Apple框架或API(WidgetKit、SwiftUI等)
  • 需要包含代码示例的完整WWDC会议文字记录
  • 查找Apple开发者文档
  • 从WWDC演示中提取代码示例
  • 基于Apple技术构建全面的技能
请勿在以下场景使用本技能:
  • 第三方框架文档
  • 通用网页研究
  • 现有技能已解答的问题
  • 基础Swift语言问题(请使用Swift文档)

Related Skills

相关技能

  • Use superpowers-chrome:browsing for interactive browser control
  • Use writing-skills when creating new skills from Apple documentation
  • Use reviewing-reference-skills to validate Apple documentation skills
  • 使用 superpowers-chrome:browsing 进行交互式浏览器控制
  • 从Apple文档创建新技能时使用 writing-skills
  • 使用 reviewing-reference-skills 验证Apple文档相关技能

Core Philosophy

核心理念

Apple Developer video pages contain full verbatim transcripts with timestamps and complete code samples. Chrome's auto-capture feature makes this content instantly accessible without manual copying.
Key insight: Don't manually transcribe or copy code from WWDC videos. The transcripts are already on the page, fully timestamped and formatted.
Apple开发者视频页面包含带时间戳的完整逐字记录和完整代码示例。Chrome的自动捕获功能无需手动复制即可即时获取这些内容。
关键见解: 不要手动转录或从WWDC视频中复制代码。页面上已有带完整时间戳和格式的文字记录。

WWDC Session Transcripts via Chrome

通过Chrome获取WWDC会议文字记录

The Technique

方法

Apple Developer video pages (
developer.apple.com/videos/play/wwdc20XX/XXXXX/
) contain complete transcripts that Chrome auto-captures.
Apple开发者视频页面(
developer.apple.com/videos/play/wwdc20XX/XXXXX/
)包含Chrome可自动捕获的完整文字记录。

Step-by-Step Process

分步流程

  1. Navigate using Chrome browser MCP tool:
    json
    {
      "action": "navigate",
      "payload": "https://developer.apple.com/videos/play/wwdc2025/278/"
    }
    Tool name:
    mcp__plugin_superpowers-chrome_chrome__use_browser
    Complete invocation:
    Use the mcp__plugin_superpowers-chrome_chrome__use_browser tool with:
    - action: "navigate"
    - payload: "https://developer.apple.com/videos/play/wwdc2025/278/"
  2. Locate the auto-captured file:
    • Chrome saves to:
      ~/.../superpowers/browser/YYYY-MM-DD/session-TIMESTAMP/
    • Session directory uses Unix timestamp in milliseconds (e.g.,
      session-1765217804099
      )
    • Filename pattern:
      NNN-navigate.md
      (e.g.,
      001-navigate.md
      )
    Finding the latest session:
    bash
    # List sessions sorted by modification time (newest first)
    ls -lt ~/Library/Caches/superpowers/browser/*/session-* | head -5
  3. Read the captured transcript:
    • Full spoken content with timestamps (e.g.,
      [0:07]
      ,
      [1:23]
      )
    • Descriptions of code and API usage (spoken, not formatted)
    • Chapter markers and resource links
  1. 导航 使用Chrome浏览器MCP工具:
    json
    {
      "action": "navigate",
      "payload": "https://developer.apple.com/videos/play/wwdc2025/278/"
    }
    工具名称:
    mcp__plugin_superpowers-chrome_chrome__use_browser
    完整调用示例:
    使用mcp__plugin_superpowers-chrome_chrome__use_browser工具,参数如下:
    - action: "navigate"
    - payload: "https://developer.apple.com/videos/play/wwdc2025/278/"
  2. 定位自动捕获的文件:
    • Chrome保存路径:
      ~/.../superpowers/browser/YYYY-MM-DD/session-TIMESTAMP/
    • 会话目录使用毫秒级Unix时间戳(例如:
      session-1765217804099
    • 文件名格式:
      NNN-navigate.md
      (例如:
      001-navigate.md
    查找最新会话:
    bash
    # 按修改时间排序列出会话(最新在前)
    ls -lt ~/Library/Caches/superpowers/browser/*/session-* | head -5
  3. 读取捕获的文字记录:
    • 带时间戳的完整语音内容(例如:
      [0:07]
      ,
      [1:23]
    • 代码和API用法的描述(语音形式,无格式)
    • 章节标记和资源链接

What You Get

可获取的内容

✅ WWDC transcripts contain:
  • Full spoken content with timestamps (e.g.,
    [0:07]
    ,
    [1:23]
    )
  • API names mentioned by speakers (e.g.,
    widgetRenderingMode
    ,
    supportedMountingStyles
    )
  • Descriptions of what code does ("I'll add the widgetRenderingMode environment variable")
  • Step-by-step explanations of implementations
  • Chapter markers and resource links
❌ WWDC transcripts do NOT contain:
  • Formatted Swift code blocks ready to copy-paste
  • Complete implementations
  • Structured code examples
Critical Understanding: Transcripts are spoken word, not code. You'll read sentences like "I'll add the widgetRenderingMode environment variable to my widget view" and need to reconstruct the code yourself from these descriptions.
✅ WWDC文字记录包含:
  • 带时间戳的完整语音内容(例如:
    [0:07]
    ,
    [1:23]
  • 演讲者提到的API名称(例如:
    widgetRenderingMode
    ,
    supportedMountingStyles
  • 代码功能描述("我将添加widgetRenderingMode环境变量")
  • 实现步骤的分步说明
  • 章节标记和资源链接
❌ WWDC文字记录不包含:
  • 可直接复制粘贴的格式化Swift代码块
  • 完整实现代码
  • 结构化代码示例
关键说明: 文字记录是语音内容,而非代码。你会看到类似"我将把widgetRenderingMode环境变量添加到我的widget视图中"的句子,需要根据这些描述自行重构代码

When Code Isn't Clear from Transcript

当文字记录中的代码描述不够清晰时

If the transcript's code descriptions aren't detailed enough, follow this fallback workflow:
  1. Check Resources Tab
    • Navigate back to the WWDC session page
    • Click "Resources" tab
    • Look for "Download Sample Code" or "View on GitHub"
    • Download Xcode project with complete working implementation
  2. Use sosumi.ai for API Details
    • Look up specific APIs mentioned in transcript
    • Example: Transcript says "widgetAccentedRenderingMode" → look up
      sosumi.ai/documentation/swiftui/widgetaccentedrenderingmode
    • Get exact signature, parameters, usage
  3. Jump to Timestamp in Video
    • Use transcript timestamp to jump directly to code explanation in video
    • Example: Transcript says code at
      [4:23]
      → watch that specific 30-second segment
    • Faster than watching entire 45-minute session
  4. Combine Sources
    • Transcript = conceptual understanding + workflow
    • Resources = complete code
    • sosumi.ai = API details
    • Result: Full picture without manually reconstructing everything
Example transcript structure:
markdown
undefined
如果文字记录的代码描述不够详细,请遵循以下备用流程:
  1. 检查资源标签页
    • 返回WWDC会议页面
    • 点击"Resources"标签页
    • 查找"Download Sample Code"或"View on GitHub"
    • 下载包含完整可运行实现的Xcode项目
  2. 使用sosumi.ai获取API详情
    • 查找文字记录中提到的特定API
    • 示例: 文字记录提到"widgetAccentedRenderingMode" → 访问
      sosumi.ai/documentation/swiftui/widgetaccentedrenderingmode
    • 获取准确的签名、参数和用法
  3. 跳转到视频对应时间戳
    • 使用文字记录的时间戳直接跳转到视频中的代码讲解部分
    • 示例: 文字记录显示代码在
      [4:23]
      → 观看该30秒片段
    • 比观看整个45分钟的会议更快
  4. 整合多来源内容
    • 文字记录 = 概念理解 + 工作流程
    • 资源 = 完整代码
    • sosumi.ai = API详情
    • 结果: 无需手动重构即可获得完整信息
文字记录结构示例:
markdown
undefined

Session Title - WWDC## - Videos - Apple Developer

Session Title - WWDC## - Videos - Apple Developer

Chapters

Chapters

  • 0:00 - Introduction
  • 1:23 - Key Topic 1
  • 0:00 - Introduction
  • 1:23 - Key Topic 1

Transcript

Transcript

0:00 Speaker: Welcome to this session...
[timestamp] Now I'll add the widgetAccentedRenderingMode modifier...
undefined
0:00 Speaker: Welcome to this session...
[timestamp] Now I'll add the widgetAccentedRenderingMode modifier...
undefined

Example Session

示例会议

WWDC 2025-278 "What's new in widgets":
  • Navigate:
    https://developer.apple.com/videos/play/wwdc2025/278/
  • Captured:
    001-navigate.md
  • Contains: ~15 minutes of full transcript with API references and code concepts
WWDC 2025-278 "What's new in widgets":
  • 导航地址:
    https://developer.apple.com/videos/play/wwdc2025/278/
  • 捕获文件:
    001-navigate.md
  • 包含内容: 约15分钟的完整文字记录,含API引用和代码概念

Apple Documentation via sosumi.ai

通过sosumi.ai获取Apple文档

Why sosumi.ai

为什么选择sosumi.ai

Developer.apple.com documentation is HTML-heavy and difficult to parse. sosumi.ai provides the same content in clean markdown format.
developer.apple.com的文档HTML结构复杂,难以解析。sosumi.ai以简洁的markdown格式提供相同内容。

URL Pattern

URL格式

Instead of:
https://developer.apple.com/documentation/widgetkit
Use:
https://sosumi.ai/documentation/widgetkit
替代:
https://developer.apple.com/documentation/widgetkit
使用:
https://sosumi.ai/documentation/widgetkit

URL Pattern Rules

URL格式规则

Format:
https://sosumi.ai/documentation/[framework]
Rules for framework name:
  1. Lowercase - Use lowercase even if framework is capitalized (SwiftUI → swiftui)
  2. No spaces - Remove all spaces (Core Data → coredata)
  3. No hyphens - Remove all hyphens (App Intents → appintents, NOT app-intents)
  4. Case-insensitive - Both
    SwiftUI
    and
    swiftui
    work, but lowercase is recommended
Common mistakes:
  • app-intents
    → ✅
    appintents
  • axiom-core-data
    → ✅
    coredata
  • AVFoundation
    → ✅
    avfoundation
Examples:
Framework Namesosumi.ai URL
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
格式:
https://sosumi.ai/documentation/[framework]
框架名称规则:
  1. 小写 - 即使框架名称首字母大写也使用小写(SwiftUI → swiftui)
  2. 无空格 - 移除所有空格(Core Data → coredata)
  3. 无连字符 - 移除所有连字符(App Intents → appintents,而非app-intents)
  4. 大小写不敏感 -
    SwiftUI
    swiftui
    都可使用,但推荐小写
常见错误:
  • app-intents
    → ✅
    appintents
  • axiom-core-data
    → ✅
    coredata
  • AVFoundation
    → ✅
    avfoundation
示例:
框架名称sosumi.ai URL
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

Using with WebFetch or Read Tools

与WebFetch或Read工具配合使用

WebFetch:
  url: https://sosumi.ai/documentation/widgetkit/widget
  prompt: "Extract information about Widget protocol"

Result: Clean markdown with API signatures, descriptions, examples
WebFetch:
  url: https://sosumi.ai/documentation/widgetkit/widget
  prompt: "Extract information about Widget protocol"

Result: 包含API签名、描述和示例的简洁markdown

Framework Examples

框架示例

Frameworksosumi.ai URL
WidgetKit
https://sosumi.ai/documentation/widgetkit
SwiftUI
https://sosumi.ai/documentation/swiftui
ActivityKit
https://sosumi.ai/documentation/activitykit
App Intents
https://sosumi.ai/documentation/appintents
Foundation
https://sosumi.ai/documentation/foundation
框架sosumi.ai URL
WidgetKit
https://sosumi.ai/documentation/widgetkit
SwiftUI
https://sosumi.ai/documentation/swiftui
ActivityKit
https://sosumi.ai/documentation/activitykit
App Intents
https://sosumi.ai/documentation/appintents
Foundation
https://sosumi.ai/documentation/foundation

Common Research Workflows

常见研究工作流

Workflow 1: New iOS Feature Research

工作流1: 新iOS功能研究

Goal: Create a comprehensive skill for a new iOS 26 feature.
  1. Find WWDC sessions — Search "WWDC 2025 [feature name]"
  2. Get transcripts — Navigate with Chrome to each session
  3. Read transcripts — Extract key concepts, code patterns, gotchas
  4. Get API docs — Use sosumi.ai for framework reference
  5. Cross-reference — Verify code samples match documentation
  6. Create skill — Combine transcript insights + API reference
Time saved: 3-4 hours vs. watching videos and manual transcription
目标: 为iOS 26的新功能创建全面的技能。
  1. 查找WWDC会议 — 搜索"WWDC 2025 [功能名称]"
  2. 获取文字记录 — 使用Chrome导航到每个会议页面
  3. 阅读文字记录 — 提取关键概念、代码模式和注意事项
  4. 获取API文档 — 使用sosumi.ai获取框架参考
  5. 交叉验证 — 验证代码示例与文档是否匹配
  6. 创建技能 — 整合文字记录见解 + API参考
节省时间: 与观看视频和手动转录相比,节省3-4小时

Workflow 2: API Deep Dive

工作流2: API深入研究

Goal: Understand a specific API or protocol.
  1. sosumi.ai docs — Get protocol/class definition
  2. WWDC sessions — Search for sessions mentioning the API
  3. Code samples — Extract from transcript code blocks
  4. Verify patterns — Ensure examples match latest API
目标: 理解特定API或协议。
  1. sosumi.ai文档 — 获取协议/类定义
  2. WWDC会议 — 搜索提到该API的会议
  3. 代码示例 — 从文字记录的代码块中提取
  4. 验证模式 — 确保示例与最新API匹配

Workflow 3: Multiple Sessions Research

工作流3: 多会议研究

Goal: Comprehensive coverage across multiple years (e.g., widgets evolution).
  1. Parallel navigation — Use Chrome to visit 3-6 sessions
  2. Read all transcripts — Compare how APIs evolved
  3. Extract timeline — iOS 14 → 17 → 18 → 26 changes
  4. Consolidate — Create unified skill with version annotations
Example: Extensions & Widgets skill used 6 WWDC sessions (2023-2025)
目标: 跨多年的全面覆盖(例如,Widgets的演变)。
  1. 并行导航 — 使用Chrome访问3-6个会议
  2. 阅读所有文字记录 — 比较API的演变过程
  3. 提取时间线 — iOS 14 → 17 → 18 → 26的变化
  4. 整合内容 — 创建带版本注释的统一技能
示例: 扩展与Widgets技能使用了6个WWDC会议(2023-2025)

Anti-Patterns

反模式

❌ DON'T: Manual Video Watching

❌ 请勿: 手动观看视频

BAD:
1. Play WWDC video
2. Pause and take notes
3. Rewind to capture code
4. Type out examples manually

Result: 45 minutes per session
错误做法:
1. 播放WWDC视频
2. 暂停并做笔记
3. 倒回以捕获代码
4. 手动输入示例

结果: 每个会议耗时45分钟

✅ DO: Chrome Auto-Capture

✅ 推荐: Chrome自动捕获

GOOD:
1. Navigate with Chrome
2. Read captured .md file
3. Copy code blocks directly
4. Reference timestamps for context

Result: 5 minutes per session
正确做法:
1. 使用Chrome导航
2. 阅读捕获的.md文件
3. 直接复制代码块
4. 参考时间戳获取上下文

结果: 每个会议耗时5分钟

❌ DON'T: Scrape developer.apple.com HTML

❌ 请勿: 爬取developer.apple.com的HTML

BAD:
Use WebFetch on developer.apple.com/documentation
Result: Complex HTML parsing required
错误做法:
在developer.apple.com/documentation上使用WebFetch
结果: 需要复杂的HTML解析

✅ DO: Use sosumi.ai

✅ 推荐: 使用sosumi.ai

GOOD:
Use WebFetch on sosumi.ai/documentation
Result: Clean markdown, instant access
正确做法:
在sosumi.ai/documentation上使用WebFetch
结果: 简洁的markdown,即时访问

Troubleshooting

故障排除

Chrome Session Directory Not Found

Chrome会话目录未找到

Symptom: Can't locate
001-navigate.md
file
Solution:
  1. Check Chrome actually navigated (look for URL confirmation)
  2. Find latest session:
    ls -lt ~/Library/Caches/superpowers/browser/*/
  3. Session directory format:
    YYYY-MM-DD/session-TIMESTAMP/
症状: 无法找到
001-navigate.md
文件
解决方案:
  1. 确认Chrome已完成导航(查看URL确认信息)
  2. 查找最新会话:
    ls -lt ~/Library/Caches/superpowers/browser/*/
  3. 会话目录格式:
    YYYY-MM-DD/session-TIMESTAMP/

Transcript Incomplete

文字记录不完整

Symptom: File exists but missing transcript
Solution:
  1. Page may still be loading - wait 2-3 seconds
  2. Try navigating again
  3. Some sessions require scrolling to load full content
症状: 文件存在但缺少文字记录
解决方案:
  1. 页面可能仍在加载 - 等待2-3秒
  2. 尝试重新导航
  3. 部分会议需要滚动才能加载完整内容

sosumi.ai Returns Error

sosumi.ai返回错误

Symptom: 404 or invalid URL
Solution:
  1. Verify framework name spelling
  2. Check sosumi.ai format:
    /documentation/[frameworkname]
  3. Fallback: Use developer.apple.com but expect HTML
症状: 404或无效URL
解决方案:
  1. 验证框架名称拼写
  2. 检查sosumi.ai格式:
    /documentation/[frameworkname]
  3. 备用方案: 使用developer.apple.com,但需处理HTML

Verification Checklist

验证清单

Before using captured content:
  • ☐ Transcript includes timestamps
  • ☐ Code samples are complete (not truncated)
  • ☐ Speaker names and chapter markers present
  • ☐ Multiple speakers properly attributed
  • ☐ Code syntax highlighting preserved
使用捕获的内容前:
  • ☐ 文字记录包含时间戳
  • ☐ 代码示例完整(未截断)
  • ☐ 包含演讲者姓名和章节标记
  • ☐ 正确区分多位演讲者的内容
  • ☐ 代码语法高亮保留

Resources

资源

Skills: superpowers-chrome:browsing, writing-skills, reviewing-reference-skills

Time Saved: Using this technique saves 30-40 minutes per WWDC session vs. manual video watching and transcription. For comprehensive research spanning multiple sessions, savings compound to 3-4 hours per skill.
技能: superpowers-chrome:browsing, writing-skills, reviewing-reference-skills

节省时间: 与手动观看视频和转录相比,使用该技术每个WWDC会议可节省30-40分钟。对于跨多个会议的全面研究,每个技能可节省3-4小时。",