sosumi

Sosumi 技能

当编码 Agent 需要精确的 API 详情时，使用此技能以可靠地获取 Apple 文档的 Markdown 内容。

适用场景

当请求涉及以下任一内容时，请使用 Sosumi：

• Apple 平台 API（Swift、SwiftUI、UIKit、AppKit、Foundation 等）
• API 签名、可用性、参数行为或返回语义
• Human Interface Guidelines 相关问题
• 查询 WWDC 会议字幕
• 外部 Swift-DocC 文档（例如，GitHub Pages 或 Swift Package Index 托管的文档）

核心工作流

1. 如果已有 developer.apple.com URL，请将主机名替换为 sosumi.ai，并保留相同的路径。
2. 如果不知道确切的页面路径，请先搜索，再获取最匹配的页面。
3. 回答实现问题时，优先选择具体的符号页面，而不是宽泛的顶层页面。

可选的 CLI 预检

如果 Sosumi CLI 可用，请先快速确认本地访问正常，再进行深入调试：

• sosumi --version 可确认 CLI 已安装且位于 PATH 中。
• sosumi --help 可查看顶层用法。
• sosumi <command> --help 是特定命令行为的手册。

HTTP 用法

将 developer.apple.com 替换为 sosumi.ai：

• 原始地址：https://developer.apple.com/documentation/swift/array
• AI 可读地址：https://sosumi.ai/documentation/swift/array

内容类型

Apple API 参考

• 模式：https://sosumi.ai/documentation/{framework}/{symbol}
• 示例：
  • https://sosumi.ai/documentation/swift/array
  • https://sosumi.ai/documentation/swiftui/view

Human Interface Guidelines

• 模式：https://sosumi.ai/design/human-interface-guidelines/{topic}
• 示例：
  • https://sosumi.ai/design/human-interface-guidelines
  • https://sosumi.ai/design/human-interface-guidelines/foundations/color

Apple 视频字幕

• 模式：https://sosumi.ai/videos/play/{collection}/{id}
• 示例：
  • https://sosumi.ai/videos/play/wwdc2021/10133
  • https://sosumi.ai/videos/play/meet-with-apple/208

外部 Swift-DocC

• 模式：https://sosumi.ai/external/{full-https-url}
• 示例：
  • https://sosumi.ai/external/https://apple.github.io/swift-argument-parser/documentation/argumentparser/
  • https://sosumi.ai/external/https://swiftpackageindex.com/pointfreeco/swift-composable-architecture/1.23.1/documentation/composablearchitecture

MCP 工具速查

当 Sosumi 配置为 MCP 服务（https://sosumi.ai/mcp）时，请使用以下工具：

工具	参数	用途
searchAppleDocumentation	query: string	搜索 Apple 文档并返回结构化结果
fetchAppleDocumentation	path: string	按路径获取 Apple 文档或 HIG 内容，格式为 Markdown
fetchAppleVideoTranscript	path: string	按 /videos/play/... 路径获取 Apple 视频字幕
fetchExternalDocumentation	url: string	按绝对 HTTPS URL 获取外部 Swift-DocC 页面

最佳实践

• 如果不知道确切路径，请先搜索。
• 对于编码问题，请获取目标明确的符号页面。
• 在回答中保留来源链接，方便用户快速验证详情。
• 引用 Apple 文档页面时，直接在回复中使用 Sosumi 路径。
• 不要依赖一致性条件，例如“当 Element 遵循 Hashable 时遵循该协议”。Apple 文档数据可能会遗漏部分条件，也可能存在错误。当条件很重要时，请查看 SDK 中模块的 .swiftinterface 文件里的声明。

故障排除

404 或输出内容过少

• 路径可能不正确，或范围过宽。
• 先运行搜索查询，再获取具体结果路径。

无法获取外部页面

• 主机可能通过 robots.txt 或 X-Robots-Tag 指令阻止访问。
• 请尝试同一符号的其他规范页面 URL。