$ ~/registry/skill/facebook-plugins-mwdat-ios-skills-dat-conventions

SKILL

dat-conventions

Name: dat-conventions
Author: facebook

帮助开发者掌握 DAT SDK 的 Swift 规范、命名与异步开发模式

星标

★ 458

来源

GitHub

更新于

2026-06-24

// 安全评估需留意

仅提示词，不执行代码
开源可审计

总评

该材料显示这是一个开源的 iOS 开发约定/文档型 Skill，未声明需要密钥或远程端点，整体风险较低。README 提到可构建测试与接入设备/相机相关 SDK 模块，但就当前材料看更像提示与规范说明，未见明确数据外发或凭证滥用红旗。

凭证密钥低风险

材料明确标注“无”密钥/环境变量；README 也未要求 API token、账号凭证或敏感配置，未见凭证收集、存储或滥用迹象。

网络外发低风险

未声明任何远程端点，系统检查项也表明其为 prompt-only。文档虽提到设备发现、注册、流媒体等 SDK 概念，但当前材料未表明该 Skill 自身会把用户数据发送到外部服务。

代码执行低风险

作为 prompt-only Skill，本体不表现为可执行工具。README 中出现 xcodebuild/open 等命令仅是开发说明文字，不应视为该 Skill 自动获得本机执行权限。

数据访问低风险

材料未声明读写本地文件、数据库或其他用户资源的能力；关于相机、显示、设备选择等内容是 SDK 架构说明，不足以证明该 Skill 直接访问用户数据或请求过度授权。

来源供应链需留意

正面因素是 GitHub 开源、源码可审计；但仓库 star 为 0、许可证未声明、维护状态未知，且该 Skill 与仓库关系仅由材料声称，可信度与持续维护性仍需核验，因此建议留意供应链背景。

安全建议

将其视为文档/规范参考使用，不要把 README 中的示例命令自动执行到生产环境。
安装前核验 GitHub 仓库归属、提交历史、发布记录及该 Skill 与仓库内容是否一致。
若后续接入真实 DAT SDK 或设备能力，再单独评估相机、设备注册与权限申请范围。
优先在隔离开发环境中测试，并确认许可证条款后再纳入正式项目。

审计模型: gpt-5.4 · 2026-06-17

// 安装

复制安装指令，让 AI 自动完成配置 · 推荐新手

请帮我安装 askskill 上的 "dat-conventions" 技能：
1. 下载 https://raw.githubusercontent.com/facebook/meta-wearables-dat-ios/main/plugins/mwdat-ios/skills/dat-conventions/SKILL.md
2. 保存为 ~/.claude/skills/dat-conventions/SKILL.md
3. 装好后重载技能，告诉我可以用了

// 下载

下载 SKILL.md机读安装清单 ↗

// 用法示例

统一 Swift 命名风格

输入

请根据 DAT SDK iOS 开发约定，检查这段 Swift 代码的类型名、方法名、属性名是否规范，并给出修改建议与重构后的代码。

预期产出

返回命名问题清单、原因说明，以及符合规范的 Swift 重构代码。

改写为 async/await

输入

把这段基于回调的 DAT SDK iOS 调用改写成 async/await 写法，并解释错误处理、线程切换和返回类型该如何设计。

预期产出

输出采用 async/await 的示例代码，并附带关键设计说明与最佳实践建议。

设计关键类型结构

输入

我在开发 DAT SDK 的 iOS 集成，请帮我设计核心 Swift 类型，包括请求模型、响应模型、错误类型和协议抽象，并说明各自职责。

预期产出

给出清晰的类型设计方案、示例代码，以及每个类型在架构中的作用说明。

// 文档

DAT SDK Conventions (iOS)

Architecture

The SDK is organized into four modules:

MWDATCore: Device discovery, registration, permissions, device selectors
MWDATCamera: Stream, VideoFrame, photo capture
MWDATDisplay: Display capability, display UI components, icons, images, buttons, video
MWDATMockDevice: MockDeviceKit for testing without hardware

Swift Patterns

Use async/await for all SDK operations — the SDK is fully async
Use AsyncSequence / publisher .listen {} for observing streams
Annotate UI-updating code with @MainActor
Never block the main thread with frame processing
Handle errors with do/catch — the SDK throws typed errors

