SuperAPI AI 工具集

fusion-framework-feature-toggling

编程与开发

查看项目

更新于 10-15 15:10

技能介绍

用途

Fusion Framework Feature Toggling 用于为使用 Fusion Framework 的开发者提供有据可依的功能开关(feature toggling)帮助。典型触发场景包括:为 Fusion Framework 应用添加功能开关、了解如何使用 useFeature、选择合适的功能开关 API、审查 Fusion 功能开关配置,以及规划功能开关的发布与后续移除。

该技能不适用于:通用 LaunchDarkly 或 SaaS 功能开关平台配置、Fusion Framework 之外的后端发布系统、脱离框架证据自行发明新的功能开关架构,以及非 Fusion 的 React 或前端开关指导。

主要能力

该技能优先使用 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),或框架包中基于 provider 的 useFeature(provider, key) 变体。

技能要求给出实用指导而非仅罗列 API 名称:优先使用稳定的枚举或常量键而非临时字符串字面量;当开关暴露给用户或审查者时包含 title 与 description;仅在行为除开关状态外还需配置时使用 value;保持开关易于移除、定义所有权并指出清理触发条件;区分本地应用开关与框架级或插件支持的开关。

最终返回需包含:指导来自 Fusion MCP 还是随附回退、相关 Fusion Framework 入口点与包、一个可适配的具体示例片段或源路径、简短的实现/发布/清理检查清单,以及针对仍存歧义的 API 细节的明确验证说明。

适用场景

适用于需要在 Fusion Framework 内落地功能开关的前端/应用开发者,包括:新增功能开关配置、使用 useFeature 读取开关、审查与发布规划、以及开关的下线与清理。代表请求如“帮我给一个 Fusion Framework 应用添加功能开关”“我该如何在 Fusion Framework 中使用 useFeature”“审查这个 Fusion Framework 功能开关配置并告诉我遗漏了哪些清理工作”。

限制与注意事项

该技能已被合并到 fusion-app-react-dev,官方建议改用 fusion-app-react-dev 及其 references/using-feature-flags.md 获取所有 Fusion Framework 功能开关指导。本技能仅供历史参考,并将在未来版本中移除。

技能明确要求:绝不发明 Fusion Framework 的包、hook 或模块名;绝不在服务器不可用时假装存在 Fusion MCP 结果;绝不将 SaaS 功能开关建议泛化为 Fusion Framework 行为;绝不在未指出所有权与清理的情况下让开关长期存在。同时要求:始终优先使用 Fusion MCP,其次使用随附开源回退;将已确认的框架 API 与通用发布指导分离;当公开来源不一致时指出 API 或版本歧义;保持示例小巧易改。

技能还指出公开来源存在的歧义:公开来源同时出现 readonly 与 readOnly,应提示用户在最终确定代码前验证本地类型;公开文档提到功能开关未来可能走向 API 服务方向,除非实时 MCP 或本地代码确认,否则不应将其视为当前默认。