convez.ai
Skill
RedHiwiK

telemetrydeck-ios-skill

RedHiwiK/telemetrydeck-ios-skill

Ver no GitHub
InicialPluginScore · de 0 a 100

TelemetryDeck iOS/macOS 接入 skill for Claude Code

Instalação

$npx convez-ai RedHiwiK/telemetrydeck-ios-skill

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 接入实战,已抽象为通用流程。欢迎按你的项目调整。

Ver o original no GitHub

Bom para

Relacionados