SuperAPI AI 工具集

page-flow-cleanup-audit

编程与开发

查看项目

更新于 10-15 20:31

技能介绍

用途:审计并清理用户可见的页面、功能流与组件,重点处理状态所有权和业务不变量,而非机械去重。它是三个清理技能之一,另两个为 necessary-code-audit(判断 wrapper、兼容、fallback、默认值与防御代码是否必要)和 unused-code-audit(证明删除的 helper、export、文件是否仍有消费者)。

工作流:先定义流程边界,命名页面目的,识别入口(组件、handler、hook、query、mutation、store、dialog、外部消费者),建立 route、共享包、query key、API client、analytics event、测试等影响面图。再按顺序追踪 source of truth:Server/API contract、query key 与 query function、mutation 后的 cache invalidation、local store/component state、派生计算、UI adapter。危险信号包括多个 query 获取同一业务事实、store 与 React Query 同时拥有同一远程状态、mutation 在多个组件直接 invalidate 原始 key、轻量 query 制造第二份 cache。推荐形态为一个 query helper 拥有一个远程事实、mutation 调用共享 invalidation helper、count 与 label 从 canonical query 派生。

分类与顺序:只抽取确定性且业务等价的逻辑(分组、过滤排序、派生、资格判断、query-key projection、边界类型 helper),不抽取布局、响应式交互、route-specific loading 及上下文不同的相似 UI。删除无意义防御(类型已保证、恒定 bool 参数、空 fallback helper、as any 掩盖类型问题、与 required prop 冲突的可选链),保留真实可空领域状态、loading/empty/error/permission 状态、有意降级 fallback 与外部输入缺失。安全清理顺序为先删除过时 source-of-truth 路径,再复用共享 invalidation、抽取纯 helper、收紧边界类型、删除无意义 guard,最后简化 query key 并残留搜索。

验证与报告:运行最窄检查(package build、typecheck、受影响 consumer typecheck、流程级 smoke 测试),对删除符号与旧路径做残留 rg,运行 git diff --check。报告需列出 source-of-truth 变更、抽取 helper、删除的防御代码与保留的真实 nullable 状态、收紧的类型边界、验证命令、未触碰的无关文件及有意不动的候选。限制:不要把注释作为清理目标(除非过期或误导),不要在清理单个组件后停止,需覆盖完整流程边界;资料未提供具体命令示例、安装方式、收费信息与支持平台。