mcpField
F
fusion-framework-feature-toggling

fusion-framework-feature-toggling

github.com/equinor开发475 次安装
代码仓库

关于 fusion-framework-feature-toggling

面向 Fusion Framework 开发者的功能开关 Skill,现已弃用并合并至 `fusion-app-react-dev`。该 Skill 保留作历史参考,相关指导应查阅合并后的 Skill。

主要功能

  1. 01提供 Fusion Framework 功能标志指导
  2. 02涵盖配置、使用、审查、发布与移除
  3. 03优先使用 Fusion MCP,另有内置参考资料
  4. 04指出 API 歧义及待核实事项

适用场景

  1. 01为 Fusion Framework 应用添加功能标志
  2. 02审查开关配置或发布方案
  3. 03移除标志及其相关代码

安装

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

$npx skills add https://github.com/equinor/fusion-skills --skill fusion-framework-feature-toggling

安装后在 Claude Code 中输入/fusion-framework-feature-toggling确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

CHANGELOG.md
assets/
offline-feature-toggle-checklist.md
offline-prompt-template.md
README.md
references/
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 控制或类型化值
  • 需要调整的任何现有代码上下文

如果缺少重要信息,只询问选择合适框架接口所必需的最少问题。

说明

  1. 确认请求是否确实与 Fusion Framework 功能开关有关。

    • 如果请求是通用的标志平台工作,不要强行套用此技能。
  2. 有 Fusion MCP 时,优先使用它。

    • 使用 mcp_fusion_search_framework 查询用户的表述,并加入 feature flag、feature toggling、useFeature、enableFeatureFlag 或 enableFeatureFlagging 等功能开关相关术语。
    • 如果第一组结果不理想,再进行一轮细化查询。
    • 只有在需要了解超出框架实现细节的更广泛产品指导时,才使用 mcp_fusion_search_docs。
  3. 如果 Fusion MCP 不可用或无法得出明确结论,请明确说明,并改用随附的备用资料。

  4. 判断用户需要哪种帮助。

    • 新建标志:说明配置入口并给出最简示例。
    • 组件用法:说明 useFeature、开关行为和值的处理方式。
    • 审查或发布:应用检查清单,并指出缺失的负责人、测试或清理工作。
    • 移除:确定需要一并删除的标志定义、使用方和无效分支。
  5. 优先使用当前有依据的 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) 变体。
  6. 遇到公共资料中的歧义时,请明确指出,不要猜测。

    • 公共资料目前同时展示了 readonly 和 readOnly;请提醒用户在最终确定代码前核实本地类型。
    • 公共文档提到了未来将采用面向 API 服务的功能标志方案;除非实时 MCP 或本地代码证实,否则不要将其描述为当前默认方案。
  7. 提供实用指导,而不只是列出 API 名称。

    • 优先使用稳定的枚举或常量键,而不是临时字符串字面量。
    • 如果标志会展示给用户或审查人员,请包含 title 和 description。
    • 仅在行为除开关状态外还需要配置时,才使用 value。
    • 确保标志易于移除,明确负责人,并指出清理触发条件。
    • 区分本地应用开关与框架级或由插件支持的开关。
  8. 给出简洁且有依据的答复。

    • 说明指导来自 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