Agent Skills › getsentry/sentry › feature-flags

feature-flags

GitHub

提供 FlagPole 功能标志的全生命周期管理指南，涵盖注册、Python/前端检查、测试及上线流程。

.agents/skills/feature-flags/SKILL.md getsentry/sentry

Trigger Scenarios

添加新功能标志将功能隐藏于标志后注册新标志查询或启用标志

Install

npx skills add getsentry/sentry --skill feature-flags -g -y

More Options

Non-standard path

npx skills add https://github.com/getsentry/sentry/tree/master/.agents/skills/feature-flags -g -y

Use without installing

npx skills use getsentry/sentry@feature-flags

指定 Agent (Claude Code)

npx skills add getsentry/sentry --skill feature-flags -a claude-code -g -y

安装 repo 全部 skill

npx skills add getsentry/sentry --all -g -y

预览 repo 内 skill

npx skills add getsentry/sentry --list

SKILL.md

Frontmatter

{
    "name": "feature-flags",
    "description": "Gate a Sentry feature behind a FlagPole feature flag. Use when adding a feature flag, registering a flag in temporary.py, checking a flag from Python or the frontend, enabling a flag in tests, or asking where FlagPole rollout config lives. Trigger on \"add a feature flag\", \"gate this behind a flag\", \"register a flag\", \"features.has\", \"api_expose\", \"OrganizationFeature\", \"ProjectFeature\", \"FlagPole\"."
}

Feature Flags (FlagPole)

New features should be gated behind a feature flag.

Register the flag in src/sentry/features/temporary.py:
```
manager.add("organizations:my-feature", OrganizationFeature, FeatureHandlerStrategy.FLAGPOLE, api_expose=True)
```
Use api_expose=True if the frontend needs to check the flag. Use ProjectFeature and a projects: prefix for project-scoped flags.

Python check:

if features.has("organizations:my-feature", organization, actor=user):

Frontend check (requires api_expose=True):

organization.features.includes('my-feature');

Tests:

with self.feature("organizations:my-feature"):
    ...

Rollout: FlagPole YAML config lives in the sentry-options-automator repo, not here.
Removal: once the rollout is finished, the flag comes out in a fixed three-PR order — see the remove-option-or-flag skill.