telemetrydeck-ios-skill
RedHiwiK/telemetrydeck-ios-skill
TelemetryDeck iOS/macOS 接入 skill for Claude Code
Instalação
npx convez-ai RedHiwiK/telemetrydeck-ios-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
TelemetryDeck iOS/macOS 接入 Skill
A Claude Code skill — 给 iOS/macOS SwiftUI app 接入 TelemetryDeck 匿名分析埋点的标准流程(SOP)。
这是一个 Claude Code skill。装进 ~/.claude/skills/ 后,Claude Code 就能带你一步步给 Apple 平台 app 接入 TelemetryDeck —— 从 SPM 安装、埋点封装、隐私 manifest,到用 TQL 配可视化看板,全流程踩坑都已沉淀。
这是什么
TelemetryDeck 是 Apple 平台专用的匿名 app 分析服务(不碰个人数据、无需 ATT、iOS 独立开发者事实标准)。本 skill 把一次真实接入中踩过的所有坑整理成可复用 SOP,覆盖:
- SPM 安装(含「加错 target 导致链接失败」头号坑)
Analytics.swift统一埋点封装层(隐私 gate + 桶化 + 错误上报,复制即用)- 埋点策略(AI 统一闸门一处覆盖、付费墙统一入口、隐私红线)
PrivacyInfo.xcprivacy隐私清单(Required Reason API audit)- 编译验证(Xcode 16 命令行
ENABLE_DEBUG_DYLIB=NO怪癖) - 8 条踩坑清单(Test Mode、SourceKit 假报错、synchronized group…)
- Dashboard 看板:用 TQL 逐卡配置(含计数卡 / 分布卡两个范式)—— import/export JSON 不带 filter、无建卡 API,只能逐卡 JSON Editor 粘 TQL,这块全摸清了
- 错误追踪(Errors 预设面板,catch 块自动上报)
安装
把这个仓库放进 Claude Code 的 skills 目录即可:
# 方式一:clone 后软链(改 SKILL.md 即时生效)
git clone <this-repo-url> ~/src/telemetrydeck-skill
mkdir -p ~/.claude/skills/telemetrydeck-integration
ln -sf ~/src/telemetrydeck-skill/SKILL.md ~/.claude/skills/telemetrydeck-integration/SKILL.md
# 方式二:直接复制
mkdir -p ~/.claude/skills/telemetrydeck-integration
cp SKILL.md ~/.claude/skills/telemetrydeck-integration/SKILL.md
也可放进某个项目的 <project>/.claude/skills/telemetrydeck-integration/ 只对该项目生效。
用法
装好后,在 Claude Code 里:
- 直接说需求即可命中:「给这个 app 接入 TelemetryDeck」、「加用户分析埋点」、「配 TelemetryDeck 看板」、「TelemetryDeck 数据看不到怎么排查」
- 或显式触发:
/telemetrydeck-integration
Claude 会按 SOP 逐步执行(标「人工」的引导你在 Xcode/浏览器操作,标「agent」的自己写代码)。
适用范围
- iOS 17+ / macOS(SwiftUI;SwiftData / CloudKit / App Group 可选,文档已覆盖差异)
- 单 app 或多 app(各自独立 App ID,封装层只改两个常量即可复用)
隐私
本 skill 已完全去除任何具体 app 的私有信息:appID、bundle id、App Group id、app 名、源码绝对路径全部替换为占位符(<APP-ID> / <app-name> / <主app>)。文档中的事件名(record.created 等)仅为命名示例,按你的项目替换。
来源
整理自一次真实的 iOS app 接入实战,已抽象为通用流程。欢迎按你的项目调整。