SuperAPI AI 工具集

audit-simplification

编程与开发

查看项目

更新于 10-16 02:34

技能介绍

用途:审计 Elements 项目、目录或组件,找出可能不需要存在的机制,在保留必要可观察行为的前提下减少概念、分配、同步路径和生命周期职责。审计默认只读,仅在用户明确要求实现时才编辑。

主要能力:检查属性与特性重复(反射、规范化、转换器、同步)、依赖间接(仅返回公共成员的调用、恒定选项、纯转发方法、被忽略的返回值、单一实现抽象)、生命周期归属、存储状态必要性、实例基数与分配、原生平台替代、命名与放置。按证据、收益、置信度、风险排序,给出 P1/P2/P3 优先级,并输出范围、发现、保留项和推荐起点。

使用方式:先读根 AGENTS.md、更近的代理说明和目标项目的 DEVELOPMENT.md,再分析。保留已发布 API,除非用户授权破坏性变更;以 package.json exports 为发布边界,并搜索 projects/ 下所有项目(含 starters、site docs、*.examples.ts、projects/internals/patterns)。若主要问题是重复或共享职责应放哪里,用 audit-consolidation;若先问机制是否需要存在,用本技能,两者都适用时先跑本审计。

适用场景:Lit 组件、Elements 项目、目录或组件的简化审计,尤其是属性反射、状态存储、生命周期、单例与分配、原生平台替代等。

限制:不得仅因测试描述内部机制就保留内部机器;反射若支持 CSS、无障碍、序列化或外部观察则不应移除;单例可能引入 SSR、跨文档、测试或全局状态泄漏;手动 DOM 行为有意不同于原生语义时保留;生命周期需支持 Lit 之外宿主时保留;替换若增加耦合或间接则不做。性能发现需绑定具体避免的分配、监听器、同步步骤、保留对象或热路径操作,推测性收益需标注;需要测量证据时用 authoring-benchmarks。用户要求改动时,一次应用一个连贯机会,先建立行为基线,移除过时状态、回调、分支、测试和导入,搜索所有构造点,通过 mise 运行测试、类型检查、lint 和构建,再运行 git diff --check;涉及反射、插槽或 DOM 同步时还应运行 test:ssr、test:axe、test:visual。