Naming Conventions

Type	Convention	Example
Entry point	`Wearables.shared`	`Wearables.shared.startRegistration()`
Device sessions	`*Session`	`DeviceSession`
Capabilities	Named by function	`Stream`
Selectors	`*DeviceSelector`	`AutoDeviceSelector`, `SpecificDeviceSelector`
Config	`*Configuration`	`StreamConfiguration`
Publishers	`*Publisher`	`statePublisher`, `videoFramePublisher`

Imports

import MWDATCore    // Registration, devices, permissions
import MWDATCamera  // Stream, VideoFrame, photo capture
import MWDATDisplay // Display, FlexBox, Text, Button, Image, Icon, VideoPlayer

For testing:

import MWDATMockDevice  // MockDeviceKit, MockRaybanMeta, MockCameraKit

Key Types

Wearables — SDK entry point. Call Wearables.configure() at launch, then use Wearables.shared
Stream — Camera streaming session. Create with config + device selector
Display — Display capability attached to a started DeviceSession
VideoFrame — Individual video frame with .makeUIImage() convenience
AutoDeviceSelector — Automatically selects the best available device
SpecificDeviceSelector — Selects a specific device by identifier
StreamConfiguration — Configure video codec, resolution, frame rate
MockDeviceKit — Factory for creating simulated devices in tests

Error Handling

do {
    try Wearables.configure()
} catch {
    // Handle configuration error
}

do {
    try await Wearables.shared.startRegistration()
} catch {
    // Handle registration error
}

Build and Test

# Install dependencies via Swift Package Manager
# In Xcode: File > Add Package Dependencies > enter repo URL

# Build from command line
xcodebuild -scheme MWDATCore -destination 'platform=iOS Simulator,name=iPhone 16'

# Run tests
xcodebuild test -scheme MWDATCoreTests -destination 'platform=iOS Simulator,name=iPhone 16'

For sample apps:

# Open the sample app workspace
open ExternalSampleApps/CameraAccess/CameraAccess.xcodeproj

# Build and run on simulator (uses MockDeviceKit - no glasses needed)
xcodebuild -scheme CameraAccess -destination 'platform=iOS Simulator,name=iPhone 16'

Development Workflow

Add SDK via Swift Package Manager (SPM) in Xcode
Import modules (MWDATCore, MWDATCamera, MWDATDisplay when rendering Display content)
Configure at app launch: try Wearables.configure()
Build with Xcode or xcodebuild
Test with MockDeviceKit - no physical glasses required
Debug using Xcode console for SDK logs

Live docs search

If your editor supports remote MCP servers, connect https://mcp.facebook.com/wearables_dat and use search_dat_docs for current DAT setup, session lifecycle, camera streaming, MockDeviceKit, permissions, and exact API symbols.

Use llms.txt when your tool only supports static reference context.

帮助开发者掌握 SwiftUI 架构模式、状态管理与性能优化实践

affaan-m装→

$ loading_

请帮我安装 askskill 上的 "dat-conventions" 技能： 1. 下载 https://raw.githubusercontent.com/facebook/meta-wearables-dat-ios/main/plugins/mwdat-ios/skills/dat-conventions/SKILL.md 2. 保存为 ~/.claude/skills/dat-conventions/SKILL.md 3. 装好后重载技能，告诉我可以用了

// 用法示例

统一 Swift 命名风格

输入

请根据 DAT SDK iOS 开发约定，检查这段 Swift 代码的类型名、方法名、属性名是否规范，并给出修改建议与重构后的代码。

预期产出

返回命名问题清单、原因说明，以及符合规范的 Swift 重构代码。

改写为 async/await

输入

把这段基于回调的 DAT SDK iOS 调用改写成 async/await 写法，并解释错误处理、线程切换和返回类型该如何设计。

预期产出

输出采用 async/await 的示例代码，并附带关键设计说明与最佳实践建议。

设计关键类型结构

输入

我在开发 DAT SDK 的 iOS 集成，请帮我设计核心 Swift 类型，包括请求模型、响应模型、错误类型和协议抽象，并说明各自职责。

预期产出

给出清晰的类型设计方案、示例代码，以及每个类型在架构中的作用说明。

// 文档

