关于 fusion-framework-feature-toggling
面向 Fusion Framework 开发者的功能开关 Skill,现已弃用并合并至 `fusion-app-react-dev`。该 Skill 保留作历史参考,相关指导应查阅合并后的 Skill。
主要功能
- 01提供 Fusion Framework 功能标志指导
- 02涵盖配置、使用、审查、发布与移除
- 03优先使用 Fusion MCP,另有内置参考资料
- 04指出 API 歧义及待核实事项
适用场景
- 01为 Fusion Framework 应用添加功能标志
- 02审查开关配置或发布方案
- 03移除标志及其相关代码
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ equinor/ fusion-skills --skill fusion-framework-feature-toggling安装后在 Claude Code 中输入/fusion-framework-feature-toggling确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
CHANGELOG.mdassets/offline-feature-toggle-checklist.mdoffline-prompt-template.mdREADME.mdreferences/public-framework-reference.md详细介绍
已弃用 — 此技能已合并到
fusion-app-react-dev。 所有 Fusion Framework 功能标志相关指导,请使用fusion-app-react-dev及其参考文档references/using-feature-flags.md。 保留此技能仅供历史参考,并将在未来版本中移除。
Fusion Framework 功能切换
何时使用
当开发者需要有关 Fusion Framework 功能切换的可靠指导时,使用此技能。
典型触发场景:
- “帮我为 Fusion Framework 应用添加功能标志”
- “如何在 Fusion Framework 中使用 useFeature?”
- “我应该在这里使用哪种 Fusion Framework 功能标志 API?”
- “帮我检查此 Fusion 功能切换设置”
- “我该如何逐步推出此 Fusion 功能标志,并在之后将其移除?”
何时不使用
以下情况不要使用此技能:
- 通用的 LaunchDarkly 或 SaaS 标志平台设置
- Fusion Framework 之外仅限后端的发布系统
- 在缺少框架依据时设计新的功能切换架构
- 非 Fusion React 或前端标志相关指导
所需输入
回复前请收集:
- 工作属于应用级还是框架级
- 开发者的目标:添加、检查、调试、推出或移除标志
- 预期的功能键或功能描述
- 标志是否需要持久化、URL 控制或类型化值
- 需要调整的任何现有代码上下文
如果缺少重要信息,只询问选择合适框架接口所必需的最少问题。
说明
-
确认请求是否确实与 Fusion Framework 功能开关有关。
- 如果请求是通用的标志平台工作,不要强行套用此技能。
-
有 Fusion MCP 时,优先使用它。
- 使用
mcp_fusion_search_framework查询用户的表述,并加入feature flag、feature toggling、useFeature、enableFeatureFlag或enableFeatureFlagging等功能开关相关术语。 - 如果第一组结果不理想,再进行一轮细化查询。
- 只有在需要了解超出框架实现细节的更广泛产品指导时,才使用
mcp_fusion_search_docs。
- 使用
-
如果 Fusion MCP 不可用或无法得出明确结论,请明确说明,并改用随附的备用资料。
- 使用 references/public-framework-reference.md 作为备用信息来源。
- 对于没有服务器的用户,使用 assets/offline-feature-toggle-checklist.md 和 assets/offline-prompt-template.md。
-
判断用户需要哪种帮助。
- 新建标志:说明配置入口并给出最简示例。
- 组件用法:说明
useFeature、开关行为和值的处理方式。 - 审查或发布:应用检查清单,并指出缺失的负责人、测试或清理工作。
- 移除:确定需要一并删除的标志定义、使用方和无效分支。
-
优先使用当前有依据的 Fusion Framework 入口。
- 应用级示例:来自
@equinor/fusion-framework-react-app/feature-flag的enableFeatureFlag(appConfigurator, [...])。 - 框架级示例:来自
@equinor/fusion-framework-module-feature-flag的enableFeatureFlagging(config, builder => ...)。 - 插件示例:
createLocalStoragePlugin和createUrlPlugin。 - Hook 用法:应用包中的
useFeature(key),或框架包中基于提供程序的useFeature(provider, key)变体。
- 应用级示例:来自
-
遇到公共资料中的歧义时,请明确指出,不要猜测。
- 公共资料目前同时展示了
readonly和readOnly;请提醒用户在最终确定代码前核实本地类型。 - 公共文档提到了未来将采用面向 API 服务的功能标志方案;除非实时 MCP 或本地代码证实,否则不要将其描述为当前默认方案。
- 公共资料目前同时展示了
-
提供实用指导,而不只是列出 API 名称。
- 优先使用稳定的枚举或常量键,而不是临时字符串字面量。
- 如果标志会展示给用户或审查人员,请包含
title和description。 - 仅在行为除开关状态外还需要配置时,才使用
value。 - 确保标志易于移除,明确负责人,并指出清理触发条件。
- 区分本地应用开关与框架级或由插件支持的开关。
-
给出简洁且有依据的答复。
- 说明指导来自 Fusion MCP 还是随附的备用资料。
- 提供相关的包名以及一个具体代码片段或源文件路径。
- 提供发布、测试和清理方面的指导。
- 以仍需明确说明的不确定点或验证步骤收尾。
典型请求
- “帮我在 Fusion Framework 应用中添加一个功能标志。”
- “如何在 Fusion Framework 中使用 useFeature?”
- “审查这套 Fusion Framework 功能开关配置,并指出还需要清理哪些内容。”
预期输出
请返回:
- 指导来自 Fusion MCP 还是随附的备用资料
- 相关的 Fusion Framework 入口和包
- 一个可供调整的具体示例代码片段或源文件路径
- 简短的实现、发布和清理检查清单
- 对任何有歧义的 API 细节明确说明验证事项
参考资料
资源
安全与约束
绝不:
- 虚构 Fusion Framework 软件包、钩子或模块名称
- 在服务器不可用时,假装 Fusion MCP 结果存在
- 将 SaaS 功能标志建议泛化为 Fusion Framework 的行为
- 保留功能标志却不说明其归属和清理方式
始终:
- 优先使用 Fusion MCP,其次使用捆绑的公开来源回退方案
- 将已确认的框架 API 与通用发布指导分开
- 公开来源存在分歧时,指出 API 或版本的模糊之处
- 保持示例简短易于调整
评论
支持 Markdown