feature-flags-ruby

Ruby 的 PostHog 功能标记

此技能可帮助你为 Ruby 应用添加 PostHog 功能标记。

参考文件

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

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

核心原则

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

PostHog MCP 工具

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

框架指南

• posthog-ruby 是 Ruby SDK gem 的名称（将 gem 'posthog-ruby' 添加到 Gemfile），但应使用 require 'posthog' 引入它（而不是 require 'posthog-ruby'）。
• 在脚本和 CLI 中，使用 PostHog::Client.new(api_key: key, host: host) 进行基于实例的初始化。
• 在 CLI 和脚本中：必须在退出前调用 client.shutdown，否则所有事件都会丢失。
• 使用 begin/rescue/ensure，并在 ensure 块中调用 shutdown，以正确清理。
• capture 和 identify 接受单个哈希参数：client.capture(distinct_id: 'user_123', event: 'my_event', properties: { key: 'value' })
• capture_exception 接受位置参数（而非关键字参数）：client.capture_exception(exception, distinct_id, additional_properties) — 不要使用 distinct_id: 关键字语法。