SuperAPI AI 工具集

remove-feature-flag

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

用途:在 Warp 代码库中,当某个功能开关已对所有用户启用并在生产环境稳定运行后,将其彻底移除,消除技术债并简化代码。

移除时机:功能已在 app/Cargo.toml 的 default features 中启用;在生产环境稳定运行足够时间;没有计划再关闭该功能或提供配置项;团队确认该功能为永久功能。

主要步骤:

  1. 从 app/Cargo.toml 的 [features] 和 default 数组中移除该 feature。
  2. 从 warp_core/src/features.rs 的 FeatureFlag 枚举中移除变体。
  3. 从 app/src/lib.rs 中移除条件编译指令。
  4. 若该 flag 出现在 DOGFOOD_FLAGS/PREVIEW_FLAGS/RELEASE_FLAGS 数组中,一并移除。
  5. 移除所有运行时检查和死代码(如 FeatureFlag::YourFeatureName.is_enabled() 判断)。注意共享 FeatureFlag 可能被 headless TUI 使用,需搜索 crates/warp_tui/ 及其他非 app/ crate:rg "YourFeatureName" app/ warp_core/ crates/warp_tui/
  6. 若该 flag 用于按键绑定 enabled 谓词,移除该谓词。
  7. 清理仅在功能关闭时执行的死代码分支。
  8. 运行测试与校验: ./script/format cargo clippy --workspace --all-targets --all-features --tests -- -D warnings cargo nextest run --no-fail-fast --workspace --exclude command-signatures-v2 cargo run 若 flag 用于 TUI,还要运行 ./script/run-tui

最佳实践:及时移除不再需要的开关;移除全部相关代码;用 ripgrep/grep 确认无遗漏;彻底测试防止回归;建议单独 PR 以便审查。

限制:资料仅说明 Warp 代码库内的操作流程,未提供其他项目适用性、自动化工具或平台信息。