axiom-apple-docs-research
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseApple 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 () contain complete transcripts that Chrome auto-captures.
developer.apple.com/videos/play/wwdc20XX/XXXXX/Apple开发者视频页面()包含Chrome可自动捕获的完整文字记录。
developer.apple.com/videos/play/wwdc20XX/XXXXX/Step-by-Step Process
分步流程
-
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_browserComplete invocation:Use the mcp__plugin_superpowers-chrome_chrome__use_browser tool with: - action: "navigate" - payload: "https://developer.apple.com/videos/play/wwdc2025/278/" -
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: (e.g.,
NNN-navigate.md)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 - Chrome saves to:
-
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
- Full spoken content with timestamps (e.g.,
-
导航 使用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/" -
定位自动捕获的文件:
- 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 - Chrome保存路径:
-
读取捕获的文字记录:
- 带时间戳的完整语音内容(例如: ,
[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:
-
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
-
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
-
Jump to Timestamp in Video
- Use transcript timestamp to jump directly to code explanation in video
- Example: Transcript says code at → watch that specific 30-second segment
[4:23] - Faster than watching entire 45-minute session
-
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如果文字记录的代码描述不够详细,请遵循以下备用流程:
-
检查资源标签页
- 返回WWDC会议页面
- 点击"Resources"标签页
- 查找"Download Sample Code"或"View on GitHub"
- 下载包含完整可运行实现的Xcode项目
-
使用sosumi.ai获取API详情
- 查找文字记录中提到的特定API
- 示例: 文字记录提到"widgetAccentedRenderingMode" → 访问
sosumi.ai/documentation/swiftui/widgetaccentedrenderingmode - 获取准确的签名、参数和用法
-
跳转到视频对应时间戳
- 使用文字记录的时间戳直接跳转到视频中的代码讲解部分
- 示例: 文字记录显示代码在→ 观看该30秒片段
[4:23] - 比观看整个45分钟的会议更快
-
整合多来源内容
- 文字记录 = 概念理解 + 工作流程
- 资源 = 完整代码
- sosumi.ai = API详情
- 结果: 无需手动重构即可获得完整信息
文字记录结构示例:
markdown
undefinedSession 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...
undefined0:00
Speaker: Welcome to this session...
[timestamp]
Now I'll add the widgetAccentedRenderingMode modifier...
undefinedExample 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/widgetkitUse:
https://sosumi.ai/documentation/widgetkit替代:
https://developer.apple.com/documentation/widgetkit使用:
https://sosumi.ai/documentation/widgetkitURL Pattern Rules
URL格式规则
Format:
https://sosumi.ai/documentation/[framework]Rules for framework name:
- Lowercase - Use lowercase even if framework is capitalized (SwiftUI → swiftui)
- No spaces - Remove all spaces (Core Data → coredata)
- No hyphens - Remove all hyphens (App Intents → appintents, NOT app-intents)
- Case-insensitive - Both and
SwiftUIwork, but lowercase is recommendedswiftui
Common mistakes:
- ❌ → ✅
app-intentsappintents - ❌ → ✅
axiom-core-datacoredata - ❌ → ✅
AVFoundationavfoundation
Examples:
| Framework Name | sosumi.ai URL |
|---|---|
| SwiftUI | |
| App Intents | |
| Core Data | |
| AVFoundation | |
| UIKit | |
格式:
https://sosumi.ai/documentation/[framework]框架名称规则:
- 小写 - 即使框架名称首字母大写也使用小写(SwiftUI → swiftui)
- 无空格 - 移除所有空格(Core Data → coredata)
- 无连字符 - 移除所有连字符(App Intents → appintents,而非app-intents)
- 大小写不敏感 - 和
SwiftUI都可使用,但推荐小写swiftui
常见错误:
- ❌ → ✅
app-intentsappintents - ❌ → ✅
axiom-core-datacoredata - ❌ → ✅
AVFoundationavfoundation
示例:
| 框架名称 | sosumi.ai URL |
|---|---|
| SwiftUI | |
| App Intents | |
| Core Data | |
| AVFoundation | |
| 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, examplesWebFetch:
url: https://sosumi.ai/documentation/widgetkit/widget
prompt: "Extract information about Widget protocol"
Result: 包含API签名、描述和示例的简洁markdownFramework Examples
框架示例
| Framework | sosumi.ai URL |
|---|---|
| WidgetKit | |
| SwiftUI | |
| ActivityKit | |
| App Intents | |
| Foundation | |
| 框架 | sosumi.ai URL |
|---|---|
| WidgetKit | |
| SwiftUI | |
| ActivityKit | |
| App Intents | |
| Foundation | |
Common Research Workflows
常见研究工作流
Workflow 1: New iOS Feature Research
工作流1: 新iOS功能研究
Goal: Create a comprehensive skill for a new iOS 26 feature.
- Find WWDC sessions — Search "WWDC 2025 [feature name]"
- Get transcripts — Navigate with Chrome to each session
- Read transcripts — Extract key concepts, code patterns, gotchas
- Get API docs — Use sosumi.ai for framework reference
- Cross-reference — Verify code samples match documentation
- Create skill — Combine transcript insights + API reference
Time saved: 3-4 hours vs. watching videos and manual transcription
目标: 为iOS 26的新功能创建全面的技能。
- 查找WWDC会议 — 搜索"WWDC 2025 [功能名称]"
- 获取文字记录 — 使用Chrome导航到每个会议页面
- 阅读文字记录 — 提取关键概念、代码模式和注意事项
- 获取API文档 — 使用sosumi.ai获取框架参考
- 交叉验证 — 验证代码示例与文档是否匹配
- 创建技能 — 整合文字记录见解 + API参考
节省时间: 与观看视频和手动转录相比,节省3-4小时
Workflow 2: API Deep Dive
工作流2: API深入研究
Goal: Understand a specific API or protocol.
- sosumi.ai docs — Get protocol/class definition
- WWDC sessions — Search for sessions mentioning the API
- Code samples — Extract from transcript code blocks
- Verify patterns — Ensure examples match latest API
目标: 理解特定API或协议。
- sosumi.ai文档 — 获取协议/类定义
- WWDC会议 — 搜索提到该API的会议
- 代码示例 — 从文字记录的代码块中提取
- 验证模式 — 确保示例与最新API匹配
Workflow 3: Multiple Sessions Research
工作流3: 多会议研究
Goal: Comprehensive coverage across multiple years (e.g., widgets evolution).
- Parallel navigation — Use Chrome to visit 3-6 sessions
- Read all transcripts — Compare how APIs evolved
- Extract timeline — iOS 14 → 17 → 18 → 26 changes
- Consolidate — Create unified skill with version annotations
Example: Extensions & Widgets skill used 6 WWDC sessions (2023-2025)
目标: 跨多年的全面覆盖(例如,Widgets的演变)。
- 并行导航 — 使用Chrome访问3-6个会议
- 阅读所有文字记录 — 比较API的演变过程
- 提取时间线 — iOS 14 → 17 → 18 → 26的变化
- 整合内容 — 创建带版本注释的统一技能
示例: 扩展与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 file
001-navigate.mdSolution:
- Check Chrome actually navigated (look for URL confirmation)
- Find latest session:
ls -lt ~/Library/Caches/superpowers/browser/*/ - Session directory format:
YYYY-MM-DD/session-TIMESTAMP/
症状: 无法找到文件
001-navigate.md解决方案:
- 确认Chrome已完成导航(查看URL确认信息)
- 查找最新会话:
ls -lt ~/Library/Caches/superpowers/browser/*/ - 会话目录格式:
YYYY-MM-DD/session-TIMESTAMP/
Transcript Incomplete
文字记录不完整
Symptom: File exists but missing transcript
Solution:
- Page may still be loading - wait 2-3 seconds
- Try navigating again
- Some sessions require scrolling to load full content
症状: 文件存在但缺少文字记录
解决方案:
- 页面可能仍在加载 - 等待2-3秒
- 尝试重新导航
- 部分会议需要滚动才能加载完整内容
sosumi.ai Returns Error
sosumi.ai返回错误
Symptom: 404 or invalid URL
Solution:
- Verify framework name spelling
- Check sosumi.ai format:
/documentation/[frameworkname] - Fallback: Use developer.apple.com but expect HTML
症状: 404或无效URL
解决方案:
- 验证框架名称拼写
- 检查sosumi.ai格式:
/documentation/[frameworkname] - 备用方案: 使用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小时。",