DAT SDK Conventions (iOS)

Architecture

The SDK is organized into four modules:

MWDATCore: Device discovery, registration, permissions, device selectors
MWDATCamera: Stream, VideoFrame, photo capture
MWDATDisplay: Display capability, display UI components, icons, images, buttons, video
MWDATMockDevice: MockDeviceKit for testing without hardware

Swift Patterns

Use async/await for all SDK operations — the SDK is fully async
Use AsyncSequence / publisher .listen {} for observing streams
Annotate UI-updating code with @MainActor
Never block the main thread with frame processing
Handle errors with do/catch — the SDK throws typed errors

Naming Conventions

Type	Convention	Example
Entry point	`Wearables.shared`	`Wearables.shared.startRegistration()`
Device sessions	`*Session`	`DeviceSession`
Capabilities	Named by function	`Stream`
Selectors	`*DeviceSelector`	`AutoDeviceSelector`, `SpecificDeviceSelector`
Config	`*Configuration`	`StreamConfiguration`
Publishers	`*Publisher`	`statePublisher`, `videoFramePublisher`

Imports

import MWDATCore    // Registration, devices, permissions
import MWDATCamera  // Stream, VideoFrame, photo capture
import MWDATDisplay // Display, FlexBox, Text, Button, Image, Icon, VideoPlayer

For testing:

import MWDATMockDevice  // MockDeviceKit, MockRaybanMeta, MockCameraKit

Key Types

Wearables — SDK entry point. Call Wearables.configure() at launch, then use Wearables.shared
Stream — Camera streaming session. Create with config + device selector
Display — Display capability attached to a started DeviceSession
VideoFrame — Individual video frame with .makeUIImage() convenience
AutoDeviceSelector — Automatically selects the best available device
SpecificDeviceSelector — Selects a specific device by identifier
StreamConfiguration — Configure video codec, resolution, frame rate
MockDeviceKit — Factory for creating simulated devices in tests

Error Handling

do {
    try Wearables.configure()
} catch {
    // Handle configuration error
}

do {
    try await Wearables.shared.startRegistration()
} catch {
    // Handle registration error
}

Build and Test

# Install dependencies via Swift Package Manager
# In Xcode: File > Add Package Dependencies > enter repo URL

# Build from command line
xcodebuild -scheme MWDATCore -destination 'platform=iOS Simulator,name=iPhone 16'

# Run tests
xcodebuild test -scheme MWDATCoreTests -destination 'platform=iOS Simulator,name=iPhone 16'

For sample apps:

# Open the sample app workspace
open ExternalSampleApps/CameraAccess/CameraAccess.xcodeproj

# Build and run on simulator (uses MockDeviceKit - no glasses needed)
xcodebuild -scheme CameraAccess -destination 'platform=iOS Simulator,name=iPhone 16'

Development Workflow

Add SDK via Swift Package Manager (SPM) in Xcode
Import modules (MWDATCore, MWDATCamera, MWDATDisplay when rendering Display content)
Configure at app launch: try Wearables.configure()
Build with Xcode or xcodebuild
Test with MockDeviceKit - no physical glasses required
Debug using Xcode console for SDK logs

Live docs search

Use llms.txt when your tool only supports static reference context.

// 用法示例

// 文档

DAT SDK Conventions (iOS)

Architecture

Swift Patterns

Naming Conventions

Imports

Key Types

Error Handling

Build and Test

Development Workflow

Live docs search

Links

// 同源资产

session-lifecycle

sample-app-guide

camera-streaming

debugging

permissions-registration

getting-started

// 功能相似

dat-conventions

sample-app-guide

kotlin-patterns

Swift-Concurrency-Agent-Skill

swift-protocol-di-testing

swiftui-patterns

// 用法示例

// 文档

DAT SDK Conventions (iOS)

Architecture

Swift Patterns

Naming Conventions

Imports

Key Types

Error Handling

Build and Test

Development Workflow

Live docs search

Links

// 同源资产

session-lifecycle

sample-app-guide

camera-streaming

debugging

permissions-registration

getting-started

// 功能相似

dat-conventions

sample-app-guide

kotlin-patterns

Swift-Concurrency-Agent-Skill

swift-protocol-di-testing

swiftui-patterns