mcpField
F
feature-flags-ios

feature-flags-ios

github.com/posthog开发76111 次安装今天更新
代码仓库

关于 feature-flags-ios

feature-flags-ios 是一项用于为 iOS 应用添加 PostHog 功能标志的技能。它提供 iOS 专用配置指引，包括 Xcode 环境变量和 Swift Package Manager 项目设置。

主要功能

  1. 01为 iOS 应用集成 PostHog 功能标志
  2. 02从 Xcode 运行环境读取配置
  3. 03指导 SPM 项目依赖配置
  4. 04检查 posthog-ios 最新版本
  5. 05按需启用 App Sandbox 网络访问

适用场景

  1. 01为 iOS 应用添加功能标志检查
  2. 02在 Xcode 中配置 PostHog 环境变量
  3. 03将 posthog-ios 添加到 SPM 项目

MCP 相关

该技能会检查是否连接了 PostHog MCP 服务，并可使用其工具创建、列出、更新或删除功能标志。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/posthog/skills --skill feature-flags-ios

安装后在 Claude Code 中输入/feature-flags-ios确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
adding-feature-flag-code.md
best-practices.md
ios.md

详细介绍

iOS 的 PostHog 功能标志

此技能可帮助你在 iOS 应用中添加 PostHog 功能标志。

参考文件

  • references/ios.md - iOS 功能标志安装文档
  • references/adding-feature-flag-code.md - 添加功能标志代码文档
  • references/best-practices.md - 功能标志最佳实践文档

请查阅文档，了解 API 详情和特定框架的模式。

核心原则

  • 环境变量：始终使用环境变量存储 PostHog 密钥。切勿将其硬编码。
  • 最小改动：在现有逻辑旁添加功能标志代码。不要替换或重构现有代码。
  • 优先使用布尔标志：除非用户明确要求使用多变量标志，否则默认检查布尔标志。
  • 尽可能在服务端处理：优先在服务端评估标志，以避免 UI 闪烁。

PostHog MCP 工具

检查是否已连接 PostHog MCP 服务。如果已连接，请查找与功能标志管理相关的工具（创建、列出、更新和删除标志）。使用这些工具直接在 PostHog 中管理标志，而不是要求用户手动在控制面板中操作。

框架指南

  • 通过 PostHogEnv 枚举从环境变量读取配置。该枚举应具有一个调用 ProcessInfo.processInfo.environment[rawValue] 并在缺少变量时调用 fatalError 的计算属性 value。枚举成员应为 projectToken = "POSTHOG_PROJECT_TOKEN" 和 host = "POSTHOG_HOST"，并在 Xcode 方案的 Run 环境变量中设置
  • 向 project.pbxproj 添加 SPM 依赖时，创建 3 个 UUID 唯一的独立对象：带有 productRef 的 PBXBuildFile、带有 package 和 productName 的 XCSwiftPackageProductDependency，以及带有 repositoryURL 和 requirement 的 XCRemoteSwiftPackageReference。将构建文件添加到 Frameworks 阶段的 files，将产品依赖项添加到目标的 packageProductDependencies，并将包引用添加到项目的 packageReferences
  • 在 SPM 包引用中设置 minimumVersion 之前，请先在 https://github.com/PostHog/posthog-ios/releases 查看 posthog-ios 的最新发行版本；不要硬编码过时的版本
  • 如果项目使用 App Sandbox（macOS），请在目标的构建设置中添加 ENABLE_OUTGOING_NETWORK_CONNECTIONS = YES，以便 PostHog 能够连接其服务器——请勿完全禁用沙盒

评论

支持 Markdown