mcpField
F
finding-experiments

finding-experiments

github.com/posthog数据与数据库95350 次安装今天更新
代码仓库

关于 finding-experiments

将自然语言中的 PostHog 实验描述解析为具体实验 ID 的技能，使用 experiment-list，并说明如何处理匹配不明确或无匹配的情况。

主要功能

  1. 01按名称或创建时间查找实验
  2. 02按状态或部分标志键搜索
  3. 03根据标志键解析对应实验
  4. 04指导处理多个或无匹配结果

适用场景

  1. 01修改实验设置前先查找实验
  2. 02区分名称相近的实验
  3. 03检查标志键是否已有实验

MCP 相关

指导 Agent 使用 Posthog-local MCP 服务的 experiment-list 工具，并在需要时调用 experiment-get-by-flag-key 或 experiment-get。

安装

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

$npx skills add https://github.com/posthog/ai-plugin --skill finding-experiments

安装后在 Claude Code 中输入/finding-experiments确认已加载。

详细介绍

查找实验

用户会通过名称、描述或相对引用来指代实验，而不是通过 ID。 此技能可将自然语言引用解析为具体的实验 ID。

如何查找实验

使用 Posthog-local MCP 服务中的 experiment-list 工具。

重要：不要使用 feature-flag-get-all 或任何功能标志工具来查找实验。请使用专用的实验列表工具：experiment-list。

此工具会返回实验的 id、name、status、feature_flag_key、start_date、end_date 和 created_at。浏览返回的列表，查找与用户所指实验匹配的条目：

  • 按名称查找：检查 name 字段，寻找匹配项
  • 按新旧顺序查找：默认情况下，结果按从新到旧排序
  • 按状态查找：匹配 status 字段（draft、running、paused、exposure_frozen、stopped）
  • 按标志键查找：跳过列表，使用该键调用 experiment-get-by-flag-key。它会返回完整实验；如果未找到，则返回 found: false 和 reason。no_flag 和 no_experiment 表示该键未被占用，因此在调用 experiment-create 之前也应通过此方式检查是否已存在。ambiguous 表示有多个实验共用该标志，且没有唯一的活动实验：展示 candidates，并使用 experiment-get 选择其中一个，而不是另建一个。
  • 按部分标志键查找：调用 experiment-list，并将 search 设为片段。search 会忽略大小写，匹配实验名称和标志键中的子字符串。

找到匹配项后

  • 只有一个匹配项：使用该实验。在执行破坏性操作（删除、发布、结束）之前，按名称向用户确认。
  • 多个匹配项：列出其名称、状态和创建日期，并请用户选择。
  • 没有匹配项：告知用户。建议检查已归档的实验，或尝试其他搜索词。

如有需要，获取完整详情

解析出 ID 后，调用 experiment-get 获取完整对象（指标、标志详情、参数）。

示例

User: "pause my signup experiment"

Agent:
1. Calls experiment-list
2. Scans results, finds "New signup process" (ID: 1371, status: running)
3. Proceeds to pause experiment 1371

以下情况无需搜索

  • 你已在对话早前获得实验 ID
  • 用户刚刚创建了实验，你已从创建响应中获得 ID
  • 用户直接提供了 ID

相关技能

  • managing-experiment-lifecycle — 解析出实验 ID 后，对其进行操作
  • diagnosing-experiment-health — 调查找到的实验

评论

支持 Markdown